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

תיעוד 164

סקירה כללית של Agent SDK

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

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

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

ה-Agent SDK, ה-CLI, ה-Client SDK ו-Managed Agents נבדלים בכך מי מריץ את הסוכן, מה מגיע מובנה, ואיך מגיעים אליו. מצאו את השורה שמתאימה לאופן שבו אתם רוצים לבנות ולהריץ את שלכם.

מה אתם רוציםמה להשתמשמה מקבלים
להטמיע את הסוכן של Claude Code ביישום Python או TypeScript משלכם, בתהליך שאתם מפעיליםAgent SDKספרייה שמריצה את הקובץ הבינארי של Claude Code, עם היכולות של Claude Code, כמו כלים מובנים, הרשאות, סשנים ו-hooks.
לפתח באופן אינטראקטיבי או להריץ משימות חד פעמיות ממסוףClaude Code CLIממשק המסוף, שנבנה לשימוש אינטראקטיבי יומיומי.
לקרוא ל-Claude API ישירות מהקוד שלכםClient SDKגישה ישירה ל-Claude API מכל אחת משפות ה-Client SDK. אתם כותבים את לולאת הכלים בעצמכם, או נותנים ל-tool runner בבטא של ה-Client SDK להניע אותה.
ש-Anthropic יארח את הסוכן, שמוגדר דרך Claude APIManaged Agentsרתמת סוכן מתארחת שמריצה את לולאת הסוכן, עם סשנים בארגז חול בענן שמנוהל על ידי Anthropic או ב-ארגז חול באירוח עצמי על התשתית שלכם. משתמשים בה מה-SDK של השפה שלכם, מ-CLI של ant, או מ-REST API.

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

#יכולות

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

יכולתמה היא עושהלמידע נוסף
כלים מובניםקריאה, כתיבה ועריכה של קבצים, הרצת פקודות וחיפוש באינטרנטעיון בכלים
Hooksהרצת קוד מותאם בנקודות מפתח במחזור החיים של הסוכןHooks
סוכני משנהיצירת סוכנים מתמחים לתת משימות ממוקדותסוכני משנה
MCPחיבור כלים ומקורות נתונים חיצוניים באמצעות Model Context ProtocolMCP
הרשאותשליטה באילו כלים רצים אוטומטית ואילו צריכים אישורהרשאות
סשניםשמירת הקשר לאורך חילופים, והמשך או fork מאוחר יותרסשנים
מיומנויות, פקודות וזיכרוןנטענים אוטומטית מ-.claude/ של הפרויקט שלכם ומ-~/.claude/, כמו ב-Claude Codeמיומנויות, פקודות, זיכרון, טעינת תצורה
תוספיםאריזת מיומנויות, סוכנים, hooks ושרתי MCP, וטעינתם לפי נתיב מקומיתוספים

#התחלה

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

[!NOTE]

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

#יומן שינויים

צפו ביומן השינויים המלא לעדכוני 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.