دليل الأخطاء · حتى 20 نوفمبر 2026

Claude Code 401 مع عنوان API مخصص: Invalid API key وAUTH_TOKEN، بترتيب الفحص

حتى 20 نوفمبر 2026، ظهور 401 بعد توجيه Claude Code إلى عنوان API مخصص يعود إلى أحد أربعة أسباب: المفتاح والعنوان يخصان خدمتين مختلفتين، أو أن ANTHROPIC_API_KEY وANTHROPIC_AUTH_TOKEN متبادلان، أو أن قيمة قديمة ما زالت في كتلة env داخل ملف الإعدادات، أو أن العنوان يحوي /v1 إضافية. شغّل /status أولاً واقرأ سطري Anthropic base URL وAuth token، ثم أبقِ متغير اعتماد واحداً فقط مطابقاً لهما.

آخر تحديث 2026-11-20

مفتاح API مستقل لـ Claude وGPT وDeepSeek وQwen، بفوترة حسب token وتفعيل خلال دقائق.

#401 Invalid API key#ANTHROPIC_BASE_URL#AUTH_TOKEN مقابل API_KEY#قيم env قديمة في الإعدادات

أربع قيم يجب معرفتها أولاً

401

الاعتماد مرفوض، وليس الشبكة

يُعرّف مرجع أخطاء API من Anthropic الرمز 401 بأنه authentication_error: المفتاح نفسه تالف أو ملغى أو منتهي. وعندما يشير العنوان إلى بوابة، فإن النص الذي يلي 401 كتبته تلك البوابة لا Anthropic.

x-api-key

ANTHROPIC_API_KEY يُرسل في هذه الترويسة

يقول مرجع المصادقة إنه يُرسل كترويسة X-Api-Key للوصول المباشر إلى Anthropic API. وعندما يكون لديك أيضاً تسجيل دخول باشتراك، فإن مفتاح API المعتمد له أولوية عليه، ولهذا قد تفشل جلسة مسجّلة الدخول بسبب الاعتماد.

Bearer

ANTHROPIC_AUTH_TOKEN يُرسل في هذه الترويسة

تُضاف البادئة Bearer إلى قيمته وتُرسل كترويسة Authorization، وهو مخصص للبوابات أو الوسائط التي تصادق برموز bearer. النصيحة الرسمية: إن لم يخبرك أحد أيّهما تستخدم، ابدأ بهذا.

/status

اطّلع على العنوان والاعتماد الساريين

يعرض دليل البوابة سطر Anthropic base URL فقط عند تعيين عنوان بوابة. وظهور سطر Auth token أو API key يعني أن اعتماد بوابة فعّال؛ وظهور سطر Login method يعني أن تسجيل دخولك هو الفعّال.

ما هو 401 على عنوان مخصص فعلاً

نادراً ما يكون 401 على عنوان API مخصص مشكلة شبكة: فالاعتماد المرفق بالطلب غير مقبول على الطرف الآخر. توضح صفحة الأخطاء الرسمية أن Invalid API key يعني أن متغير ANTHROPIC_API_KEY أو سكربت apiKeyHelper أعاد مفتاحاً رفضه API، أو أن Claude Code حجب ذلك المفتاح قبل إرساله. أما الرسالة الأخرى، API Error: 401 Invalid authentication credentials، فهي أدق: فقد تعرّف API على صيغة الاعتماد لكنه رفض الحساب أو المؤسسة وراءه، لذا فانتهاء صلاحية الرمز ليس السبب.

وهناك حالة ثالثة: عندما يشير العنوان إلى بوابة، فإن النص بعد 401 هو خطأ البوابة نفسها ولا يمكن لـ /login تغييره، لأن البوابة تريد اعتماداً مختلفاً. الحالات الثلاث تبدأ بالطريقة نفسها: شغّل /status وانظر أي عنوان وأي اعتماد ساريان.

تغيّران مرتبطان بهذا الخطأ 401، حتى 20 نوفمبر 2026

