Your credit balance is too low to access the Anthropic API: الحل

تعني رسالة «Your credit balance is too low to access the Anthropic API» أن رصيدك المدفوع مسبقًا لا يكفي لتغطية استخدام Claude API. وفي Claude Code تظهر بصيغة «Credit balance is too low». فإن كنت تظن أنك تستخدم خطة مثل Pro أو Max ومع ذلك تراها، فالسبب المعتاد أن مفتاح API الموجود في متغير البيئة ANTHROPIC_API_KEY يتقدّم على تسجيل دخولك بالخطة، فتنتقل إلى الفوترة عبر API.

400 invalid_request_error
Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.

مثال على استجابة API. تظهر بهذا الشكل في السجلات التي ألصقها المستخدمون على GitHub الخاص بـ Claude Code (بلاغ من أبريل 2025، بلاغ من أغسطس 2026). ولا تتضمن قائمة أخطاء API لدى Anthropic هذه الجملة بنصّها.

استنادًا إلى الوثائق الرسمية لـ Claude Code ومركز مساعدة Anthropic (تاريخ التحقق: 26 أكتوبر 2026)، يشرح هذا المقال معنى الخطأ، وكيف تميّز بين أسبابه، والحلّين، والفرق بينه وبين رصيد API الشهري المضمَّن في Max وTeam وبين «رصيد الاستخدام» الخاص بخطتك. وقد ميّزنا السببين بلونين: A الرصيد وB مفتاح API.

1. معنى الخطأ وكيف يظهر

يعمل Claude API بالدفع المسبق، باستثناء المؤسسات التي لديها عقد مبيعات وتُصدَر لها فاتورة في نهاية الشهر. ووفقًا لمقال المساعدة من Anthropic، يُخصم استخدام API وPlayground وClaude Code عبر مؤسسة في Claude Console من رصيد تشتريه مسبقًا، ومتى نفد رصيدك لا يمكنك استدعاء API حتى تضيف المزيد. وهذا الخطأ يخبرك بأنك بلغت حالة «عدم الكفاية» هذه.

تشير عبارة «Plans & Billing» في آخر الرسالة إلى شاشة الفوترة في Console. وفي Console الحالية يمكنك الاطلاع على رصيدك وشراء الرصيد من صفحة Billing (platform.claude.com/settings/billing).

المصادر: Anthropic، «How do I pay for my Claude API usage?»؛ Claude Code، «Error reference: Credit balance is too low». والرسالة الأقدم مأخوذة من بلاغ على GitHub. تاريخ التحقق: 26 أكتوبر 2026.

يذكر مرجع الأخطاء الرسمي لـ Claude Code سببين: نفاد الرصيد المدفوع مسبقًا لمؤسستك في Console، أو أنك قصدت استخدام اشتراك لكن الطلبات تُرسَل بمفتاح API من Console. وهما السببان A وB أعلاه.

2. ثلاثة أسئلة لتحديد السبب

أجب عنها بالترتيب، وستعرف أيّ حلّ تتبع.

1. Q1 هل تقصد استخدام Claude Code بخطة Pro أو Max أو Team أو Enterprise؟

   نعم انتقل إلى Q2. إن كنت تعمل بخطتك فلا ينبغي أن يظهر هذا الخطأ

   لا (تستخدم مفتاح API أو تطبيقك الخاص) انتقل إلى Q3

2. Q2 هل يعرض /status مفتاح API؟

   نعمالسبب B مفتاح ANTHROPIC_API_KEY وافقتَ عليه يتقدّم على خطتك ← القسم 4

   لا افحص سطر طريقة تسجيل الدخول. إن كنت مسجّلًا بحساب Console فأنت تدفع من رصيد Console ← شغّل /login لتسجّل الدخول مجددًا بحساب خطتك (الخطوة 5 في القسم 4)

3. Q3 في صفحة Billing في Console، هل لمؤسسة المفتاح رصيد؟

   لا رصيد أو رصيد قليلالسبب A اشترِ رصيدًا ← القسم 3

   نعم تحقّق مما إذا كان المفتاح ينتمي إلى مؤسسة أخرى، وهل اشتريت الرصيد للتو، وهل كل ما لديك هو رصيد Max أو Team الشهري وتستخدمه في شيء لا يغطيه ← الأسئلة الشائعة

