Agent SDK: בונים סוכן AI מותאם על גבי Claude Code

מאת צוות מדיה דיל · 08.08.2026 · AI · 9 דק׳

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

תארו לעצמכם עוזר AI שיודע לקרוא קוד, לערוך קבצים, להריץ פקודות טרמינל ולחפש מידע ברשת - בדיוק כמו Claude Code בטרמינל שלכם - אבל רץ בשקט בתוך המוצר שלכם: בתוך בוט פנימי, בתוך פייפליין אוטומציה, או בתוך שירות SaaS שלם שאתם מוכרים ללקוחות. זו בדיוק ההבטחה של Claude Agent SDK. לא עוד כלי CLI אינטראקטיבי שמיועד למפתחים שיושבים מול טרמינל, אלא ספרייה (library) שאפשר להטמיע בקוד שלכם ב-Python או ב-TypeScript, עם אותה לולאת סוכן (agent loop), אותם כלים ואותו ניהול הקשר (context management) שמניעים את Claude Code עצמו. במילים אחרות - כל מה שהופך את Claude Code לחזק כל כך, זמין עכשיו כרכיב שאפשר לבנות עליו מוצר משלכם, בשליטה מלאה.

מה זה Claude Agent SDK, ולמה הוא שונה מ-Claude Code הרגיל

Claude Agent SDK הוא ספרייה רשמית מבית Anthropic שנותנת למפתחים גישה לאותה לולאת סוכן, אותם כלים מובנים ואותו ניהול הקשר שעליהם מבוסס Claude Code - אבל כרכיב שמריץ אתם בתוך התהליך (process) שלכם, ולא כתוכנית עצמאית שרצה בטרמינל. ההבדל המרכזי הוא בקהל היעד ובאופן השימוש: Claude Code, ה-CLI, נבנה לשימוש אינטראקטיבי יומיומי - מפתח יושב מול המסך, נותן הנחיות, ורואה תוצאות בזמן אמת. ה-Agent SDK, לעומת זאת, נועד למי שרוצה לבנות אפליקציה שלמה סביב סוכן AI - עם ממשק משתמש משלה, לוגיקה עסקית משלה, ואינטגרציות משלה למערכות פנימיות.

כדי להבין איפה בדיוק ה-SDK ממוקם, כדאי להכיר את שלוש האפשרויות השכנות שלו. הראשונה היא Claude Code CLI עצמו - הממשק הטרמינלי המיועד לפיתוח אינטראקטיבי ומשימות חד-פעמיות, כפי שתיארנו במדריך המלא על Claude Code. השנייה היא ה-Client SDK הרגיל - גישה ישירה ל-API של Anthropic, שבה אתם צריכים לממש בעצמכם את כל לולאת הכלים (tool loop): לשלוח בקשה, לקבל קריאת כלי, להריץ אותה, להחזיר תוצאה, וחוזר חלילה. השלישית היא Managed Agents - מוצר נפרד ומנוהל לחלוטין, שבו Anthropic מריץ עבורכם גם את הסוכן וגם את הסביבה המבודדת (sandbox) שבה הוא פועל, מתאים בעיקר לסוכנים אסינכרוניים וארוכי טווח שלא רוצים לנהל תשתית בעצמכם.

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

אבני הבניין המרכזיות של ה-SDK

מה שמייחד את Claude Agent SDK הוא שהוא לא מגיע ריק - הוא מביא איתו את מלוא היכולות שהופכות את Claude Code לכלי כל כך שלם, ומאפשר לכם להרכיב מהן בדיוק את הסוכן שאתם צריכים:

• כלים מובנים (Built-in tools) - קריאה, כתיבה ועריכה של קבצים, הרצת פקודות מערכת, וחיפוש באינטרנט, בדיוק כמו הכלים שסוכן Claude Code משתמש בהם מדי יום.
• הרשאות (Permissions) - שליטה מדויקת בשאלה אילו כלים רצים אוטומטית ואילו דורשים אישור מפורש. זה הלב של הבטיחות בסוכן שרץ בתוך מוצר שלכם: אתם קובעים בדיוק מה מותר לו לעשות בלי מגע יד אדם, ומה מצריך אישור.
• אינטגרציית MCP - חיבור לכלים חיצוניים ולמקורות מידע דרך פרוטוקול ה-Model Context Protocol, כך שהסוכן שלכם יכול לדבר עם מערכות פנימיות, מסדי נתונים, או שירותי SaaS נוספים. הרחבנו על הארכיטקטורה הזו במדריך על MCP.
• Hooks - נקודות עצירה שבהן אפשר להריץ קוד מותאם אישית בשלבים מרכזיים של מחזור החיים של הסוכן, למשל לוגים, בדיקות תקינות, או חסימת פעולות מסוימות לפני שהן קורות בפועל.
• Subagents - יכולת להריץ סוכנים ייעודיים למשימות ממוקדות בתוך התהליך הכולל, כך שסוכן-על יכול להאציל חלק מהעבודה לסוכן קטן ומתמחה. הנושא הזה מפורט במדריך על מערכות multi-agent.
• Sessions - שמירת הקשר בין פניות, כולל היכולת לחדש שיחה או "לפצל" (fork) אותה להמשך נפרד - קריטי לכל סוכן שצריך לזכור מה קרה קודם. הנושא של ניהול זיכרון בסוכנים נסקר במדריך על ניהול זיכרון.
• Skills, פקודות וזיכרון - נטענים אוטומטית מתיקיית .claude/ בפרויקט ומ-~/.claude/, בדיוק כפי שקורה ב-Claude Code עצמו. אם כבר בניתם Skills מותאמות אישית כמתואר במדריך על Skills ופקודות, הן ממשיכות לעבוד גם כשהסוכן רץ דרך ה-SDK.
• Plugins - אריזה של Skills, סוכנים, hooks ושרתי MCP יחד, וטעינה שלהם לפי נתיב מקומי - נוח כשרוצים להפיץ חבילת יכולות שלמה בין פרויקטים או צוותים.

