בונים על ה-SDK עם תקציב וגבול
תבחרו שכבת אינטגרציה, תגדירו גישת כלים ותשאירו אימות בנתיב המורשה. הפלטים להמחשה.
מקורות Agent SDK ו-quickstart נבדקו ב-30 בספטמבר 2026: ספריות Python ו-TypeScript שמריצות את לולאת הסוכן של Claude Code בתהליך שלכם, עם כלים, hooks, subagents, MCP, הרשאות, סשנים, skills ו-plugins. ה-SDK הוא ספרייה, אז הקוד שלכם מחזיק את ה guardrails.
השכבה הנכונה למשימה
עבודה יומית אינטראקטיבית שייכת ל-CLI. פיצ׳ר מוצר שקורא לסוכן שייך ל-Agent SDK. קריאות API ישירות עם לולאת כלים משלכם שייכות ל-Client SDK. סוכנים מתמשכים בענן שייכים ל-Managed Agents. בשפה אחרת, הריצו את ה-CLI כתת-תהליך עם -p ו---output-format json.
אנחנו רוצים כלי שבודק פרקי קורס מול המקורות לפי דרישה.
השו CLI script, Agent SDK ו-Managed Agents למשימה.
צוות קטן, שפה אחת, בלי דרישת always-on.
החזר המלצה אחת עם הגורמים המכריעים.
החלטה להמחשה:
נבחר: Agent SDK (TypeScript) מאחורי script פנימי.
למה: שליטה פרוגרמטית, resume של סשנים, ריצה לפי דרישה.
לא נבחר: Managed Agents (אין צורך always-on), עטיפת CLI (צריך state מובנה).
כלים והרשאות באחריות הקוד
ה-SDK טוען .claude/ ו-~/.claude/ כמו ה-CLI אלא אם הגדרתם אחרת, אז סוכן בייצור יכול לרשת hooks, MCP וזיכרון אישיים. הגדירו קונפיגורציה מפורשת לכלי שנשלח: כלים מותרים, תיקיית עבודה ומודל, לא מה שיש במכונת המפתח.
הגדירו permission callback במכוון. אישור אוטומטי של הכל הוא החלטת מוצר על נתוני המשתמשים; callback שאף אחד לא עונה לו הוא תקיעה.
אימות בצורה מורשית
Anthropic לא מאפשרת למפתחי צד שלישי להציע התחברות claude.ai או מגבלות מנוי במוצרים שלהם, כולל סוכני SDK. השתמשו באימות API key כפי שה-quickstart מתאר. מוצר ששורף בשקט את המנוי של המפתח מחוץ לתנאים ונשבר כשהמפתח עוזב.
מיתוג ותנאים
הזכירו Claude בכנות: ניסוח בסגנון "Powered by Claude" מותר; אל תציגו את הכלי כ"Claude Code" או תחקו את המיתוג. תנאים מסחריים חלים על שימוש SDK במוצרים ללקוחות. סקירה משפטית ושמית היא חלק מהשילוח, לא מחשבה מאוחרת.
תרגול מדורג
קל: שכבה
ארבעה צרכים ל-CLI, Agent SDK, Client SDK, Managed Agents. הצלחה: גורם מכריע נקוב.
בינוני: היגיינת קונפיגורציה
מה טעינת .claude/ אוטומטית יכולה לדלוף לייצור. הצלחה: תוכנית קונפיגורציה מפורשת.
מאתגר: אימות
למה התחברות claude.ai אינה אופציה למוצר. הצלחה: נתיב API key מורשה.
תקלות
התנהגות שונה בייצור: קונפיגורציה בירושה ממכונות מפתחים.
תקיעה: permission callback לא מחזיר תשובה.
קפיצת עלות: הגבילו משימות ומודלים; עקבו שימוש לכל ריצה.
עובד רק מקומית: נתיב CLI תת-תהליך או API key חסר בפריסה.
שאלת מיתוג: שנו שם לפני שילוח, לא אחרי תלונה.