الوضع بلا واجهة (Headless) وحزمة تطوير الوكلاء (Agent SDK)
Claude Code ليس تفاعليًا فقط. يمكنك تشغيله بلا واجهة (headless) (غير تفاعلي، قابل للبرمجة بالسكربتات) ويمكنك بناء وكلائك الخاصين على الإطار (harness) الأساسي نفسه عبر Agent SDK.
الوضع بلا واجهة
شغّل مطالبة واحدة بشكل غير تفاعلي والتقط المخرَج — مثالي للسكربتات، وخطافات ما قبل الـ commit، وCI:
claude -p "Review the staged diff and list any bugs as a Markdown checklist"
مرّر الإدخال، واحصل على نتيجة. اقرنه بـأذونات مضبوطة على وضع آمن وغير تفاعلي حتى لا يتعلق منتظرًا الموافقة أبدًا — وأحكم إغلاقه حتى لا يستطيع تشغيل مؤتمَت لمس الأسرار (راجع تحصين عمليات التشغيل المستقلة).
استخدام كلاسيكي: مهمة CI تجعل Claude يراجع كل طلب سحب (pull request) — راجع الدليل التطبيقي لمراجعة طلبات السحب.
حزمة تطوير الوكلاء (Agent SDK)
تتيح لك Claude Agent SDK (لـ Python و TypeScript) بناء وكلاء إنتاجيين على الحلقة نفسها التي تشغّل Claude Code — استخدام الأدوات، والوصول إلى الملفات/الصدفة، والأذونات، وإدارة السياق — لكن موصولة بتطبيقك أنت.
الجأ إليها عندما تتجاوز نداء API واحدًا أو حلقة مكتوبة يدويًا وتريد بيئة تشغيل وكيل متكاملة جاهزة. للاطلاع على طيف الخيارات — نداء واحد ← سير عمل ← وكيل مخصص ← مُدار — راجع بناء الوكلاء على الـ API.
بلا واجهة/SDK مقابل التفاعلي
| الوضع | لِـ |
|---|---|
| Claude Code التفاعلي | التطوير اليومي مع وجود إنسان في الحلقة |
بلا واجهة (claude -p) | السكربتات، وما قبل الـ commit، ومهام CI لمرة واحدة |
| Agent SDK | وكلاء إنتاجيون مدمجون في برمجياتك |