كيفية استخدام Claude Agent SDK مع خطة Claude الخاصة بك؟

تسمح لك Anthropic بتشغيل Claude Agent SDK على اشتراكك الحالي في Claude اعتبارًا من 15 يونيو 2026. سابقًا، كان بناء أي عميل باستخدام Agent SDK يتطلب مفتاح API منفصلًا وفوترة دفع حسب الاستخدام، حتى لو كنت تدفع بالفعل مقابل Claude Pro أو Max. الآن تتضمن خطة Claude الشهرية رصيدًا مخصصًا لاستخدام Agent SDK، ولا تحتاج إلى مفتاح API للتجربة.

جرّب Apidog اليوم

إذا كنت تريد بناء عميل مخصص مثل بوت نشر، مساعد بحث، أو أداة فرز مشكلات، فهذا التغيير يقلل العائق الأول: لم تعد بحاجة إلى إعداد فوترة API منفصلة فقط لتجربة SDK. تحصل خطة Pro على رصيد شهري بقيمة 20 دولارًا، وخطة Max 20x على 200 دولار، ومقاعد Team Premium على 100 دولار.

ما الذي تغير في 15 يونيو 2026؟

أصبح استخدام Claude Agent SDK يُخصم من رصيد شهري مرتبط بخطة Claude الخاصة بك. سابقًا، كان الاستخدام يُفوتر عبر Anthropic API ورصيد منفصل في لوحة التحكم.

الرصيد حسب الخطة:

الخطة	رصيد Agent SDK الشهري
Pro	$20
Max 5x	$100
Max 20x	$200
Team Standard لكل مقعد	$20
Team Premium لكل مقعد	$100
Enterprise حسب الاستخدام	$20
مقعد Enterprise Premium	$200

قواعد مهمة قبل البدء:

• مقاعد Enterprise Standard لا تحصل على رصيد. تحتاج إلى مفتاح API أو ترقية المقعد إلى Premium.
• الأرصدة لكل مستخدم وغير قابلة للتحويل. لا يمكن دمج رصيدك مع رصيد زميلك.
• الأرصدة غير المستخدمة لا تُرحّل. يتم تصفير المتبقي في نهاية دورة الفوترة.
• يجب الاشتراك مرة واحدة. لن يتم تفعيل الرصيد حتى تطالب به يدويًا مرة واحدة، ثم يتجدد شهريًا.
• مستخدمو ANTHROPIC_API_KEY لا يحصلون على هذا الرصيد تلقائيًا. إذا كنت تصادق عبر مفتاح API، فأنت تستخدم نموذج فوترة API القديم.

ما الذي يغطيه الرصيد؟

يغطي رصيد Agent SDK أحمال العمل البرمجية وغير التفاعلية، مثل:

• استدعاءات Claude Agent SDK من Python أو TypeScript.
• أمر claude -p في Claude Code، أي الوضع غير التفاعلي.
• تكامل Claude Code مع GitHub Actions.
• تطبيقات الطرف الثالث التي تصادق باستخدام Agent SDK.

ولا يغطي:

• جلسات Claude Code التفاعلية.
• محادثات Claude عبر الويب أو تطبيق الهاتف.
• جلسات Claude Cowork.

بمعنى آخر: استخدم الرصيد للمهام المؤتمتة، وليس للمحادثات اليومية. استخدام Claude Code التفاعلي يبقى ضمن حدود الخطة العادية، والتي زادتها Anthropic مؤخرًا بنسبة 50% حتى 13 يوليو.

ماذا يحدث عند نفاد الرصيد؟

يعتمد السلوك على إعداد الاستخدام الإضافي:

• الاستخدام الإضافي مفعّل: يتم فوترة ما بعد الرصيد بأسعار API القياسية.
• الاستخدام الإضافي معطّل: تتوقف الطلبات عند سقف الرصيد حتى دورة الفوترة التالية.

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

يتم دائمًا استهلاك الرصيد أولًا، ثم تبدأ فوترة الاستخدام الزائد إن كانت مفعلة.

كيفية الاشتراك في رصيد Agent SDK

الرصيد لا يعمل تلقائيًا. اتبع الخطوات التالية مرة واحدة:

1. سجّل الدخول إلى حساب Claude الذي يملك الاشتراك.
2. افتح إعدادات Claude Agent SDK من مقالة الدعم الرسمية لـ Anthropic.
3. طالب بالرصيد.
4. بعد التفعيل، سيتجدد الرصيد تلقائيًا كل شهر.

