מדריך קלוד קוד בעברית
לאתר הראשי כל המדריכים קלאודפלייר קלוד דסקטופ גרוק CLI גרוק בוט MCP קרסור וואטסאפ OpenClaw n8n בענן n8n בהתקנה עצמית

תיעוד 123

סקירת Agent SDK

בנו סוכני AI לייצור באמצעות Claude Code כספרייה

סוכן הוא יישום שמשלים משימה על ידי תכנון השלבים של עצמו וקריאה לכלים שקוראים קבצים, מריצים פקודות או עורכים קוד. ה-Agent SDK מעניק לכם את אותם הכלים, את לולאת הסוכן ואת ניהול ההקשר שמניעים את Claude Code, הניתנים לתכנות ב-Python וב-TypeScript.

#השוואת Agent SDK לכלי Claude אחרים

ה-Agent SDK, ה-CLI, ה-Client SDK ו-Managed Agents מתאימים כל אחד לצרכים שונים. השתמשו בטבלה כדי למצוא את הכלי שמתאים למה שאתם בונים.

אם אתם...השתמשו ב-למה
בונים סוכן בלי לממש את לולאת הכלים בעצמכםAgent SDKספרייה שמריצה את לולאת הסוכן בתהליך שלכם, ב-Python או ב-TypeScript.
מבצעים פיתוח אינטראקטיבי או מריצים משימות חד פעמיות מתוך מסוףClaude Code CLIממשק המסוף, שנבנה לשימוש אינטראקטיבי יומיומי.
קוראים ל-API ישירות ומממשים את לולאת הכלים בעצמכםClient SDKגישה ישירה ל-API של Anthropic ולא ל-Claude Code. אתם מממשים את לולאת הכלים בעצמכם.
מריצים סוכנים הפועלים לאורך זמן או סוכנים אסינכרוניים בלי לנהל תשתית ארגז חול (sandbox) או תשתית הפעלות (sessions) משלכםManaged AgentsREST API מתארח, מוצר נפרד מ-Agent SDK. חברת Anthropic מריצה את הסוכן ואת ארגז החול.

ה-SDK זמין כספרייה עבור Python ועבור TypeScript בלבד. כדי להפעיל את אותה לולאת סוכן משפה אחרת, הריצו את ה-CLI כתהליך משנה (subprocess) עם הדגל -p ועם --output-format json.

#יכולות

יכולות Claude Code הבאות זמינות ב-SDK:

יכולתמה היא עושהמידע נוסף
כלים מובנים (Built-in tools)קריאה, כתיבה, עריכת קבצים, הרצת פקודות וחיפוש באינטרנטTools reference
Hooksהרצת קוד מותאם אישית בנקודות מפתח במחזור החיים של הסוכןHooks
סוכני משנה (Subagents)הפעלת סוכנים ייעודיים עבור משימות משנה ממוקדותSubagents
MCPחיבור כלים ומקורות נתונים חיצוניים דרך Model Context ProtocolMCP
הרשאות (Permissions)שליטה באילו כלים ירוצו אוטומטית, ואילו זקוקים לאישורPermissions
הפעלות (Sessions)שמירה על ההקשר לאורך חילופי דברים, המשכה או פיצול (fork) מאוחר יותרSessions
מיומנויות, פקודות וזיכרון (Skills, commands, and memory)נטענים אוטומטית מתוך תיקיית .claude/ של הפרויקט שלכם ומתוך ~/.claude/, בדיוק כמו ב-Claude CodeSkills, Commands, Memory, Configuration loading
תוספים (Plugins)אריזת מיומנויות, סוכנים, hooks ושרתי MCP, וטעינתם לפי נתיב מקומיPlugins

#תחילת העבודה

פעלו לפי מדריך ה-Quickstart כדי להתקין את ה-SDK, להגדיר את מפתח ה-API שלכם ולבנות את הסוכן הראשון שלכם, כזה שמוצא ומתקן באגים בקוד קיים.

הערה: אלא אם כן ניתן אישור מראש, Anthropic אינה מאפשרת למפתחי צד שלישי להציע התחברות באמצעות claude.ai או מגבלות קצב (rate limits) עבור המוצרים שלהם, כולל סוכנים שנבנו באמצעות Claude Agent SDK. השתמשו במקום זאת בשיטות האימות באמצעות מפתח API המתוארות ב-Quickstart.

#יומן שינויים (Changelog)

עיינו ביומן השינויים המלא לקבלת עדכוני SDK, תיקוני באגים ותכונות חדשות:

#דיווח על באגים

אם נתקלתם בבאגים או בבעיות ב-Agent SDK:

#הנחיות מיתוג

עבור שותפים המשלבים את Claude Agent SDK, השימוש במיתוג של Claude הוא אופציונלי. בעת התייחסות ל-Claude במוצר שלכם:

מותר:

  • "Claude Agent", מועדף עבור תפריטים נפתחים
  • "Claude", כאשר זה בתוך תפריט שכבר מתויג כ-"Agents"
  • "{YourAgentName} Powered by Claude", אם יש לכם שם סוכן קיים

אסור:

  • "Claude Code" או "Claude Code Agent"
  • אמנות ASCII ממותגת של Claude Code או אלמנטים חזותיים שמחקים את Claude Code

המוצר שלכם צריך לשמור על מיתוג משלו ולא להיראות כמו Claude Code או כמוצר כלשהו של Anthropic. לשאלות בנוגע לעמידה בהנחיות המיתוג, פנו אל צוות המכירות של Anthropic.

#רישיון ותנאים

השימוש ב-Claude Agent SDK כפוף ל-תנאי השירות המסחריים של Anthropic, כולל כאשר אתם משתמשים בו כדי להפעיל מוצרים ושירותים שאתם מעמידים לרשות הלקוחות ומשתמשי הקצה שלכם, למעט במידה שבה רכיב או תלות ספציפיים מכוסים ברישיון אחר כפי שמצוין בקובץ ה-LICENSE של אותו רכיב.

#הצעדים הבאים

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