dotsagent.io
اللغة:العربية
إطار عمل · 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 · 8,200 نجمة
خيار الاستضافة
Claude Managed Agents
تستضيف Anthropic بيئة التشغيل؛ وتُشغّل الجلسات في sandbox تديره Anthropic أو تستضيفه بنفسك.

البدء السريع

ثبّت الحزمة، واضبط بيانات الاعتماد، ثم شغّل أبسط وكيل وفقًا للوثائق الرسمية. معرّفات النماذج هي المعتمدة في الوثائق، وقد لا تكون مفعّلة في حسابك.

Python

التثبيت
pip install claude-agent-sdk

يتطلب ANTHROPIC_API_KEY

Python
import 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-sdk

يتطلب ANTHROPIC_API_KEY

TypeScript
import { 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.

بدائل باللغة نفسها

المصادر

  1. code.claude.com/docs/en/agent-sdk/overview
  2. code.claude.com/docs/en/agent-sdk/quickstart
  3. code.claude.com/docs/en/agent-sdk/observability
  4. code.claude.com/docs/en/bedrock-vertex
  5. pypi.org/pypi/claude-agent-sdk/json
  6. registry.npmjs.org/@anthropic-ai%2fclaude-agent-sdk
  7. api.github.com/repos/anthropics/claude-agent-sdk-python
  8. api.github.com/repos/anthropics/claude-agent-sdk-typescript