الدليل الكامل لـ CC-Switch: تعلم إدارة تكوينات API المتعددة لـ Claude Code في 5 دقائق

استخدام Claude Code لكتابة الأكواد ممتع للغاية، لكن هل واجهة البرمجة (API) الرسمية مكلفة جداً؟ هل تريد الانتقال إلى وسيط API (Proxy) ولكنك لا تعرف كيفية تعديل ملفات الإعدادات؟ أداة CC-Switch وُجدت خصيصاً لحل هذه المشكلة. سيأخذك هذا المقال في جولة لـ إتقان تثبيت واستخدام CC-Switch خلال 5 دقائق، لتتمكن بسهولة من إدارة واجهات البرمجة الموحدة لأربعة من كبار مساعدي البرمجة بالذكاء الاصطناعي: Claude Code، وCodex، وOpenCode، وGemini CLI.

القيمة الأساسية: بقراءتك لهذا المقال، ستتعلم كيفية استخدام CC-Switch لإدارة مرئية لمزودي API متعددين، والتبديل بين الإعدادات بضغطة زر واحدة، وداعاً لتعقيدات التعديل اليدوي لملفات JSON.

ما هو CC-Switch؟ ولماذا تحتاجه؟

CC-Switch هو تطبيق مكتبي مفتوح المصدر ومتعدد المنصات، مخصص للإدارة الموحدة لتكوينات مساعدي البرمجة المعتمدين على الذكاء الاصطناعي. تم إنشاؤه من قبل المطور farion1231 وهو متاح كمشروع مفتوح المصدر على GitHub.

التوجه الأساسي لـ CC-Switch

ببساطة، يعد CC-Switch "مركز إدارة التكوين" لأدوات البرمجة المعتمدة على الذكاء الاصطناعي:

أدوات برمجة الذكاء الاصطناعي الأربعة التي يدعمها CC-Switch

🚀 البداية السريعة: يدعم CC-Switch الاتصال بالمحطات الوسيطة لجهات خارجية مثل APIYI (apiyi.com). بعد إعداد المزود (Provider)، يمكنك استخدام أدوات مثل Claude Code بتكلفة أقل، مع الاستمتاع براحة التبديل بضغطة واحدة.

شرح مفصل لميزات CC-Switch الأساسية

CC-Switch ليس مجرد مبدل للتكوينات، بل هو منصة متكاملة لإدارة أدوات الذكاء الاصطناعي:

الميزة الأولى: إدارة المزودين (Provider Management) – الوظيفة الأساسية

هذه هي الميزة الأكثر استخدامًا في CC-Switch، وتدعم:

مثال على تكوين المزود:

{
  "name": "APIYI",
  "baseUrl": "https://api.apiyi.com",
  "apiKey": "sk-your-apiyi-key",
  "models": {
    "claude-sonnet-4-20250514": "claude-sonnet-4-20250514",
    "claude-opus-4-20250514": "claude-opus-4-20250514"
  }
}

الميزة الثانية: إدارة خوادم MCP

بروتوكول سياق النموذج (MCP) هو بروتوكول توسيع لـ Claude Code. يوفر CC-Switch واجهة إدارة موحدة لـ MCP:

• يدعم ثلاثة أنواع من النقل: stdio / http / sse
• تكوين موحد عبر التطبيقات (Claude/Codex/Gemini)
• إضافة، تحرير، وحذف خوادم MCP بشكل مرئي

الميزة الثالثة: إدارة المهارات (Skills)

يمكن لـ CC-Switch اكتشاف وتثبيت مهارات Claude تلقائيًا:

• مسح تلقائي لمستودعات GitHub بحثًا عن المهارات
• تثبيت بضغطة واحدة في دليل ~/.claude/skills/
• دعم المسح المتكرر للمجلدات المتداخلة

الميزة الرابعة: إدارة موجهات النظام (System Prompts)

إنشاء إعدادات مسبقة لموجهات النظام لسيناريوهات مختلفة:

• عدد غير محدود من الإعدادات المسبقة للموجهات
• دعم ملفات CLAUDE.md، AGENTS.md، و GEMINI.md
• تبديل سريع بين أنماط العمل المختلفة

الميزة الخامسة: وكيل API محلي (v3.9.0+)

يتضمن CC-Switch خادم وكيل محلي مدمج يوفر ميزات متقدمة:

💡 نصيحة تقنية: تعمل ميزة الوكيل المحلي بشكل أفضل عند استخدامها مع APIYI (apiyi.com). يوفر APIYI واجهة متوافقة ومستقرة مع OpenAI، ويمكن لميزة تجاوز الفشل في CC-Switch التبديل تلقائيًا أثناء تقلبات الشبكة لضمان تجربة برمجة غير منقطعة.

دليل تثبيت CC-Switch

يدعم CC-Switch المنصات الثلاث الكبرى: Windows وmacOS وLinux، ويوفر طرق تثبيت متعددة.

التثبيت على Windows

الطريقة الأولى: حزمة تثبيت MSI (موصى بها)

قم بتنزيل ملف .msi من إصدارات GitHub (Releases)، وانقر عليه مرتين للتثبيت.