إذا كنت ضمن خطة Team أو Enterprise، يجب على كل مستخدم المطالبة برصيده بنفسه. لا يمكن للمسؤول تفعيل الرصيد نيابة عن الجميع.

إعداد Claude Agent SDK في Python

ثبّت الحزمة:

pip install claude-agent-sdk

سجّل الدخول عبر Claude Code:

claude login

هذا يخزن بيانات الاعتماد المرتبطة بخطتك محليًا. لا تضبط ANTHROPIC_API_KEY إذا كنت تريد استخدام الرصيد المرتبط بالخطة.

مثال عميل بسيط:

from claude_agent_sdk import Agent

agent = Agent(
    system_prompt="You are a code review assistant.",
)

response = agent.run(
    "Review the diff in /tmp/patch.diff and flag concerns."
)

print(response.text)

نقطة الاختبار المهمة: شغّل المثال بدون ANTHROPIC_API_KEY وتأكد أن الاستخدام يظهر ضمن رصيد Agent SDK في إعدادات حسابك.

إعداد Claude Agent SDK في TypeScript

ثبّت الحزمة:

npm install @anthropic-ai/claude-agent-sdk

سجّل الدخول:

claude login

مثال عميل بسيط:

import { Agent } from "@anthropic-ai/claude-agent-sdk";

const agent = new Agent({
  systemPrompt: "You are a code review assistant.",
});

const response = await agent.run(
  "Review the diff in /tmp/patch.diff and flag concerns."
);

console.log(response.text);

في بيئات CI أو Docker أو بيئات التطوير البعيدة، قد لا يجد SDK بيانات اعتماد Claude Code تلقائيًا. في هذه الحالة، استخدم متغيرات البيئة التي تنشرها Anthropic في وثائق Agent SDK.

إذا واجهت أخطاء إعداد قبل الوصول إلى SDK، فراجع إصلاح خطأ تكوين المؤسسة custom3p غير الصالح.

استخدام claude -p للمهام المؤتمتة

لا تحتاج دائمًا إلى كتابة كود لاستخدام رصيد Agent SDK. يمكنك استخدام:

claude -p "Your prompt here"

الخيار -p يشغّل Claude Code في وضع غير تفاعلي: يعطي نتيجة ثم يخرج. هذا مناسب لـ:

• مهام CI.
• مهام cron.
• Git hooks.
• مراجعات diff تلقائية.
• إنشاء تقارير قصيرة من المستودع.

مثال hook قبل الالتزام:

#!/usr/bin/env bash
# .git/hooks/pre-commit

DIFF=$(git diff --cached)

claude -p "Review this diff for security issues, secret leaks, and breaking changes. Return PASS or FAIL with reasoning:

$DIFF"

بعد 15 يونيو، يتم خصم هذا النوع من التشغيلات من رصيد Agent SDK، وليس من ميزانية Claude Code التفاعلية.

يمكن دمج هذا النمط مع أمر /goal للحلقات المستقلة، ومع ملفات AGENTS.md لتوفير سياق ثابت للعميل.

استخدام GitHub Actions

تكامل Claude Code مع GitHub Actions يقع أيضًا ضمن رصيد Agent SDK.

ينطبق ذلك على تشغيلات مثل:

• مراجعة Pull Requests.
• فرز issues.
• إنشاء ملاحظات إصدار.
• تشغيل مهام صيانة على المستودع.

إذا كان التكامل مثبتًا عبر حساب مستخدم طالب برصيد Agent SDK، يتم خصم التشغيلات من رصيد ذلك المستخدم.

هذا مفيد لمشاريع مثل Clawsweeper، بوت فرز GitHub المبني على Claude Code، حيث تعمل الأتمتة باستمرار وكانت سابقًا تعتمد على مفتاح API وفوترة منفصلة.

بناء عميل حقيقي باستخدام Agent SDK و Apidog

القيمة العملية لـ Agent SDK تظهر عندما لا يكتفي العميل بإنتاج نص، بل يتعامل مع واجهات API حقيقية. عندها يحتاج العميل إلى عقد API واضح بدل تخمين شكل الطلبات والاستجابات.

يمكن استخدام Apidog كطبقة عقد API في هذا التدفق:

