إطار عمل · Anthropic
نظرة عامة على Claude Agent SDK
يضع SDK من Anthropic بيئة التشغيل خلف Claude Code، مع أدوات للملفات وshell، وأذونات وخطافات ووكلاء فرعيين ومهارات، ضمن برنامج Python أو TypeScript خاص بك. وعلى خلاف بقية الخيارات في هذه القائمة، لا يعمل إلا مع نماذج Claude، ويخضع استخدامه للشروط التجارية لدى Anthropic.
الأنسب لـ: التطبيقات التي تحتاج إلى Claude لإنجاز مهام فعلية على نظام الملفات، باستخدام أذونات أدوات تتحكم فيها.
معلومات أساسية
- الجهة المسؤولة عن الصيانة
- Anthropic
- اللغات
- Python, TypeScript
- الترخيص
- Anthropic Commercial Terms
- أحدث إصدار
Python 0.2.163 / TypeScript 0.3.286· 30 سبتمبر 2026- المستودع
- anthropics/claude-agent-sdk-python
- خيار الاستضافة
- Claude Managed Agents
البدء السريع
ثبّت الحزمة، واضبط بيانات الاعتماد، ثم شغّل أبسط وكيل وفقًا للوثائق الرسمية. معرّفات النماذج هي المعتمدة في الوثائق، وقد لا تكون مفعّلة في حسابك.
Python
pip install claude-agent-sdkimport asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
async def main():
async for message in query(
prompt="Find and fix the bug in auth.py",
options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"]),
):
print(message) # Claude reads the file, finds the bug, edits it
asyncio.run(main())TypeScript
npm install @anthropic-ai/claude-agent-sdkimport { query } from "@anthropic-ai/claude-agent-sdk";
for await (const message of query({
prompt: "Find and fix the bug in auth.ts",
options: { allowedTools: ["Read", "Edit", "Bash"] }
})) {
console.log(message); // Claude reads the file, finds the bug, edits it
}الميزات
| أي نموذج | لا | Claude فقط، عبر Anthropic أو Bedrock أو Google Cloud أو Foundry |
|---|---|---|
| عميل MCP | نعم | خيار mcpServers؛ ويمكن أن تجمع الإضافات خوادم MCP |
| خادم MCP | غير مؤكّد | |
| متعدد الوكلاء | نعم | يتولى الوكلاء الفرعيون المهام الفرعية المحددة |
| عمليات تنفيذ مستدامة | غير مؤكّد | يمكن استئناف الجلسات أو تفريعها؛ لا يوجد محرك استمرارية |
| موافقة بشرية | نعم | تحدد أوضاع الأذونات الأدوات التي تتطلب موافقة |
| التتبّع | نعم | تصدير OpenTelemetry؛ والتتبّع في مرحلة تجريبية |
| التقييمات | لا |
التغييرات الأخيرة
- تغيّر الاسم من Claude Code SDK؛ ويتوفر دليل للترحيل.
- يتضمن كلا SDK الآن ملف Claude Code ثنائيًا أصليًا.
- منذ 15 June 2026، يُحتسب استخدام SDK ضمن خطط الاشتراك من رصيد شهري منفصل باسم Agent SDK.
- لا يجوز للتطبيقات التابعة لجهات خارجية إتاحة تسجيل الدخول عبر claude.ai من دون موافقة Anthropic.