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

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

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

زر

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

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

فيما يلي الرصيد حسب الخطة، مأخوذ مباشرة من إعلان Anthropic:

الخطة	رصيد 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.
الأرصدة لكل مستخدم وغير قابلة للتحويل. لا يمكن دمج رصيد مقعدك مع رصيد زميلك في الفريق.
الأرصدة غير المستخدمة لا ترحّل. ما يتبقى في نهاية دورة الفواتير الخاصة بك يعاد تعيينه.
يتطلب الاشتراك مرة واحدة. لن يتم تفعيل الرصيد في حسابك حتى تقوم بالمطالبة به لمرة واحدة. بعد ذلك، يتجدد تلقائيًا كل شهر.
مستخدمو مفتاح API لا يتلقون الرصيد. هذا خاص بالخطة. إذا كنت تقوم بالمصادقة عبر ANTHROPIC_API_KEY، فأنت على نموذج الفوترة القديم.

ما يغطيه الرصيد وما لا يغطيه

لقد قسمت Anthropic هذا بعناية. اقرأ جيدًا؛ الخط الفاصل بين "المغطى" و "غير المغطى" هو ما يحدد ما إذا كانت فاتورتك ستتغير بالفعل.

يغطيه رصيد Agent SDK:

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

غير مغطى (هذه لا تزال تخصم من خطة Claude العادية الخاصة بك، أو تظل منفصلة):

جلسات Claude Code التفاعلية (واجهة سطر الأوامر العادية التي تستخدمها يوميًا)
المحادثات على تطبيق الويب أو تطبيق الهاتف المحمول Claude
جلسات Claude Cowork

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

هذا خيار تصميم مهم. إنه يعني أنه يمكنك تجربة عميل مخصص مبني على SDK دون استنزاف الميزانية التي تستخدمها للبرمجة اليومية عبر Claude Code.

عندما ينفد رصيدك

يغطي الرصيد مبلغًا ثابتًا بالدولار شهريًا. ما يحدث عند تجاوز هذا المبلغ يعتمد على إعداد واحد:

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

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

يتم سحب الرصيد دائمًا أولاً. لا تدفع رسوم الاستخدام الزائد حتى ينتهي رصيدك الشهري.

كيفية الاشتراك

الرصيد ليس مفعلاً افتراضيًا. الاشتراك يتم لمرة واحدة ويستمر عبر دورات الفوترة، ولكن يجب عليك القيام بذلك مرة واحدة.

سجّل الدخول إلى حساب Claude الذي يملك الاشتراك (حساب المستخدم في Pro/Max، أو حساب المقعد في Team/Enterprise).
تفضل بزيارة إعدادات خطة Claude Agent SDK (مرتبطة من مقالة الدعم الرسمية لـ Anthropic).
اطالب بالرصيد. بعد ذلك، يتجدد الرصيد تلقائيًا كل شهر.

إذا كان لديك مقاعد متعددة في خطة فريق، يجب على كل مستخدم المطالبة بشكل مستقل. لا يمكن للمسؤولين المطالبة نيابة عن أعضاء المقاعد.

إعداد SDK في Python أو TypeScript

يتوفر Agent SDK في كل من Python و TypeScript. يتم المصادقة على كلاهما بنفس الطريقة مقابل خطتك: عبر Claude Code CLI بدلاً من مفتاح API خام.

Python

التثبيت:

pip install claude-agent-sdk

صادق عن طريق تسجيل الدخول إلى Claude Code أولاً:

claude login

يخزن هذا بيانات الاعتماد المرتبطة بالخطة محليًا. يلتقطها Python SDK تلقائيًا؛ لا تقوم بتعيين 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 وفواتير API بالعداد من قبل. الآن يتم سحبها من رصيد خطتك بدلاً من ذلك.

TypeScript

التثبيت:

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

صادق عبر نفس تسجيل الدخول إلى Claude Code:

claude login

عميل أدنى في TypeScript:

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);

بالنسبة للبيئات التي لا يمكن لـ SDK فيها العثور على بيانات اعتماد Claude Code تلقائيًا (مشغلات CI، حاويات Docker، صناديق التطوير عن بُعد)، يمكنك تعيينها كمتغيرات بيئة. تنشر Anthropic أسماء المتغيرات الدقيقة في وثائق Agent SDK.

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

سير عمل `claude -p`

هناك طريقة ثانية لاستخدام رصيد Agent SDK لا تتضمن كتابة التعليمات البرمجية: أمر claude -p في Claude Code.

يضع -p برنامج Claude Code في وضع غير تفاعلي. تعطيه مطالبة، ينفذها مقابل المستودع الخاص بك، ثم يخرج. لا توجد جلسة ذهابًا وإيابًا. هذه هي الطريقة التي يمكنك بها برمجة Claude Code في مسارات CI، مهام cron، وخطافات Git.

مثال بسيط: خطاف قبل الالتزام يطلب من Claude الإبلاغ عن التغييرات الخطرة.

#!/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:\n\n$DIFF"

كل استدعاء لـ claude -p بعد 15 يونيو يتم خصمه من رصيد Agent SDK الخاص بك، وليس من ميزانية Claude Code التفاعلية الخاصة بك. مما يعني أنه يمكنك ربطه بسير العمل الآلي دون القلق بشأن استهلاك الحدود التي تحتاجها للبرمجة اليومية.

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