الطريقة الثانية: النسخة المحمولة (Portable)

قم بتنزيل نسخة .zip المحمولة، وفك الضغط عنها ثم قم بتشغيلها مباشرة دون الحاجة للتثبيت.

التثبيت على macOS

الطريقة الأولى: Homebrew (موصى بها)

brew install --cask cc-switch

الطريقة الثانية: التثبيت اليدوي

قم بتنزيل ملف .dmg أو .zip واسحبه إلى مجلد التطبيقات (Applications).

ملاحظة: عند التشغيل لأول مرة، قد تواجه تحذيرًا من Gatekeeper؛ ستحتاج إلى السماح بالتشغيل من «تفضيلات النظام ← الأمن والخصوصية».

التثبيت على Linux

يوفر CC-Switch عدة تنسيقات للحزم لنظام Linux:

التحقق من التثبيت

بعد اكتمال التثبيت، قم بتشغيل CC-Switch، ومن المفترض أن ترى الواجهة الرئيسية تعرض حالة أدوات CLI التي تم اكتشافها.

دليل الإعداد السريع لـ CC-Switch

الخطوة الأولى: إضافة مزود APIYI

1. انقر على زر 「Add Provider」 في الواجهة الرئيسية.
2. اختر 「Custom」 للإعداد المخصص.
3. قم بتعبئة المعلومات التالية:

名称: APIYI
Base URL: https://api.apiyi.com
API Key: sk-your-apiyi-key  # 从 apiyi.com 获取

4. تكوين تعيين النماذج (اختياري):

{
  "claude-sonnet-4-20250514": "claude-sonnet-4-20250514",
  "claude-opus-4-20250514": "claude-opus-4-20250514",
  "gpt-4o": "gpt-4o"
}

5. انقر على 「Save」 لحفظ الإعدادات.

الحصول على مفتاح API: قم بزيارة APIYI (apiyi.com) لتسجيل حساب والحصول على مفتاح API. توفر المنصة رصيدًا تجريبيًا مجانيًا، وتدعم النماذج الرائدة مثل Claude وGPT وGemini وغيرها من نماذج لغة كبيرة.

الخطوة الثانية: تبديل المزود (Switch Provider)

بعد حفظ الإعدادات، في قائمة المزودين (Provider List) بالواجهة الرئيسية:

1. ابحث عن مزود «APIYI» الذي أضفته للتو.
2. انقر على 「Switch」 أو انقر مباشرة على ذلك المزود.
3. سيقوم CC-Switch تلقائيًا بتعديل ملف التكوين للأداة المعنية.
4. أعد تشغيل أدوات CLI مثل Claude Code لتفعيل الإعدادات.

الخطوة الثالثة: اختبار الاتصال

استخدم ميزة اختبار السرعة في CC-Switch للتحقق من الإعدادات:

1. انقر على زر 「Test」 بجانب المزود.
2. انتظر حتى يكتمل اختبار زمن الوصول.
3. اطلع على وقت الاستجابة ومؤشر الحالة.

بعد نجاح الاختبار، افتح الجهاز (Terminal) وقم بتشغيل Claude Code:

claude

إذا تمكنت من إجراء محادثة بشكل طبيعي، فهذا يعني أن الإعداد تم بنجاح.

مثال على إعداد مبسط

{
  "id": "apiyi-provider",
  "name": "APIYI (推荐)",
  "baseUrl": "https://api.apiyi.com",
  "apiKey": "sk-your-apiyi-key",
  "enabled": true,
  "models": {
    "claude-sonnet-4-20250514": {
      "id": "claude-sonnet-4-20250514",
      "name": "Claude Sonnet 4",
      "maxTokens": 64000
    },
    "claude-opus-4-20250514": {
      "id": "claude-opus-4-20250514",
      "name": "Claude Opus 4",
      "maxTokens": 32000
    },
    "gpt-4o": {
      "id": "gpt-4o",
      "name": "GPT-4o",
      "maxTokens": 16384
    },
    "gpt-4o-mini": {
      "id": "gpt-4o-mini",
      "name": "GPT-4o Mini",
      "maxTokens": 16384
    }
  },
  "healthCheck": {
    "enabled": true,
    "interval": 60
  }
}

مميزات CC-Switch المتقدمة

استراتيجية إدارة مزودي الخدمة المتعددين (Providers)

يدعم CC-Switch تكوين عدة مزودين (Providers)، مما يتيح استراتيجيات استخدام مرنة:

┌─────────────────────────────────────────────────┐
│              قائمة مزودي CC-Switch               │
├─────────────────────────────────────────────────┤
│  ⭐ APIYI (أساسي)      التأخير: 120ms   ✓ سليم    │
│  📦 OpenRouter (احتياطي) التأخير: 280ms   ✓ سليم    │
│  🏢 Claude الرسمي (نهائي) التأخير: 350ms   ✓ سليم    │
└─────────────────────────────────────────────────┘

الإعدادات الموصى بها:

