CC-Switch دليل كامل لإضافة مزود: دليل تهيئة من 4 خطوات باستخدام APIYI كمثال

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

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

التحضيرات قبل إضافة مزود خدمة إلى CC-Switch

قبل البدء في الإعداد، ستحتاج إلى تجهيز المتطلبات التالية:

قائمة المتطلبات الأساسية

تسجيل حساب في APIYI

إذا لم يكن لديك حساب في APIYI بعد، فاتبع الخطوات التالية للتسجيل:

1. قم بزيارة الموقع الرسمي لـ APIYI: apiyi.com
2. انقر على "تسجيل" (Register) وأكمل عملية إنشاء الحساب.
3. ادخل إلى لوحة التحكم للحصول على مفتاح API Key.
4. قم بتدوين المعلومات التالية:
   • API Key: سلسلة مفاتيح تبدأ بـ sk-
   • Base URL: https://api.apiyi.com

🚀 ميزة للمستخدمين الجدد: يقدم موقع APIYI (apiyi.com) رصيد اختبار مجاني عند التسجيل، ويدعم النماذج الرائدة مثل Claude وGPT وGemini، مما يتيح لك التجربة قبل اتخاذ قرار الشحن.

التحقق من تضارب متغيرات البيئة

هام: إذا قمت سابقاً بتعيين مفتاح API Key في متغيرات بيئة النظام، فقد يؤدي ذلك إلى تجاوز إعدادات CC-Switch.

تحقق من متغيرات البيئة المتضاربة وقم بتنظيفها:

macOS/Linux:

# التحقق من وجود متغيرات متضاربة
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_AUTH_TOKEN
echo $OPENAI_API_KEY

# إذا ظهرت لها قيم، يجب حذفها من ملف ~/.zshrc أو ~/.bashrc

Windows:

• افتح "خصائص النظام ← خيارات متقدمة ← متغيرات البيئة" (System Properties → Advanced → Environment Variables).
• ابحث عن المتغيرات مثل ANTHROPIC_API_KEY و OPENAI_API_KEY وقم بحذفها.

خطوات إضافة مزود خدمة في CC-Switch

الخطوة الأولى: فتح واجهة إضافة المزود

1. قم بتشغيل تطبيق CC-Switch.
2. ابحث عن زر "Add Provider" (إضافة مزود) في الواجهة الرئيسية (عادة ما يكون فوق قائمة المزودين).
3. انقر فوق الزر لتظهر لك نافذة إعدادات المزود.

الخطوة الثانية: اختيار طريقة الإعداد

يوفر CC-Switch طريقتين للإضافة:

بما أن APIYI هو مزود طرف ثالث، فسنختار "Custom" (إعداد مخصص).

الخطوة الثالثة: ملء معلومات إعدادات المزود

هذه هي الخطوة الأكثر أهمية، حيث يجب تعبئة الحقول التالية بدقة:

المعلومات الأساسية

إعدادات Claude Code (في حال الاستخدام)

يدعم CC-Switch تعبئة الحقول التالية لـ Claude Code:

إعدادات تعيين النماذج (اختياري)

إذا كنت بحاجة إلى تحديد نموذج افتراضي، يمكنك تهيئة ما يلي:

مثال على الإعدادات الكاملة

فيما يلي مثال لإعداد كامل لإضافة APIYI كمزود خدمة:

# المعلومات الأساسية
Name: APIYI
Base URL: https://api.apiyi.com

# إعدادات Claude Code
ANTHROPIC_AUTH_TOKEN: sk-your-apiyi-key
ANTHROPIC_BASE_URL: https://api.apiyi.com

# إعدادات النماذج (اختياري)
ANTHROPIC_MODEL: claude-sonnet-4-20250514

{
  "name": "APIYI",
  "baseUrl": "https://api.apiyi.com",
  "claude": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-apiyi-key",
    "ANTHROPIC_API_KEY": "sk-your-apiyi-key",
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-20250514"
  },
  "codex": {
    "OPENAI_API_KEY": "sk-your-apiyi-key",
    "OPENAI_BASE_URL": "https://api.apiyi.com/v1"
  },
  "gemini": {
    "GEMINI_API_KEY": "sk-your-apiyi-key",
    "GOOGLE_GEMINI_BASE_URL": "https://api.apiyi.com/v1"
  }
}

