# الاستيراد بنقرة واحدة عبر CC Switch

> استخدم أداة سطح المكتب CC Switch لاستيراد إعدادات API الخاصة بـ LMU AI إلى Claude Code بنقرة واحدة، متجاوزًا التعديل اليدوي لملف settings.json.

URL: https://docs.lmuai.com/ar/docs/tools/cc-switch





**CC Switch** هي أداة سطح مكتب مفتوحة المصدر ومتعددة المنصات لإدارة إعدادات مزودي API والتبديل بينها بنقرة واحدة عبر أدوات البرمجة بالذكاء الاصطناعي مثل Claude Code وCodex وOpenCode وGemini CLI.

بالاقتران مع زر "**Import to CCS**" في وحدة تحكم LMU AI، فإنها تربط Claude Code بالـ API بنقرة واحدة، **دون الحاجة إلى إنشاء أو تحرير ملف `settings.json` يدويًا**.

***

## الخطوة 1 — تثبيت CC Switch [#الخطوة-1--تثبيت-cc-switch]

نزّل المثبّت المناسب لمنصتك من صفحة Releases في المستودع الرسمي:

* **GitHub Releases**: [https://github.com/farion1231/cc-switch/releases](https://github.com/farion1231/cc-switch/releases)

Windows / macOS / Linux مدعومة. بعد التثبيت، شغّل CC Switch مرة واحدة على الأقل حتى يسجّل النظام مخطط URL المخصص الخاص بها.

<Callout type="info">
  بعد التشغيل الأول، أبقِ CC Switch قيد التشغيل (أو دعها تبقى في الخلفية) حتى يتمكن النقر على "Import to CCS" من استدعائها بشكل صحيح.
</Callout>

***

## الخطوة 2 — إنشاء مفتاح API في وحدة تحكم LMU AI [#الخطوة-2--إنشاء-مفتاح-api-في-وحدة-تحكم-lmu-ai]

راجع [البدء - إنشاء مفتاح API](/ar/docs/guide/getting-started#create-key):

1. افتح "**API Keys**" من القائمة اليسرى
2. انقر "**Create key**" وأعطه أي اسم
3. اختر **المجموعة** للخطة التي استبدلتها، وأكمل إنشاءه

***

## الخطوة 3 — الاستيراد إلى CC Switch بنقرة واحدة [#الخطوة-3--الاستيراد-إلى-cc-switch-بنقرة-واحدة]

في قائمة مفاتيح API، ابحث عن المفتاح الذي أنشأته للتو وانقر زر "**Import to CCS**" في عمود "**Actions**" على يمين صفه:

<img alt="موقع زر &#x22;Import to CCS&#x22; في قائمة مفاتيح API بوحدة تحكم LMU AI" src="__img0" />

* يعرض المتصفح رسالة تسأل "السماح لهذا الموقع بفتح CC Switch؟" — انقر "**Allow / Open**"
* يكتشف CC Switch تلقائيًا ويملأ `Base URL` الخاص بـ LMU AI ومفتاح API الخاص بك
* اجعل تلك الإعدادات العنصر النشط في CC Switch

<Callout type="info" title="رسالة المرة الأولى">
  تصيغ المتصفحات المختلفة (Chrome / Edge / Safari) رسالة التأكيد بطريقة مختلفة قليلًا، لكنها جميعًا تسأل عمّا إذا كان يجب تشغيل التطبيق الخارجي CC Switch. حدّد خيار "تذكّر اختياري" لتجنب السؤال مجددًا.
</Callout>

***

## الخطوة 4 — جعلها سارية المفعول في Claude Code [#الخطوة-4--جعلها-سارية-المفعول-في-claude-code]

يكتب CC Switch الإعدادات المحددة في ملف `settings.json` الخاص بـ Claude Code (أو يحقن متغيرات البيئة عند التشغيل)، لذا:

* إذا كان Claude Code **مفتوحًا بالفعل**، أعد تشغيله مرة واحدة حتى تسري الإعدادات الجديدة
* بعد ذلك، ما عليك سوى تشغيل `claude` — دون الحاجة إلى تحرير أي ملف إعدادات يدويًا

تحقق من أن Base URL هو `https://api.lmuai.com` باستخدام أمر `/status`.

***

## المشكلات الشائعة [#المشكلات-الشائعة]

### زر "Import to CCS" لا يفعل شيئًا [#زر-import-to-ccs-لا-يفعل-شيئًا]

**السبب:** لم يسجّل النظام مخطط URL الخاص بـ CC Switch.

**الحل:**

1. تأكد من أنك ثبّت CC Switch بالكامل (وليس بنية محمولة مفكوكة من ملف مضغوط ومُشغّلة مباشرة)
2. شغّل CC Switch مرة واحدة، وأغلقه تمامًا، ثم انقر "Import to CCS" مرة أخرى
3. إذا استمر الفشل على Windows، ابحث عن خيار "تسجيل البروتوكول / ربط الروابط" في إعدادات CC Switch

### المتصفح حظر الانتقال عبر البروتوكول [#المتصفح-حظر-الانتقال-عبر-البروتوكول]

تحظر بعض المتصفحات البروتوكولات غير المعروفة افتراضيًا. في نافذة الحوار، اختر "**السماح دائمًا** لنطاق المستندات / وحدة التحكم بفتح روابط كهذه."

### تريد إضافة الإعدادات يدويًا [#تريد-إضافة-الإعدادات-يدويًا]

يدعم CC Switch أيضًا إضافة مزود مخصص يدويًا:

* **الاسم**: أي شيء (مثل `LMU AI`)
* **Base URL**: `https://api.lmuai.com`
* **API Key**: المفتاح `sk-` الذي أُنشئ في وحدة التحكم

احفظه واجعله العنصر النشط في الشاشة الرئيسية.

***

## توصيات [#توصيات]

* يمكن لـ CC Switch تخزين مفاتيح لمجموعات / خطط متعددة والتبديل بينها بنقرة، مما يجعله **أفضل من تحرير `settings.json` لمستخدمي الخطط المتعددة**
* في وضع الإقامة بشريط النظام يستهلك موارد قليلة جدًا، لذا يُوصى بضبطه ليبدأ عند الإقلاع
* إذا كنت تستخدم سطر الأوامر بشكل أساسي ولا تمانع تحرير ملف إعدادات، فتابع الضبط يدويًا وفق [دليل Claude Code](/ar/docs/tools/claude-code) — لكليهما التأثير نفسه