توجيه Claude Code إلى
نقطة نهاية API مخصصة
اعتبارًا من 2026-10-07، ووفقًا لوثائق البوابة الخاصة بـ Anthropic، يكفي متغيران: ANTHROPIC_BASE_URL لنقطة النهاية، وANTHROPIC_AUTH_TOKEN الذي يُرسَل كترويسة Authorization: Bearer (استخدم ANTHROPIC_API_KEY إذا كانت بوابتك تقرأ x-api-key)؛ ويمكن أن يوجد كلا المتغيرين أيضًا في كتلة env داخل settings.json. بدءًا من Claude Code 2.1.285، تعمل النماذج ذات نافذة 1M (Opus 4.7+، Sonnet 5+، Fable) عند 1M خلف ANTHROPIC_BASE_URL مخصص، والنصيحة الرسمية هي تشغيل /autocompact 200k إذا كانت بوابتك تتوقف عند 200K. جلسات السحابة ليست جزءًا من نشر البوابة، لذا لا تُطبَّق متغيرات البوابة المعينة هناك.
آخر تحديث 2026-11-14
وجّه هذه الأداة إلى نقطة نهاية QCode — مفتاح واحد لـ Claude وGPT والنماذج الصينية.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
أربعة أمور يجب معرفتها
الحد الأدنى من الإعداد
يشير ANTHROPIC_BASE_URL إلى نقطة النهاية، ويوفّر ANTHROPIC_AUTH_TOKEN بيانات الاعتماد. في معظم الحالات، هذا كل ما تحتاجه.
أين تستقر بيانات الاعتماد
وفقًا للوثائق اعتبارًا من 2026-10-07: يوضع ANTHROPIC_AUTH_TOKEN في Authorization: Bearer، وANTHROPIC_API_KEY في x-api-key، وapiKeyHelper في كليهما؛ بيانات الاعتماد الموجودة في المتغير الخاطئ تصل إلى ترويسة لا تقرأها البوابة وتفشل بالرمز 401.
المكان الثاني للإعداد
إذا كنت تفضّل عدم استخدام متغيرات البيئة، فضع المفاتيح نفسها في كتلة env داخل settings.json — فالبنية تتطابق واحدًا بواحد.
جلسات الويب والسحابة
وفقًا للوثائق اعتبارًا من 2026-10-07: جلسات السحابة ليست جزءًا من نشر البوابة، ولا تُطبَّق متغيرات البوابة المعينة في إعداد بيئة جلسة سحابية؛ إذا كان يجب أن تبقى حركة المرور على البوابة، فلا تفعّل هذه الواجهات لهؤلاء المستخدمين.
لماذا يكفي هذان المتغيران
اعتبارًا من 2026-10-07، الإجابة لا تزال متغيرين. حركة الخروج في Claude Code قابلة للإعداد: يحدد ANTHROPIC_BASE_URL إلى أين تتجه الطلبات، ويحدد ANTHROPIC_AUTH_TOKEN بيانات الاعتماد التي تنتقل معها. وتوضح الوثائق الثاني بوضوح — فذلك المتغير البيئي هو الخطوة التي تضع المفتاح في ترويسة Authorization، والترويسة هي بالضبط ما تقرأه البوابة. لذا ما دامت نقطة النهاية لديك تتحدث بروتوكول Anthropic وتصادق عبر ترويسة Authorization، فإن التكامل يعمل دون أي تغييرات في شيفرة العميل.
الصيغ الموثّقة وتغيير 2.1.285 (تم التحقق في 2026-10-07)
الشكل الأول هو متغيرات البيئة: عيّن ANTHROPIC_BASE_URL على نقطة النهاية لديك وANTHROPIC_AUTH_TOKEN على بيانات الاعتماد. الشكل الثاني هو كتلة env في settings.json، باستخدام أسماء المفاتيح نفسها. تصف الوثائق أيضًا apiKeyHelper: أمر تشغّله Claude Code لجلب بيانات اعتماد البوابة بدلًا من قراءتها من متغير بيئة ثابت، وهو ما يناسب بيانات الاعتماد التي تحتاج إلى تدوير. وهناك قسمان إضافيان — إضافة نماذج البوابة إلى منتقي النماذج، وإيقاف حركة المرور خارج مسار البوابة — يستحقان القراءة في نشر على مستوى المؤسسات. أُضيف في 2026-10-07: يقول مدخل سجل التغييرات الخاص بـ Claude Code 2.1.285 (الصادر في 2026-09-29): «غُيّرت الجلسات خلف ANTHROPIC_BASE_URL مخصص لتستخدم نافذة السياق 1M لدى النماذج التي تمتلكها (Opus 4.7+، Sonnet 5+، Fable)؛ شغّل /autocompact 200k إذا توقفت بوابتك عند 200K». وتضيف صفحة إعداد النماذج أن Claude Code لا تستطيع اكتشاف حدًا أقل تفرضه البوابة أو الخادم الذي خلفها.
ثلاث خطوات للاتصال
عيّن المتغيرين: ANTHROPIC_BASE_URL إلى نقطة النهاية وANTHROPIC_AUTH_TOKEN إلى بيانات الاعتماد. جرّبه أولًا في طرفية نظيفة بدلًا من الكتابة مباشرة في إعداداتك العامة.
أرسل طلبًا بسيطًا واحدًا للتأكد من أنه يعمل، وتحقق من أن النموذج الذي يعيده الرد هو النموذج الذي طلبته — فهذا يخبرك أيضًا ما إذا كانت هناك طبقة إعادة كتابة في ما بينهما.
بعد أن يصبح مستقرًا، اجعله دائمًا: انقله إلى كتلة env في settings.json، أو احقنه في CI من مخزن الأسرار لديك (شكل CI الموثق يمرر بيانات الاعتماد من الأسرار إلى ANTHROPIC_AUTH_TOKEN). إذا كانت بيانات الاعتماد تحتاج إلى تدوير، فانتقل إلى apiKeyHelper.
موثّق من Anthropic مقابل ما تسأل مزوّد نقطة النهاية عنه
موثّق من Anthropic
① ما الذي يفعله كل من ANTHROPIC_BASE_URL وANTHROPIC_AUTH_TOKEN. ② أن بيانات الاعتماد تنتقل في ترويسة Authorization. ③ أن كتلة env في settings.json شكل ثانٍ مكافئ. ④ أن apiKeyHelper يجلب بيانات الاعتماد عبر أمر بدلًا من متغير ثابت. ⑤ أن جلسات السحابة (نسخة الويب) وClaude Code في Slack ليستا جزءًا من نشر بوابة، وأن متغيرات البوابة المعيّنة في بيئة جلسة سحابية لا تُطبّق. ⑥ بدءًا من Claude Code 2.1.285، تعمل النماذج ذات نافذة 1M (Opus 4.7+، Sonnet 5+، Fable) عند 1M خلف ANTHROPIC_BASE_URL مخصص، مع التوصية بتشغيل /autocompact 200k عندما تتوقف البوابة عند 200K (وفق صياغة سجل التغييرات، تم التحقق في 2026-10-07).
اسأل مزوّد نقطة النهاية لديك
ما إذا كان ينبغي أن يحمل Base URL لاحقة مسار، وأي معرفات النماذج تُخدم، وما إذا كان سياق 1M والتخزين المؤقت مدعومين، وما سقف الطلبات المتزامنة — كل ذلك يعتمد على نقطة النهاية التي تتصل بها، ولن تجيب عنه وثائق Anthropic نيابة عنهم. عند ظهور 404، فإن جزء المسار في Base URL لديك هو أول ما يجب التحقق منه مقابل وثائقهم؛ وعند ظهور 401، تأكد من أن بيانات الاعتماد تنتقل في ترويسة Authorization وليست في مكان آخر. اسأل عن حد السياق على وجه الخصوص: منذ 2.1.285 تضع Claude Code في حسبانها 1M خلف نقطة نهاية مخصصة، لكنها لا تستطيع اكتشاف حد بوابة أقل؛ وإذا توقفت البوابة عند 200K، فشغّل /autocompact 200k كما تقول النصيحة الرسمية.
موضعان للتكوين
متغيرات البيئة
الأسرع في التغيير والأنسب لأول محاولة ناجحة. العيب أنه يسهل فقدانه — تكفي طرفية جديدة أو مشغّل CI مختلف ليختفي — وبيانات الاعتماد موجودة في بيئة العملية. جيد للتحقق والمهام لمرة واحدة.
كتلة env في settings.json
ينتقل مع التكوين بدلًا من الاعتماد على shell الحالي لديك، لذا يناسب جعل الأمور دائمة. لا تزال بيانات الاعتماد تُكتب على القرص دون تشفير، لذا إذا كانت تحتاج إلى تدوير أو لا ينبغي أن تكون على القرص، فاستخدم apiKeyHelper بدلًا من ذلك: أمر تستدعيه Claude Code لجلب بيانات الاعتماد عندما تحتاج إليها.
العقبات الثلاث المعتادة
① عُيّن لكنه لا يسري: تحقق من أن المتغير مرئي للعملية التي تشغّلها فعليًا، وأن مفتاحًا بالاسم نفسه في settings.json لا يحجبه — فعند وجود كليهما، فالترتيب الفعلي للتحميل هو ما يحدد. ② لا يسري في جلسات الويب أو السحابة: هذا سلوك موثّق؛ تقول وثائق البوابة الحالية إن الجلسات السحابية ليست جزءًا من نشر البوابة، لذا لا تُطبّق متغيرات البوابة المعيّنة هناك. ③ ميزات هوية الحساب تتصرف بغرابة: تشير الوثائق إلى أن جلسة مصادَق عليها باستخدام ANTHROPIC_AUTH_TOKEN قد تحصل على نتيجة فحص توفر تتعارض مع إعداد المؤسسة، لأن ذلك الفحص يتطلب تسجيل الدخول إلى claude.ai أو مفتاح API من Anthropic.
على QCode
حتى 2026-10-07، تقول وثائق QCode إن توصيل Claude Code يتطلب بالضبط المتغيرين أعلاه: ANTHROPIC_BASE_URL معيّنًا إلى https://api.qcode.cc/api (دون شرطة مائلة لاحقة) وANTHROPIC_AUTH_TOKEN معيّنًا إلى مفتاحك الذي يبدأ بـ cr_؛ والأداة التي تقرأ ANTHROPIC_API_KEY فقط تعمل بالمفتاح نفسه الذي يبدأ بـ cr_. نماذج Claude تعمل فقط على نقطة النهاية التي تستخدم بروتوكول Anthropic. لا تقدم هذه الصفحة أي وعد بحد السياق لأي نموذج على QCode؛ إذا واجهت خطأ في حد السياق، فاتبع نصيحة Claude Code الرسمية واخفض الحد باستخدام /autocompact. بمجرد الاتصال، افعل أمرين فورًا: أرسل طلبًا بسيطًا واحدًا وتحقق من أن النموذج المعاد في الاستجابة يطابق النموذج الذي طلبته، وطابق الاستخدام مع المبالغ المحتسبة عليك مرة واحدة. الفوترة تتم لكل token؛ راجع /models لمعرفة سعر كل نموذج.
ما الذي يتغير عندما تشير ANTHROPIC_BASE_URL إلى بوابة
كلا التحذيرين واردان في مدخل ANTHROPIC_BASE_URL الرسمي بشرط واحد: أن تشير القيمة إلى مضيف غير تابع للطرف الأول. QCode مضيف كذلك، لذا ينطبق التحذيران على هذا المسار أيضًا.
البحث عن أدوات MCP معطّل افتراضيًا
المدخل الرسمي صريح: عندما يشير المتغير إلى مضيف غير تابع للطرف الأول، يكون البحث عن أدوات MCP معطّلًا افتراضيًا؛ إذا كان الوسيط لديك يمرر كتل tool_reference، فعيّن ENABLE_TOOL_SEARCH=true وتحقق منه مرة واحدة. وحيث لا يمرر الوسيط هذه الكتل، فإن إبقاءه معطّلًا لا يكلفك سوى اختصار الاسترجاع ذلك — استدعاءات الأدوات والرسائل العادية لا تتأثر. تم التحقق في 2026-10-07.
Remote Control معطّل
الوثيقة نفسها: اعتبارًا من v2.1.196، يتوقف Remote Control عن العمل عندما يشير المتغير إلى مضيف غير api.anthropic.com، بما يطابق سلوكه على Amazon Bedrock وGoogle Cloud Agent Platform وMicrosoft Foundry. إذا كنت تشغّل جلسات Remote Control من هاتف، فتعامل مع هذا على أنه حد معروف بدلًا من شيء يستدعي التصحيح. تم التحقق في 2026-10-07.
أي ترويسة تحمل بيانات الاعتماد
التقسيم الرسمي: إذا قال فريق البوابة لديك bearer token أو ترويسة Authorization، فعيّن ANTHROPIC_AUTH_TOKEN؛ وإذا قالوا مفتاح API أو x-api-key، فعيّن ANTHROPIC_API_KEY؛ وعندما لا يحدد أحد أيهما، توجّهك الوثائق ابتداءً إلى ANTHROPIC_AUTH_TOKEN، وتستخدم أنت طلبًا بالحد الأدنى لمعرفة ما إذا كان ينبغي التبديل. يقبل QCode أيًا منهما — السؤال الوحيد هو أي متغير تكتب. تم التحقق في 2026-10-07.
تأتي هذه الملاحظات الثلاث من مدخل ANTHROPIC_BASE_URL وصفحة اتصال بوابة LLM في وثائق Anthropic، وتم التحقق منها في 2026-10-07؛ يتتبع كلا السلوكين إصدار Claude Code الذي تشغله، لذا تبقى الوثائق الحية هي المرجع.
الأسئلة الشائعة
ما الحد الأدنى لمجموعة المتغيرات؟
متغيران: ANTHROPIC_BASE_URL لنقطة النهاية وANTHROPIC_AUTH_TOKEN لبيانات الاعتماد. تنص الوثائق على أن الأخير هو المتغير الذي يضع المفتاح في ترويسة Authorization.
هل يجب أن يتضمن Base URL لاحقة مسار؟
يعتمد ذلك على نقطة النهاية التي تتصل بها؛ ولا تجيب وثائق Anthropic عن ذلك نيابة عنهم. أسرع طريقة لحسم الأمر هي اتباع وثائق المزوّد وإرسال طلب بسيط واحد — إذا تلقيت 404، فالجزء الخاص بالمسار هو أول ما يجب فحصه. بالنسبة إلى QCode، القيمة الموثّقة هي https://api.qcode.cc/api، دون شرطة مائلة لاحقة.
هل يمكنني تجنب متغيرات البيئة كليًا؟
نعم — ضع المفاتيح نفسها في كتلة env من settings.json. إذا كانت بيانات الاعتماد تحتاج إلى تدوير، أو كنت تفضّل ألا تبقى على القرص مكشوفة، فاستخدم apiKeyHelper بدلًا من ذلك: وهو أمر يشغّله Claude Code لجلب بيانات الاعتماد.
لماذا لا يسري ذلك على نسخة الويب؟
هذا سلوك موثّق. حتى 2026-10-07، تقول وثائق البوابة الرسمية إن Claude Code في Slack والجلسات السحابية (نسخة الويب) ليست جزءًا من نشر بوابة، وإن متغيرات البوابة المعيّنة في إعداد بيئة الجلسة السحابية لا تُطبّق؛ إذا كان يجب أن تبقى حركة المرور على بوابتك، فلا تفعّل هذه الواجهات لهؤلاء المستخدمين. كما قالت النسخة الملتقطة في 2026-09-22 إن كليهما يستخدم دائمًا API الخاص بـ Anthropic؛ ولم تعد الوثائق الحالية تتضمن ذلك النصف من الجملة.
كيف أضبطه في CI؟
الشكل الموثّق يمرّر بيانات الاعتماد من مخزن الأسرار لديك إلى ANTHROPIC_AUTH_TOKEN، مع تعيين Base URL كالمعتاد. لا تضع بيانات الاعتماد في ملف إعدادات داخل المستودع — فهذا لا يختلف عن كتابتها مباشرة في الشيفرة.
ما أول شيء يجب التحقق منه بمجرد أن يتصل؟
أن النموذج المعاد في الاستجابة هو النموذج الذي طلبته. إذا كان يحمل بادئة أو لاحقة أو اسم مزوّد لم يكن في طلبك، فهناك طبقة إعادة كتابة في ما بينهما. ليس سيئًا بالضرورة، لكنه يحدد كيفية إسناد ما تراه لاحقًا في الفاتورة.
المصادر
ما يفعله المتغيران البيئيان، وأي ترويسة تستخدمها كل بيانات اعتماد، وصيغة كتلة env في settings.json، وتعريف apiKeyHelper، وأن الجلسات السحابية لا تمر عبر بوابة: وثائق Anthropic «Connect Claude Code to an LLM gateway» (code.claude.com/docs/en/llm-gateway-connect، جُلبت لأول مرة في 2026-09-02، وأُعيد التحقق منها في 2026-10-07). مدخل ANTHROPIC_BASE_URL: صفحة متغيرات بيئة Claude Code (جُلبت في 2026-10-07). سياق 1M و/autocompact 200k: سجل تغييرات Claude Code (CHANGELOG.md في مستودع anthropics/claude-code على GitHub، مدخل 2.1.285) وصفحة إعداد النموذج، مع تاريخ الإصدار من GitHub Releases في المستودع نفسه، وجميعها جُلبت في 2026-10-07. إعداد QCode: صفحتا متغيرات البيئة ونقاط النهاية على docs.qcode.cc (جُلبت في 2026-10-07). يعتمد شكل المسار والنماذج المتاحة وحدود أي نقطة نهاية محددة على المزوّد الذي تتصل به؛ ولا تجيب هذه الصفحة عنها.
متغيران، يُجرَّبان أولًا في صدفة أوامر نظيفة
بعد أن يعمل، تحقق من النموذج المُعاد في الاستجابة وطابِق الاستخدام قبل تثبيته في الإعدادات.
قراءات إضافية
Cline مع نقطة نهاية متوافقة مع OpenAI
كيف يبدو إعداد نقطة النهاية المخصصة في فئة مختلفة من العملاء.
رصيد API الشهري لـ Claude Max وTeam
متاح منذ 2026-10-07: $100 / $200 / حتى $500، يُطالَب به داخل مؤسسة في Console، وليس لـ Claude Code، بلا ترحيل.
استخدام Claude Code في اليابان: دليل عملي
طرق الدفع (بطاقة، Apple Pay، Google Pay، العملات المشفرة)، والوثائق اليابانية، وخطوات إعداد ANTHROPIC_BASE_URL.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
الوثائق الرسمية المقتبسة هنا روجعت آخر مرة في 2026-10-07 وقد تتغير؛ صفحات Anthropic لها الأولوية. شكل المسار ومجموعة النماذج وحدود أي نقطة نهاية محددة تحكمها وثائق ذلك المزوّد؛ أما توافر النماذج فهو ما يعرضه /models.