1. مصدر إضافي للخطأ 401 على جانب البوابة: تقول صفحة الأخطاء الرسمية إنه إذا فشل كل طلب بالخطأ 401 بعد أن تحصل بوابتك على الاعتماد الذي تتوقعه، فتحقق مما إذا كانت البوابة تقبل حقول tool search؛ فقبل v2.1.304 كان tool search معطلاً خلف البوابة ما لم تفعّله بـ ENABLE_TOOL_SEARCH. 2. أصبحت أعطال apiKeyHelper تبدو مختلفة الآن: فعندما لا يعيد السكربت أي مفتاح، يصل الطلب إلى API باعتماد بديل ويُرفض بالخطأ 401، وقبل v2.1.208 كان Claude Code ينفق ميزانية إعادة المحاولة كاملة في إعادة إرسال ذلك الطلب بالاعتماد البديل ثم يبلّغ عن خطأ 401 authentication error عام بدلاً من فشل السكربت؛ أما من v2.1.208 فصاعداً، فإن السكربت الذي يخطئ أو ينتهي وقته أو لا يطبع شيئاً يظهر على شكل Your apiKeyHelper script is failing خلال ثلاث محاولات.

ثلاثة تواريخ: أي متغير في أي مكان، وطريقة ملف الإعدادات، والخطأ 401 على جانب البوابة

2026-07-05

خبرة شائعة في نقاشات استكشاف الأخطاء المجتمعية: نقطة نهاية مخصصة تأخذ ANTHROPIC_AUTH_TOKEN، والاتصال المباشر بـ api.anthropic.com يأخذ ANTHROPIC_API_KEY. وبموجب هذا التقسيم، فإن عنوان بوابة مقترن بمفتاح Anthropic، أو عنوان مباشر مقترن بمفتاح بوابة، لا يمكن أن تتطابق ترويسات طلبه، لذا لا يستطيع الطرف الآخر سوى الرد بالخطأ 401.

2026-11-11

خبرة شائعة في نقاشات استكشاف الأخطاء المجتمعية: ضع العنوان ومفتاح البوابة في كتلة env داخل ~/.claude/settings.json بدلاً من تصديرهما في الطرفية فقط. وتتكرر قاعدتان: املأ العنوان حتى المضيف دون /v1، وعندما يوجد المتغير نفسه مرتين يفوز ملف الإعدادات.

2026-11-20

عندما تملك البوابة الاعتماد الصحيح ومع ذلك يعيد كل طلب الخطأ 401، تحقق مما إذا كانت البوابة تقبل حقول tool search؛ فقبل v2.1.304 كانت هذه الميزة معطلة خلف البوابة وكان يجب تفعيلها بـ ENABLE_TOOL_SEARCH. وتشير الوثائق نفسها إلى أن سطر Anthropic base URL في /status يظهر فقط عند تعيين عنوان بوابة.

ما تؤكده الوثائق الرسمية مقابل ادعاءات المجتمع وتفاصيل غير منشورة

مؤكد من وثائق Claude Code للأخطاء والمصادقة ومتغيرات البيئة والبوابة والإعدادات، إضافة إلى مرجع أخطاء API من Anthropic

1. كلتا الرسالتين: Invalid API key · Fix external API key تعني أن ANTHROPIC_API_KEY أو سكربت apiKeyHelper أعطى مفتاحاً رفضه API، أو أن Claude Code حجبه قبل الإرسال؛ وAPI Error: 401 Invalid authentication credentials تعني أن الصيغة عُرفت لكن الحساب أو المؤسسة رُفض، لذا فانتهاء صلاحية الرمز ليس السبب. 2.

الترويسات: تُضاف البادئة Bearer إلى قيمة AUTH_TOKEN وتُرسل كـ Authorization؛ ويُرسل API_KEY كـ X-Api-Key. 3. الأولوية: AUTH_TOKEN أعلى من API_KEY، وتسجيل الدخول أدنى من كليهما؛ وفي الوضع التفاعلي يحتاج مفتاح API إلى موافقتك مرة واحدة، أما في وضع -p فيُستخدم المفتاح متى وُجد. 4. حالة البوابة: عندما يشير العنوان إلى بوابة، فالنص بعد 401 هو رسالة البوابة و/login لا يغيّرها؛ والاعتماد يوضع في AUTH_TOKEN أو API_KEY أو apiKeyHelper، أيّها تريده البوابة. 5.

