Claude Agent SDK، مشروحاً لمن يبني المواقع

Agent SDK هو Claude Code على هيئة مكتبة: الأدوات نفسها وحلقة الوكيل نفسها وإدارة السياق نفسها، بـPython أو TypeScript. ما الذي يفعله، وبمَ يختلف عن Claude Code والواجهة البرمجية، وكم يكلّف، وأيّ الوكلاء يستحق أن يُبنى أولاً.

نبني مواقع العملاء بـClaude Code كل يوم، والسؤال الذي نسمعه الآن من العملاء ومن مطوّرين آخرين هو السؤال التالي: هل يمكن أن يعمل الشيء نفسه دون أن يجلس أحد أمام الطرفية؟ لهذا وُجد Claude Agent SDK. ومعظم ما يتصدّر البحث عنه إمّا توثيق مرجعي وإمّا شرح مكتوب لمهندسي الذكاء الاصطناعي. أمّا هذا فلمن يدير المواقع أو يبنيها، وكل تفصيل أدناه رُوجع على توثيق Anthropic نفسه في 9 نوفمبر 2026.

ما هو Claude Agent SDK؟

Claude Agent SDK هو Claude Code على هيئة مكتبة. تصفه Anthropic بأنه الأدوات نفسها وحلقة الوكيل نفسها وإدارة السياق نفسها التي تشغّل Claude Code، قابلة للبرمجة بـPython وTypeScript. تستدعي دالة واحدة، query، مع طلب ومجموعة خيارات، فيعيد SDK الرسائل تباعاً بينما يخطّط Claude ويقرأ الملفات ويشغّل الأوامر ويعدّل الشيفرة، حتى تنتهي المهمة أو يصادف خطأ.

والفرق عن استدعاء واجهة Claude البرمجية مباشرة هو من يكتب الحلقة. مع الواجهة ترسل رسالة وتتلقّى رداً، وإن طلب الرد أداةً شغّلتها بنفسك وأعدت النتيجة. أمّا Agent SDK فيأتي بتلك الحلقة مكتوبة، مع الأدوات المدمجة التي يستعملها Claude Code: قراءة الملفات وكتابتها وتعديلها، وتشغيل أوامر الطرفية، والبحث في الملفات، والبحث في الويب.

كتابات

تريد هذا على موقعك؟

احجز مكالمة

بمَ يختلف عن Claude Code وعن واجهة Claude البرمجية؟

الخيارمن يشغّلهاستعمله حين
Claude Codeأنت، تفاعلياً، في الطرفية أو المحرّر أو تطبيق سطح المكتب أو المتصفحشخص أمام لوحة المفاتيح ينجز العمل
Agent SDKعمليتك أنت، بـPython أو TypeScriptشيفرتك تبدأ المهمة: جدول زمني أو webhook أو خط إنتاج
واجهة Claude البرمجيةعمليتك أنت، وتكتب حلقة الأدوات بنفسكتحتاج تحكّماً كاملاً أو لا تحتاج وكيلاً أصلاً
Managed Agentsبنية Anthropic، تُضبط عبر الواجهة البرمجيةتريد أن تُستضاف الحلقة عنك
من مقارنة Anthropic في نظرة Agent SDK العامة، قُرئت في 9 نوفمبر 2026.

والسطر المهم لنشاط مواقع هو الثاني. Claude Code لحين يقود شخص. وAgent SDK لحين يبدأ العمل شيء آخر: جدول ليلي، أو إرسال نموذج، أو عنصر جديد في نظام إدارة المحتوى، أو طلب دمج.

كيف تثبّت Claude Agent SDK؟

الحزمتان هما @anthropic-ai/claude-agent-sdk على npm وclaude-agent-sdk على PyPI، وتحتاجان Node.js 18.14 أو أحدث، أو Python 3.10 أو أحدث. وكلتاهما تضمّ ملف Claude Code التنفيذي، فلا يحتاج معظم التثبيتات شيئاً آخر. اضبط ANTHROPIC_API_KEY في بيئة العملية التي تشغّل الوكيل. ولا يقرأ SDK ملفات .env من تلقاء نفسه، وهذا أول ما يوقع الناس: مفتاح يعمل في طرفيتك ويفشل في مهمة مجدولة يكون عادةً في ملف لم تحمّله المهمة قط. ويشرح دليل البدء السريع أول وكيل يجد الأخطاء في ملف ويصلحها.