الخطوة الرابعة: حفظ الإعدادات

1. تأكد من اكتمال جميع الحقول المطلوبة.
2. انقر على زر "Save" (حفظ) أو "تأكيد".
3. سيقوم CC-Switch بالتحقق من تنسيق الإعدادات.
4. بعد الحفظ بنجاح، سيظهر المزود الجديد في القائمة.

💡 تلميح للإعداد: الواجهات التي يوفرها APIYI (apiyi.com) متوافقة تماماً مع تنسيقات OpenAI و Anthropic، لذا يكفي إدخال https://api.apiyi.com كعنوان أساسي (Base URL) دون الحاجة لإضافة لاحقة /v1 (حيث سيتعامل CC-Switch مع ذلك تلقائياً).

3 طرق لتبديل المزودين في CC-Switch

بعد الانتهاء من الإضافة، تحتاج إلى التبديل إلى المزود الجديد ليدخل حيز التنفيذ. يوفر CC-Switch 3 طرق للتبديل:

الطريقة الأولى: التبديل من الواجهة الرئيسية (موصى بها للمبتدئين)

هذه هي الطريقة الأكثر وضوحاً:

1. في قائمة المزودين بواجهة CC-Switch الرئيسية.
2. ابحث عن 「APIYI」 الذي أضفته للتو.
3. انقر فوق زر 「Enable」 أو 「تفعيل」 الموجود على يمين هذا المزود.
4. عندما تتغير الحالة إلى Active، فهذا يعني نجاح التبديل.

┌─────────────────────────────────────────────────┐
│               قائمة مزودي CC-Switch              │
├─────────────────────────────────────────────────┤
│  ○ Official Login          [Enable]             │
│  ● APIYI (نشط)             [Disable] [Test]    │  ← مفعل حالياً
│  ○ OpenRouter              [Enable]             │
└─────────────────────────────────────────────────┘

الطريقة الثانية: التبديل من علبة النظام (موصى بها للمستخدمين المتمرسين)

طريقة أسرع، لا تتطلب فتح النافذة الرئيسية:

1. ابحث عن أيقونة CC-Switch في علبة النظام (System Tray) (أسفل يمين الشاشة في Windows / شريط القوائم في macOS).
2. انقر فوق الأيقونة لتوسيع القائمة.
3. انقر مباشرة على اسم المزود 「APIYI」.
4. يدخل حيز التنفيذ فوراً، دون الحاجة لتأكيد إضافي.

الميزة: هذه الطريقة هي الأسرع، ومناسبة جداً للحالات التي تتطلب تبديلاً متكرراً بين المزودين.

الطريقة الثالثة: التخصيص حسب التطبيق

إذا كنت تستخدم أدوات CLI متعددة في وقت واحد، يمكنك تعيين مزودين مختلفين لكل تطبيق:

في CC-Switch، يمكن لكل تطبيق تكوين المزود الخاص به بشكل مستقل.

طريقة تفعيل المورد في CC-Switch

هام: بعد تبديل المورد، لن تدخل الإعدادات حيز التنفيذ في أدوات CLI فوراً، بل يتطلب الأمر إعادة تشغيل التطبيق المقابل.

خطوات التفعيل

التحقق من تفعيل الإعدادات

بعد إعادة التشغيل، يمكنك التحقق عبر الطرق التالية:

الطريقة الأولى: اختبار الحوار المباشر

claude
# أدخل سؤالاً بسيطاً، إذا تمت الإجابة بشكل طبيعي فهذا يعني نجاح الإعداد
> Hello, 请用中文回复

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

1. انقر على زر 「Test」 بجانب المورد.
2. تحقق من التأخير (Latency) والحالة.
3. ظهور علامة ✓ خضراء يعني أن الاتصال سليم.

الطريقة الثالثة: فحص ملف الإعدادات

# ملف إعدادات Claude Code
cat ~/.claude/settings.json

# يجب أن ترى محتوى مشابهاً لهذا:
# "apiBaseUrl": "https://api.apiyi.com"

🎯 نصيحة للتحقق: يمكنك الاطلاع على سجلات استدعاء الـ API من خلال لوحة تحكم APIYI apiyi.com؛ فإذا وجدت سجلات لطلبات جديدة، فهذا يعني أن الإعدادات قد فُعلت بنجاح.