ملفات الإعدادات: تنطبق كتلة env في كل مكان يعمل فيه Claude Code، و~/.claude/settings.json على مستوى المستخدم يغطي كل مشاريعك، و.claude/settings.local.json المحلي بالمشروع يغطي مشروعاً واحداً، أما .claude/settings.json الخاص بالمشروع فيُلتزم في المستودع، لذا لا اعتمادات فيه. 6. الجيران: 403 هو صلاحية غير كافية، و429 هو حد معدل أو إنفاق، و529 هو API محمّل بإفراط، ولا شيء منها مشكلة اعتماد.

ادعاءات المجتمع وما لا تقوله الوثائق الرسمية

1. إضافة /v1 إلى العنوان أكثر أمانًا: تقول نقاشات المجتمع إنه ينبغي ترك /v1 خارج نهاية العنوان، لأن /v1/messages يُضاف نيابة عنك؛ ويُكتب طلب التحقق الرسمي بالصيغة $ANTHROPIC_BASE_URL/v1/messages، ما يُظهر أن /v1 ليس جزءًا من المتغير. على QCode القيمة هي https://api.qcode.cc/api ، ووجود /v1 إضافي في النهاية يُنتج أيضًا /v1/v1/messages مكرَّرًا. 2.

تصدير export في الطرفية فعّال دائمًا: تحذّر الوثائق الرسمية من أن direnv وإضافات dotenv في الصدفة وطرفيات IDE قد تُحمّل مفتاحًا قديمًا من ملف .env في المشروع، وتذكر منشورات المجتمع أن ملف الإعدادات هو الذي يفوز عندما يضبط الاثنان المتغير نفسه، لذا اقرأ /status قبل تعديل الصدفة. 3. /login جديد يستبدل مفتاح API: لا يفعل ذلك. تقول الوثائق إن مفتاح API المعتمد له أولوية على تسجيل الدخول وإن /login لا يستبدله؛ أزل تعيينه أو بدّل المفتاح.

مساران: API_KEY مباشرة إلى Anthropic مقابل AUTH_TOKEN عبر بوابة

ANTHROPIC_API_KEY: مفتاح Console للوصول المباشر إلى Anthropic API

يُرسل كترويسة X-Api-Key ويأتي من Claude Console. في الوضع التفاعلي توافق عليه مرة واحدة ويُحفظ الاختيار؛ وفي وضع -p يُستخدم متى وُجد. وهو يتقدم على تسجيل دخول اشتراكك، ولهذا قد تستمر خطة نشطة في إعادة الخطأ 401: بدّل المفتاح في Console، أو أزل تعيينه وارجع إلى الاشتراك.

ANTHROPIC_AUTH_TOKEN: اعتماد bearer الذي تتوقعه البوابة

تُضاف البادئة Bearer إلى قيمته وتُرسل في Authorization، للبوابات التي تعتمد المصادقة برموز bearer. على QCode العنوان هو https://api.qcode.cc/api بدون /v1، وبيانات الاعتماد هي المفتاح الذي يبدأ بـ cr_؛ ونفّذ unset ANTHROPIC_API_KEY كي لا تتواجد بيانات اعتماد مزدوجة. التوصية الرسمية: عندما لا تحدد البوابة نوعها المطلوب، ابدأ بـ AUTH_TOKEN وأكّد بطلب تحقق.

ست خطوات: من نص الخطأ الحرفي إلى عميل مُعاد تشغيله ومُتحقَّق منه

1. اقرأ السطر الحرفي وصنّفه في واحد من ثلاثة: Invalid API key · Fix external API key يعني أن المفتاح رُفض أو حُجب قبل الإرسال؛ API Error: 401 Invalid authentication credentials يعني أن الصيغة سليمة وأن الحساب أو المؤسسة رُفض؛ وعندما يشير العنوان إلى بوابة، فالنص بعد 401 يخص البوابة، لذا غيّر بيانات الاعتماد التي تطلبها بدل تشغيل /login. 2.