أساس Q2: يوجّه مرجع الأخطاء في Claude Code مستخدمي الخطط الذين يرون هذا الخطأ إلى فحص سطر مفتاح API في /status. وللتبديل حين تكون طريقة تسجيل دخولك هي Console، راجع Anthropic، «Use Claude Code with your Pro or Max plan» (إن كنت مسجّلًا عبر حساب Console بالدفع حسب الاستخدام، فبدّل إلى خطتك بالأمر /login).

ما تدفعه مقابل خطة مثل Claude Pro لا يمكن استخدامه لدفع ثمن API. فمساعدة Anthropic تقول إن الخطط وConsole منتجان منفصلان، وإن API يُفوتَر بشكل منفصل (Why is Claude API usage billed separately from my paid Claude plan?). فحتى مع وجود خطة، تحتاج إلى رصيد في Console ما دمت تعمل بمفتاح API.

3. السبب A أضف رصيدًا

هذا هو الحل لمن يستخدم مفتاح API. لا يستطيع شراء الرصيد إلا الأعضاء الذين لديهم دور Admin أو Billing في مؤسسة Console. وإن كانت المؤسسة تابعة لشركتك فاطلب ذلك من أحد المسؤولين.

1. افتح صفحة Billing سجّل الدخول إلى Console وافتح Billing. يظهر رصيد المؤسسة والمبلغ المستخدم في الصفحة نفسها. وإن كنت عضوًا في أكثر من مؤسسة فتأكد من أنك اخترت المؤسسة التي أُنشئ فيها المفتاح الذي يفشل. فالرصيد لكل مؤسسة على حدة، وكل مفاتيح API في المؤسسة نفسها تسحب من الرصيد نفسه.
2. اشترِ رصيدًا انقر «Buy credits» وأدخل مبلغًا ثم أكّد. ووفقًا لمقال المساعدة، يصبح الرصيد المشترى متاحًا فورًا.
3. فعّل إعادة الشحن التلقائية (اختياري) في قسم Credit balance، استخدم «Set up auto-reload» لإدخال الرصيد الذي تبدأ عنده إعادة الشحن (When credit balance reaches) والرصيد الذي يُعاد الشحن إليه (Bring credit balance back up to)، ثم انقر «Turn on». وإن كان رصيدك عند ذلك المبلغ أو دونه بالفعل، يصبح الزر «Turn on and purchase» ويتم الشراء في الحال.
4. أعد ما فشل في Claude Code، أرسل التعليمة نفسها مرة أخرى.

المصدر: Anthropic، «How do I pay for my Claude API usage?» (خطوات الشراء، والإتاحة الفورية، وإعداد إعادة الشحن التلقائية، وانتهاء الصلاحية بعد سنة من الشراء، وعدم الاسترداد). تاريخ التحقق: 26 أكتوبر 2026.

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

4. السبب B احذف مفتاح API واستخدم خطتك

هذا هو الحل لمن يقصد استخدام خطة Pro أو Max أو Team أو Enterprise. حين توجد عدة بيانات اعتماد، يختار Claude Code واحدة منها بترتيب ثابت، ويأتي متغير البيئة ANTHROPIC_API_KEY وapiKeyHelper في ملف الإعدادات قبل تسجيل الدخول بالخطة الذي أعددته بالأمر /login. وعند استخدام المفتاح، كما توضح مساعدة Anthropic، تُفوتَر بالدفع حسب الاستخدام على مؤسسة ذلك المفتاح، وإن لم يكن لتلك المؤسسة رصيد فإنك تتوقف بهذا الخطأ.

1. تحقّق بالأمر /status شغّل /status داخل Claude Code وانظر إلى سطر مفتاح API. وحين يوجد تسجيل دخول ومفتاح API معًا، يُعلَّم الذي لا يُستخدم منهما.
2. احذفه من الصدفة الحالية احذف المتغير من الطرفية المفتوحة لديك (الأوامر أدناه).
3. احذف مصدر المفتاح ابحث عن سطر export ANTHROPIC_API_KEY=... في ملف إعدادات الصدفة واحذفه، وكذلك متغير بيئة المستخدم في Windows، وأي إدخال في ملف تعريف PowerShell ($PROFILE). وإلا فستحمّله الطرفية التالية التي تفتحها من جديد. ووفقًا لمرجع الأخطاء الرسمي، قد تحمّل أدوات مثل direnv أو طرفية بيئة التطوير المفتاح من ملف .env في المشروع، فافحص .env في مجلد مشروعك أيضًا. أما كيف تجده في env أو apiKeyHelper داخل ملفات إعدادات Claude Code فمشروح في مقالنا عن «claude.ai connectors are disabled».
4. أعد فتح الطرفية وشغّل claude تذكر المساعدة الرسمية أن تغيير متغيرات البيئة دون إعادة فتح الطرفية خطأ شائع.
5. شغّل /login عند الحاجة، ثم /status مجددًا إن لم تكن قد سجّلت الدخول بحساب خطتك بعد، فشغّل /login. ومتى أكّد /status أن أي مفتاح API لا يُستخدم، فقد انتهيت.