وفي الشيفرة، النواة صغيرة. تستورد query، وتمرّر طلباً، وتضبط الخيارين الأهم من سواهما: allowedTools، أي الأدوات التي يستعملها الوكيل دون استئذان، وpermissionMode، أي القدر الذي يفعله دون رقابة. وكل ما عدا ذلك، من موجّه نظام مخصّص إلى خوادم MCP، يتعلّق بكائن الخيارات نفسه.

كم يكلّف Claude Agent SDK؟

المكتبة مجانية، أمّا استعمال النموذج فلا. يتحقّق SDK من الهوية بمفتاح API من Claude Console، أو عبر Amazon Bedrock أو Google Cloud أو Microsoft Foundry أو Claude Platform on AWS، وكلها تحاسب بالرمز. وبحسب أسعار الواجهة الحالية لدى Anthropic، فإن Claude Sonnet 5.5 بدولارين لكل مليون رمز إدخال و10 دولارات لكل مليون رمز إخراج، وClaude Opus 5.5 بـ4 و20، وClaude Haiku 5.5 بـ0.10 و0.50 للطلبات حتى 100,000 رمز. ومراجعة للقراءة فقط لموقع صغير رخيصة بهذه الأسعار، أمّا وكيل يعيد قراءة قاعدة شيفرة كبيرة كل ساعة فليس كذلك.

وما لا يمكنك فعله هو شحن وكيل يسجّل الدخول باشتراك Claude. يقول توثيق Anthropic إنه، ما لم توجد موافقة مسبقة، لا يجوز للمطوّرين من أطراف ثالثة أن يتيحوا تسجيل الدخول عبر claude.ai أو حدوده في منتجاتهم، بما فيها الوكلاء المبنيّون على SDK. خطة Pro أو Max تغطّي استعمالك أنت لـClaude Code، أمّا الوكيل الذي يعمل لعميل أو داخل منتج فيعمل بمفتاح API. ويخضع استعمال SDK لـشروط الخدمة التجارية لدى Anthropic.

ما الذي تغيّر حين أُعيدت تسمية Claude Code SDK؟

إن بنيت على Claude Code SDK القديم، فثلاثة أشياء تتغيّر. أُعيدت تسمية الحزمتين من @anthropic-ai/claude-code وclaude-code-sdk. وصار صنف الخيارات في Python ClaudeCodeOptions اسمه ClaudeAgentOptions. ومنذ الإصدار 0.1.0 لم يعد SDK يستعمل موجّه نظام Claude Code افتراضياً، بل يبدأ بموجّه مختصر، وتطلب سلوك Claude Code صراحة بالإعداد المسبق claude_code. ويعرض دليل الانتقال الشيفرة قبل التغيير وبعده للّغتين.

وإعداد افتراضي آخر يستحق الانتباه لأنه يفاجئ في الاتجاه المعاكس. ما لم تمرّر settingSources: []، يحمّل SDK إعدادات نظام الملفات نفسها التي تحمّلها واجهة الأوامر: إعدادات المستخدم، ومجلد .claude في المشروع، وملفات CLAUDE.md فيه. على حاسوبك هذا مريح. أمّا على خادم يشغّل وكلاء لعدة عملاء، فيعني أن تعليمات مشروع قد تتسرّب إلى تشغيل مشروع آخر، فاعزل كلاً منها.

