تنزيل CC Switch: أحدث إصدار v4.0.28 والإعداد

CC Switch v4.0.28 (2026-11-08): ccswitch.io هو الموقع الرسمي الوحيد. نزّل من GitHub Releases، ثم أضف QCode.cc إلى Claude Code أو Codex CLI.

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 2026-11-09 · 📄 وفق الوثائق الرسمية (CC Switch v4.0.28، صدر في 2026-11-08؛ تم التحقق من أقسام التنزيل وCLI وقائمة التطبيقات المدعومة مقابل README وReleases وCHANGELOG في 2026-11-09)

نظرة سريعة¶

CC Switch تطبيق سطح مكتب متعدد المنصات (Windows / macOS / Linux) يدير إعدادات مزوّدي API لـ Claude Code، Claude Desktop، Codex، Gemini CLI، Grok Build، OpenCode، OpenClaw، Hermes، Pi، MiniMax Code، Kimi Code وOh My Pi من واجهة واحدة، بالإضافة إلى Antigravity CLI (agy) منذ v4.0.18 (القائمة من README الرسمي الذي تم التحقق منه في 2026-10-26؛ والإضافات الثلاث مشمولة أدناه). يوضح هذا الدليل كيفية إضافة QCode.cc كمزوّد مخصص في CC Switch، وكيفية التبديل بين عدة مزوّدين/حسابات بنقرة واحدة، ويغطي حالات الاستخدام الشائعة واستكشاف الأخطاء وإصلاحها.

لماذا تستخدم CC Switch¶

• دون تحرير يدوي للإعدادات: تحل الاستمارات المرئية محل settings.json / config.toml
• تبديل المزوّد بنقرة واحدة: بدّل بين qcode.cc وAnthropic الرسمي والبروكسيات المحلية فورًا
• منظومة Claude + Codex: أدِر إعدادات Claude Code وCodex CLI معًا في تطبيق واحد
• إدارة الحسابات/الخطط المتعددة: احفظ عدة إعدادات للمزوّد نفسه (مثل مفتاح عمل ومفتاح شخصي) وبدّل في أي وقت
• اختصارات علبة النظام: بدّل المزوّدين من قائمة علبة النظام دون فتح النافذة الرئيسية

CC Switch هو أساسًا «مبدّل ملفات تعريف الإعدادات»: كل مزوّد هو ملف تعريف واحد، والتبديل يستبدل فقط الحقول الرئيسية في ملف إعداد CLI الهدف (نقطة النهاية، المفتاح، اسم النموذج، البروتوكول وما إلى ذلك) بينما يبقى كل شيء آخر كما هو (README الرسمي). يكون مزوّد واحد فقط نشطًا في كل مرة، ما يساعدك على تجنب افتراض أن عدة مزوّدين يعملون معًا.

المتطلبات المسبقة¶

• Claude Code CLI أو Codex CLI مثبتًا
• مفتاح API من QCode.cc (يبدأ بـ cr_)، متاح من لوحة التحكم
• يعمل المفتاح نفسه عبر عدة نقاط نهاية بروتوكولية (Anthropic، OpenAI، إلخ) — راجع نقاط النهاية وصيغ API

الموقع والتنزيل والتثبيت حسب نظام التشغيل¶

حتى 2026-11-09، يذكر ملف README الرسمي لـ CC Switch: «الموقع الرسمي الوحيد: ccswitch.io». توجد الشيفرة المصدرية وملفات التثبيت في مستودع GitHub، وفي صفحة الإصدارات الخاصة به؛ أحدث إصدار هو v4.0.28 (صدر في 2026-11-08، وفقًا لصفحة الإصدار وCHANGELOG). مراجعة هذه الصفحة بتاريخ 2026-10-26 تحققت من v4.0.20 (صدر في 2026-10-24)؛ ومراجعة 2026-10-15 تحققت من v4.0.12 (صدر في 2026-10-14). نزّل من هذين المكانين فقط.

متطلبات النظام (ملف README الرسمي):

• Windows: Windows 10 فما فوق
• macOS: macOS 12 (Monterey) فما فوق
• Linux: x86_64 أو ARM64 مع glibc 2.35+ وWebKitGTK 4.1، مثل Ubuntu 22.04+ وDebian 12+ وFedora الحديثة؛ لا تُدعم RHEL / Rocky / Alma 8–9 بعد

في أسماء الملفات أدناه، {version} هو أحدث إصدار في صفحة الإصدارات (على سبيل المثال 4.0.28):

Flatpak ليس جزءًا من الإصدارات الرسمية؛ ويذكر README أنه يمكنك بناؤه بنفسك من .deb (راجع flatpak/README.md في المستودع). بعد التثبيت، تابع مع «تكوين مزوّد Claude» أدناه.

تحذير المصدر الرسمي والعملاء المضافين في v4.0.18–v4.0.20 (2026-10-26)¶

تحمل ملاحظات الإصدار الرسمية تحذيرًا من المنتجات المقلدة، منقولًا حرفيًا: «أي موقع أو عميل "CC Switch" يطلب منك الدفع أو شحن الرصيد أو بيانات تسجيل الدخول فهو مزيف.» وتضيف أنه إذا خُدعت ودفعت، فعليك إيقاف المعاملة والإبلاغ عنها عبر GitHub Issues. نزّل فقط من ccswitch.io ومن GitHub Releases.

انضم ثلاثة عملاء إلى القائمة المُدارة في إصدارات 4.0.18–4.0.20 (التواريخ من CHANGELOG):