1. عرّف عقد API في Apidog. أضف endpoints، مخططات الطلب والاستجابة، وأمثلة payload.
2. صدّر OpenAPI. استخدمه كسياق للعميل أو كمرجع لتوليد الأدوات.
3. اربط Agent SDK بنقاط النهاية الفعلية. اجعل العميل يستدعي API بناءً على المخططات المحددة.
4. تحقق من السلوك عبر Apidog CLI. اجعل كل تشغيل عميل يتحقق أن API ما زال يطابق العقد.

إذا كان عميلك ينظم أدوات عبر MCP servers، استخدم سير عمل اختبار خادم MCP مع Apidog لاختبار الأدوات التي يستدعيها العميل.

الفكرة الأوسع موضحة في دليل سير عمل API الذي يركز على التصميم أولًا: عندما يمتلك العميل عقدًا واضحًا، تقل أخطاء JSON schema ويصبح وقتك موجهًا لتحسين القيود والسلوك بدل تصحيح payloads عشوائية.

يمكنك تنزيل Apidog مجانًا إذا كنت تريد طبقة عقود API لمشاريع Agent SDK.

متى تحتاج إلى مفتاح API منفصل؟

الرصيد المرتبط بالخطة مناسب لمعظم التجارب والعمل الشخصي. لكن مفتاح API مستقل يبقى أفضل في حالات معينة:

• عملاء إنتاج يحتاجون إلى ميزانية وفوترة واضحة. رصيد الخطة محدود بقيمة شهرية ثابتة.
• وصول مشترك بين عدة مستخدمين أو فرق. مفاتيح API ليست مرتبطة بمستخدم واحد بنفس طريقة رصيد الخطة.
• مقاعد Enterprise Standard. هذه المقاعد لا تحصل على رصيد Agent SDK.

إذا كنت تبحث عن مسارات استخدام مختلفة، راجع دليل الوصول المجاني إلى Claude API.

قائمة تحقق قبل التشغيل

• [ ] تأكد أن خطتك مؤهلة: Pro أو Max 5x أو Max 20x أو Team Standard أو Team Premium أو Enterprise usage-based أو Enterprise Premium seat.
• [ ] طالب برصيد Agent SDK من إعدادات Claude.
• [ ] قرر هل تريد تفعيل الاستخدام الإضافي أم لا.
• [ ] شغّل claude login.
• [ ] ثبّت حزمة Python أو TypeScript.
• [ ] شغّل عميلًا بسيطًا بدون ANTHROPIC_API_KEY.
• [ ] راقب الرصيد بعد أول عدة تشغيلات.
• [ ] إذا كنت تستخدم CI، تأكد من إعداد بيانات الاعتماد حسب وثائق Anthropic.

الأسئلة الشائعة

هل أحتاج إلى إزالة ANTHROPIC_API_KEY القديم؟

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

هل الرصيد يُحسب بعدد الطلبات؟

لا. الرصيد مقوم بالدولار. كل استدعاء يستهلك جزءًا من الرصيد حسب تكلفة النموذج، الرموز، السياق، واستخدام الأدوات.

هل يمكنني مشاركة الرصيد مع زميل؟

لا. الرصيد لكل مستخدم وغير قابل للتحويل.

ماذا يحدث لرصيد Anthropic API القديم؟

يبقى منفصلًا. رصيد الخطة يستخدم Agent SDK والأسطح المدعومة، بينما رصيد API القديم يستمر لأحمال العمل التي تستخدم مفاتيح API.

هل Agent SDK هو Claude Code؟

لا. Claude Code هو واجهة سطر أوامر وإضافات IDE. Agent SDK مكتبة برمجية لبناء عملاء مخصصين في Python أو TypeScript. الرصيد يغطي SDK وclaude -p غير التفاعلي، بينما يبقى Claude Code التفاعلي ضمن حدود الخطة العادية.

هل تتغير فوترة GitHub Actions؟

إذا كنت تستخدم تكامل Claude Code GitHub Actions الرسمي وكان حساب المستخدم المثبت قد طالب بالرصيد، تُخصم التشغيلات من رصيد Agent SDK.

هل يعمل الرصيد خارج SDK وclaude -p وGitHub Actions؟

لا. ينطبق الرصيد على الأسطح المدعومة فقط: Python/TypeScript SDK، أمر claude -p، GitHub Actions، وتطبيقات Agent SDK التابعة لجهات خارجية. أي استخدام آخر يرجع إلى حدود خطة Claude العادية أو مفتاح API حسب طريقة المصادقة.