CC Switch CLI (cc-switch-cli): التثبيت والتبديل على خادم
اعتبارًا من 2026-10-26، يُعدّ CC Switch CLI (cc-switch-cli) إصدار سطر أوامر يحتفظ به المجتمع وليس منتجًا رسميًا من CC Switch؛ أحدث إصدار هو v5.11.3 (2026-10-22)، ويعيد التوافق مع مخطّطات قاعدة البيانات 21 و22. يوضّح README الرسمي أن CC Switch نفسه يُوزّع فقط كتطبيق سطح مكتب يحتاج إلى واجهة رسومية، ويوصي بهذا CLI للخوادم وجلسات SSH والأجهزة التي لا يتوفر فيها سطح مكتب. وهو نسخة CLI متفرعة من CC Switch، أصدرها مؤلف آخر بشكل منفصل. يعتمد التثبيت والتبديل ومجلد البيانات المشترك أدناه على README مشروع CLI؛ وتعتمد حقول QCode على وثائق QCode.
آخر تحديث 2026-11-14
وجّه هذه الأداة إلى نقطة نهاية QCode — مفتاح واحد لـ Claude وGPT والنماذج الصينية.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
ما هو، كيفية التثبيت، كيفية التبديل، v5.11.3، حقول QCode
ليس منتجًا رسميًا من CC Switch
هو نسخة CLI متفرعة من CC Switch، أصدرها مؤلف آخر بشكل منفصل وليست منتجًا رسميًا من CC Switch؛ ويوصي به README الرسمي للخوادم وجلسات SSH والأجهزة التي لا يتوفر فيها سطح مكتب.
طريقتان للتثبيت
التثبيت السريع في README ذلك المشروع هو curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash، وهو يضع الملف الثنائي في ~/.local/bin؛ ويوثّق README أيضًا Homebrew عبر brew install cc-switch-cli.
العرض والتبديل
الاستخدام الأساسي المذكور في README ذلك المشروع: يفتح cc-switch واجهة الطرفية بملء الشاشة؛ ويسرد cc-switch provider list الإدخالات المحفوظة؛ وينفّذ cc-switch provider switch (id) التبديل؛ وcc-switch use (id) هو اختصار لذلك؛ ويحدّد cc-switch --app codex provider list الأداة باستخدام --app، والافتراضي هو claude.
مجلد البيانات المشترك مع تطبيق سطح المكتب
تذكر وثائق QCode أن هذا CLI يتشارك مجلد البيانات ~/.cc-switch مع تطبيق سطح المكتب افتراضيًا؛ وقد يتأخر إصدار قاعدة البيانات الذي يدعمه أحيانًا عن تطبيق سطح المكتب، لذا عندما يتبيّن أن إصدار قاعدة البيانات أحدث من اللازم، فقم بترقية CLI أو انتظر حتى يلحق بتطبيق سطح المكتب.
متى يكون إصدار سطر الأوامر مناسبًا
على الخوادم وجلسات SSH والحاويات، حيث لا يوجد سطح مكتب، لا يُعدّ تطبيق سطح المكتب خيارًا، وهنا يناسب إصدار سطر الأوامر. ويذكر README المشروع نفسه أنه يوفّر واجهة طرفية بملء الشاشة وسطر أوامر قابلًا للبرمجة النصية.
التوصية الرسمية وأحدث إصدار: v5.11.3
يجيب README الرسمي لـ CC Switch عن سؤال «هل يوجد إصدار من سطر الأوامر أو بلا واجهة؟» بالتوصية بـ CC Switch CLI الذي يحتفظ به المجتمع. أحدث إصدار هو v5.11.3 (2026-10-22)، ويعيد التوافق مع مخطّطَي قاعدة البيانات 21 و22 من أجل بدء التشغيل المحلي ومزامنة WebDAV؛ أما الإصدار السابق v5.11.2 فقد نُشر في 2026-10-16. وتُعلَّم صفحة وثائق QCode عن CC Switch على أنها محدّثة في 2026-10-20، وسجّل قسم CLI فيها الإصدار v5.11.1 من README بتاريخ 2026-10-15.
الخط الزمني
صدر CC Switch v4.0.12 لتطبيق سطح المكتب؛ وتذكر صفحة وثائق QCode أن قسمَي التنزيل وسطر الأوامر قد تم التحقق منهما مقابل README وReleases في 2026-10-15.
التاريخ المثبت على صفحة وثائق QCode حول CC Switch؛ وتذكر الصفحة أنه لا توجد نسخة رسمية لسطر الأوامر، وأن CLI المجتمعي يُوصى به للخوادم وSSH، وأن دليل البيانات ~/.cc-switch مشترك افتراضيًا.
أصدر مشروع CLI الإصدار v5.11.3 (2026-10-22): يعيد نص الإصدار التوافق مع مخططي قاعدة البيانات 21 و22. أصدر مشروع CLI المجتمعي الإصدار v5.11.2؛ وتعرض صفحة الإصدار الوسم v5.11.2 والطابع الزمني للنشر 2026-10-16T13:51:51Z. وسجلت صفحة وثائق QCode الإصدار v5.11.1 عند فحصها في 2026-10-15.
ما له مصدر، وما ليس له مصدر
مستند إلى مصدر
① يذكر README الرسمي أن CC Switch يتوفر فقط كتطبيق سطح مكتب يحتاج إلى واجهة رسومية. ② وللخوادم أو جلسات SSH أو الأجهزة بلا سطح مكتب، يوصي بـ CC Switch CLI الذي يصونه المجتمع؛ ووفقًا لـ README مشروع CLI ووثائق QCode، فهو نسخة CLI متفرعة من CC Switch، أصدره مؤلف آخر بشكل منفصل وليس منتجًا رسميًا لـ CC Switch. ③ يعرض README المشروع طريقتين للتثبيت: سكربت التثبيت وHomebrew. ④ يغطي الاستخدام الأساسي فتح واجهة الطرفية بملء الشاشة، وعرض القائمة، والتبديل، والاختصار الخاص بالتبديل، واختيار الأداة عبر --app، وتشغيل جلسة واحدة بمدخل معين فقط. ⑤ افتراضيًا، يكون دليل البيانات ~/.cc-switch مشتركًا مع تطبيق سطح المكتب، وتقع البيانات الأساسية في ~/.cc-switch/cc-switch.db؛ وينقل CC_SWITCH_CONFIG_DIR دليل البيانات إلى مكان آخر. ⑥ تتبع حقول QCode وثائق QCode: ANTHROPIC_BASE_URL وANTHROPIC_AUTH_TOKEN لـ Claude، وBase URL ومفتاح API لـ Codex. ⑦ أحدث إصدار هو v5.11.3 (2026-10-22)، ويعيد نص إصداره التوافق مع مخططي قاعدة البيانات 21 و22؛ وصفحة وثائق QCode محددة كمحدثة في 2026-10-20.
ما لم تذكره الوثائق الرسمية أو المشروع
① لا توجد مقارنة رسمية ميزة بميزة بين نسخة سطر الأوامر وتطبيق سطح المكتب، وتذكر وثائق QCode أن CLI المجتمعي لم يُختبر ميزة بميزة. ② لا يصف README المشروع كيف يرتبط إصدار قاعدة بياناته بتطبيق سطح المكتب؛ ولا يقول إصدار v5.11.3 سوى إنه يعيد التوافق مع المخططين 21 و22. ③ لا يذكر أي من الطرفين جميع الشروط الدقيقة التي تظهر عندها عبارة «إصدار قاعدة البيانات أحدث من اللازم». ④ لا يذكر أي من الطرفين التبعيات التي يحتاجها CLI داخل صورة حاوية.
نسخة سطر الأوامر وتطبيق سطح المكتب
تطبيق سطح المكتب (الرسمي)
تسرد صفحة وثائق QCode طرق تثبيت تطبيق سطح المكتب على أنها مثبتات كل نظام وأوامر مديري الحزم؛ وما تحصل عليه في النهاية هو تطبيق ذو واجهة رسومية.
نسخة سطر الأوامر (تفرّع مجتمعي)
يوفر المشروع المجتمعي واجهة طرفية بملء الشاشة وسطر أوامر قابلًا للاستخدام في السكربتات؛ وعندما تتباعد النسختان، يفيد CLI بأن إصدار قاعدة البيانات أحدث من اللازم.
التثبيت والتبديل والتحقق من الإصدارات على خادم
① التثبيت: اتبع README المشروع ونفّذ curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash، الذي يثبت في ~/.local/bin، أو استخدم Homebrew عبر brew install cc-switch-cli. ② إضافة مدخل: cc-switch provider add، مع الحقول المأخوذة من وثائق QCode. ③ التبديل: cc-switch provider switch (id) (الصيغة المختصرة cc-switch use (id))؛ لاستخدام مدخل معين لعملية تشغيل واحدة فقط، نفّذ cc-switch start claude (id) — يذكر README أن هذا يؤثر فقط في الجلسة التي يبدأها ذلك الأمر، بينما لا يزال provider switch وuse يغيّران المدخل العام. ④ دليل البيانات والتحديثات: تقع البيانات الأساسية افتراضيًا في ~/.cc-switch/cc-switch.db ويوجّه CC_SWITCH_CONFIG_DIR دليل البيانات إلى مكان آخر (يذكر README أن البيانات الموجودة تحت ~/.cc-switch لا تُنقل تلقائيًا)؛ ويذكر README أن عمليات تثبيت Homebrew ينبغي تحديثها عبر brew upgrade cc-switch-cli. ⑤ الإصدارات والتحديثات: اعتبارًا من 2026-10-26، أحدث إصدار هو v5.11.3 (2026-10-22)؛ ويعيد نص إصداره التوافق مع مخططي قاعدة البيانات 21 و22، ويُحدَّث تثبيت Homebrew عبر brew upgrade cc-switch-cli.
على QCode
وفقًا لصفحة وثائق QCode عن CC Switch: بالنسبة إلى Claude، أدخل ANTHROPIC_BASE_URL https://api.qcode.cc/api وANTHROPIC_AUTH_TOKEN (مفتاح يبدأ بـ cr_)؛ وبالنسبة إلى Codex، أدخل Base URL https://api.qcode.cc/openai ومفتاح API؛ يكتب CC Switch الإعدادات في ~/.claude/settings.json و~/.codex/config.toml. تفرض QCode رسومًا عن كل token؛ وتُدرج أسعار كل نموذج على qcode.cc/models. لإبقاء Claude Code أو Codex قيد التشغيل على خادم، يمكنك استخدام خوادم QCode السحابية: ضع الجهاز في الخارج، وثبّت Claude Code / Codex عليه، واستدعِ النماذج باستخدام مفتاح QCode الخاص بك؛ تشترك خدمة الذكاء الاصطناعي والخوادم السحابية في رصيد واحد (qcode.cc/en/cloud).
الأسئلة الشائعة
هل توجد نسخة CLI رسمية من CC Switch؟
لا. يوضح README الرسمي أن CC Switch يُوزّع فقط كتطبيق سطح مكتب يحتاج إلى واجهة رسومية؛ وللخوادم أو جلسات SSH أو الأجهزة التي لا تحتوي على سطح مكتب، يوصي بـ CC Switch CLI الذي يصونه المجتمع (وفقًا لـ README الخاص بمشروع CLI ووثائق QCode، فإنه ليس منتجًا رسميًا من CC Switch). يورد README الرسمي أيضًا دعم Claude Code وCodex وGemini CLI وOpenCode وOpenClaw وHermes وPi، مع Homebrew وسكربت تثبيت كطريقتي التثبيت.
كيف أثبّته على خادم؟
يقدّم README الخاص بالمشروع طريقتين: Homebrew عبر brew install cc-switch-cli، أو curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash، الذي يثبّت في ~/.local/bin. يغطي README أيضًا تنزيل الأرشيف المناسب لمنصتك ووضعه على PATH، وبناء Linux هو البناء الثابت الخاص بـ musl.
كيف أنتقل إلى إدخال آخر؟
يوضح الاستخدام الأساسي في README الخاص بالمشروع: يسرد cc-switch provider list الإدخالات المحفوظة؛ ويبدّل cc-switch provider switch (id) بينها؛ وcc-switch use (id) هو اختصار لذلك؛ ويختار cc-switch --app codex provider list الأداة عبر --app، والافتراضي هو claude. لاستخدام إدخال معيّن لمرة تشغيل واحدة فقط، شغّل cc-switch start claude (id).
ماذا أفعل بشأن «database version is too new»؟
تذكر الأسئلة الشائعة في README الرسمي ووثائق QCode أن هذا CLI يشترك افتراضيًا في دليل البيانات ~/.cc-switch مع تطبيق سطح المكتب، وأن إصدار قاعدة البيانات الذي يدعمه يتأخر أحيانًا عن تطبيق سطح المكتب — في هذه الحالة حدّث CLI أو انتظر حتى يلحق به. اعتبارًا من 2026-10-26، يعيد الإصدار v5.11.3 (2026-10-22) التوافق مع مخططي قاعدة البيانات 21 و22؛ وإذا أبلغ بدء التشغيل عن أن 21 أو 22 غير مدعوم، فحدّث إلى v5.11.3.
ما الحقول التي أدخلها لـ QCode؟
اتبع صفحة وثائق QCode عن CC Switch: بالنسبة إلى Claude، تكون ANTHROPIC_BASE_URL هي https://api.qcode.cc/api ويأخذ ANTHROPIC_AUTH_TOKEN المفتاح الذي يبدأ بـ cr_؛ وبالنسبة إلى Codex، تكون Base URL هي https://api.qcode.cc/openai ويأخذ API Key المفتاح نفسه. يكتب CC Switch هذه القيم في ~/.claude/settings.json و~/.codex/config.toml. تأتي أسماء هذه الحقول من وثائق QCode، التي تصف تطبيق سطح المكتب وتذكر أن CLI المجتمعي لم يُختبر ميزة بميزة؛ عند تشغيل cc-switch provider add، اتبع prompts التي تظهر فعليًا.
هل توجد حزمة باسم cc-switch-cli على npm؟
توجد واحدة، لكنها ليست الشيء نفسه الذي يشير إليه المشروع في README: الحزمة بهذا الاسم على سجل npm مشرفها jacob.shi، وأحدث إصدار لها هو 1.0.1 ونُشر في 2026-04-26؛ أما المشروع الذي يشير إليه README الرسمي فهو برنامج ثنائي مكتوب بـ Rust، واسم أمره cc-switch، ولا يتضمن README الخاص به تثبيتًا عبر npm. ثبّت بناء Homebrew أو سكربت التثبيت كما يوضح README.
المصادر
README وreleases/latest لمشروع CC Switch CLI المجتمعي (الوسم v5.11.2، نُشر في 2026-10-16، وجُلب وفُحص في 2026-10-20)؛ وصفحة وثائق QCode عن CC Switch (حُدّثت في 2026-10-15، وفُحصت في 2026-10-20)؛ وبيانات السجل الوصفية لحزمة npm بالاسم نفسه (فُحصت في 2026-10-20). أُعيد الفحص في 2026-10-26 مقابل v5.11.3 (2026-10-22) وصياغة README الرسمي الحالية.
اربط Claude Code بـ QCode على خادمك
تُحتسب الفاتورة لكل token؛ وتُدرج أسعار كل نموذج على qcode.cc/models.
قراءات ذات صلة
باقات الدفع حسب الاستخدام من Claude Code: بلا اشتراك، 7 أيام
باقات حصة لمرة واحدة صالحة لمدة 7 أيام، بلا اشتراك؛ وتُضاف الباقات الإضافية إلى المفتاح نفسه.
magpie مقابل CC Switch: بوابة محلية أم مبدّل إعدادات (2026-10-27)
فُحص في 2026-10-27: كيف يختلف الاثنان في التشغيل والعملاء وترجمة البروتوكول والتجاوز عند الفشل وإخفاء الخصوصية والترخيص، وكيف يتصل كل منهما بـ QCode.
CC Switch 4.0: التجميع، والروابط العميقة، وCLI (أكتوبر 2026)
يقسّم 4.0 المباشر والتوجيه والتجميع إلى ثلاث علامات تبويب، ويشير إلى أن README الرسمي لا يحتوي على نسخة سطر أوامر.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
تم التحقق من محتوى هذه الصفحة في 2026-10-20 ومرة أخرى في 2026-10-26 مقابل README وإصدارات مشروع CC Switch CLI المجتمعي، وREADME الرسمي لـ CC Switch، ووثائق QCode؛ ويُصان هذا المشروع من قبل المجتمع ويُصدر بشكل مستقل، لذا قد تتغير الإصدارات والميزات في أي وقت — اقرأ README الخاص به قبل التثبيت. تتبع حقول إعداد QCode وثائق QCode، وتُدرج إتاحة النماذج على /models.