نفّذ /status: تحقق من وجود سطر Anthropic base URL والعنوان الذي يسمّيه، ثم اقرأ سطر Auth token أو API key لمعرفة أي بيانات اعتماد سارية. 3. افتح ~/.claude/settings.json وابحث عن ANTHROPIC_BASE_URL قديم أو مفتاح قديم في كتلة env؛ وعندما يكون المتغير نفسه مضبوطًا أيضًا في ملف الإعدادات، فقد لا تسري القيمة التي تعدّلها في الطرفية.

لا تضع بيانات الاعتماد أبدًا في .claude/settings.json الخاص بالمشروع، لأنه يُودَع في المستودع. 4. أبقِ متغير بيانات اعتماد واحدًا: للبوابة اضبط ANTHROPIC_AUTH_TOKEN ونفّذ unset ANTHROPIC_API_KEY؛ وللوصول المباشر إلى Anthropic افعل العكس، أبقِ ANTHROPIC_API_KEY وامسح AUTH_TOKEN. 5. تحقق من العنوان: عنوان Claude Code في QCode هو https://api.qcode.cc/api بدون /v1، بينما يستخدم Codex العنوان https://api.qcode.cc/openai؛ لا تخلط بينهما. 6.

أعد تشغيل claude وأرسل طلبًا أدنى واحدًا باستخدام curl: POST $ANTHROPIC_BASE_URL/v1/messages مع Authorization: Bearer $ANTHROPIC_AUTH_TOKEN و anthropic-version: 2023-06-01. يعني 401 أن تبدّل إلى المتغير الآخر وتعيد المحاولة؛ ويعني جسم JSON أن العنوان وبيانات الاعتماد كلاهما صحيح.

جانب QCode: عنوان واحد، متغير واحد

QCode خدمة وصول مستقلة إلى واجهات API لا تربطها علاقة تبعية بـ Anthropic أو OpenAI أو غيرهم من المزوّدين. نماذج Claude تمر فقط عبر نقطة Anthropic Messages: اضبط ANTHROPIC_BASE_URL على https://api.qcode.cc/api بدون /v1، واضبط ANTHROPIC_AUTH_TOKEN على المفتاح الذي يبدأ بـ cr_، ونفّذ unset ANTHROPIC_API_KEY كي لا تتواجد بيانات اعتماد مزدوجة.

ضع السطرين في كتلة env في ~/.claude/settings.json، وأعد تشغيل claude، ثم تحقق من سطري Anthropic base URL و Auth token في /status. يستخدم Codex عنوانًا مختلفًا هو https://api.qcode.cc/openai، فلا تخلطه مع Claude Code. الفوترة حسب الرمز (token)؛ والأسعار الحالية لكل نموذج على /models. لست مستعدًا لخطة شهرية؟

تبدأ باقات الدفع حسب الاستخدام من $4 لحصة تُدفع مرة واحدة وتُستخدم خلال 7 أيام؛ وإذا كانت لديك خطة شخصية بالفعل، فأضف باقة التعزيز عندما تحتاج حصة أكبر.

أسئلة شائعة

لماذا صدّرت ANTHROPIC_AUTH_TOKEN في طرفيتي وما زال Claude Code يعيد 401؟

نفّذ /status أولًا واقرأ أي بيانات اعتماد يسمّيها سطر Auth token أو API key وأي عنوان يظهر في سطر Anthropic base URL؛ فهذه هي الطريقة الرسمية لمعرفة مصدر بيانات الاعتماد الساري. ثلاثة أسباب معتادة. أولًا، قيمة قديمة في ملف الإعدادات: أي شيء يُكتب في كتلة env في ~/.claude/settings.json يسري في كل مكان يعمل فيه Claude Code وليس بالضرورة أن تتجاوزه القيمة الجديدة في طرفيتك. ثانيًا، مفتاح يُحمَّل من مكان آخر: تحذّر التوثيق من أن direnv وإضافات dotenv في الصدفة وطرفيات بيئات التطوير قد تحمّل مفتاحًا لم تضبطه صراحة من ملف .env في المشروع، لذا نفّذ env | grep ANTHROPIC في الصدفة نفسها. ثالثًا، مفتاح من خدمة مختلفة عن النقطة الطرفية: نقطة طرفية مخصصة مقترنة بمفتاح Anthropic، أو عنوان مباشر مقترن بمفتاح بوابة.