• v4.0.18 (2026-10-21) — Antigravity CLI. تسمّيه ملاحظات الإصدار «التطبيق الحادي عشر الذي يديره CC Switch» وتذكر: «لا يسري مفعول مزوّد Antigravity إلا عندما يُشغَّل agy في طرفية من CC Switch.» يتوقع Antigravity CLI خدمة متوافقة مع Gemini API. لا يقدم QCode سلسلة Gemini حاليًا.
• v4.0.19 (2026-10-23) — Kimi Code، «التطبيق الثاني عشر الذي يديره CC Switch». يوجد إعداده في ~/.kimi-code/config.toml، أو في المجلد الذي يحدده KIMI_CODE_HOME عند تعيينه (ملاحظات الإصدار).
• v4.0.20 (2026-10-24) — Oh My Pi، «التطبيق الثالث عشر الذي يديره CC Switch». يوجد إعداده في ~/.omp/agent، أو في ~/.omp/profiles/<name>/agent عند استخدام ملف تعريف مسمّى (ملاحظات الإصدار).

ما الذي يغيّره v4.0.21 (2026-10-26) في هذا الإعداد¶

يضيف v4.0.21 التبديل بين عدة حسابات اشتراك Claude الرسمية ضمن منطقة الحسابات؛ وينطبق ذلك على بطاقات Claude الرسمية، بينما يظل مزوّد QCode مزوّدًا مخصصًا له Base URL ومفتاح خاص به. يلمس تغييران الحقول في هذه الصفحة: في نموذج مزوّد Codex، أصبح لكل صف في قائمة النماذج مقبض سحب، وهذا الترتيب هو ترتيب قائمة /model في Codex؛ وعندما يمثل الصف الأول النموذج الافتراضي، يصبح النموذج المسحوب إلى الصف الأول هو الافتراضي الجديد (المسألة #8870)؛ وانتقل Open Terminal من قائمة ⋯ إلى البطاقة كزر أيقونة على يسار Edit. كما يصلح الإصدار مشكلة انتقال طلبات Codex إلى عنوان مختلف عبر التوجيه.

سطر الأوامر (CLI): لا يوجد إصدار رسمي، لكن توجد أداة CC Switch CLI من المجتمع¶

حتى 2026-10-26، لا يملك CC Switch نفسه إصدارًا رسميًا لسطر الأوامر. تنص الأسئلة الشائعة الرسمية على أن CC Switch يُوزَّع فقط كتطبيق سطح مكتب يحتاج إلى واجهة رسومية. بالنسبة إلى الخوادم أو جلسات SSH أو الأجهزة التي لا تحتوي على سطح مكتب، يوصي README الرسمي بأداة CC Switch CLI التي يديرها المجتمع — وهي نسخة متفرعة بواجهة CLI من CC Switch، صدرت بشكل منفصل عن مؤلف آخر وليست منتج CC Switch رسميًا. لم تختبر هذه الصفحة الأداة ميزة بميزة؛ اقرأ README الخاص بها قبل الاعتماد عليها.

التثبيت (وفق README المشروع؛ أحدث إصدار بتاريخ 2026-10-15 هو v5.11.1):

# macOS / Linux: Homebrew
brew install cc-switch-cli

# or the install script (installs to ~/.local/bin; read the script first)
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash

على Windows، نزّل cc-switch-cli-windows-x64.zip من صفحة Releases الخاصة بها، وفك ضغطه وضع cc-switch.exe في دليل على PATH.

الاستخدام الأساسي:

cc-switch                             # full-screen terminal UI (TUI)
cc-switch provider list               # list providers
cc-switch provider add                # add a provider (field values: see the Claude / Codex sections below)
cc-switch provider switch <id>        # switch provider
cc-switch use <id>                    # shortcut for the line above
cc-switch --app codex provider list   # --app picks the tool; the default is claude
cc-switch start claude <id>           # launch Claude with this provider for this run only, without changing the global one

يقبل --app القيم claude (الافتراضية)، وcodex، وكذلك opencode وhermes وopenclaw وpi وغيرها. افتراضيًا، تشترك أداة CLI هذه في دليل البيانات ~/.cc-switch مع تطبيق سطح المكتب؛ وقد يتأخر إصدار قاعدة البيانات الذي تدعمه أحيانًا عن تطبيق سطح المكتب — إذا ظهرت لك «database version is too new»، فحدّث CLI أو انتظر حتى يلحق بتطبيق سطح المكتب.

إذا كنت تفضّل ألا تثبّت أيًا منهما، فيمكنك أيضًا تحرير ملفات الإعدادات يدويًا: راجع دليل Claude Code التعليمي الخاص بـ Claude Code ودليل Codex التعليمي الخاص بـ Codex؛ فقيم Base URL والمفتاح هي نفسها الواردة في هذه الصفحة.

إعداد مزوّد Claude (لـ Claude Code)¶

شغّل CC Switch → اختر Claude Code في الشريط الجانبي → انقر على «+» (إضافة مزوّد) في أعلى اليمين → في علامة تبويب المزوّدين الخاصة بالتطبيق، اختر مخصص من القائمة المنسدلة للإعدادات المسبقة → حرّر JSON الإعدادات في اللوحة (تختلف صياغة واجهة المستخدم بين الإصدارات؛ اتبع ما يعرضه إصدارك):

لماذا asia.qcode.cc؟ إنها نقطة نهاية QCode.cc في آسيا وتناسب المستخدمين في البر الرئيسي للصين؛ وإذا كان الوصول إليها صعبًا، فاستخدم api.qcode.cc بدلًا منها. يعمل المفتاح نفسه عبر النطاقات الثلاثة كلها: api / asia / us.

بعد الحفظ، انقر على تفعيل في البطاقة (تظهر أزرار إجراءات البطاقة عند التحويم) لتعيينه مزوّد Claude الحالي. سيكتب CC Switch تلقائيًا ANTHROPIC_BASE_URL وANTHROPIC_AUTH_TOKEN إلى ~/.claude/settings.json. شغّل claude في الطرفية للتحقق من الاتصال.

اختيار النموذج الافتراضي¶

توفّر QCode.cc تشكيلة كاملة من النماذج الرائدة إلى النماذج الخفيفة. بدّل في Claude Code باستخدام /model، أو حدّد مباشرةً في الإعدادات:

الأسعار وأحجام السياق: اقرأها مباشرةً على qcode.cc/models — لم تعد هذه الصفحة تنسخ الأرقام عمدًا. التشكيلة الكاملة (نماذج GPT وعائلة النماذج الصينية) موجودة في الصفحة نفسها. بدءًا من v3.20.3، يتضمن محرّر مزوّد Claude أيضًا لوحة تعيين نماذج لكل دور (Sonnet / Opus / Fable / Haiku / الوكيل الفرعي) مع زر تطبيق على جميع الأدوار بنقرة واحدة.

إعداد مزوّد Codex (لـ Codex CLI)¶

اختر Codex في الشريط الجانبي → «+» إضافة مزوّد → مخصص → املأ كما يلي:

⚠️ يتضمن محرّر مزوّد Codex مفتاح تبديل «Needs Local Routing» مخصصًا للمزوّدين الذين يدعمون Chat Completions فقط. اتركه معطّلًا مع QCode — يقدّم QCode بروتوكول Responses أصليًا، وسيتطلب تفعيله إبقاء وكيل محلي قيد التشغيل.

ينشئ CC Switch ما يعادل ~/.codex/config.toml و~/.codex/auth.json:

model_provider = "qcode"
model = "gpt-6.1-sol"
model_reasoning_effort = "high"

[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
requires_openai_auth = true

احفظ، وانقر على تفعيل، ثم شغّل codex للتحقق من الاتصال. خيارات نماذج GPT: gpt-6.1-sol / gpt-6-sol / gpt-5.6-terra (الأسعار والسياق: qcode.cc/models). اقرأ إصدار Codex CLI من codex --version على جهازك؛ لا تثق برقم تاريخي في هذه الصفحة.

تطبيق Codex لسطح المكتب¶

الخلاصة: يقرأ تطبيق Codex لسطح المكتب الملف ~/.codex/config.toml نفسه الذي يكتبه CC Switch، لذا بمجرد إعداد QCode كمزوّد Codex كما هو موضح أعلاه، يستخدم تطبيق سطح المكتب ونسخة سطر الأوامر الإعدادات نفسها. (لم تختبر هذه الصفحة تسجيل الدخول/المصادقة في تطبيق سطح المكتب.) الأساس:

1. تنص وثائق OpenAI الرسمية (استخدام بيانات اعتماد API/المزوّد عبر بوابة) على أن تطبيق macOS يقرأ الملف ~/.codex/config.toml نفسه، وأنك تعيد تشغيل التطبيق بعد حفظ إعدادات المزوّد؛ وعلى Windows يكون الملف %USERPROFILE%\.codex\config.toml، ويجب أيضًا إعادة تشغيل التطبيق.
2. يطلب منك README الرسمي لـ CC Switch إنهاء تطبيق Codex لسطح المكتب بالكامل ثم إعادة فتحه (⌘Q على macOS؛ إغلاق النافذة لا يكفي) — ترد تلك الجملة في قسم وضع التجميع الخاص بتحديث قائمة النماذج؛ وعند تبديل مزوّد عادي، يُعد الإنهاء الكامل وإعادة الفتح عادة معقولة أيضًا.

لجعل تطبيق سطح المكتب يستخدم QCode:

1. في علامة التبويب Codex في CC Switch، أضف مزوّد QCode وفعّله كما في القسم السابق (Base URL https://api.qcode.cc/openai، wire_api = "responses").
2. أنهِ تطبيق Codex لسطح المكتب بالكامل، ثم افتحه مرة أخرى.
3. في التطبيق، تحقق من أن النموذج المحدد هو نموذج GPT يقدمه QCode (مثل gpt-6.1-sol). تقترح وثائق OpenAI التحقق من النموذج المحدد والإعدادات في تطبيق سطح المكتب.

تذكيران:

• تحذر وثائق OpenAI من أن متغيرًا يتم تعيينه في طرفية قد لا يكون متاحًا لتطبيق يُطلق من سطح المكتب. إذا كنت لا تستخدم CC Switch وبدلًا من ذلك تكتب config.toml يدويًا وتمرر المفتاح عبر متغير بيئة، فتأكد من أن عملية التطبيق تستطيع رؤية ذلك المتغير.
• حتى 2026-10-15، تسمي وثائق OpenAI تطبيق سطح المكتب «تطبيق ChatGPT لسطح المكتب»، حيث تختار ChatGPT أو Codex؛ وتأتي إصدارات macOS وWindows من chatgpt.com/download، ولدى Linux دليل التثبيت الرسمي الخاص بها. كيفية تعايش تسجيل الدخول بحساب ChatGPT مع مزوّد مخصص في تطبيق سطح المكتب غير مغطاة في تلك الصفحات الرسمية، لذا لا تقدم هذه الصفحة أي ادعاء بشأن ذلك.

التبديل بين مزوّدين/حسابات متعددة¶

القيمة الجوهرية لـ CC Switch هي التبديل. ومن الإعدادات الشائعة:

1. ضمن علامة التبويب Claude، احفظ عدة مزوّدين، مثل QCode.cc (أساسي)، QCode.cc (asia) (عقدة البر الرئيسي)، Anthropic Official (للمقارنة).
2. للتبديل، انقر على تفعيل في بطاقة المزوّد الهدف — يعيد CC Switch كتابة ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN المقابلين في ~/.claude/settings.json.
3. اجعل الإعداد الجديد نشطًا: يقول README الرسمي إن Claude Code يبدّل بيانات المزوّد أثناء التشغيل حاليًا؛ وتوثّق الأسئلة الشائعة الرسمية والمشكلة #3057 الحالة الأخرى — ملف settings.json على القرص جديد بالفعل، لكن الجلسة قيد التشغيل لا تزال تصل إلى المزوّد القديم. إذا كانت الجلسة الحالية لا تزال على العقدة القديمة، فأغلقها وافتح طرفية جديدة قبل تشغيل claude مرة أخرى. Codex وواجهات CLI الأخرى: أعد فتح الطرفية دائمًا (الأسئلة الشائعة).
4. يعمل Codex بالطريقة نفسها: تبديل العنصر النشط ضمن علامة التبويب Codex يعيد كتابة ~/.codex/config.toml.

اختصار علبة النظام: يبقى CC Switch في علبة النظام؛ منذ v3.13.0 أصبحت قائمة النقر بزر الماوس الأيمن مجمّعة في قوائم فرعية لكل تطبيق (Claude / Codex / Gemini)، وكل قائمة فرعية معنونة بالمزوّد المفعّل حاليًا وملخص الاستخدام — انقر على اسم مزوّد للتبديل. يكتب التبديل من علبة النظام الملفات النشطة نفسها التي يكتبها تفعيل في النافذة الرئيسية؛ توجد المزالق في «بعد الاتصال» أدناه.

مثال تعدّد الحسابات / الخطط¶

احفظ إعدادين للحساب نفسه في QCode.cc، لكل منهما مفتاح API مختلف:

يؤدي تبديل المزوّد النشط إلى الانتقال بسلاسة بين الحصتين دون خلط الفوترة.

حالات الاستخدام¶

• شبكة غير مستقرة في الصين: استخدم asia.qcode.cc كأساسي، وبدّل بنقرة واحدة إلى api.qcode.cc العالمي عند تذبذب الشبكة.
• مقارنة المزوّدين: نفّذ المهمة نفسها عبر QCode.cc وAnthropic الرسمي لمقارنة الاستجابات والتكلفة.
• الفصل بين الفريق والاستخدام الشخصي: استخدم مفاتيح مختلفة لفصل استخدام العمل عن الاستخدام الشخصي لتسهيل المحاسبة.
• Claude + Codex معًا: أدر كلاً من Claude Code وCodex CLI في تطبيق واحد، مع توجيه كل منهما إلى نقاط النهاية الخاصة ببروتوكول Anthropic وبروتوكول OpenAI على الترتيب.

ميزات Claude Code المتقدمة (لا تزال تعمل عبر QCode)¶

لا يبدّل CC Switch سوى المزوّدين؛ ولا تتأثر قدرات Claude Code الخاصة. بعد الاتصال بـ QCode، تعمل الميزات التالية كالمعتاد (على أي نموذج تمت تهيئة Claude Code عليه):

إدخال المرئيات: فهم المتطلبات من لقطات الشاشة / المخططات¶

يستطيع Claude Code تزويد النماذج القادرة على الرؤية بالصور: اللصق (Ctrl+V)، أو السحب والإفلات، أو الإشارة إلى مسار ملف صورة في prompt. من الاستخدامات الشائعة:

• بناء واجهة المستخدم من نموذج تصميم / لقطة شاشة
• تصحيح الأخطاء من لقطة شاشة خطأ
• قراءة مخططات البنية والرسوم البيانية

تشمل النماذج القادرة على الرؤية عبر QCode كلاً من claude-opus-5 / claude-sonnet-5، إضافة إلى claude-opus-4-8 / claude-sonnet-4-6 التي لا تزال معروضة للبيع، وعائلة GPT (مثل gpt-6.1-sol، gpt-5.6-terra). مؤشرات القدرات المباشرة: qcode.cc/models.

ملاحظة: هذا إدخال للصور (فهم)، وليس توليدًا للصور. لجعل نموذج يولّد الصور، استخدم نموذج gpt-image-2 — راجع توليد الصور باستخدام gpt-image-2.

سير العمل الديناميكي (تنسيق الوكلاء الفرعيين في الخلفية)¶

ضمّن الكلمة المفتاحية ultracode في prompt (أو اطلب ببساطة «تشغيل سير عمل») لتفعيل سير العمل الديناميكي في Claude Code: إذ ينسّق من عشرات إلى مئات من الوكلاء الفرعيين في الخلفية بالتوازي، وهو مثالي للمراجعة والترحيل والبحث على مستوى قاعدة الشيفرة. يظل الوكلاء يعملون في الخلفية بينما تواصل عملك؛ واعرض عمليات التشغيل بالأمر /workflows. تعمل هذه القدرة على أي نموذج تمت تهيئة Claude Code عليه — لذا تعمل عندما يشير Claude Code إلى QCode. قراءة إضافية: الوكلاء الفرعيون.

الوضع بلا واجهة / إخراج الأتمتة¶

في السكربتات وCI، شغّل مرة واحدة باستخدام -p وحدّد صيغة الإخراج:

# Structured JSON (incl. result / total_cost_usd / usage / session_id), parse with jq
claude -p "Summarize test coverage in this repo" --output-format json | jq '.result'

# Newline-delimited streaming JSON events, good for real-time pipes
claude -p "Review src/ for security risks" --output-format stream-json

مزيد من استخدامات الأنابيب وCI في الأتمتة وCI/CD.

حول Gemini / Antigravity¶

تتضمن قائمة CC Switch تطبيق Gemini CLI، لكن QCode لا يوفّر نماذج Gemini في الوقت الحالي، لذا لا يوجد ما يمكن إعداده لـ QCode تحت Gemini في CC Switch. استخدم بدلًا من ذلك نماذج Claude أو GPT أو نماذج العائلة الصينية؛ النماذج التي يمكنك استدعاؤها مدرجة على qcode.cc/models.

للسياق: أوقفت Google تطبيق Gemini CLI (EOL 2026-06-18 لخطط Pro/المجانية؛ مفاتيح المؤسسات المدفوعة غير متأثرة)، وخلفته Google Antigravity CLI (متاحة منذ 2026-05-19). لا يزال CC Switch يدعم Gemini CLI كتطبيق من الدرجة الأولى بالمدخل نفسه الخاص بـ Claude / Codex؛ وهذا يتعلق فقط بحسابك على Google أو بمصادر أخرى، ولا علاقة له بـ QCode.

اختيار نقطة نهاية لشبكتك¶

تتشارك نقاط النهاية الثلاث مفتاحًا واحدًا. اختر النقطة التي تناسب شبكتك؛ وإذا كانت إحداها بطيئة الوصول، فغيّر Base URL إلى أخرى.

تحقق ذاتي: طلب مسار Base URL مباشرةً يعيد 401 — هذا متوقع، ويعني أن المسار صحيح وأن المصادقة فقط هي الناقصة.

مفتاح واحد لكل من Claude وCodex¶

يمكن لمزوّدي Claude وCodex في CC Switch استخدام مفتاح API نفسه الخاص بـ QCode.cc. تُحتسب فوترة QCode لكل token؛ وأسعار كل نموذج مدرجة على qcode.cc/models (القواعد في الفوترة). إضافة مزوّدين لا تضاعف فوترتك. إذا أنشأت مزوّدين بمفاتيح مختلفة، فكل مفتاح تُحتسب فوترته بشكل مستقل.

بعد الاتصال: التبديل والتعايش والاستعادة¶

هذا القسم يغطي ما يحتاجه فعليًا من يصل إلى هنا عبر البحث عن «CC Switch» بعد الإعداد. طريقة ملء النموذج موضحة أعلاه؛ وهذا ما يحدث بعد تشغيله.

عدة خطط / عدة مفاتيح¶

المزوّد الواحد = BASE_URL واحد + مفتاح + نموذج (لـ Codex). يمكنك الإبقاء على عدة صفوف للحساب نفسه في QCode، على سبيل المثال:

لا يكون نشطًا إلا مزوّد واحد في كل مرة — لن يكتب CC Switch إعدادين معًا في ~/.claude/settings.json. لمقارنة Anthropic الرسمي وQCode، انقر «Enable» ذهابًا وإيابًا. لا تتوقع أن يكون كليهما نشطًا.

لم يلتقط CLI المزوّد الجديد¶

تحقق بهذا الترتيب؛ لا تبدأ بإلقاء اللوم على المفتاح:

1. افتح ~/.claude/settings.json (أو ~/.codex/config.toml لـ Codex) وتأكد من أن ANTHROPIC_BASE_URL / base_url هو الصف الذي فعّلته للتو.
2. تغيّر الملف ولم تتغير الجلسة: هذا هو السلوك في المشكلة #3057 — ينسخ Claude Code كتلة env من settings.json عند بدء العملية. الجلسة قيد التشغيل لا تعيد قراءته. أغلق claude / codex الحالي وافتح طرفية جديدة.
3. يقول README الرسمي إن Claude Code يبدّل الآن أثناء التشغيل. إذا كانت نسختك تفعل ذلك، يمكنك تخطي إعادة التشغيل؛ إذا كان لا يزال يصل إلى العقدة القديمة، فأعد فتح الجلسة.

التعايش مع تسجيل الدخول الرسمي لـ Anthropic / ChatGPT¶

README الرسمي / الأسئلة الشائعة:

1. بدّل إلى المزوّد الرسمي المدمج في القائمة (Claude Official / OpenAI Official؛ إذا حذفته، فأضفه مجددًا من الإعدادات المسبقة)
2. انقر «Enable»
3. أعد فتح CLI المطابق ونفّذ تسجيل الخروج / تسجيل الدخول الخاص به (أو OAuth)
4. بعد ذلك يمكنك التبديل بين تسجيل الدخول الرسمي ومزوّد QCode.cc المخصص

لا تدمج يدويًا OAuth الرسمي وANTHROPIC_AUTH_TOKEN الخاص بـ QCode في settings.json — عند التفعيل، يعيد CC Switch كتابة الحقول التي يملكها. يتبع التبديل بين عدة حسابات Codex رسمية ما ورد في README: يستطيع Codex التبديل بين مزوّدين رسميين مختلفين.

مزالق التبديل من علبة النظام¶

• أيقونة مفقودة: macOS — إعدادات شريط القوائم؛ Windows — تجاوز شريط المهام؛ قد تحتاج Linux إلى libappindicator (الأسئلة الشائعة الرسمية)
• Lightweight Mode (قائمة علبة النظام): تُدمّر النافذة الرئيسية (لا تُخفى) وتبقى علبة النظام فقط؛ قبل v4.0.21 لم يكن الوضع يُحفظ، لذا كان البدء العادي يعود إلى الوضع العادي، ومنذ v4.0.21 (2026-10-26) يبقى بعد إعادة التشغيل (ملاحظات الإصدار)؛ أول رابط عميق ccswitch:// يعيد بناء النافذة ويكون أبطأ قليلًا (الأسئلة الشائعة الرسمية، منذ v3.13.0)
• النقر على علبة النظام، وCLI دون تغيير: تكتب علبة النظام ملفات التشغيل الحية نفسها التي يكتبها Activate. وهي لا تُنهي claude قيد التشغيل. أعد فتح الجلسة كما سبق
• اللواحق مثل (asia) / (work) تُبقي قائمة علبة النظام مقروءة

تمت الكتابة فوق الإعدادات — كيف تستعيدها¶

عند التفعيل / الاستحواذ، يكتب CC Switch حقول المزوّد في ملفات التشغيل الحية الخاصة بـ CLI. تبلّغ عدة مشكلات (#2992، #4274؛ إضافة إلى #1656، وهو طلب ميزة لسلوك الكتابة المدمجة) عن كتابة فوق الملف بالكامل أسقطت مفاتيح لا يملكها CC Switch (enabledPlugins، hooks، statusLine، permissions، …). غالبًا تبقى ملفات الإضافة على القرص؛ لكنها لم تعد تُحمّل لأن enabledPlugins اختفى.

مسارات استرداد يمكنك التحقق منها (README الرسمي / دليل المستخدم، وليست مقولة يتناقلها طرف ثالث):

1. نسخ التطبيق الاحتياطية: ~/.cc-switch/backups/ (تدويرية؛ النص الرسمي: آخر 10)
2. تصدير أنشأته: يُسمّى تصدير الإعدادات على نحو cc-switch-export-{timestamp}.sql؛ يستبدل الاستيراد قاعدة البيانات الحالية — صدّر مرة أخرى قبل الاستيراد
3. لم يعد هناك «Common Config Snippet»: منذ v4.0 اختفت الميزة (README الرسمي: أُزيلت أزرارها). التبديل يستبدل الحقول الأساسية فقط — نقطة النهاية، والمفتاح، واسم النموذج، والبروتوكول — ويترك الباقي؛ الإعدادات التي كانت في مقتطف قبل الترقية كُتبت بالفعل في ملف الإعدادات عند التبديل، لذا تبقى. قبل أن يعيد CC Switch كتابة ملف إعدادات أداة لأول مرة، ينسخ الأصل احتياطيًا إلى ~/.cc-switch/backups/live-first-write/
4. التعديلات اليدوية على Claude: منذ v4.0 لا يمحوها التبديل عمومًا؛ في إصدار أقدم، إذا كنت عدّلت ~/.claude/settings.json فقط، فاستعده من نسختك الاحتياطية / Time Machine / السجل المحلي للمحرر

قاعدة بيانات CC Switch نفسها هي ~/.cc-switch/cc-switch.db؛ وواجهة الجهاز هي ~/.cc-switch/settings.json. حذف الأخير يعيد ضبط الواجهة فقط؛ ولا يستعيد خطافات Claude.

نصائح عملية¶

• التسمية باللواحق: أضف لواحق مثل (asia) / (work) إلى أسماء المزوّدين بحيث يكون التبديل من شريط النظام واضحًا من النظرة الأولى.
• تحقّق من الملف، ثم افتح جلسة جديدة: اعتمد على ~/.claude/settings.json / ~/.codex/config.toml؛ فالعملية قيد التشغيل لا تعيد التحميل الساخن (الأسئلة الشائعة / #3057).
• بلا شرطة مائلة لاحقة: يشترط QCode عناوين Base URL دون / لاحقة (وإلا فستبني SDKs مسارات معطوبة على نمط //v1/...).
• أبقِ المفاتيح منفصلة: يخزّن CC Switch المفاتيح بشكل مستقل لكل مزوّد؛ تذكّر تحديث كل مفتاح عند تدوير المفاتيح.
• أنشئ نسخة احتياطية من إعدادك: منذ الإصدار v4.0، لا يستبدل التبديل سوى الحقول الأساسية ويترك عمومًا ما أضفته؛ أما في الإصدارات الأقدم، فاحرص على النسخ الاحتياطي أولًا.

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

زر «Enable» غير قابل للنقر بعد الحفظ¶

تحقّق بالترتيب: ① ألا يكون حقل نقطة النهاية فارغًا؛ ② أن يكون JSON / TOML في اللوحة صحيحًا نحويًا (فالتعديلات اليدوية هي ما يفسده في الغالب)؛ ③ جرّب إزالة / اللاحقة من Base URL (نقاط نهاية QCode لا تتطلبها. لم توثّق CC Switch معالجتها الخاصة للشرطات المائلة اللاحقة؛ وهذا الترتيب مستمد من تجربتنا).

كل طلب من Claude Code يعيد 400 على 2.1.265–2.1.267 (مخطط Artifact)¶

أصدر Claude Code 2.1.265–2.1.267 مخطط أداة Artifact ترفضه البوابات الصارمة رفضًا قاطعًا (400، Invalid schema for function 'Artifact'). منذ CC Switch 3.20.3 (2026-09-11) أصبح محرّر مزوّد Claude يتضمن مفتاح تبديل سريع «Disable Artifact Tool»، يكتب env.CLAUDE_CODE_DISABLE_ARTIFACT="1". الإصلاح الرسمي في Claude Code هو الترقية إلى ≥2.1.268؛ راجع استكشاف الأخطاء وإصلاحها. لم نعِد إنتاج كل تفاعل على جانب QCode — إذا واجهته، فافتح تذكرة مع معرّف الطلب.

خطأ 401 غير مصرّح¶

1. تأكّد من أن مفتاح API يبدأ بـ cr_ ولا يحتوي مسافات في البداية أو النهاية
2. تحقّق من أن المفتاح صالح في qcode.cc/dashboard
3. إذا أعاد Claude الرمز 401 بينما يعمل Codex (أو العكس)، فالمفتاح في أحد المزوّدين أُدخل بشكل خاطئ — يخزّن CC Switch المفاتيح بشكل مستقل لكل مزوّد

لم يكن لتبديل المزوّدين أي تأثير¶

تحقّق أولًا من أن الملف الفعلي يعرض بالفعل المزوّد الجديد. إذا تغيّر الملف، فأغلق جلسة claude / codex الحالية وافتح جلسة جديدة (الأسئلة الشائعة الرسمية؛ #3057). لا تكتفِ بالنقر على شريط النظام ومواصلة الكتابة في النافذة القديمة.

يدور Codex بلا نهاية عند بدء التشغيل¶

تحقّق من أن base_url يتبع اصطلاح نقطة نهاية QCode وينتهي عند /openai (وليس /openai/v1). يجب أن يبقى wire_api = "responses". الخطأ الأكثر شيوعًا: أن يكون model_provider في المستوى الأعلى غائبًا أو لا يطابق اسم جدول [model_providers.xxx] — عندئذٍ يعود Codex بصمت إلى نقطة نهاية openai المدمجة (توثّق المشكلة الرسمية #7263 هذا العَرَض).

هل يمكنني استخدام Claude وCodex في الوقت نفسه؟¶

نعم. يكتب CC Switch إعداد Claude إلى ~/.claude/ وإعداد Codex إلى ~/.codex/. الإعدادان مستقلان تمامًا. شغّل claude وcodex في طرفيات منفصلة حسب الحاجة.

حرّرت settings.json يدويًا — هل سيؤدي التفعيل إلى فقدانه؟¶

عمومًا لا، منذ الإصدار v4.0: يستبدل التبديل الحقول الأساسية فقط (نقطة النهاية، والمفتاح، واسم النموذج، والبروتوكول، وما إلى ذلك)؛ أما الإضافات والخطافات والأذونات ومتغيرات البيئة التي أضفتها فتبقى (الأسئلة الشائعة الرسمية في README). وقد وردت تقارير في الإصدارات السابقة لـ v4.0 عن استبدال الملف بالكامل أدى إلى إسقاط enabledPlugins / hooks (#2992، #4274)؛ وفي إصدار أقدم، انسخ احتياطيًا أولًا، واستعد من ~/.cc-switch/backups/ (بما في ذلك live-first-write/) أو من ملف .sql مُصدَّر إذا فُقد شيء.

كيف أعود إلى تسجيل الدخول الرسمي لـ Anthropic؟¶

بدّل إلى المزوّد الرسمي المدمج (Claude Official / OpenAI Official؛ أعد إضافته من الإعدادات المسبقة إذا حُذف) → «Enable» → أعد فتح CLI → نفّذ تسجيل الخروج / تسجيل الدخول الرسمي. لا تُنشئ يدويًا إعدادًا هجينًا «بيئة فارغة مع الإبقاء على مفتاح cr_».

وضع التجميع في v4.0 وعمليات الاستيراد ccswitch:// في v4.0.10 (2026-10)¶

أصدر CC Switch الإصدار v4.0.0 في 2026-10-04 والإصدار v4.0.10 في 2026-10-12 (التواريخ مأخوذة من صفحتي الإصدار: v4.0.0 وv4.0.10). كل سطر مقتبس أدناه مأخوذ حرفيًا من ملفات ملاحظات الإصدار الإنجليزية في المستودع: docs/release-notes/v4.0.0-en.md وdocs/release-notes/v4.0.10-en.md؛ وصفحتا الإصدار أعلاه مستخدمتان فقط من أجل التواريخ وتحملان النسخة الصينية. لم نختبر أي شيء في هذا القسم، ولم يُنفَّذ أي رابط استيراد.

وضع التجميع (v4.0.0)¶

يضع وضع التجميع الجديد نماذج من عدة مزوّدين في منتقي نماذج واحد في Claude Code أو Codex، بحيث يمكنك التبديل بينها مباشرة داخل العميل

أضف بعض المزوّدين، وستظهر نماذجهم معًا في منتقي النماذج في Claude Code أو Codex

أي نموذج تختاره، يذهب الطلب مباشرة إلى ذلك المزوّد، دون مغادرة العميل إطلاقًا.

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

التجميع اختياري ويدعم حاليًا Claude Code وCodex. يوجّه كل طلب حسب النموذج الذي تختاره، ولا يوفّر تجاوز الفشل.

على الشاشة، تصف الملاحظات ثلاث علامات تبويب في أعلى كل صفحة تطبيق — مباشر / توجيه / تجميع — وتشدّد على أن الضغط على علامة تبويب يغيّر فقط ما تنظر إليه؛ وإجراءات البطاقة هي إضافة وإزالة، إضافة إلى اختيار مزوّد واحد كافتراضي للطلبات التي لا تسمّي نموذجًا مجمّعًا:

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

انقر على «إضافة» أو «إزالة» في بطاقة المزوّد، ثم اختر مزوّدًا واحدًا كافتراضي لمعالجة الطلبات التي لا تسمّي نموذجًا مجمّعًا

هناك نقطتان مهمتان للاستخدام بالدفع حسب token. أولًا، تحذّر الملاحظات من أن التبديل في منتصف الجلسة ممكن، لكن على كل نموذج جديد إعادة بناء التخزين المؤقت للـ prompt الخاص به، لذا يكلّف الدور الأول بعد التبديل أكثر بشكل ملحوظ (حرفيًا: يمكنك التبديل إلى نموذج آخر في منتصف الجلسة. لاحظ أنه بعد كل تبديل، يتعيّن على النموذج الجديد إعادة بناء التخزين المؤقت للـ prompt الخاص به، لذا يكلّف الدور الأول بعد التبديل أكثر بشكل ملحوظ). على QCode، تُدرج أسعار كل نموذج على https://qcode.cc/models. ثانيًا، يؤدي تغيّر قائمة النماذج إلى ظهور رسالة تطلب إعادة التشغيل، ويمكن لمستخدمي Codex CLI إعادة تشغيل الخدمة الخلفية من ذلك الشريط:

عند تغيّر قائمة النماذج يُطلب منك إعادة تشغيل العميل، ويمكن لمستخدمي Codex CLI إعادة تشغيل الخدمة الخلفية من الشريط بنقرة واحدة

غيّر v4.0.0 أيضًا طريقة كتابة الإعدادات، وهو أمر مهم إذا كنت تحرّر الملفات يدويًا:

يؤدي تبديل المزوّدين الآن إلى استبدال الحقول الأساسية فقط بدلًا من إعادة كتابة الملف بالكامل

استيراد الرابط العميق ccswitch:// (v4.0.10)¶

تصف ملاحظات v4.0.10 نفسها بأنها إصدار الإصلاح السادس لسلسلة 4.0، ويتمحور حول روابط الاستيراد بنقرة واحدة:

إصدار الإصلاح السادس لـ 4.0 المستقر

يركّز هذا الإصدار على روابط الاستيراد بنقرة واحدة (الروابط العميقة ccswitch://)

كان السلوك الذي يجري إصلاحه هو النقر على رابط عميق بينما التطبيق غير مفتوح، وهو ما تفصّله الملاحظات:

على Windows وLinux، كان النقر على رابط استيراد بنقرة واحدة بينما CC Switch غير مفتوح يشغّل التطبيق، لكن مربع حوار تأكيد الاستيراد لم يظهر

في الوضع الخفيف كان الرابط يُفقد أيضًا عند إعادة إنشاء النافذة

على macOS كان الرابط نفسه يُظهر مربع حوار التأكيد مرتين

تُخزَّن الروابط الآن أولًا ولا تُعدّ معالَجة إلا بعد عرض مربع حوار التأكيد، لذا لا تُفقد إذا قاطع شيء ما المسار، ولا يكتب رابط أقدم يصل لاحقًا فوق رابط أحدث.

يتيح مربع حوار التأكيد الآن أيضًا خيارًا بشأن التبديل مباشرة بعد الاستيراد. تذكر الملاحظات أن هذا الخيار معطّل افتراضيًا، وأن تشغيله يعرض تحذيرًا بأن طلبات العميل ستُرسل إلى العنوان الموجود داخل الرابط (حرفيًا: يتيح لك مربع حوار التأكيد اختيار ما إذا كنت تريد التبديل مباشرة بعد الاستيراد، وهو معطّل افتراضيًا؛ وعند تشغيله، يحذّر مربع الحوار من أن طلبات العميل ستُرسل إلى العنوان الموجود في الرابط).

بخصوص تنسيقات API، تذكر الملاحظات:

تحتاج التنسيقات غير الأصلية لـ Claude Code وCodex وGrok Build إلى تشغيل التوجيه المحلي؛ ويُرفض أي مزيج لا يدعمه التطبيق عند تحليل الرابط

يعني هذا بالنسبة لك: عندما تستورد عنوان QCode إلى Claude Code أو Codex عبر رابط عميق، انظر أولًا إلى تنسيق API الذي يعلنه الرابط (anthropic / openai_chat / openai_responses / gemini_native) — يجب أن يكون التوجيه المحلي مفعّلًا مسبقًا فقط عندما لا يكون ذلك التنسيق أصليًا في التطبيق المعني (مثل openai_chat في Claude Code)؛ وتُرفض المجموعات التي لا يدعمها التطبيق وقت التحليل. أي عنوان يُستخدم على جانب QCode لم يتغيّر عن جدول نقاط النهاية أعلاه وعن نقاط النهاية ومسارات API: https://api.qcode.cc/api لـ Claude، وhttps://api.qcode.cc/openai/v1 لـ GPT والنماذج الصينية، ولا يمر Claude أبدًا عبر العنوان المتوافق مع OpenAI. نشر الإصدار نفسه أيضًا أدلة مالكي المواقع بالصينية والإنجليزية واليابانية إضافة إلى مولّد روابط عبر الإنترنت (حرفيًا: تُنشر أيضًا أدلة مالكي المواقع بالصينية والإنجليزية واليابانية ومولّد روابط عبر الإنترنت)؛ ولا تعيد هذه الصفحة إنتاج مخرجاتها.

الخطوات التالية¶

• إعداد magpie — تشغيل Claude Code / Codex عبر بوابة محلية
• تكامل WorkBuddy — المفتاح نفسه كنموذج مخصص في Tencent WorkBuddy
• درس تعليمي عن Claude Code — أتقن سير العمل الأساسي في Claude Code
• درس تعليمي عن Codex — تعمّق أكثر مع Codex CLI
• تكامل VS Code — استخدم Claude Code مباشرةً في محررك
• الوكلاء الفرعيون — نسّق الوكلاء العاملة في الخلفية باستخدام سير عمل ديناميكية
• الأتمتة وCI/CD — الوضع بلا واجهة وتكامل النصوص البرمجية
• الفوترة — افهم الخطط والحصة

أليس لديك مفتاح API لـ QCode.cc بعد؟ انتقل إلى qcode.cc/pricing لاختيار خطة — مفتاح واحد يشغّل كلاً من Claude Code وCodex CLI داخل CC Switch.

المؤسسات ←