ماذا يبني نشاط مواقع به أولاً؟

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

  • مراجعة أسبوعية للموقع تقرأ صفحاتك، وتنبّه إلى العناوين الناقصة والروابط الداخلية المعطّلة والصور الضخمة والصفحات التي سقطت من خريطة الموقع، ثم تكتب تقريراً.
  • فحص للنماذج والتكاملات يرسل طلباً تجريبياً عبر كل نموذج ويتأكّد من وصوله إلى نظام إدارة العملاء، لأن النموذج قد يفشل بصمت أسابيع.
  • وكيل ملخّصات محتوى يقرأ صادرات Search Console ويصوغ ملخّصات للأسئلة التي اقتربت من التصدّر فيها.
  • مراجِع لطلبات الدمج يفحص التغيير على الموقع في ضوء CLAUDE.md الخاص بالمشروع قبل أن ينظر فيه شخص.

ولا يحتاج كلٌّ منها إلا Read وGlob وGrep وجلب صفحات الويب، ولا يحتاج أيٌّ منها صلاحية التعديل. وهذا مقصود. فوكيل بلا رقابة يملك صلاحية الكتابة على موقع حيّ خطرٌ مختلف عن وكيل على مكتبك، ونظام الصلاحيات هو حيث تقرّر أيّ الأدوات تعمل دون موافقة.

هل تعمل الخطافات والمهارات والوكلاء الفرعيون في SDK؟

نعم، وهذا هو السبب الرئيسي لاستعماله بدل كتابة حلقتك. فـSDK يدعم الخطافات والوكلاء الفرعيين وخوادم MCP والجلسات والمهارات والإضافات نفسها التي في Claude Code. ويستطيع فريق يستعمل Claude Code أن ينقل إعداده كما هو: الخطافات التي تمنع الأوامر الخطرة، والوكلاء الفرعيون الذين يقسّمون البناء، وخوادم MCP التي تصل نظام إدارة المحتوى، وملف CLAUDE.md الذي يضع قواعد المشروع، كلها تُحمَّل بالطريقة نفسها.

أين يعمل وكيل مبني على Agent SDK؟

حيثما تعمل شيفرتك: مهمة مجدولة، أو حاوية، أو خط تكامل مستمر، أو خادم صغير. ويغطّي دليل الاستضافة لدى Anthropic إعدادات Docker والسحابة والتكامل المستمر. وإن فضّلت ألا تشغّل العملية أصلاً، فـManaged Agents هو البديل المستضاف لدى Anthropic، ويُضبط عبر الواجهة البرمجية. ولمعظم فرق المواقع الصغيرة تكفي مهمة مجدولة في نظام التكامل المستمر الذي تستعمله أصلاً، وتعمل بجوار الشيفرة التي تفحصها.

ماذا تسمّي وكيلاً مبنياً عليه؟

ليس Claude Code. فإرشادات العلامة التجارية لدى Anthropic لـSDK تسمح بـClaude Agent، أو باسم وكيلك متبوعاً بـPowered by Claude، وتمنع Claude Code وClaude Code Agent وكل ما يقلّد مظهر Claude Code. واستعمال علامة Claude اختياري أصلاً، وينبغي أن يبدو المنتج منتجك لا منتجاً من Anthropic.

متى يكون Agent SDK الأداة الخطأ؟

حين سيراجع شخص كل خطوة على أي حال. إن كان العمل بناء موقع أو تغييره وأحدٌ يراقب، فـClaude Code نفسه هو الواجهة الأفضل، والفروق والموافقات والسجلّ أمامك. ويستحق SDK مكانه حين يجب أن يتم العمل دون أن يفتح أحد طرفية، وحين تتكرّر المهمة نفسها بما يكفي لأن تُكتب مرة واحدة فتردّ كلفتها. وإن لم تكن متأكداً أيّ مهامك المتكرّرة يصلح لذلك، فهذا هو الحديث الذي يبدأ به عملنا في الأتمتة بالذكاء الاصطناعي.

لنبنِ الموقع الذي يستحقه عملك.

أرسل ما لديك الآن وإلى أين تريد الوصول. ستحصل على إجابة صريحة حول النطاق والجدول الزمني والتكلفة، عادة خلال ساعة.

نعمل عبر أمريكا الشمالية وأوروبا والشرق الأوسط.