قد يستهلك استخدام Claude Agent SDK من حدود الخطة، أو من أرصدة واجهة API الشهرية المضافة إلى خطتي Max وTeam في 7 أكتوبر، أو من الفوترة حسب كل توكن. يعرض هذا المقال كل الأسعار، ومبالغ الأرصدة، ووفورات الذاكرة المؤقتة، وتكلفة محسوبة لتشغيل وكيل واحد.
لا يملك Claude Agent SDK سعرًا خاصًا به. تأتي الفاتورة من النموذج الذي يقف خلفه، وابتداءً من 8 أكتوبر 2026 قد تصلك هذه الفاتورة بثلاث طرق مختلفة: عبر حدود اشتراكك، أو عبر أرصدة API الشهرية الجديدة في خطتي Max وTeam، أو عبر الفوترة العادية حسب كل توكن. إذا اخترت المسار الخاطئ، فقد تتوقف فجأة في منتصف التشغيل، أو تدفع أكثر مما كان ضروريًا. يعرض هذا المقال كل خيار مع الأرقام الواردة في صفحات الأسعار والمساعدة الرسمية من Anthropic، ثم يحسب تكلفة تشغيل وكيل واحد على ثلاثة نماذج مختلفة.
Agent SDK مكتبة بلغتي Python وTypeScript تضع حلقة الوكيل الخاصة بـ Claude Code وأدواته المدمجة وجلساته وخطافاته داخل برنامجك. تصفه وثائق Anthropic بأنه مكتبة تشغّل ملف Claude Code التنفيذي في عملية تديرها أنت. لا تدرج صفحة الأسعار أي رسوم على SDK، لذلك ما تدفعه هو استخدام النموذج: توكنات الإدخال، وتوكنات الإخراج، ونشاط الذاكرة المؤقتة.
يتوقف المكان الذي تُحتسب فيه هذه التوكنات على طريقة تسجيل دخول SDK:
| المسار | طريقة الفوترة | الأنسب لـ | احذر من |
|---|---|---|---|
| حدود الاشتراك | حصة الخطة | السكربتات الشخصية والمهام الليلية | مشاركة مجموعة واحدة مع محادثاتك |
| الأرصدة الشهرية | دولارات تنتهي صلاحيتها | النماذج الأولية والمشاريع الجانبية | لا ترحيل للرصيد في نهاية الدورة |
| الفوترة لكل توكن | دولارات تشتريها | المنتجات ذات المستخدمين الفعليين | لا سقف إلا إذا حددت واحدًا |
💡 مزودو السحابة مسار رابع. يمكن أن يعمل SDK على Amazon Bedrock أو Google Cloud أو Microsoft Foundry. تأتي فواتير هذه المنصات من مزود السحابة، ولا تنطبق عليها أرصدة Max وTeam.
تمتلئ نتائج البحث بادعاءات متضاربة لأن القواعد تغيّرت ثلاث مرات هذا العام:
claude -p و Claude Code GitHub Actions والتطبيقات الخارجية المبنية على SDK إلى رصيد شهري منفصل يُحتسب وفق أسعار API الكاملة: 20 دولارًا على Pro، و100 دولار على Max 5x، و200 دولار على Max 20x.إذا ذكرت مقالة أن مشتركي Pro يحصلون على رصيد SDK بقيمة 20 دولارًا، فهي تصف الخطة التي أُوقف تطبيقها.
تنص مقالة المساعدة الرسمية لـ SDK من Anthropic على أن الاستخدام الذي يمر عبر تسجيل دخولك إلى Claude يظل يُحتسب من حدود اشتراكك، تمامًا مثل claude -p. هذا هو المسار المناسب للأتمتة الشخصية: سكربت على حاسوبك المحمول، أو مهمة ليلية على جهازك. يكلّف الاشتراك 20 دولارًا شهريًا لخطة Pro، و100 دولار لخطة Max 5x، و200 دولار لخطة Max 20x، ولا تدفع شيئًا لكل توكن.
المشكلة في المشاركة. يستخدم SDK المجموعة نفسها التي تستخدمها كل محادثة وكل جلسة برمجة تفاعلية، لذلك قد تترك حلقة وكيل طويلة حصتك منخفضة لبقية يومك.
في 7 أكتوبر 2026، أضافت Anthropic أرصدة API شهرية إلى خطتي Max وTeam. تنطبق هذه الأرصدة على Claude API وClaude Managed Agents وClaude Agent SDK وملعب Console.
| الخطة | الرصيد الشهري |
|---|---|
| Max 5x | 100 دولار |
| Max 20x | 200 دولار |
| Team، مقعد Standard | 20 دولارًا لكل مقعد |
| Team، مقعد Premium | 100 دولار لكل مقعد |
| Free وPro وEnterprise | غير مؤهلة |
يُنفق الرصيد وفق أسعار API في القسم التالي، لذلك تعني 100 دولار قيمة 100 دولار من التوكنات. لا يشمل ذلك Claude Code التفاعلي ولا الاستخدام الإضافي داخل تطبيقات Claude، كما لا تغيّر الأرصدة حدود خطتك.
لا تُمنح الأرصدة تلقائيًا. اتبع هذه الخطوات:
هناك قواعد قليلة تحدد مدى امتداد المال:
Your credit balance is too low to access the Anthropic API.هذه أسعار القائمة لكل مليون توكن من صفحة أسعار Anthropic، وقد جرى التحقق منها في 8 أكتوبر 2026.
| النموذج | الإدخال | الإخراج | قراءة الذاكرة المؤقتة |
|---|---|---|---|
| Claude Fable 5.1 | 10 دولارات | 50 دولارًا | 0.25 دولار |
| Claude Opus 5.5 | 4 دولارات | 20 دولارًا | 0.20 دولار |
| Claude Sonnet 5.5 | 2 دولار | 10 دولارات | 0.10 دولار |
| Claude Sonnet 5 | 2 دولار | 10 دولارات | 0.20 دولار |
| Claude Haiku 5.5 (للموجهات حتى 100,000 توكن) | 0.10 دولار | 0.50 دولار | 0.01 دولار |
| Claude Haiku 4.5 | 1 دولار | 5 دولارات | 0.10 دولار |
يصبح Claude Haiku 5.5 أغلى عندما يتجاوز الموجه 100,000 توكن: 0.50 دولار للإدخال و2.50 دولار للإخراج.
💡 أُطلق Claude Sonnet 5 بسعر تمهيدي قدره 2 دولار للإدخال و10 دولارات للإخراج حتى 31 أغسطس 2026. تقول صفحة Anthropic الآن إن هذا هو السعر المعتمد، وإن الزيادة المخططة في 1 سبتمبر إلى 3 و15 دولارًا لن تحدث. أي صفحة ما زالت تذكر تلك الزيادة قديمة.
تستخدم النماذج من الإصدار 4.7 فصاعدًا محللًا لغويًا (tokenizer) أحدث ينتج نحو 30% توكنات أكثر للنص نفسه مقارنةً بجيل 4.6 وما قبله. قارن تكلفة المهمة المنجزة، لا سعر التوكن وحده.
يتولى SDK تخزين الأوامر النصية مؤقتًا من تلقاء نفسه. تكلّف كتابة الذاكرة المؤقتة لمدة 5 دقائق 1.25 مرة من سعر الإدخال الأساسي، وتكلّف كتابة لمدة 1 ساعة 2 مرة، وتكلّف قراءة الذاكرة المؤقتة 0.1 مرة. تقرأ Opus 5.5 و Sonnet 5.5 بمعدل 0.05 مرة، و Fable 5.1 بمعدل 0.025 مرة. تعيد حلقة الوكيل إرسال بادئة طويلة ومستقرة في كل خطوة، لذلك يتحول معظم توكنات الإدخال إلى قراءات رخيصة.
مع بيانات اعتماد API تبقى الذاكرة المؤقتة لمدة 5 دقائق افتراضيًا. إذا كانت عمليات التشغيل متباعدة أكثر من ذلك، فاضبط متغير البيئة ENABLE_PROMPT_CACHING_1H. يكلّف خيار مدته 1 ساعة كتابةً أكثر، ويستحق ذلك عندما تقرأ عمليات التشغيل اللاحقة البادئة نفسها.
التوكنات ليست الفاتورة كلها. تحقق من هذه البنود قبل وضع الميزانية:
inference_geo: "us" على نماذج Claude 4.6 وما بعدها.تخيّل تشغيلًا لإصلاح خطأ: يقرأ الوكيل بعض الملفات، ويعدّل الكود، ويشغّل الاختبارات، ويكرر ذلك نحو 30 خطوة. افترض 600,000 توكن إدخال عبر تلك الخطوات، موزعة على 20,000 توكن غير مخزنة، و40,000 كُتبت في الذاكرة المؤقتة لمدة 5 دقائق، و540,000 قُرئت منها، إضافةً إلى 30,000 توكن إخراج. هذه أرقام توضيحية وليست قياسًا فعليًا، لكنها تحمل شكل حلقة وكيل مخزنة مؤقتًا.
على Sonnet 5.5 يكون الحساب كالتالي:
يبلغ المجموع 0.494 دولار. شغّل الشكل نفسه على ثلاثة نماذج، وسيشتري رصيد 100 دولار كميات عمل مختلفة جدًا:
| النموذج | التكلفة لكل تشغيل | عدد التشغيلات من رصيد 100 دولار |
|---|---|---|
| Claude Haiku 5.5 | نحو 0.03 دولار | أكثر من 3,600 |
| Claude Sonnet 5.5 | نحو 0.49 دولار | نحو 200 |
| Claude Opus 5.5 | نحو 0.99 دولار | نحو 100 |
تبرز نتيجتان. أولًا، يوفّر التخزين المؤقت نحو الثلثين: كان تشغيل Sonnet 5.5 نفسه بلا ذاكرة مؤقتة سيكلّف 1.50 دولار. ثانيًا، الإخراج هو الجزء الباهظ. تمثل توكنات الإخراج البالغة 30,000 نحو 5% من الحجم و61% من التكلفة. يضاعف رصيد Max 20x كل رقم في العمود الأخير ببساطة.
ينتهي كل استدعاء query() برسالة نتيجة تحمل total_cost_usd، أي التكلفة المقدّرة لذلك الاستدعاء. يفصّل الحقل modelUsage التكلفة لكل نموذج، بما في ذلك قراءات الذاكرة المؤقتة وكتابتها. هناك ثلاثة تفاصيل تربك الناس:
total_cost_usd وmodelUsage يشملان عمل الوكلاء الفرعيين، أما usage فيستبعده، لذلك يقلل usage التقدير بمجرد تشغيل وكلاء فرعيين.output_tokens في كل خطوة عنصر نائب. اقرأ عدد توكنات الإخراج الحقيقي من رسالة النتيجة.💡
total_cost_usdتقدير يُحسب على جانب العميل من جدول أسعار مضمّن في SDK. تقول Anthropic إن الفوترة الرسمية تُؤخذ من Usage and Cost API أو من صفحة Usage في Console، ولا ينبغي أبدًا أن تفوتر عملاءك بناءً على هذا التقدير.
import { query } from "@anthropic-ai/claude-agent-sdk";
for await (const message of query({
prompt: "Fix the failing test in src/auth.ts",
options: { maxBudgetUsd: 2 },
})) {
if (message.type === "result") {
console.log(message.subtype, message.total_cost_usd);
}
}
يوقف الخيار maxBudgetUsd في TypeScript، أو max_budget_usd في Python، الاستدعاء بمجرد أن يتجاوز إنفاقه الخاص الحد. يحتسب هذا الحد ذلك الاستدعاء وحده: لا يُحتسب فيه الإنفاق المستعاد من جلسة مستأنفة، وتبدأ /clear الميزانية من جديد. تصل النتيجة بعد ذلك بالنوع الفرعي error_max_budget_usd.
لتحديد سقف لمشروع كامل، امنحه مساحة عمل خاصة في Console واضبط حد الإنفاق لتلك المساحة. تسحب كل بيانات اعتماد ومساحة عمل في منظمة مرتبطة من الرصيد الائتماني نفسه، لذلك يمنع حد مساحة العمل مهمة مزعجة واحدة من استنزاف رصيد الشهر.
أرصدة الفرق هي 20 دولارًا لكل مقعد Standard و100 دولار لكل مقعد Premium، وتُجمع في رصيد واحد بسقف 500 دولار شهريًا. يحصل فريق فيه ثلاثة مقاعد Standard ومقعدان Premium على 260 دولارًا شهريًا، وإضافة مقعد Premium ترفع رصيد الشهر التالي إلى 360 دولارًا. يحدد المبلغ عدد المقاعد في الخطة عند بداية كل دورة فوترة شهرية. كما أن ربط منظمة يرفعها إلى مستوى الاستخدام Start على الأقل، أو مستوى Build إذا تجاوز الرصيد الشهري 200 دولار.
إذا كنت تطلق منتجًا، فخطط للفوترة عبر API. لا تسمح Anthropic للمطورين الخارجيين بعرض تسجيل دخول claude.ai أو حدود معدلاته في منتجاتهم، بما في ذلك الوكلاء المبنيون على SDK، ما لم تكن Anthropic قد وافقت على ذلك مسبقًا. الأرصدة الشهرية مخصصة لبناء تطبيقاتك ووكلائك وتشغيلها، لذلك أبقِ حركة عملائك على الفوترة لكل توكن، حيث تتحكم في حدود الإنفاق لكل مساحة عمل.
Claude Managed Agents هو البديل المستضاف: تشغّل Anthropic حلقة الوكيل في بيئة سحابية معزولة تديرها. يُحتسب بالأسعار نفسها للتوكنات مضافًا إليها 0.08 دولار لكل ساعة جلسة، ولا يُحتسب إلا أثناء تشغيل الجلسة، ولا يُحتسب وقت الخمول. تكلّف جلسة مدتها ساعة واحدة على Sonnet 5.5 مع 50,000 توكن إدخال و15,000 توكن إخراج: 0.10 دولار + 0.15 دولار + 0.08 دولار، أي 0.33 دولار. مع SDK لا يوجد بند للتشغيل، لكن الجهاز الذي يعمل عليه عليك أنت دفع ثمنه. تعمل أرصدة Max وTeam على الخيارين معًا.
قبل أن تنفق الأرصدة على ضبط وكيل، اكتب موجه النظام الخاص به واختبره في نموذج دردشة أولًا. Claude Sonnet 5 متاح على PicassoIA، ومصمم لمهام البرمجة متعددة الخطوات واستخدام الأدوات، مما يجعله مكانًا مناسبًا لتجربة الأمر النصي قبل إدخاله إلى SDK.
💡 سلّم الجهد يحرّك فاتورة SDK أيضًا. كلما ارتفع الجهد زادت توكنات الإخراج، والإخراج هو الجانب المكلف في كل جدول أسعار أعلاه.
لمقارنة طريقة رد نموذج أخف أو أثقل على الموجه نفسه، توجد Claude Haiku 4.5 وClaude Opus 4.7 وClaude Fable 5 في المجموعة نفسها.
كل صورة في هذا المقال جاءت من P Image، وهو نموذج تحويل النص إلى صورة على PicassoIA يعيد صورة نهائية في أقل من ثانية. يقبل 16:9 و1:1 و9:16 وأحجامًا مخصصة، ويوفر توسيعًا للأمر النصي للأفكار القصيرة، ويقبل قيمة بذرة حتى يمكن إعادة إنتاج نتيجة أعجبتك بدقة.
جرّبه الآن. صف مشهدًا واحدًا في جملة واحدة، مثل مكتب ونافذة وضوء بعد الظهر المتأخر. شغّله، وغيّر تفصيلًا واحدًا، ثم شغّله مرة أخرى. عشر محاولات تستغرق دقائق قليلة، وبنهايتها ستشعر بكيفية تشكيل كلمات الكاميرا والضوء والملمس للصورة.
يقدم PicassoIA أيضًا 91 نموذجًا لتحويل النص إلى صورة و87 نموذجًا لتحويل النص إلى فيديو، إضافة إلى نماذج للموسيقى والكلام واللغة، وكلها في القائمة الكاملة للنماذج. اختر واحدًا، واكتب موجهك، وأنشئ شيئًا خاصًا بك اليوم.
اختر لغتك
