# إعداد Kilo Code

> **آخر تحقق**: 2026-09-18 · 📄 وفق الوثائق الرسمية (إضافة Kilo Code؛ الوثائق على kilo.ai)

> **⚠️ تغيّرت الملكية وواجهة المستخدم**: في 2026-07-15 [أعلنت Anaconda استحواذها على Kilo Code](https://www.anaconda.com/press/anaconda-acquires-kilo-code). منذ ذلك الحين أعاد Kilo تصميم إدخال نقطة النهاية المخصصة: لم يعد إدخال Roo Code «API Provider dropdown + tick Use custom base URL»، بل أصبح الإعدادات → تبويب **Providers** → مربع حوار **Custom provider** (كما ورد حرفيًا في صفحتي [anthropic](https://kilo.ai/docs/ai-providers/anthropic) و[openai-compatible](https://kilo.ai/docs/ai-providers/openai-compatible) الرسميتين). تتبع الخطوات أدناه واجهة المستخدم الجديدة.

## نظرة سريعة

| البند | التفاصيل |
|---|---|
| النماذج التي يمكنك استخدامها | Claude ✅ (**Provider API = Anthropic Messages**) · GPT ✅ · النماذج الصينية ✅ (**Provider API = OpenAI Compatible**) · Gemini ❌ (لا يوجد مسار Gemini موثّق في هذه الصفحة) |
| البروتوكول وBase URL | Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai/v1` |
| مكان الإعداد | إعدادات الإضافة (الترس) → تبويب **Providers** → مرّر إلى الأسفل → مربع حوار **Custom provider** |
| الوثائق الرسمية | [kilo.ai](https://kilo.ai) |

[Kilo Code](https://kilo.ai) هي إضافة مفتوحة المصدر للبرمجة بالذكاء الاصطناعي لـ VS Code. وهي تفرّع من [Roo Code](/docs/ide/roo-code)، الذي تفرّع بدوره من [Cline](/docs/ide/cline) — **الأصل نفسه، وواجهات مختلفة**: يستخدم Kilo مربع حوار Custom provider في تبويب Providers، بينما لا يزال Roo Code وCline يستخدمان قائمة منسدلة API Provider. لا تنسخ هذه الخطوات إلى هاتين الأداتين؛ اقرأ صفحتيهما الخاصتين.

## أي بروتوكول

| النماذج التي تريدها | Provider API | Base URL |
|---|---|---|
| Claude | `Anthropic Messages` | `https://api.qcode.cc/api` |
| GPT والعائلات الصينية الأربع | `OpenAI Compatible` | `https://api.qcode.cc/openai/v1` |
| GPT / xAI بأسلوب Responses | `OpenAI Responses` | راجع [نقاط النهاية وتنسيقات API](/docs/getting-started/endpoints-and-api-paths) |

🔴 **لا تستدعِ Claude أبدًا عبر OpenAI Compatible** — ترفض نقطة نهاية OpenAI لدى QCode نماذج Claude مع رسالة الخطأ `model_not_available_on_endpoint`. وتضع الوثائق الرسمية كذلك Anthropic وMiniMax ضمن **Anthropic Messages**.
## التثبيت

ابحث عن **Kilo Code** في سوق إضافات VS Code، أو اتبع التعليمات على [kilo.ai](https://kilo.ai).

## إعداد Claude (مزوّد مخصص)

1. افتح **الإعدادات** في الشريط الجانبي لـ Kilo Code (أيقونة الترس) وانتقل إلى علامة التبويب **المزوّدون**
2. مرّر إلى الأسفل وانقر **مزوّد مخصص**
3. املأ مربع الحوار:

   | الحقل | ما الذي تدخله |
   |---|---|
   | **معرّف المزوّد** | معرّف فريد، مثل `qcode` |
   | **اسم العرض** | الاسم الظاهر في الواجهة، أي شيء تريده |
   | **API المزوّد** | اختر **Anthropic Messages** من أجل Claude |
   | **Base URL** | `https://api.qcode.cc/api` |
   | **مفتاح API** | المفتاح الخاص بك في QCode (يبدأ بـ `cr_`) |
   | **النماذج** | اكتبه يدويًا، أو اختر من القائمة المجلوبة تلقائيًا (مثل `claude-sonnet-5`) |
   | **الترويسات** | ترويسات HTTP مخصصة اختيارية كأزواج مفتاح-قيمة |

4. انقر **إرسال**؛ تظهر النماذج في منتقي النموذج
5. أرسل رسالة في الدردشة للتحقق

> **الصين القارية**: استبدل المضيف بـ `https://asia.qcode.cc/api` (عقدة آسيا، قريبة من كوريا / تايوان / هونغ كونغ)؛ يبقى المفتاح نفسه.
> تُكتب أمثلة Base URL الرسمية بصيغة تحمل رقم إصدار (على غرار
> `https://api.your-provider.com/v1`)، ويجلب Kilo قائمة النماذج تلقائيًا من URL صالح. بالنسبة إلى
> نقطة نهاية Anthropic Messages، نقترح التوقف عند `/api` وترك الإضافة تُلحق `/v1/messages`.
> **دون شرطة مائلة لاحقة.** **لم نختبر** ما إذا كانت الشرطة المائلة الإضافية تُنتج فعليًا 404، لذا اتبع
> الصيغة المقترحة. أيًا كان ما تضبطه في الواجهة، فإنه يُخزَّن في ملف إعدادات (تسميه الصفحات الرسمية
> `kilo.json` في موضع و`kilo.jsonc` في موضع آخر) ويمكن تحريره مباشرة.
## إعداد GPT والنماذج الصينية (متوافق مع OpenAI)

نفس مربع الحوار **مزوّد مخصص**، مع تغيير حقلين فقط:

1. اضبط **API المزوّد** على **OpenAI Compatible**
2. **Base URL**: `https://api.qcode.cc/openai/v1`
3. **مفتاح API**: المفتاح نفسه `cr_`
4. **النماذج**: اكتب `gpt-6-sol`، أو `gpt-5.6-terra`، أو [معرّف نموذج صيني](/docs/usage/cn-models) مثل `glm-5.2`

بالنسبة إلى الواجهة ذات النمط Responses في GPT / xAI، القيمة الرسمية هي **OpenAI Responses**؛ لا تزال نماذج Anthropic تعمل فقط عبر Anthropic Messages (Base URL `https://api.qcode.cc/api`). نقطتا النهاية غير قابلتين للتبادل.
## التحقق من الاتصال

تحقق من نقطة النهاية والمفتاح باستخدام curl أولًا، لتعرف ما إذا كان عليك تصحيح واجهة الإضافة:

```bash
KEY="cr_your_qcode_key"
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'
```

وجود JSON يحتوي على `content` يعني أن جانب نقطة النهاية سليم؛ وإذا استمر فشل الإضافة، فالمشكلة في إعداداتها.

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

| العَرَض | السبب | الإصلاح |
|---------|-------|-----|
| `model_not_available_on_endpoint` | الوصول إلى Claude عبر OpenAI Compatible | بدّل إلى مزوّد Anthropic مع `/api` |
| `Invalid API key` | مفتاح خاطئ أو مسافات بيضاء زائدة | تحقق من بادئة `cr_` وأزل المسافات |
| 404 | شرطة مائلة لاحقة في Base URL، أو مسار خاطئ | قارن بالجدول أعلاه |
| معرّف النموذج الخاص بك غير موجود في القائمة المنسدلة | غير موجود في قائمة الإضافة المدمجة | اكتبه في حقل معرّف النموذج المخصص |

## ذات صلة

- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths) — جدول البروتوكول × عائلة النموذج
- [إعداد Roo Code](/docs/ide/roo-code) — المشروع الذي تفرّع عنه Kilo Code، بإعداد شبه مطابق
- [تكامل Cline](/docs/ide/cline) — المشروع الذي تفرّع عنه Roo Code
- [النماذج الصينية](/docs/usage/cn-models)