تكامل GitHub Actions

تكامل Claude Code GitHub Actions هو عبء العمل الثالث الذي يغطيه رصيد SDK. إذا كنت قد ربطت Claude بمراجعات طلبات السحب (PR reviews)، أو فرز المشكلات، أو إنشاء ملاحظات الإصدار، فإن عمليات تشغيل سير العمل هذه تتم الآن فوترتها مقابل رصيد Agent SDK للمستخدم الذي قام بتثبيت تطبيق GitHub.

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

بناء عملاء حقيقيين: إقران SDK مع Apidog

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

وهنا يأتي دور Apidog في سير العمل:

حدد عقد API أولاً في Apidog. حدد نقاط النهاية، ومخططات الطلب/الاستجابة، وحمولات الأمثلة. يصبح هذا هو مصدر الحقيقة.
صدّر OpenAPI ومررها إلى عميلك كسياق.
استخدم SDK لربط العميل بنقاط النهاية الحقيقية. يستدعي العميل واجهة برمجة التطبيقات الخاصة بك باستخدام المخططات التي يعرف أنها صحيحة.
تحقق باستخدام Apidog CLI. يمكن لكل تشغيل عميل التحقق من أن API لا يزال يعيد ما يعد به العقد.

بالنسبة للعملاء الذين ينظمون أدوات أخرى عبر خوادم MCP، فإن سير عمل اختبار خادم MCP مع Apidog هو الدليل المطابق. تحصل على تغطية اختبار شاملة للأدوات التي يستدعيها عميلك.

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

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

متى لا تزال ترغب في الحصول على مفتاح API منفصل

الرصيد القائم على الخطة هو الخيار الافتراضي الصحيح لمعظم المطورين. لا تزال هناك حالات يكون فيها مفتاح API مستقل منطقيًا:

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

يغطي دليل الوصول المجاني إلى Claude API مسارات استخدام Claude التي لا تتطلب خطة Pro أو مفتاح API مدفوعًا.

قائمة تحقق واضحة قبل البدء

[ ] تأكد من أن خطتك ضمن القائمة المؤهلة (Pro, Max 5x, Max 20x, Team Standard, Team Premium, Enterprise usage-based, Enterprise Premium seat)
[ ] اطالب بالاشتراك لمرة واحدة لرصيد Agent SDK
[ ] قرر ما إذا كنت تريد تمكين الاستخدام الإضافي (إيقاف للنماذج الأولية، تشغيل للإنتاج)
[ ] قم بتشغيل claude login لمصادقة SDK مقابل خطتك
[ ] قم بتثبيت حزمة Python أو TypeScript SDK
[ ] قم ببناء عميل أدنى وتأكد من أنه يعمل دون تعيين ANTHROPIC_API_KEY
[ ] تحقق من رصيد الائتمان في إعدادات حسابك بعد التشغيلات القليلة الأولى

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

هل أحتاج إلى إزالة ANTHROPIC_API_KEY القديم الخاص بي لكي يعمل رصيد الخطة؟ يستخدم SDK بيانات اعتماد Claude Code المحلية عند توفرها، مما يعني أن claude login يكفي لتبديل SDK إلى الفوترة القائمة على الخطة. إذا كان لديك ANTHROPIC_API_KEY مضبوطًا في بيئتك لأدوات أخرى، فاتركه؛ سيفضل SDK مصادقة الخطة عند وجودها.

ماذا يعتبر "طلب" واحد مقابل الرصيد؟ الرصيد مقوم بالدولار، وليس بالطلبات. يتم فوترة كل استدعاء SDK بنفس الأسعار التي تنشرها Anthropic لاستخدام API؛ يتناقص رصيدك بتكلفة كل استدعاء نموذج، بما في ذلك استخدام الأدوات ورموز السياق. لا توجد رسوم لكل طلب إضافية.

هل يمكنني مشاركة رصيدي مع زميل في الفريق؟ لا. الأرصدة مخصصة لكل مستخدم وغير قابلة للتحويل. كل مقعد في Team أو Enterprise لديه مجموعة رصيده الخاصة.

ماذا يحدث لرصيد لوحة تحكم Anthropic API القديم الخاص بي؟ يبقى كما هو. رصيد الخطة هو آلية فوترة منفصلة. إذا كان لديك رصيد مدفوع مسبقًا في لوحة تحكم API الخاصة بك، فلا يزال يعمل لأي أحمال عمل مفتاح API.

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

هل ستتغير فاتورة GitHub Actions الخاصة بي؟ إذا كان الإجراء الخاص بك يستخدم تكامل Claude Code GitHub Actions الرسمي وتم المطالبة بالرصيد في حساب المستخدم المثبت، فإن عمليات التشغيل هذه تخصم الآن من رصيد SDK بدلاً من أي فوترة لمفتاح API.

هل يعمل الرصيد خارج Agent SDK و claude -p؟ لا ينطبق ذلك على الأسطح الأربعة المغطاة (SDK في Python/TS، claude -p، GitHub Actions، تطبيقات Agent SDK لجهات خارجية). أي استخدام آخر لـ Claude يعود إلى حدود خطتك العادية أو مفتاح API الخاص بك، اعتمادًا على مصدر الطلب.

زر