استعادة تسجيل الدخول الرسمي عبر CC-Switch

إذا كنت بحاجة للعودة إلى الخدمات الرسمية، يوفر CC-Switch ميزة استعادة الخدمة الرسمية بنقرة واحدة.

استعادة تسجيل الدخول الرسمي لـ Claude Code

1. ابحث عن الإعداد المسبق 「Official Login」 في قائمة موردي CC-Switch.
2. انقر على 「Enable」 للتبديل إلى الوضع الرسمي.
3. أعد تشغيل الطرفية وشغل claude.
4. اتبع إجراءات تسجيل الدخول الرسمية لـ Claude Code (مصادقة OAuth).

استعادة تسجيل الدخول الرسمي لـ Codex

1. اختر الإعداد المسبق 「Official Login」 (نسخة Codex).
2. انقر على تفعيل.
3. بعد إعادة التشغيل، شغل codex.
4. اتبع المطالبات لإكمال المصادقة الرسمية من OpenAI.

استعادة تسجيل الدخول الرسمي لـ Gemini CLI

1. اختر الإعداد المسبق 「Google Official」.
2. انقر على تفعيل.
3. بعد إعادة التشغيل، شغل gemini.
4. اتبع المطالبات لإكمال إجراءات Google OAuth.

ملخص عملية الاستعادة

ملاحظة: بعد استعادة تسجيل الدخول الرسمي، سيقوم CC-Switch تلقائياً بعمل نسخة احتياطية من إعداداتك المخصصة. عند العودة إلى مورد خارجي في المرة القادمة، ستظل إعداداتك السابقة محفوظة كما هي.

نصائح متقدمة لإدارة الموردين في CC-Switch

النصيحة 1: مقارنة سرعة الموردين

بعد إضافة عدة موردين، يمكنك اختبار السرعة بشكل جماعي لاختيار الأسرع بينهم:

1. انقر بالتتابع على زر 「Test」 الخاص بكل مورد.
2. سجل قيم التأخير (latency) لكل مورد.
3. اختر المورد صاحب أقل تأخير ليكون المورد الأساسي.

معايير المرجعية:

النصيحة 2: نسخ المورد

إذا كنت بحاجة إلى إنشاء مورد بإعدادات مشابهة لمورد موجود:

1. اختر المورد الحالي.
2. انقر على 「Duplicate」 أو اختر "نسخ" من القائمة بالضغط على الزر الأيمن للماوس.
3. قم بتعديل الاسم وبعض الإعدادات.
4. احفظه كمورد جديد.

النصيحة 3: النسخ الاحتياطي والمزامنة للإعدادات

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

1. افتح Settings ← Storage.
2. اختر مجلد المزامنة السحابية (مثل Dropbox أو OneDrive).
3. سيتم مزامنة جميع إعدادات الموردين تلقائياً.

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

النصيحة 4: مشاركة إعدادات المورد

الإصدار v3.9.0 فما فوق يدعم ميزة "المورد المشترك":

• يمكن تطبيق إعدادات مورد واحد على تطبيقات Claude و Codex و Gemini في نفس الوقت.
• مثالي عند استخدام بوابات تدعم بروتوكولات متعددة مثل APIYI.
• عند إضافة مورد، قم بتحديد خيار "Sync to all apps".

الأسئلة الشائعة حول إضافة الموردين في CC-Switch

جدول مرجعي سريع لتكوين مزود الخدمة APIYI

لتسهيل التكوين السريع، قمنا بتنظيم المعلمات الكاملة لـ APIYI هنا:

الخلاصة

من خلال هذا البرنامج التعليمي، تعلمت العملية الكاملة لإدارة مزودي الخدمة في CC-Switch:

1. إضافة مزود خدمة: انقر على Add Provider ← اختر Custom ← املأ الإعدادات ← حفظ
2. تبديل مزود الخدمة: انقر على Enable في الواجهة الرئيسية أو انقر مباشرة على اسم مزود الخدمة في شريط النظام
3. تفعيل التغييرات: أعد تشغيل الطرفية (Terminal) أو عميل CLI المقابل
4. العودة للوضع الرسمي: اختر الإعداد المسبق Official Login ← أعد التشغيل ← أكمل عملية OAuth

إن الجمع بين CC-Switch و APIYI يجعل إدارة واجهات البرمجية (API) بسيطة للغاية:

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

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

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