رصيد Claude Agent SDK: ما الذي يتغير في claude -p وGitHub Actions وأدوات الوكلاء الخارجية في 15 يونيو

في 15 يونيو 2026، تغيّر Anthropic اقتصاديات Claude بلا واجهة. claude -p، واستدعاءات Claude Agent SDK، وClaude Code GitHub Actions، والتطبيقات الخارجية المبنية على Agent SDK ستتوقف عن السحب من حدود اشتراك Claude المعتادة، وستبدأ بدلًا من ذلك بالسحب من رصيد شهري منفصل لـ Agent SDK (Anthropic Help Center).

قد يبدو هذا كحاشية في الفوترة. ليس كذلك. إذا كانت لديك مهام cron، أو مراجعات CI، أو سكربتات محلية، أو تكاملات وكلاء على طريقة Zed، أو CLIs مغلّفة حول claude -p، فهذه هي النقطة التي يتحول فيها معنى “مشمول في خطتي” إلى “محسوب على رصيد بالدولار.”

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

ما الذي ينتقل فعليًا إلى الرصيد الجديد

مقالة المساعدة من Anthropic صريحة بشأن الحد الفاصل. بدءًا من 15 يونيو، استخدام Agent SDK وclaude -p على خطط اشتراك Claude سيسحب من رصيد شهري جديد لـ Agent SDK، منفصل عن حدود الاستخدام التفاعلي (Anthropic Help Center). وثائق Agent SDK تكرر التحذير نفسه في أعلى صفحة النظرة العامة (Claude Docs).

ما يشمله الرصيد الجديد:

أرصدة الخطط مقوّمة بالدولار:

تقول Anthropic أيضًا إن الأرصدة لكل مستخدم، وليست مجمّعة؛ تتجدد مع دورة الفوترة؛ لا يُرحّل الرصيد غير المستخدم؛ ويجب المطالبة بالرصيد مرة واحدة، ثم يتجدد تلقائيًا (Anthropic Help Center).

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

الكسر العملي: claude -p لم يعد “مجرد استخدام CLI”

الأمر الذي سيفاجئ الناس هو claude -p.

مرجع CLI من Anthropic يصف --print / -p بأنه “طباعة الاستجابة دون الوضع التفاعلي”، مع خيارات صديقة للأتمتة مثل --output-format json و--output-format stream-json و--max-turns و--json-schema و--max-budget-usd (Claude Code CLI reference). وهذا جعله مادة لاصقة مثالية للسكربتات:

git diff --staged |
  claude -p "Review this diff for security issues. Return JSON." \
  --output-format json \
  --max-turns 3 \
  --max-budget-usd 2

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

لهذا جاء رد فعل المجتمع حادًا. في خيط حالي على r/ClaudeCode، يسأل المطورون ما إذا كان الرصيد قائمًا على التوكن/النموذج، وإلى أي مدى يصل $200 واقعيًا، وهل يلزم الاشتراك الاختياري، وكيف يُحسب التخزين المؤقت للبرومبت، وهل GitHub Actions مشمولة (Reddit). تعليق أحدهم: “أوه… لم أدرك أنه يشمل GH actions أيضًا” هو الخطر بالضبط: الناس ربطوا هذا التغيير بمكتبات SDK، لا بكل سير عمل Claude Code بلا واجهة.

الإجابة عن سؤال التوكن هي عمليًا نعم: تقول Anthropic إن الاستخدام الزائد عن الرصيد ينتقل إلى أرصدة الاستخدام بأسعار API القياسية إذا كانت أرصدة الاستخدام مفعّلة. صفحة تسعير Claude API الحالية تعرض Fable 5 بسعر $10 للإدخال / $50 للإخراج لكل مليون توكن، وOpus 4.8 بسعر $5 / $25، وSonnet 4.6 بسعر $3 / $15، وHaiku 4.5 بسعر $1 / $5 (Claude API pricing). معدل الاحتراق الدقيق يعتمد على النموذج، وعدد الجولات، واستخدام الأدوات، وقراءات التخزين المؤقت، وكتاباته، وكمية سياق المستودع التي يحمّلها الوكيل.

لا تحوّل $20 أو $200 إلى “ساعات”. هذه وحدة خاطئة. حوّل مهامك الفعلية إلى آثار توكن وتكلفة.

GitHub Actions: نفس YAML، ميزانية مختلفة

Claude Code GitHub Actions داخل النطاق مباشرة. تقول وثائق GitHub Actions من Anthropic إن الإجراء مبني فوق Claude Agent SDK ويمكنه الرد على إشارات @claude، وإنشاء PRs، وتنفيذ ميزات، وإصلاح عيوب، أو تشغيل أتمتة مخصصة (Claude Code GitHub Actions docs). وتحذر الوثائق أيضًا من أن كل تفاعل مع Claude يستهلك توكنات API، وتوصي بـ --max-turns والمهلات الزمنية وضوابط التزامن لإدارة التكلفة.