# macOS / Linux: تحقّق مما إذا كان معيّنًا
env | grep ANTHROPIC
# احذفه من الصدفة الحالية
unset ANTHROPIC_API_KEY
# اعثر على ملف الإعدادات الذي يعيّنه
grep -n ANTHROPIC_API_KEY ~/.zshrc ~/.bashrc ~/.bash_profile ~/.profile 2>/dev/null

# Windows (PowerShell): تحقّق مما إذا كان معيّنًا
Get-ChildItem Env:ANTHROPIC*
# احذفه من الصدفة الحالية
Remove-Item Env:ANTHROPIC_API_KEY

# Windows (موجّه الأوامر): تحقّق مما إذا كان معيّنًا
echo %ANTHROPIC_API_KEY%
# احذفه من الصدفة الحالية
set ANTHROPIC_API_KEY=

في Windows، احذف الإعدادات الدائمة من متغيرات المستخدم ضمن «خصائص النظام» ← «خيارات متقدمة» ← «متغيرات البيئة». المصادر: Anthropic، «Manage API key environment variables in Claude Code»؛ Claude Code، «Authentication precedence» و«Error reference» (أوامر الفحص و.env موجودة في بند «Invalid API key»). تاريخ التحقق: 26 أكتوبر 2026.

إن كنت لا تريد حذف المفتاح، يمكنك سحب موافقتك بدلًا من ذلك. فعند تشغيل Claude Code تفاعليًا، يسألك مرة واحدة عمّا إذا كان سيستخدم ANTHROPIC_API_KEY عند أول مرة يجده فيها، ويتذكر إجابتك. ولتغييرها لاحقًا، بدّل خيار «Use custom API key» في /config (يظهر هذا الخيار فقط ما دام المتغير معيّنًا). لكن مع claude -p (غير التفاعلي) يُستخدم المفتاح دائمًا إن كان موجودًا. وإن كانت سكربتات أخرى تحتاج إلى المفتاح، فمرّره فقط عند تشغيل تلك الأوامر.

إن ظهر في إضافة VS Code

في إضافة Claude Code لـ VS Code تفحص الأشياء نفسها. اكتب /status في اللوحة لترى حسابك وتفاصيل أخرى (Claude Code v2.1.280 أو أحدث). ووفقًا للوثائق الرسمية، فإن VS Code الذي يُشغَّل من الطرفية بالأمر code . يرث متغيرات البيئة من تلك الصدفة. فإن كان المفتاح في ملف إعدادات طرفيتك، فقد يصل إلى الإضافة أيضًا. وبعد حذف المفتاح، أغلق VS Code وأعد فتحه قبل الفحص.

يمكنك أيضًا تعيين متغيرات البيئة في إعداد الإضافة claudeCode.environmentVariables. في الإعدادات، ضمن Extensions → Claude Code، تأكد من أن ANTHROPIC_API_KEY غير معيّن هناك.

المصدر: Claude Code، «Use Claude Code in VS Code» (وراثة متغيرات البيئة، وإعداد environmentVariables، و/status). تاريخ التحقق: 26 أكتوبر 2026.

5. ما الذي يدفع ثمن استخدامك

هناك ثلاثة أشياء تُسمّى «رصيدًا»، والخلط بينها يؤدي إلى سوء فهم هذا الخطأ: رصيد API المشترى في Console، ورصيد API الشهري المضمَّن في Max وTeam، ورصيد الاستخدام الذي يدفع ثمن الاستخدام بعد تجاوز حدود خطة Pro أو Max. وإليك ما يمكن أن يُدفع به كل نوع من الاستخدام.

