تخطَّ إلى المحتوى
موارد المطورين
موارد المطورين

مفتاح CC

ثبّت CC Switch، أضف RunAPI Claude Code Provider، واختر نموذجاً، وتحقق من الاتصال.

عرض Markdown

نظرة عامة

CC Switch هو تطبيق سطح مكتب لإدارة مزوّدي أدوات البرمجة. يربط هذا الدليل موفّر Claude Code الخاص به بـ RunAPI دون الحاجة إلى تعديل ملف الـ shell profile أو ملفات المشروع يدوياً.

قبل البدء

  • ثبّت Claude Code وسجّل الدخول إلى حساب RunAPI الخاص بك.
  • أنشئ مفتاح API قياسياً وفق دليل المصادقة. احتفظ به في CC Switch ولا تضفه إلى نظام التحكم في الإصدار.
  • استخدم معرّف نموذج RunAPI المتاح عبر هذا الاتصال. يمكنك اختيار معرّف من CC Switch أو نسخه من كتالوج النماذج.

التثبيت

حمّل CC Switch من الإصدارات الرسمية لنظام Windows أو macOS أو Linux. على macOS باستخدام Homebrew، ثبّته بالأمر:

SHELL 
brew install --cask cc-switch

افتح CC Switch بعد التثبيت وحدد Claude Code في محوِّل التطبيقات.

إعداد RunAPI

  1. حدد إضافة موفر، ثم اختر الإعداد المسبق Custom.
  2. سمِّ الموفر RunAPI وأدخل مفتاح API وBase URL في محرر التكوين الخاص به:
JSON 
{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_BASE_URL": "https://runapi.ai"
  }
}

مفتاح API أعلاه هو عنصر نائب. أنشئ مفتاحك الفعلي وقم بتدويره من خلال دليل المصادقة.

اختر نموذجاً

  1. استخدم Fetch Models فقط لاكتشاف المرشحين. إن لم يكن النموذج مُدرجاً، انسخ معرّفه من كتالوج النماذج. لا تُسند عملية الجلب النماذجَ إلى أدوار طلبات Claude Code.
  2. عيِّن المعرّف المختار كـ نموذج الرجوع الافتراضي، ثم حدد Quick Set. يُطبَّق المعرّف بذلك على كل صف من صفوف نموذج الطلب الفعلي: Sonnet وOpus وFable وHaiku وSubagent.
  3. قبل الحفظ، تأكد من أن كل صف يعرض معرّف RunAPI المقصود. يحفظ CC Switch هذا التعيين كـ ANTHROPIC_MODEL وANTHROPIC_DEFAULT_SONNET_MODEL وANTHROPIC_DEFAULT_OPUS_MODEL وANTHROPIC_DEFAULT_FABLE_MODEL وANTHROPIC_DEFAULT_HAIKU_MODEL وCLAUDE_CODE_SUBAGENT_MODEL.
  4. احفظ الموفر، وحدده في قائمة الموفرين، ثم فعِّله.

تحقق

افتح محطة طرفية جديدة في مجلد مشروع وابدأ Claude Code:

SHELL 
claude

شغِّل /status لفحص النموذج النشط، ثم أرسل موجهاً قصيراً مثل Describe this repository in one sentence. تؤكد الاستجابة الطبيعية أن CC Switch يستخدم موفر RunAPI النشط.

استكشاف الأخطاء وإصلاحها

  • فشل المصادقة: تحقق من مفتاح API في CC Switch Provider النشط، ثم أنشئ مفتاحاً جديداً من دليل المصادقة إذا لزم الأمر.
  • النموذج المطلوب غير متاح: أعد تحميل محدد النماذج أو انسخ معرّف نموذج مدعوم من كتالوج النماذج، ثم عيّنه كـ Default fallback model واختر Quick Set مجدداً.
  • Claude Code لا يزال يستخدم Provider آخر: فعّل RunAPI Provider في CC Switch، ثم افتح جلسة طرفية جديدة. راجع توثيق المزوّد الخاص بـ CC Switch للاطلاع على تعارضات البيئة.

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

للاطلاع على اختيار البروتوكول وسلوك الطلب، استخدم البدء السريع لـ LLM API . للاطلاع على حقول الطلب والاستجابة، استخدم مرجع Anthropic Messages API . لإضافة أدوات RunAPI إلى Claude Code، تابع مع نظرة عامة على MCP.