---
title: "Claude Managed Agents - מדריך מעשי להתחלה נכונה | RT-AI"
description: "מדריך מעשי ל-Claude Managed Agents: Agent, Environment, Session ו-Events, מסלול מהיר ב-Console, הקמה דרך API, הרשאות, רשת ו-MCP בלי טעויות."
url: "https://rt-ai.co.il/guides/claude-managed-agents-guide-2026"
language: "he"
published: "2026-04-10T00:00:00.000Z"
modified: "2026-04-10T00:00:00.000Z"
---

מדריכים מעשיים

Claude

# Claude Managed Agents - המדריך המעשי להתחלה נכונה

רועי טל

פורסם: 10.4.2026

13 דקות קריאה

![Claude Managed Agents - המדריך המעשי להתחלה נכונה](https://rt-ai.co.il/assets/claude-managed-agents-guide-69287d20.jpg)

מדריכים מעשיים

Claude

## Claude Managed Agents - המדריך המעשי להתחלה נכונה

מאת רועי טל | 10 באפריל 2026 | 13 דקות קריאה

תארו לעצמכם שאתם לא רק מבקשים מ-Claude לענות, אלא נותנים לו ממש לעבוד: לפתוח סביבת עבודה, לקרוא ולכתוב קבצים, להריץ פקודות, לגלוש באינטרנט ולחזור אליכם רק כשהמשימה באמת מתקדמת. זה בדיוק מה ש-Claude Managed Agents עושה. במקום לבנות הכל לבד - ניהול הסוכן, הסביבה, ההרשאות והמעקב - אתם מקבלים תשתית מוכנה מ-Anthropic ומגדירים עליה את הסוכן שלכם. במדריך הזה נתחיל נכון: קודם במסלול מהיר דרך Console ואז במסלול טכני דרך ה-API, עם הווידאו הרשמי, דוגמאות מעשיות והטעויות שכדאי להכיר לפני שמתחילים לעבוד.

אם אתם רוצים קודם לראות את המוצר דרך Anthropic עצמה, זה הסרטון הרשמי: **Introducing Claude Managed Agents**.

### 📚 המקורות הרשמיים שכדאי להשאיר פתוחים לידכם

- [Claude Managed Agents overview](https://platform.claude.com/docs/en/managed-agents/overview)
- [Quickstart רשמי](https://platform.claude.com/docs/en/managed-agents/quickstart)
- [Events and streaming](https://platform.claude.com/docs/en/managed-agents/events-and-streaming)
- [Permission policies](https://platform.claude.com/docs/en/managed-agents/permission-policies)
- [Cloud container reference](https://platform.claude.com/docs/en/managed-agents/cloud-containers)
- [Skills in Managed Agents](https://platform.claude.com/docs/en/managed-agents/skills)
- [Multiagent sessions](https://platform.claude.com/docs/en/managed-agents/multi-agent)
- [Scaling Managed Agents - הפוסט ההנדסי של Anthropic](https://www.anthropic.com/engineering/managed-agents)

### 🎯 מה תשיגו בסוף המדריך הזה

- ✅ תבינו מתי לבחור Claude Managed Agents במקום Messages API רגיל
- ✅ תדעו מה זה Agent, Environment, Session ו-Events בלי להסתבך בז׳רגון
- ✅ תעלו Agent ראשון במסלול מהיר דרך Console בלי לכתוב קוד
- ✅ תבנו זרימה אמיתית דרך API עם יצירת Agent, Environment, Session ו-stream
- ✅ תחסכו את הטעויות הכי נפוצות סביב רשת, הרשאות, uploads ו-output files

**נכון ל-10 באפריל 2026:** כל קריאות ה-API ל-Claude Managed Agents דורשות את ה-beta header `managed-agents-2026-04-01`. לפי ה-overview הרשמי, הגישה הבסיסית זמינה כברירת מחדל לחשבונות API, אבל **multi-agent**, **memory** ו-**outcomes** עדיין מסומנים כ-Research Preview ודורשים גישה נוספת.

## לפני שמתחילים - מה נדרש

🔑

#### Console + API Key

במסלול המהיר מספיק Console של Anthropic. במסלול הטכני תצטרכו גם API Key פעיל.

🧭

#### Use Case ברור

Managed Agents מתאים למשימות מרובות שלבים: קבצים, shell, גלישה, חיבורים וכל עבודה שנמשכת מעבר לתשובת צ׳אט אחת.

🧩

#### MCP ו-Skills הם בונוס

לא חייבים להתחיל איתם. עדיף קודם להרים Agent בסיסי עם toolset מובנה ורק אחר כך להרחיב.

## 🧠 מה זה Claude Managed Agents בכלל?

בגדול, Claude Managed Agents הוא תשתית מוכנה שמריצה סוכנים בשבילכם. במקום לבנות הכל לבד, Anthropic נותנת לכם מערכת שכבר יודעת לנהל סוכן, סביבת עבודה, כלים ומשימות. אתם רק מגדירים מה הסוכן צריך לעשות והמערכת דואגת לשאר - כולל ריצות ארוכות, שמירת מצב ועבודה עם כלים בצורה מסודרת.

#### Agent

זה ה״מוח״ - ההגדרה של מי הסוכן, מה הוא יודע לעשות ואילו כלים יש לו. מגדירים פעם אחת ומשתמשים שוב ושוב.

#### Environment

סביבת העבודה של הסוכן. כאן מחליטים אם הוא יכול לגלוש באינטרנט, לגשת לקבצים ומה ההרשאות שלו.

#### Session

כל פעם שנותנים לסוכן משימה, נפתח Session חדש. הוא שומר את כל מה שקרה - מה הסוכן עשה, מה יצא ומה הסטטוס.

#### Events

ככה עוקבים אחרי מה שהסוכן עושה בזמן אמת: אתם שולחים לו הוראה והוא מעדכן אתכם על כל צעד שהוא מבצע.

## מתי כן להשתמש - ומתי לא

#### ✅ כן - אם המשימה שלכם היא באמת Agentic

- - יש לכם משימה של דקות או יותר, לא רק תשובה אחת
- - הסוכן צריך לגשת לקבצים, shell, web או MCP
- - חשוב לכם לעקוב אחרי הסוכן בזמן אמת ולדעת מה הסטטוס שלו
- - אתם רוצים session מתמשך במקום prompt בודד

#### ❌ לא - אם Messages API מספיק לכם

- - אתם צריכים רק תשובה טקסטואלית אחת או פלט מובנה
- - אין צורך אמיתי בקבצים, הרצת פקודות, או משימה ארוכה
- - אתם רוצים לשלוט בעצמכם על כל שלב שהסוכן עושה
- - היישום קטן, מהיר ופשוט - לא באמת צריך סוכן מלא

## מה כבר מחכה לכם בתוך הסביבה

#### Cloud Container מוכן מראש

לפי ה-container reference, ברירת המחדל היא Ubuntu 22.04 עם עד 8GB RAM ועד 10GB דיסק. הרשת כבויה כברירת מחדל עד שאתם מחליטים אחרת.

#### שפות וכלים נפוצים כבר בפנים

Python 3.12, Node.js 20, Go, Rust, Java, git, curl, jq, rg, sed, awk ו-vim כבר זמינים. זה אומר שאפשר להתחיל לעבוד כמעט מיד.

#### Filesystem עם חוקים שחשוב להכיר

קבצים שמעלים מראש זמינים ב-`/mnt/session/uploads` כקריאה בלבד. תוצרים סופיים שומרים ב-`/mnt/session/outputs`. עבודה editable עושים ב-`/mnt/user` או `/tmp`.

🚀

### מסלול מהיר - Console

למי שרוצה להבין מהר איך המוצר מרגיש, בלי להתחיל מ-curl או SDK.

🛠️

### מסלול טכני - API

למי שרוצה לבנות Agent אמיתי דרך API עם מעקב, תוצרים ושליטה מלאה.

🚀

## מסלול מהיר - להתחיל דרך Console

הדרך הכי טובה להבין איך הדברים עובדים לפני שנוגעים ב-API.

1

### פתחו Agent חדש ב-Console

היכנסו ל-Anthropic Console, עברו לאזור Managed Agents וצרו Agent חדש עם מודל Sonnet עדכני.

💬 הדביקו בשדה System:

אתה סוכן ביצוע מעשי וזהיר. לפני כל פעולה, הסבר בקצרה מה אתה עומד לעשות. השתמש בכלים כשצריך, אל תנחש כשחסר מידע ושמור כל תוצר סופי בתוך /mnt/session/outputs.

1. 1. תנו ל-Agent שם ברור, למשל **Managed Agents Demo**
2. 2. בחרו מודל Sonnet עדכני, אלא אם יש לכם סיבה אחרת
3. 3. אל תחברו Skills או MCP כבר בצעד הראשון. קודם ודאו שהבסיס עובד

2

### הפעילו Tools והבינו מה קורה עם ההרשאות

כלי העבודה המובנים כוללים הרצת פקודות, עבודה עם קבצים, חיפוש באינטרנט ושליפת תוכן מדפי אינטרנט. זה מספיק לרוב הניסויים הראשונים.

1. 1. הפעילו את **agent_toolset_20260401**
2. 2. שימו לב: לפי docs, ברירת המחדל של agent toolset היא **always_allow**
3. 3. לעומת זאת, ב-MCP toolset ברירת המחדל היא **always_ask**
4. 4. אם אתם מתכננים MCP, תכננו מראש מי מאשר tool calls ומתי

**טיפ:** לפי docs של Skills, אפשר לצרף עד **20 skills** בכל session, כולל across multiple agents אם תעברו אחר כך למבנה multi-agent.

3

### צרו Environment נכון כבר מהניסיון הראשון

Environment הוא לא סתם הגדרה טכנית. הוא קובע אם הסוכן יכול לגלוש, לאילו קבצים יש לו גישה ואיך הריצה מתנהגת.

#### Limited networking

הבחירה השמרנית לניסיון ראשון. מצוין אם אתם בודקים עבודה עם קבצים, הרצת פקודות ומשימות פנימיות בלי גישה לאינטרנט.

#### Unrestricted networking

צריך את זה אם ה-Agent אמור לגלוש, לדבר עם שירותים חיצוניים, לעבוד מול MCP מרוחק או למשוך משאבים מהרשת.

#### ⚠️ שגיאה נפוצה: למה web search לא עובד?

ברוב המקרים פשוט שכחתם להפעיל רשת ב-Environment. סביבת העבודה מגיעה עם אינטרנט כבוי כברירת מחדל.

**איך מתקנים:** עברו ל-Environment, הפעילו unrestricted networking והריצו session חדש. אל תצפו ש-session שכבר רץ ישנה התנהגות מעצמו.

4

### הריצו Session ראשון עם משימה אמיתית

אל תבדקו עם שאלה כללית. תנו משימה שמכריחה את ה-Agent להשתמש בקבצים, shell או בדיקה של הסביבה.

💬 כתבו ל-Agent ב-session הראשון:

בדוק מה זמין בסביבה הזאת. צור קובץ בשם first-run-report.md בתוך /mnt/session/outputs וכתוב בו: 1. איזו מערכת הפעלה וכלים זמינים 2. שלושה use cases שמתאימים ל-Claude Managed Agents 3. אילו הרשאות או חיבורים עוד חסרים כדי לעבוד עם GitHub או MCP. אם משהו לא נגיש, כתוב את זה במפורש.

#### מה יקרה עכשיו? במילים פשוטות

אחרי שתשלחו את ההודעה, אתם תראו את Claude מתחיל "לחשוב" ולעבוד. בניגוד לצ'אט רגיל, יכול להופיע על המסך רצף של ריבועים קטנים עם קוד או פעולות. זה סימן טוב: ה-Agent פשוט משתמש בכלים שלו.

- - אל תחפשו מיד תשובה ארוכה בצ'אט. רוב המידע יישמר בתוך קובץ שהסוכן יוצר "במחשב שלו".
- - אם אתם רואים קוד, פקודות או tool use, זה לא אומר שמשהו נשבר. זה בדיוק מה שאמור לקרות כאן.
- - הדרך הכי פשוטה לבדוק שהכול הצליח היא פשוט לשאול: **"אפשר לראות את התוכן של הקובץ שיצרת?"**

1. 1. שימו לב אם ה-Agent באמת מפעיל כלים או רק מחזיר טקסט
2. 2. חפשו אירועים כמו `agent.message` ו-`agent.tool_use`
3. 3. ודאו שבסוף יש מעבר ברור ל-`session.status_idle` או **end_turn**

5

### בדיקה - תוודאו שה-Agent באמת סיים

1. 1. ראיתם לפחות הודעת `agent.message` אחת
2. 2. ראיתם לפחות tool use אחד - אחרת נתתם משימה צ׳אטית מדי
3. 3. נוצר קובץ output אמיתי ב-`/mnt/session/outputs`
4. 4. ה-session הסתיים בצורה ברורה ולא פשוט נעלם
5. 5. אם נדמה שהוא תקוע, בדקו אם ה-stop reason הוא **requires_action**

#### ⚠️ ה-session נראה תקוע, אבל בעצם מחכה לכם

לפי docs של event stream ו-permission policies, Session יכול לעבור ל-idle גם כשהמשימה לא באמת הסתיימה, אלא פשוט מחכה לאישור אנושי.

**איך מתקנים:** חפשו `requires_action` ואז אשרו את ה-tool call המתאים או שלחו `user.tool_confirmation`.

🛠️

מסלול טכני - שליטה מלאה דרך API

🛠️

## מסלול טכני - API, Events ו-output אמיתי

המסלול הזה מבוסס על ה-quickstart הרשמי, אבל מותאם לעבודה הנדסית אמיתית ולא רק להדגמה.

## 1 הגדירו API Key

אם אתם עובדים עם curl, אתם חייבים להגדיר את ה-beta header בעצמכם. ב-SDK הרשמי ה-beta headers מתווספים אוטומטית.

Terminal

```
export ANTHROPIC_API_KEY="your-api-key-here"
```

## 2 צרו Agent

נתחיל מהגדרת הסוכן עצמו: שם, מודל, system prompt וכלי העבודה המובנים.

create-agent.sh

```
AGENT_RESPONSE=$(curl -sS --fail-with-body https://api.anthropic.com/v1/agents   -H "x-api-key: $ANTHROPIC_API_KEY"   -H "anthropic-version: 2023-06-01"   -H "anthropic-beta: managed-agents-2026-04-01"   -H "content-type: application/json"   -d @- <
```

`
`

`

3צרו Environment
כאן מחליטים מה סביבת הריצה תאפשר. בדוגמה הזאת אנחנו מתחילים ב-limited networking כדי לא לפתוח יותר מדי מהר.

create-environment.sh
📋 העתק

ENV_RESPONSE=$(curl -sS --fail-with-body https://api.anthropic.com/v1/environments -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -H "anthropic-beta: managed-agents-2026-04-01" -H "content-type: application/json" -d @- <

4פתחו Session
Session הוא ההרצה עצמה של הסוכן בתוך הסביבה שיצרתם. ממנו תתחילו לשלוח הוראות ולקבל עדכונים.

create-session.sh
📋 העתק

SESSION_RESPONSE=$(curl -sS --fail-with-body https://api.anthropic.com/v1/sessions -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -H "anthropic-beta: managed-agents-2026-04-01" -H "content-type: application/json" -d @- <

5שלחו משימה והאזינו ל-stream
קודם שולחים הודעה לסוכן ואז מאזינים לעדכונים בזמן אמת - כדי לראות מה הוא עונה, אילו כלים הוא מפעיל ומה הסטטוס.

run-and-stream.sh
📋 העתק

curl -sS --fail-with-body "https://api.anthropic.com/v1/sessions/$SESSION_ID/events" -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -H "anthropic-beta: managed-agents-2026-04-01" -H "content-type: application/json" -d @- </dev/null
{
"events": [
{
"type": "user.message",
"content": [
{
"type": "text",
"text": "Inspect this environment. Create /mnt/session/outputs/first-run-report.md and include: 1. which OS and major tools are available 2. three good use cases for Claude Managed Agents 3. what is still missing if I want GitHub or MCP access. Be explicit when something is not available."
}
]
}
]
}
EOF

curl -sS -N "https://api.anthropic.com/v1/sessions/$SESSION_ID/stream" -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -H "anthropic-beta: managed-agents-2026-04-01" |
while IFS= read -r line; do
[[ $line == data:* ]] || continue
json=$(sed "s/^data: //" <<<"$line")
type=$(jq -r ".type // empty" <<<"$json")

case "$type" in
agent.message)
jq -r '.content[]? | select(.type == "text") | .text' <<<"$json"
;;
session.status_update)
jq -r ".status // empty" <<<"$json"
;;
session.status_idle)
echo "Session is idle"
break
;;
esac
done

6תוודאו שהתוצרים נשמרו במקום הנכון
אחד החלקים הכי חשובים ב-Managed Agents הוא לא רק מה Claude אומר, אלא מה הוא משאיר אחריו. אם אתם רוצים output שאפשר להוריד, להציג או להמשיך לעבד, אל תשאירו אותו בתוך תשובת הצ׳אט בלבד.

/mnt/session/uploads
הקבצים שהעליתם מראש ל-session. לפי docs הם mounted כקריאה בלבד, אז אל תנסו לערוך אותם במקום.

/mnt/session/outputs
כאן שומרים תוצרים סופיים שאתם רוצים להוציא החוצה: דוחות, CSV, JSON, markdown ותמונות.

/mnt/user או /tmp
אם צריך קובץ editable במהלך העבודה, העתיקו אליו את החומר ועבדו שם. זה המקום הנכון ל-temp workspace.

⚠️שגיאה נפוצה: מנסים לערוך upload קיים
הקבצים ב-/mnt/session/uploads הם read-only. אם תנסו לשנות אותם ישירות, הסוכן ייתקע או יחזיר שגיאת כתיבה.
איך מתקנים: העתיקו את הקובץ ל-/mnt/user או /tmp, עבדו עליו שם ושמרו את התוצר הסופי ל-/mnt/session/outputs.

7מה כדאי לעשות אחרי ה-Hello World
אחרי שהרמתם Agent בסיסי ועברתם דרך אחת מלאה של Session, אפשר להתחיל לשפר את הסוכן בצורה מסודרת.

Skills
אם יש לכם משימות שחוזרות על עצמן, העבירו אותן ל-Skills. זה עדיף על prompt ארוך שחוזר שוב ושוב.

MCP
חברו MCP כשאתם באמת צריכים כלים חיצוניים או מקורות נתונים. זכרו שברירת המחדל ב-MCP toolset היא always_ask.

Multi-agent
זה כבר Research Preview, אבל חשוב לדעת: כל הסוכנים חולקים אותו container ואותו filesystem וכל אחד רץ ב-thread מבודד עם event stream משלו.

מתי multi-agent כן שווה את זה? כשיש משימה מורכבת עם כמה תתי-משימות עצמאיות: למשל חוקר שמחפש מידע, סוכן בדיקות שכותב טסטים ומתאם שמרכז את התוצאה. לא צריך את זה לכל Agent.

סיכום

Claude Managed Agents לא נועד להחליף כל קריאה ל-Claude. הוא נועד לרגע שבו תשובת צ׳אט כבר לא מספיקה ואתם צריכים סביבת עבודה מנוהלת, כלים, קבצים, stream, sessions ודרך אמינה להחזיק משימה לאורך זמן.

אם אתם רק מתחילים, תעשו את זה פשוט: קודם Console, אחר כך API ורק אחר כך Skills, MCP ו-multi-agent. ההתקדמות הנכונה פה היא לא להפעיל את כל הפיצ׳רים בבת אחת, אלא לבנות אמון בזרימה הבסיסית.

הצעד הבא שאני ממליץ עליו

      1. הרימו Agent ראשון ב-Console עם task קטן אבל אמיתי
      2. הריצו את מסלול ה-API פעם אחת עם output file אמיתי
      3. הוסיפו MCP או Skill אחד בלבד, לא חמישה בבת אחת
      4. רק אם יש צורך אמיתי, עברו אחר כך ל-multi-agent

`

`
`

`
`