המשמעות המעשית היא שאתם לא בונים סוכן AI מאפס. אתם מרכיבים אותו מרכיבים מוכנים ובדוקים - אותם רכיבים בדיוק שעומדים מאחורי Claude Code - ומתאימים רק את השכבה שבאמת ייחודית לצורך שלכם: איזה כלים מותרים, אילו מקורות מידע מחוברים, ואיך הכל משתלב בממשק המוצר שלכם.

תרחיש מציאותי: בונים סוכן פנימי לחברה

נניח שיש לכם צוות פיתוח בינוני, ואתם רוצים בוט פנימי בסלאק (Slack) שמפתחים יכולים לפנות אליו עם שאלות על הקוד, בקשות לתיקון באג קטן, או בדיקה האם שינוי מסוים לא שובר טסטים קיימים. עם Client SDK הרגיל הייתם צריכים לממש בעצמכם את כל מנגנון ה"תכנן, קרא לכלי, קבל תוצאה, החלט מה השלב הבא" - עבודה לא טריוויאלית שדורשת תחזוקה מתמשכת. עם Managed Agents הייתם מקבלים פתרון מנוהל לגמרי, אבל בלי שליטה עדינה על הסביבה שבה הבוט רץ ועל האינטגרציות הפנימיות הספציפיות שלכם.

עם Agent SDK, התמונה נראית אחרת. אתם בונים שירות קטן ב-TypeScript או ב-Python שמאזין להודעות בסלאק, ומעביר כל בקשה לסוכן שמופעל דרך ה-SDK. לסוכן הזה יש גישה לכלים המובנים - קריאת קבצים, הרצת פקודות, חיפוש ברשת - אבל דרך שכבת ההרשאות אתם קובעים בדיוק שהוא יכול להריץ טסטים ולקרוא קוד באופן אוטומטי, ואילו פעולה כמו push ל-branch ראשי או מחיקת קבצים מצריכה אישור אנושי מפורש. דרך MCP אתם מחברים אותו גם למערכת הטיקטים הפנימית שלכם, כך שהוא יכול לפתוח או לעדכן טיקט ישירות מתוך השיחה בסלאק. באמצעות hooks אתם מוסיפים לוג מפורט של כל פעולה שהסוכן מבצע, לצורכי ביקורת ותחקור עתידי. ואם המשימה גדולה מדי לסוכן אחד - למשל "בדוק את כל ה-PR הפתוחים ותן סיכום סיכונים" - אתם מפצלים אותה בין כמה subagents ממוקדים, כל אחד עם תפקיד צר משלו.

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

מתי לבחור ב-SDK, ומתי פשוט להשתמש ב-Claude Code

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

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

למה זה משנה עסקית - במיוחד לחברות וסוכנויות

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

יש לזה גם היבט מיתוגי. Anthropic מאפשרת לשלב מיתוג של Claude במוצר משלכם - למשל "Claude Agent" בתפריטי בחירה, או "מופעל על ידי Claude" (Powered by Claude) לצד השם המסחרי שלכם - אבל אוסרת להציג את המוצר כאילו הוא Claude Code עצמו, או לחקות את המיתוג והעיצוב הוויזואלי שלו. כלומר אתם בונים ומוכרים מוצר עם זהות משלכם, שנשען מתחת למכסה המנוע על אותה טכנולוגיה שמניעה את Claude Code - שילוב שמאפשר גם מהירות פיתוח וגם בידול עסקי אמיתי מול לקוחות.

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

שאלות נפוצות

באילו שפות תכנות אפשר להשתמש ב-Claude Agent SDK?

ה-SDK זמין כרגע כספרייה רשמית ל-Python ול-TypeScript בלבד. אם הפרויקט שלכם בנוי בשפה אחרת, האפשרות המתועדת היא להריץ את Claude Code CLI כתת-תהליך עם הדגל -p ופורמט --output-format json, מה שמאפשר לכם לקבל תשובות מובנות מאותה לולאת סוכן דרך ממשק שורת פקודה.

מה ההבדל בין Agent SDK ל-Client SDK הרגיל של Anthropic?

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

האם משתמשי הקצה של סוכן שבניתי עם ה-SDK יכולים להתחבר עם חשבון claude.ai שלהם?

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

אפשר להשתמש ב-Skills, פקודות מותאמות ו-MCP servers גם דרך ה-SDK?

כן. Skills, פקודות (commands) וזיכרון (memory) נטענים אוטומטית מתיקיית .claude/ בפרויקט ומ-~/.claude/, בדיוק כמו בעבודה עם Claude Code ישירות. גם חיבורי MCP לכלים ומקורות מידע חיצוניים עובדים באותו אופן, כך שאם כבר השקעתם בהתאמה אישית של Claude Code, ההשקעה הזו ממשיכה לשרת אתכם כשעוברים ל-SDK.

מותר לי למתג את הסוכן בשם המוצר שלי?

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

מאיפה כדאי להתחיל אם רוצים לבנות סוכן ראשון עם ה-SDK?

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

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

תגיות: Claude Agent SDK · Claude Code · בניית סוכן AI · MCP · אוטומציה עסקית · AI Agents · מדיה דיל

← חזרה לבלוג · צור קשר