ما الفرق بين ANTHROPIC_AUTH_TOKEN و ANTHROPIC_API_KEY؟

الفرق في الترويسة وحالة الاستخدام. تُضاف البادئة Bearer إلى قيمة AUTH_TOKEN وتُرسل في Authorization، للبوابات أو الوسائط التي تعتمد المصادقة برموز bearer. أما ANTHROPIC_API_KEY فيُرسل في X-Api-Key وهو مخصص لمفتاح Claude Console عند الوصول المباشر إلى Anthropic API. تضع قائمة الأولوية الرسمية AUTH_TOKEN قبل API_KEY، لذا فعند وجود كليهما يُستخدم AUTH_TOKEN: خلف بوابة أبقِه ونفّذ unset للآخر، وللوصول المباشر افعل العكس. وعندما لا تعرف أي المتغيرين تريد البوابة، توصي التوثيق بالبدء بـ AUTH_TOKEN والتأكيد بطلب تحقق.

هل يجب أن يتضمن ANTHROPIC_BASE_URL المقطع /v1؟

لا. لا تُضِف /v1 إلى نهاية العنوان؛ فـ /v1/messages يضيفه Claude Code نفسه، ويُكتب طلب التحقق الرسمي بالصيغة $ANTHROPIC_BASE_URL/v1/messages، ما يُظهر أن /v1 ليس جزءًا من القيمة. أي مقطع إضافي في النهاية يُنتج /v1/v1/messages، ولا تستطيع البوابة توجيه ذلك المسار، وغالبًا تبدو الاستجابة كأنها مشكلة في بيانات الاعتماد. على QCode القيمة هي https://api.qcode.cc/api ، حيث /api جزء من العنوان نفسه وليس /v1 مكرَّرًا. ولا تنطبق القاعدة نفسها على كل عميل: فحِزم SDK المتوافقة مع OpenAI وCodex تستخدم عناوين تحتوي على /openai أو /openai/v1.

ما الفرق بين 401 و 403؟

401 يتعلق ببيانات الاعتماد نفسها: يعرّفه مرجع API بأنه authentication_error، أي أن المفتاح مشوّه أو ملغى أو منتهي الصلاحية. و 403 هو permission_error: المفتاح صالح لكنه لا يملك إذنًا للمورد المطلوب، فتحقق من إعدادات وصول المؤسسة ومساحة العمل في Console. ثمة استثناء واحد يستحق التذكر: إذا بدأ نص 401 بعبارة CORS requests are not allowed for this Organization، فالمفتاح ليس المشكلة، لأن الطلب حمل ترويسة Origin من متصفح، وعليه أن يُرسل من الواجهة الخلفية الخاصة بك بدلًا من ذلك؛ وتغيير المفتاح لا يفعل شيئًا.

هل 429 و 529 مشكلتان في المفتاح؟

لا. لا يتعلق أي من الرقمين ببيانات الاعتماد ولن يصلحهما مفتاح جديد. 429 هو rate_limit_error: بلغت المؤسسة حدًا للسرعة، أو سقف الإنفاق الشهري لفئة استخدامها، أو حد إنفاق على مساحة عمل Claude Code؛ ومثل هذا 429 قد يستمر في الفشل حتى تعود إمكانية الوصول وقد يصل دون ترويسة retry-after. و 529 هو overloaded_error: الواجهة محمّلة مؤقتًا، وهو ما تقول التوثيق إنه قد يحدث عند ارتفاع حركة المرور لدى جميع المستخدمين. تعيد حزمة SDK الرسمية محاولة هذه الأعطال العابرة تلقائيًا، مرتين افتراضيًا، مع احترام retry-after.

