טיפ: שמור פרומפטים שעבדו ✅ לשימוש חוזר - חסוך זמן
    מדריכים מעשיים
    Claude

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

    רועי טל
    פורסם: 10.4.2026
    13 דקות קריאה
    Claude Managed Agents - המדריך המעשי להתחלה נכונה
    מדריכים מעשיים Claude

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

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

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

    אם אתם רוצים קודם לראות את המוצר דרך Anthropic עצמה, זה הסרטון הרשמי: Introducing Claude 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. 1. הרימו Agent ראשון ב-Console עם task קטן אבל אמיתי
    2. 2. הריצו את מסלול ה-API פעם אחת עם output file אמיתי
    3. 3. הוסיפו MCP או Skill אחד בלבד, לא חמישה בבת אחת
    4. 4. רק אם יש צורך אמיתי, עברו אחר כך ל-multi-agent
    Subscribe

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

    השאירו פרטים וקבלו התראה ישירות לתיבת הדואר עם כל פוסט חדש. ערך מובטח, ללא ספאם. 💌