هذه النصيحة أصبحت أهم الآن.

تقرير يومي مجدول مثل هذا:

name: Daily Claude Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Summarize yesterday's commits and open issues"
          claude_args: "--model sonnet --max-turns 3"

له قصتان محتملتان للفوترة:

1. إذا كان يستخدم مفتاح Claude Platform API، تقول Anthropic إن لا شيء يتغير. يبقى ضمن فوترة API العادية حسب الاستخدام.
2. إذا كان يستخدم رصيد Agent SDK موثّقًا بالاشتراك، فهو الآن يستنزف رصيد Agent SDK الخاص بكل مستخدم أولًا، ثم أرصدة الاستخدام إذا كانت مفعّلة.

لا تزال وثائق إعداد الإجراء تؤكد على ANTHROPIC_API_KEY للاستخدام المباشر لـ API، وخيارات مزودي السحابة لـ Bedrock وVertex AI (Claude Code GitHub Actions docs). بالنسبة إلى CI إنتاجي، هذا أنظف من ربط أتمتة مستودع باشتراك إنسان واحد. تقول Anthropic الشيء نفسه في إرشادات الإدارة: الأتمتة الإنتاجية على نطاق واسع ينبغي أن تستخدم Claude Platform مع مفتاح API لفوترة متوقعة حسب الاستخدام (Anthropic Help Center).

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

أدوات الوكلاء الخارجية: سؤال نمط Zed

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

تقول مقالة المساعدة من Anthropic إن الرصيد يغطي “التطبيقات الخارجية التي توثّق باشتراك Claude لديك عبر Agent SDK” (Anthropic Help Center). كما تقول النظرة العامة لـ Agent SDK إن Anthropic عمومًا لا تسمح للمطورين الخارجيين بتقديم تسجيل دخول claude.ai أو حدود معدلاته ما لم يكن ذلك معتمدًا سابقًا، وتطلب من المطورين استخدام طرق التوثيق بمفتاح API بدلًا من ذلك (Claude Docs).

هذا يعطينا قاعدة عملية:

• إذا كانت الأداة تستخدم مفتاح Claude Platform API الخاص بك، فهذا التغيير لا يمنحها رصيدًا شهريًا مجانيًا. إنها لا تزال فوترة API.
• إذا كانت الأداة تطبيق Agent SDK معتمدًا وموثّقًا بالاشتراك، فهي تسحب من رصيد Agent SDK.
• إذا كانت الأداة تحاول العبور عبر تسجيل دخول Claude Code، أو رموز OAuth، أو PTYs مخفية، أو حدود الاشتراك بطرق لم تعتمدها Anthropic، فتعامل معها كشيء هش.

المجتمع بدأ بالفعل يبني حول هذا الغموض. منشور على r/ClaudeCode يصف “بديلًا مباشرًا لـ -p” قائمًا على hooks يبقي العمل داخل Claude Code التفاعلي ويدّعي تجنب أرصدة SDK (Reddit). ومنشور آخر على r/ClaudeAI يصف clarp، وهو CLI محلي يشغّل Claude Code التفاعلي تحت الغطاء لمحاكاة مخرجات claude -p (Reddit). الكاتب يقدمه كتوافق محلي، بينما يطرح المعلقون فورًا أسئلة حول مخاطر الحساب.

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

كيف تدقق سير عملك اليوم

افعل هذا قبل أن تنتظر فشل مهمة.

أولًا، ابحث عن claude -p واستيرادات Agent SDK:

rg 'claude\s+(-p|--print)|@anthropic-ai/claude-agent-sdk|claude_agent_sdk' .

ثم ابحث في CI:

rg 'claude-code-action|ANTHROPIC_API_KEY|claude_args|@claude' .github .gitlab .circleci

صنّف كل نتيجة:

لمستخدمي SDK، اربط تتبع التكلفة بتدفق النتائج. تقول وثائق تتبع التكلفة من Anthropic إن total_cost_usd وcostUSD تقديرات من جهة العميل، وليست بيانات فوترة رسمية، لكنها مفيدة لفهم التطوير (Claude Docs). وتقول الصفحة نفسها إن SDK يعرض استخدام التوكن لكل خطوة، والاستخدام لكل نموذج، وتوكنات قراءة التخزين المؤقت، وتوكنات إنشاء التخزين المؤقت، والإجماليات التراكمية.

استخدم ذلك لإنشاء ملف احتراق:

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

for await (const message of query({
  prompt: "Review this repo for flaky tests",
  options: { maxTurns: 3 },
})) {
  if (message.type === "result") {
    console.log({
      estimatedCostUsd: message.total_cost_usd,
      modelUsage: message.modelUsage,
    });
  }
}

لا تستخدم تقديرات التكلفة من جهة العميل لفوترة مستخدميك. Anthropic تقول صراحة إن عليك استخدام Usage and Cost API أو Claude Console للفوترة الرسمية (Claude Docs).