ماذا أفعل عندما يفشل apiKeyHelper أو تستمر الطلبات في إعادة 401؟

شغّل السكربت وحده أولًا وتأكد من أنه يطبع مفتاحًا صالحًا إلى stdout، فهذه أول خطوة فرز رسمية. عندما لا يعيد السكربت أي مفتاح، يصل الطلب إلى API ببيانات اعتماد بديلة ويُرفض بـ 401: قبل v2.1.208 كان Claude Code ينفق ميزانية إعادة المحاولة كاملة على إعادة إرسال ذلك الطلب ببيانات الاعتماد البديلة ثم يبلّغ عن خطأ مصادقة 401 عام بدل الإبلاغ عن فشل السكربت، وابتداءً من v2.1.208 يظهر السكربت الذي يخطئ أو تنتهي مهلته أو لا يطبع شيئًا في صورة Your apiKeyHelper script is failing خلال ثلاث محاولات. وعندما يستغرق إعادة المفتاح أكثر من 10 ثوانٍ، يظهر إشعار تحذيري مع الوقت المنقضي في شريط الإدخال. إذا كان السكربت سليمًا وما زلت تتلقى 401، فتحقق في /status مما إذا كان ناتجه هو بيانات الاعتماد السارية، لأن AUTH_TOKEN و API_KEY أعلى مرتبة من apiKeyHelper، ويعني متغير متبقٍّ أن مفتاح السكربت لا يُستخدم أبدًا. لاحظ أن Claude Desktop والجلسات السحابية لا تستدعي apiKeyHelper ولا تقرأ متغيرات البيئة هذه.

المصادر

مرجع أخطاء Claude Code code.claude.com/docs/en/errors (تم التحقق في 2026-11-20)؛ المصادقة والأولوية code.claude.com/docs/en/authentication (تم التحقق في 2026-11-20)؛ متغيرات البيئة code.claude.com/docs/en/env-vars (تم التحقق في 2026-11-20)؛ اتصال بوابة LLM code.claude.com/docs/en/llm-gateway-connect (تم التحقق في 2026-11-20)؛ ملفات الإعدادات code.claude.com/docs/en/settings (تم التحقق في 2026-11-20)؛ أخطاء Anthropic API platform.claude.com/docs/en/api/errors (تم التحقق في 2026-11-20)؛ تأتي ادعاءات المجتمع من منشورات نقاش عامة ويُشار إليها على هذا النحو في المتن. تم التحقق من كل ما سبق في 2026-11-20.

طابِق بين العنوان وبيانات الاعتماد، ثم تحقق عبر /status وطلب واحد

أنشئ حسابًا للحصول على مفتاح cr_، واضبط ANTHROPIC_BASE_URL=https://api.qcode.cc/api و ANTHROPIC_AUTH_TOKEN في Claude Code، واستدعِ النماذج مفوترة حسب الرمز، مع الأسعار على /models.

قراءات ذات صلة

دليل الدفع بالعملات المشفرة

تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.

تم التحقق من توثيق Claude Code ومرجع أخطاء API لدى Anthropic في 2026-11-20 وهما المرجع المعتمد على code.claude.com و platform.claude.com. QCode.cc خدمة وصول مستقلة إلى API لا تربطها علاقة تبعية بـ Anthropic أو OpenAI ولا تحظى بتأييدهما، ولا يمكنها تغيير طريقة حكم المزوّد على حسابك أو مفتاحك. يتوافق توفر نماذج QCode وأسعارها المباشرة مع qcode.cc/models.

لست متأكدًا من أين تبدأ؟

جرّبه لمدة أسبوع

الباقة الصغيرة: $4 مقابل $30 من الحصة، مدة الصلاحية: 7 يوم

استخدمها كل يوم

Starter: $9.00 شهريًا مع $5 من الحصة كل يوم — $0.060 فقط لكل $1 من الحصة، مقارنةً بنحو $0.113 لـ الباقة المتوسطة