• الأساسي: APIYI – سعر مميز ووصول سريع محلياً.
• الاحتياطي: OpenRouter – نماذج متنوعة واستقرار عالٍ من الخارج.
• خيار الأمان: تسجيل الدخول الرسمي – لضمان بقاء الخدمة متاحة دائماً.

تكوين المزامنة السحابية

يدعم CC-Switch مزامنة الإعدادات مع التخزين السحابي:

1. افتح Settings ← Storage
2. اختر مجلد المزامنة السحابية (Dropbox، OneDrive، iCloud Drive)
3. سيقوم CC-Switch تلقائياً بمزامنة تكوينات المزودين (Provider)

بهذه الطريقة، يمكنك مشاركة نفس إعدادات واجهة البرمجية (API) بين أجهزة متعددة.

الإعدادات المتقدمة للوكيل المحلي (Local Proxy)

عند تفعيل الوكيل المحلي، سيقوم CC-Switch بـ:

1. تشغيل خادم وكيل (Proxy server) على جهازك.
2. تعديل تكوينات واجهة سطر الأوامر (CLI) تلقائياً لتشير إلى الوكيل المحلي.
3. يقوم خادم الوكيل بتوجيه الطلبات إلى المزود الفعلي.

المزايا:

• تمر جميع الطلبات عبر مدخل موحد، مما يسهل المراقبة.
• تجاوز الفشل تلقائياً؛ إذا تعطل أحد المزودين، يتم التبديل تلقائياً.
• تسجيل سجلات الطلبات (Logs) لتسهيل استكشاف الأخطاء وإصلاحها.

# تدفق الطلب في وضع الوكيل
Claude Code ← localhost:8080 ← وكيل CC-Switch ← APIYI ← Claude API

ميزة Claude Rectifier

تمت إضافة ميزة Claude Rectifier في الإصدار v3.10.0 لإصلاح مشاكل التوافق مع واجهات البرمجية (APIs) التابعة لجهات خارجية:

• إصلاح تنسيق "توقيع التفكير" (thinking signature) تلقائياً.
• تحسين التوافق مع واجهات البرمجية غير الرسمية.
• تقليل أخطاء "خطأ في التنسيق" (format error).

الأسئلة الشائعة حول CC-Switch

# الطريقة الأولى: أغلق الطرفية (Terminal) الحالية وأعد فتحها
# الطريقة الثانية: اكتب /exit داخل Claude Code للخروج ثم أعد التشغيل
claude  # أعد التشغيل

# حذف الإعدادات المخصصة واستعادة الوضع الرسمي
rm ~/.claude/settings.json
claude  # أعد تسجيل الدخول للحساب الرسمي

مقارنة بين CC-Switch والتهيئة اليدوية

🎯 نصيحة الاختيار: إذا كنت بحاجة للتنقل بشكل متكرر بين عدة مزودي API، أو تستخدم أدوات برمجة AI متعددة في وقت واحد، فإن CC-Switch سيزيد من كفاءتك بشكل كبير. وبالاستخدام مع APIYI apiyi.com، ستحصل على أفضل تجربة تجمع بين التكلفة المنخفضة والسهولة العالية.

مقارنة بين الأدوات المتعلقة بـ CC-Switch

بالإضافة إلى CC-Switch، هناك بعض الأدوات المشابهة:

التشكيلة الموصى بها: CC-Switch (لإدارة الإعدادات) + APIYI (لوساطة الـ API) = الحل الأفضل من حيث القيمة مقابل السعر.

المراجع

الملخص

تُعد CC-Switch أداة قوية لإدارة تكوينات مساعدي البرمجة المعتمدين على الذكاء الاصطناعي، حيث تعالج نقاط الضعف التالية:

1. تعقيد التكوين: واجهة مرئية تغنيك عن التحرير اليدوي لملفات JSON.
2. صعوبة التنقل: التبديل بين عدة مزودين (Providers) بنقرة واحدة.
3. تشتت الأدوات: إدارة موحدة لكل من Claude Code، وCodex، وOpenCode، وGemini CLI.
4. غياب اختبار السرعة: اختبار مدمج لزمن الاستجابة (Latency) لمساعدتك في اختيار أسرع مزود.
5. فقدان الإعدادات: نسخ احتياطي تلقائي ومزامنة سحابية تضمن عدم ضياع إعداداتك أبداً.

بالنسبة للمطورين الذين يستخدمون أدوات البرمجة بالذكاء الاصطناعي بشكل متكرر، فإن الجمع بين CC-Switch و APIYI هو الحل الموصى به:

• CC-Switch: توفر إدارة سهلة ومريحة للتكوينات.
• APIYI apiyi.com: توفر خدمات API مستقرة وبأسعار تنافسية.

تفضل بزيارة APIYI apiyi.com لتسجيل حساب والحصول على مفتاح API الخاص بك، ثم قم بإضافة المزود (Provider) في CC-Switch للبدء في الاستمتاع بتجربة برمجة سلسة ومدعومة بالذكاء الاصطناعي.

📝 المؤلف: الفريق التقني لـ APIYI | APIYI apiyi.com – لتبسيط استدعاء واجهات برمجة تطبيقات الذكاء الاصطناعي (AI API).