المصادر: Anthropic، «Monthly API credits for Max and Team plans» (Claude Code التفاعلي ورصيد الاستخدام غير مشمولين؛ وclaude -p وAgent SDK اللذان تشغّلهما بنفسك بمفتاح API مشمولان)؛ «Manage usage credits for paid Claude plans» (رصيد الاستخدام ينطبق على Claude وClaude Code كليهما بعد حدود خطتك، وهو منفصل عن رصيد API الشهري)؛ «Manage API key environment variables in Claude Code» (إن وُجد مفتاح API، تُفوتَر بالدفع حسب الاستخدام على مؤسسة ذلك المفتاح)؛ «How do I pay for my Claude API usage?». تاريخ التحقق: 26 أكتوبر 2026.

ما يهمّ في هذا الخطأ هو العمودان الأخيران (رصيد مؤسستك في Console). ويترتب على الجدول ثلاثة أمور.

• إن رأيته وأنت تظن أنك تعمل بخطتك، فأنت في أحد صفوف مفتاح API. وزيادة خطتك أو رصيد الاستخدام (العمودان الأوّلان) لن تحلّ المشكلة مهما أضفت (السبب B).
• لا يمكن استخدام رصيد API الشهري في Max وTeam لـ Claude Code التفاعلي. فحتى لو ظل رصيد خطتك يظهر في شاشة الرصيد في Console، فلا يمكنه دفع ثمن تشغيل Claude Code التفاعلي بمفتاح API. أما كيفية المطالبة به وترتيب استخدامه فمشروحان في مقالنا عن رصيد API في Max وTeam.
• رصيد الاستخدام رصيد منفصل في إعدادات claude.ai (Settings → Usage). ولأنه منفصل عن رصيد Console، فإن شحنه لا يفيد في استخدام مفتاح API.

6. أخطاء مشابهة لكنها مختلفة

هناك أخطاء أخرى تتعلق أيضًا بالرصيد أو الحدود. ميّز بينها من بداية الرسالة.

المصادر: Claude API، «Rate limits» (خطآ حدّ الإنفاق)؛ Claude Code، «Error reference». تاريخ التحقق: 26 أكتوبر 2026.

للاطلاع على قائمة بأخطاء Claude Code الأخرى، راجع الأخطاء الشائعة في Claude Code وحلولها.

الخلاصة

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

س. هل توجد فئة مجانية في Claude API؟

ج. لا تذكر المساعدة الرسمية أي فئة مجانية. فبعد إنشاء مؤسسة في Console، تقول الإرشادات «أضف رصيدًا إلى رصيد مؤسستك لاستخدام API وPlayground» (I created a Claude Console organization - how do I start using the Claude API?). والاستثناء هو رصيد API الشهري المضمَّن في خطتَي Max وTeam؛ أما خطط Free وPro وEnterprise فغير مؤهلة.

س. لديّ Claude Pro. لماذا يظهر لي هذا الخطأ؟

ج. لأن Claude Code يعمل بمفتاح API. رسوم خطتك لا يمكنها دفع ثمن API، فإن لم يكن لمؤسسة مفتاح API رصيد، يظهر لك هذا الخطأ. تحقّق بالأمر /status مما إذا كان مفتاح API مستخدمًا، واحذفه باتباع الخطوات في القسم 4.

س. اشتريت رصيدًا، لكن الخطأ ما زال يظهر.

ج. وفقًا لمقال المساعدة، يصبح الرصيد المشترى متاحًا فورًا. تحقّق أولًا من أن المؤسسة التي أنشأت فيها المفتاح هي نفسها التي اشتريت لها الرصيد. وتسجّل صفحة الحالة لدى Anthropic حادثًا في 1 سبتمبر 2026 (بتوقيت UTC) تأخّر فيه تطبيق الرصيد المشترى للمستخدمين الذين بلغ رصيدهم صفرًا، وأعادت فيه بعض طلبات API خطأً عبارة «credit balance is too low» (Delays in credit purchases). وفي 1 أكتوبر من العام نفسه وقع حادث آخر تأخّر فيه تطبيق المشتريات (Delayed credits on the Claude Platform). فإن كانت المؤسسة مطابقة والرصيد ظاهرًا، فافحص status.claude.com بحثًا عن حادث جارٍ.

س. ما زال لديّ رصيد API الشهري في Max، لكن هذا الخطأ يظهر في Claude Code.

ج. رصيد API الشهري لا يمكن استخدامه لـ Claude Code التفاعلي في الطرفية أو بيئة التطوير أو تطبيق سطح المكتب أو على الويب (الجدول في القسم 5). لاستخدام خطتك، احذف مفتاح API واستخدم تسجيل الدخول؛ ولاستخدام مفتاح API، اشترِ رصيدًا في Console.