أضف أيضًا نقاط توقف صارمة. بالنسبة إلى claude -p، استخدم --max-turns و--max-budget-usd. بالنسبة إلى GitHub Actions، استخدم مهلات سير العمل، وضوابط التزامن في GitHub، وبرومبتات ضيقة. وبالنسبة إلى وكلاء SDK، قيّد الأدوات. مراجع للقراءة فقط لا ينبغي أن يملك Bash وEdit وWrite افتراضيًا.

أسئلة الاشتراك الاختياري والتجاوز

أهم سؤال تشغيلي غير محسوم هو الاشتراك الاختياري. تقول Anthropic إن الرصيد يتطلب اشتراكًا اختياريًا لمرة واحدة، تتم المطالبة به عبر حساب Claude مرة واحدة، ثم يتجدد تلقائيًا. بالنسبة إلى مسؤولي Team وEnterprise، كان من المقرر أن يتلقى المستخدمون المؤهلون بريدًا إلكترونيًا بالتفاصيل والتعليمات قبل 15 يونيو 2026 (Anthropic Help Center).

خيط حالي على r/Anthropic يطرح السؤال البديهي التالي: ماذا يحدث إذا لم تشترك؟ هل يواصل claude -p العمل ضد حدود الاشتراك العادية، أم يتوقف حتى تطالب بالرصيد، أم يفشل إلى أرصدة الاستخدام؟ المقالة لا تذكر هذا المسار الاحتياطي بوضوح (Reddit).

لذلك لا تصمم بناءً على تخمين لمسار احتياطي. طالب بالرصيد إذا كنت مؤهلًا. إذا كنت مسؤولًا، فأخبر المستخدمين أين يطالبون به وأي أتمتات يُسمح لها باستخدامه. إذا كنت تشغّل سير عمل مشتركًا، فانقله إلى مفتاح API.

أما التجاوز، فـ Anthropic أوضح. استخدام Agent SDK يستنزف الرصيد الشهري أولًا. بعد ذلك، ينتقل الاستخدام إلى أرصدة الاستخدام بأسعار API القياسية فقط إذا كانت أرصدة الاستخدام مفعّلة. إذا لم تكن أرصدة الاستخدام مفعّلة، تتوقف طلبات Agent SDK حتى يتجدد الرصيد (Anthropic Help Center).

هذا جيد من زاوية ضبط الإنفاق. ويعني أيضًا أن أتمتتك قد تفشل بإغلاق آمن. ابنِ لهذا. يجب أن يعرض CI رسالة “استُنفد رصيد Agent SDK” كفشل فوترة/إعداد، لا كخطأ نموذج متقلب. ينبغي للسكربتات المحلية طباعة رسالة واضحة والخروج برمز غير صفري. وينبغي للوكلاء طويلي التشغيل حفظ نقاط تقدم قبل كل جولة مكلفة.

الخلاصة للمطورين

هذا التغيير ليس موت claude -p. إنه نهاية التظاهر بأن حلقة وكيل بلا واجهة لها ملف تكلفة مماثل لإنسان جالس داخل IDE.

بالنسبة إلى المطورين الأفراد، الرصيد الجديد مفيد. مستخدم Pro يحصل على $20 شهريًا للسكربتات. ومستخدم Max 20x يحصل على $200. هذا يكفي لأتمتة مدروسة، لا لوكلاء يعملون طوال الوقت بلا حدود.

بالنسبة إلى الفرق، الإجابة مملة وصحيحة: استخدموا مفاتيح API لأتمتة الإنتاج. أبقوا أرصدة Agent SDK الخاصة بالاشتراكات شخصية. أضيفوا تسجيل التكلفة. ضعوا سقفًا للجولات. فضّلوا Haiku أو Sonnet عندما لا تحتاج المهمة إلى نموذج حدودي. وتعاملوا مع أدوات التغليف التي تلتف حول الحد الجديد كتجارب، لا كبنية تحتية.

فصل 15 يونيو يحل مشكلة حقيقية: لا ينبغي لسكربتك الليلي أن يلتهم بصمت الحصة نفسها التي تحتاجها للبرمجة التفاعلية. ويخلق مشكلة أخرى: على المطورين الآن أن يفكروا كمستخدمي API كلما شغّلوا Claude من دون إنسان داخل الحلقة.

هذه مقايضة عادلة. لكنها لا تنجح إلا إذا دققت قبل أن يبدأ العداد بالعض.

يمكن للقراء الذين يريدون تجربة Claude Fable 5 بأنفسهم استخدامه عبر OneHop: نقطة نهاية بديلة مباشرة، بسعر أقل من القائمة بنحو 30%، مع $10 مجانًا للحسابات الجديدة ودون الحاجة إلى بطاقة. راجع Claude Fable 5 on OneHop أو ابدأ مع $10 مجانًا.

قراءة إضافية: البدء مع Claude Fable 5.