إضافة Claude Code لـ VS Code: مفتاح API وإعداد بوابة مخصصة
اعتبارًا من 2026-10-07، تقدّم الوثائق الرسمية لـ Claude Code طريقة موثوقة واحدة لتوجيه إضافة VS Code إلى بوابة مخصصة: ضع ANTHROPIC_BASE_URL وANTHROPIC_AUTH_TOKEN في claudeCode.environmentVariables ضمن إعدادات المستخدم في VS Code، لأن الإضافة تتحقق من بيانات الاعتماد في ذلك الإعداد قبل التشغيل. أضف القيمتين نفسيهما إلى كتلة env في ~/.claude/settings.json حتى يشاركها CLI الطرفية. أما QCode فالقيمتان هما https://api.qcode.cc/api ومفتاح يبدأ بـ cr_. تغطي هذه الصفحة الخطوات، وكيف ترتبط الإضافة بـ CLI، وثلاث مشكلات شائعة: مفتاح لا يتم العثور عليه، ومطالبة تسجيل دخول تظهر باستمرار، واختيار النموذج.
آخر تحديث 2026-11-14
وجّه هذه الأداة إلى نقطة نهاية QCode — مفتاح واحد لـ Claude وGPT والنماذج الصينية.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
أربعة أمور يجب معرفتها أولًا
كل ما يحتاجه QCode
ضبط ANTHROPIC_BASE_URL على https://api.qcode.cc/api (حتى /api، دون شرطة مائلة لاحقة) وضبط ANTHROPIC_AUTH_TOKEN على المفتاح الذي يبدأ بـ cr_ والذي تنشئه في لوحة التحكم.
المكان الموثوق لبيانات اعتماد البوابة
وفقًا للوثائق الرسمية، تتحقق الإضافة من بيانات الاعتماد في claudeCode.environmentVariables قبل التشغيل؛ وتصل القيم الموجودة في ~/.claude/settings.json إلى العملية التي تُشغَّل، لكن ليس إلى فحص تسجيل الدخول الخاص بالإضافة.
إعدادات مشتركة مع CLI الطرفية
يُشارَك ~/.claude/settings.json بين الإضافة وCLI. ضع القيمتين نفسيهما في كتلة env الخاصة به، وسيستخدم claude في الطرفية البوابة نفسها. لا تضعهما في ملف .claude/settings.json الخاص بالمشروع، لأنه يُثبَّت في المستودع.
نافذة السياق مع Base URL مخصص
بدءًا من 2.1.285، تعمل الجلسات خلف ANTHROPIC_BASE_URL مخصص مع Opus 4.7+ وSonnet 5+ وFable عند 1M مباشرةً؛ وإذا توقفت بوابتك عند 200K، فإن سجل التغييرات الرسمي ينص على تشغيل /autocompact 200k.
كيف تقرأ إضافة VS Code إعداداتها
اعتبارًا من 2026-10-07، الإجابة المختصرة هي أن للإضافة نوعين من الإعدادات. وفقًا للوثائق الرسمية، تتحكم إعدادات الإضافة في VS Code في سلوك الإضافة، بينما يُشارَك ~/.claude/settings.json بين الإضافة وCLI ويحتوي على متغيرات البيئة والأوامر المسموح بها والخطافات وخوادم MCP. بالنسبة إلى بوابة مخصصة، تضع الوثائق الرسمية للبوابة بيانات الاعتماد في claudeCode.environmentVariables ضمن إعدادات المستخدم في VS Code، لأن الإضافة تتحقق من بيانات الاعتماد هناك قبل التشغيل. تضمّ الإضافة نسختها الخاصة من CLI للوحة الدردشة، لكنها لا تضيف claude إلى PATH لديك؛ لتشغيل claude في الطرفية المدمجة تحتاج إلى تثبيت CLI المستقل. تتطلب VS Code 1.94.0 أو أحدث. لا يحتاج تسجيل الدخول باشتراك Claude مدفوع أو حساب Console إلى مفتاح API؛ ومع بوابة، يحل متغير بيانات الاعتماد محل تسجيل دخولك إلى claude.ai.
التغييرات الأخيرة المتعلقة بـ VS Code (اعتبارًا من 2026-10-07)
حتى 2026-10-07، أحدث إصدار على GitHub Releases هو 2.1.292، نُشر في 2026-10-06 (UTC). البنود المتعلقة بالبوابة: منذ 2.1.285، تستخدم الجلسات خلف ANTHROPIC_BASE_URL مخصص نافذة السياق 1M للنماذج التي تمتلكها (Opus 4.7+، Sonnet 5+، Fable)، ويقول سجل التغييرات الرسمي إنه يجب تشغيل /autocompact 200k إذا توقفت بوابتك عند 200K؛ أضاف 2.1.280 مربع حوار Status إلى VS Code، يُفتح بكتابة /status، ويعرض إصدار الجلسة والحساب والنموذج وتفاصيل الخادم؛ بدءًا من 2.1.277، حيث لا تنطبق حدود الخطة (يسرد سجل التغييرات Vertex وBedrock وFoundry ومفتاح API)، يعرض مربع حوار Account & usage تكلفة الجلسة واستخدام token؛ أصلح 2.1.290 عدم إعطاء تسجيل الدخول والجلسات الجديدة سببًا واضحًا عندما يتعذر على Claude Code العثور على برنامجه أو تشغيله.
الجدول الزمني للإصدارات
صدر 2.1.261 (UTC): أُصلحت مشكلة ظهور شاشة تسجيل الدخول في VS Code رغم إعداد Disable Login Prompt عندما يفيد Claude Code بعدم وجود تسجيل دخول أو يفشل طلب لغيابه.
صدر 2.1.280 (UTC): اكتسب VS Code مربع حوار Status. اكتب /status في اللوحة لرؤية إصدار الجلسة والحساب والنموذج وتفاصيل الخادم، ما يسهّل التحقق من أن إعدادك أصبح ساريًا.
صدر 2.1.285 (UTC): أصبحت الجلسات خلف ANTHROPIC_BASE_URL مخصص تشغّل النماذج التي تمتلك نافذة 1M (Opus 4.7+، Sonnet 5+، Fable) عند 1M مباشرة.
مؤكد مقابل غير موثّق
مؤكد (حرفيًا في الوثائق)
يمكن التحقق من كل واحد من هذه كلمة بكلمة في وثائق Claude Code الرسمية أو سجل التغييرات أو وثائق QCode: VS Code 1.94.0 أو أحدث؛ تضمّن الإضافة CLI لكنها لا تضيفه إلى PATH؛ يُشارَك ~/.claude/settings.json بين الإضافة وCLI؛ توضع متغيرات البوابة في claudeCode.environmentVariables، التي تتحقق الإضافة من بيانات اعتمادها قبل التشغيل؛ يتجاوز Disable Login Prompt مطالبات المصادقة؛ يُرسَل ANTHROPIC_AUTH_TOKEN بصيغة Authorization: Bearer ويُرسَل ANTHROPIC_API_KEY بصيغة x-api-key؛ متغير بيانات الاعتماد له الأولوية على تسجيل دخول claude.ai محفوظ؛ وضع ANTHROPIC_BASE_URL فقط دون بيانات اعتماد لا يستبدل تسجيل دخول الاشتراك؛ تتشارك الإضافة وCLI سجل المحادثات؛ والتحول إلى نافذة افتراضية 1M في 2.1.285؛ وقيم QCode https://api.qcode.cc/api ومفتاح cr_.
غير موثّق أو غير متحقّق منه
لا تخلص هذه الصفحة إلى نتيجة في ثلاث نقاط. أولًا، حتى 2026-10-07 لا يسرد جدول إعدادات الإضافة الرسمي إعدادًا منفصلًا لمفتاح API أو Base URL؛ تغطي هذه الصفحة فقط مواقع الإعداد التي تسردها الوثائق الرسمية، وتخرج الأساليب الأخرى القائمة على ملفات الإعداد عن النطاق. ثانيًا، تقول الوثائق الرسمية إن Claude Code لا يستطيع اكتشاف حد أقل تفرضه البوابة، لذا فإن قبول بوابتك لـ 1M متروك لوثائقها أو لاختبارك الخاص لبيانه. ثالثًا، تتغير أسماء الإعدادات والأزرار في الإضافة بين الإصدارات؛ تتبع هذه الصفحة الوثائق الرسمية التي جُلبَت في 2026-10-07 دون اختبار كل إصدار، لذا اعتمد على الإصدار الذي لديك.
أين يوضع وعلاقته بـ CLI
environmentVariables مقابل settings.json
كتابة كليهما هي الأبسط. claudeCode.environmentVariables إعداد مستخدم في VS Code يضبط متغيرات البيئة لعملية Claude؛ تتحقق الإضافة من بيانات اعتمادها قبل التشغيل، ولهذا تضع وثائق البوابة الرسمية بيانات الاعتماد هناك. كتلة env في ~/.claude/settings.json مشتركة بين الإضافة وCLI الطرفية، وتوصي بها وثائق VS Code الرسمية للإعداد المشترك. إذا كتبت الأخير فقط، تصل القيم إلى العملية لكن ليس إلى فحص تسجيل الدخول الخاص بالإضافة؛ وإذا كتبت الأول فقط، لا يكون الإعداد مشتركًا مع CLI الطرفية.
إضافة VS Code مقابل CLI الطرفية
يقرأ كلاهما ملفات الإعداد نفسها ويتشاركان سجل المحادثات: شغّل claude --resume في الطرفية لمتابعة محادثة من الإضافة. الفرق في الميزات. يقول جدول المقارنة الرسمي إن CLI يمتلك جميع الأوامر والمهارات بينما تمتلك الإضافة مجموعة فرعية منها (اكتب / لعرضها)؛ اختصار ! Bash والإكمال بمفتاح Tab متاحان في CLI فقط. لا تضيف الإضافة claude إلى PATH لديك، لذا يحتاج CLI إلى تثبيت خاص به؛ وعندما لا تعرض الإضافة سبب فشل شيء ما، فإن النصيحة الرسمية هي تشغيل claude في الطرفية للحصول على رسائل خطأ أكثر تفصيلًا.
خمس خطوات إلى بوابة مخصصة
① ثبّت الإضافة: افتح عرض الإضافات (Cmd+Shift+X / Ctrl+Shift+X)، وابحث عن Claude Code وانقر على Install، أو نفّذ code --install-extension anthropic.claude-code في طرفية؛ يلزم VS Code 1.94.0 أو أحدث. ② نفّذ Preferences: Open User Settings (JSON) من لوحة الأوامر وأضف claudeCode.environmentVariables بمدخلين: الاسم ANTHROPIC_BASE_URL والقيمة https://api.qcode.cc/api، والاسم ANTHROPIC_AUTH_TOKEN والقيمة مفتاح cr_ الخاص بك. ③ إذا كانت شاشة تسجيل الدخول لا تزال تظهر، فافتح الإعدادات وابحث عن Claude Code login وحدد Disable Login Prompt (تصف الوثائق الرسمية هذا الخيار بأنه تخطي مطالبات المصادقة لإعدادات الجهات الخارجية). ④ لمشاركة الإعداد مع CLI الطرفية، أضف القيمتين نفسيهما إلى كتلة env في ~/.claude/settings.json (على Windows: %USERPROFILE%\.claude\settings.json)؛ لا تضعها في .claude/settings.json الخاص بمشروع. ⑤ نفّذ Developer: Reload Window، واكتب /status في اللوحة للتحقق من الإصدار والحساب والنموذج وتفاصيل الخادم، ثم أرسل رسالة اختبار.
على QCode
على QCode، تأتي القيمتان من وثائق QCode: ANTHROPIC_BASE_URL=https://api.qcode.cc/api (حتى /api، دون شرطة مائلة في النهاية)، و ANTHROPIC_AUTH_TOKEN المضبوط على مفتاح يبدأ بـ cr_ (أُنشئ في لوحة التحكم)، ويرسله Claude Code كـ Bearer token. تعمل نماذج Claude فقط عبر نقطة نهاية بروتوكول Anthropic، وهو البروتوكول الذي تستخدمه إضافة VS Code. تشمل نماذج Claude التي يمكنك استدعاؤها على QCode ما يلي: claude-sonnet-5-5 و claude-opus-5-5 و claude-sonnet-5؛ وتُحتسب الفوترة لكل token، وسعر كل نموذج على /models، ولا تمتلك عائلة Claude فئة منفصلة للسياق الطويل. في أمريكا الشمالية وأوروبا يمكنك استخدام us.qcode.cc (لوس أنجلوس)؛ وبالنسبة للشبكات في البر الرئيسي الصيني تقترح الوثائق asia.qcode.cc، مع المسار نفسه والمفتاح نفسه. يمكن الاستعلام عن كل طلب على probe.qcode.cc بإدخال مفتاحك.
الأسئلة الشائعة
أين أُدخل مفتاح API و Base URL المخصص لـ Claude Code في VS Code؟
في claudeCode.environmentVariables ضمن إعدادات المستخدم في VS Code. نفّذ Preferences: Open User Settings (JSON) من لوحة الأوامر وأضف مدخلين هما ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN؛ ولـ QCode استخدم https://api.qcode.cc/api ومفتاح cr_ الخاص بك. اعتبارًا من 2026-10-07، لا يسرد جدول إعدادات الإضافة الرسمي إعدادًا منفصلًا لمفتاح API أو لـ Base URL، وتقول وثائق البوابة الرسمية إن الإضافة تتحقق من بيانات الاعتماد من هذا الإعداد قبل التشغيل، لذا فهو المكان الموثوق لبيانات اعتماد البوابة.
صدّرت المتغيرات في طرفيتي، لكن الإضافة ما زالت لا تجد المفتاح. لماذا؟
الأرجح أن المتغيرات لم تصل إلى VS Code أصلًا. تقول الوثائق الرسمية إن تصديرات shell تنطبق فقط على جلسة الطرفية تلك والبرامج التي تبدأ منها، ولن يراها محرر يُشغّل من الـ dock أو قائمة Start. ولا يكفي أيضًا وضعها فقط في كتلة env في ~/.claude/settings.json: تصل تلك القيم إلى العملية المُشغّلة، لكن ليس إلى فحص تسجيل الدخول الخاص بالإضافة. أضف كليهما إلى claudeCode.environmentVariables، ونفّذ Developer: Reload Window، واكتب /status في اللوحة للتحقق.
لماذا ما زال يطلب مني تسجيل الدخول بعد أن أعددت كل شيء؟
عادةً لا يرى فحص تسجيل الدخول في الإضافة أي بيانات اعتماد. تأكد أولًا من وجود بيانات الاعتماد في claudeCode.environmentVariables، ومن أنك لم تضبط ANTHROPIC_BASE_URL فقط: تقول الوثائق الرسمية إن ضبط Base URL دون متغير بيانات اعتماد لا يستبدل الاشتراك، ويظل تسجيل الدخول المحفوظ إلى claude.ai هو بيانات الاعتماد النشطة. إذا كانت شاشة تسجيل الدخول لا تزال تظهر، فابحث في الإعدادات عن Claude Code login وحدد Disable Login Prompt؛ فقد أصلح الإصدار 2.1.261 ظهور الشاشة رغم هذا الإعداد، لذا حدّث الإصدارات الأقدم أولًا. إذا أظهر بدء التشغيل تحذيرًا يذكر مصدرين لبيانات الاعتماد وينتهي بعبارة «auth may not work as expected»، فالإصلاح الرسمي هو تنفيذ /logout بحيث تبقى بيانات اعتماد البوابة فقط.
هل يمكن لإضافة VS Code و CLI الطرفية مشاركة إعداد واحد؟
نعم، عبر ~/.claude/settings.json. تقول الوثائق الرسمية إن الطرفية وامتدادي VS Code وJetBrains وتطبيق سطح المكتب كلها تقرأ ملفات الإعدادات نفسها؛ ضع ANTHROPIC_BASE_URL وANTHROPIC_AUTH_TOKEN في كتلة env داخل ملف الإعدادات، وسيستخدم claude في الطرفية البوابة نفسها. عندما يضبط كل من تصدير shell وكتلة env في ملف إعدادات المتغيّر نفسه، تُطبّق قيمة ملف الإعدادات. وتتشارك الطرفية والامتداد أيضًا سجل المحادثات، لذا يتابع claude --resume في الطرفية محادثة الامتداد. لاحظ أن الامتداد لا يضيف claude إلى PATH لديك؛ ويحتاج CLI إلى تثبيت خاص به.
كيف أختار نموذجًا، وماذا لو لم يكن النموذج الذي أريده في قائمة الاختيار؟
انقر شريحة النموذج أسفل مربع prompt أو اكتب /model؛ يمكنك أيضًا ضبط متغيّر البيئة ANTHROPIC_MODEL أو حقل model في ملف إعدادات. تقول الوثائق الرسمية إن /model يحفظ اختيارك كافتراضي للجلسات الجديدة في حقل model ضمن إعدادات المستخدم، لذا يقرأ كل من الامتداد وCLI الافتراضي نفسه. إذا لم تكن أسماء النماذج لدى بوابتك في قائمة Claude Code المدمجة، فالإصلاح الرسمي هو CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1، الذي يملأ قائمة الاختيار من قائمة النماذج لدى البوابة. على QCode، يمكن أن يكون النموذج claude-sonnet-5-5 أو claude-opus-5-5 أو claude-sonnet-5؛ والقائمة الحالية على /models.
هل أستخدم ANTHROPIC_AUTH_TOKEN أم ANTHROPIC_API_KEY؟
مع QCode، استخدم ANTHROPIC_AUTH_TOKEN. تقول الوثائق الرسمية إنه يُرسَل في ترويسة Authorization: Bearer، بينما يُرسَل ANTHROPIC_API_KEY في x-api-key؛ وبيانات الاعتماد في المتغيّر الخطأ تصل إلى البوابة في ترويسة لا يقرأها وتفشل بالرمز 401، لذا بدّل إلى المتغيّر الآخر وحاول مرة أخرى. تضع وثائق QCode المفتاح في ANTHROPIC_AUTH_TOKEN بحسب الاصطلاح، وتعمل أداة تقرأ ANTHROPIC_API_KEY فقط أيضًا مع مفتاح cr_ نفسه. ثمة فرق آخر: يحتاج ANTHROPIC_API_KEY إلى موافقة لمرة واحدة في الوضع التفاعلي قبل أن يسري، بينما يتقدّم ANTHROPIC_AUTH_TOKEN فورًا على تسجيل دخول محفوظ.
المصادر
مواقع الإعدادات وسلوك الامتداد: صفحة وثائق Claude Code الرسمية الخاصة بـ VS Code (code.claude.com: المتطلبات الأساسية، وجدول إعدادات الامتداد، وخطوات إعداد الطرف الثالث، ومقارنة CLI والإصلاحات الشائعة)، إضافة إلى صفحات الاتصال ببوابة LLM، ونظرة عامة على بوابة LLM، والمصادقة، والإعدادات، ومتغيرات البيئة، وإعداد النموذج، جُلبت جميعها في 2026-10-07. تغييرات الإصدارات: أوقات نشر CHANGELOG وGitHub Releases (UTC) لمستودع anthropics/claude-code، جُلبت في اليوم نفسه. قيم QCode: صفحات وثائق QCode عن متغيرات البيئة (محدّثة في 2026-09-25)، ونقاط النهاية وتنسيقات API، وتكامل VS Code (محدّثة في 2026-09-18)، إضافة إلى صفحة /models، جُلبت في اليوم نفسه.
اربط VS Code بـ QCode
متغيّران ومفتاح cr_ واحد، يستخدمهما كل من الامتداد وCLI في الطرفية. تُحتسب الفوترة لكل token؛ راجع /models لمعرفة سعر كل نموذج.
قراءات ذات صلة
انتهت صلاحية token OAuth في Claude Code: استعادة تشغيلات claude -p وcron وCI غير المراقبة
تم التحقق في 2026-10-26: خطأ انتهاء صلاحية تسجيل الدخول الرسمي في Claude Code، وtoken claude setup-token لمدة سنة، وANTHROPIC_API_KEY وANTHROPIC_AUTH_TOKEN، والتحذير المتعلق بـ --bare.
Claude Code دون اشتراك Claude: مسارات تسجيل الدخول
مسارات تسجيل الدخول التي تسردها الوثيقة الرسمية، وقواعد الرصيد على جانب Console، إضافة إلى متغيّري بيئة QCode والسكربت بنقرة واحدة.
Claude Code في الصين: دليل شامل
ملاحظات إعداد للمطورين في البر الرئيسي للصين الذين يستخدمون Claude Code وCodex API، مع الدفع عبر Alipay.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
تم التحقق من الخطوات والاقتباسات في هذه الصفحة في 2026-10-07 مقابل وثائق Claude Code الرسمية وسجل التغييرات ووثائق QCode؛ وقد تحدث تغييرات دون إشعار. تتغير شاشات الامتداد وأسماء الإعدادات بين الإصدارات، لذا اعتمد على الإصدار الذي لديك؛ أما توافر النماذج فهو ما تعرضه /models.