# استخدام Kilo Code بمفتاح خبير: إعداد مزوّد مخصّص

> أضف خبير إلى Kilo Code مزوّدًا مخصّصًا من نوع OpenAI Compatible، والصق مفتاح API، وشغّل نماذج Claude أو GPT أو Gemini من رصيدك.

آخر تحديث: 2026-11-01

لاستخدام Kilo Code مع خبير، افتح الإعدادات ثم تبويب Providers وأضف مزوّدًا مخصّصًا عبر Custom provider. اختر في حقل Provider API الخيار OpenAI Compatible، وضع في Base URL العنوان `https://api.5abeer.ai/v1`، والصق مفتاح API من خبير، ثم أضف معرّف نموذج مثل `claude-sonnet-5.5`. بعد ذلك يُدفع كل طلب من رصيدك في خبير.

## ما تحتاج إليه

- إضافة Kilo Code في VS Code، أو Kilo CLI في الطرفية. وكلاهما يقرأ إعدادات المزوّد نفسها.
- مفتاح API من خبير لمزوّد النموذج الذي ستستخدمه. فالمفتاح يعمل مع نماذج مزوّد واحد فقط، ومفتاح Claude يشغّل نماذج Claude وحدها ([أنشئ مفتاحًا](https://5abeer.ai/ar/docs/start/keys.md#create)).
- رصيد في حسابك ([طرق الدفع](https://5abeer.ai/ar/docs/start/payment.md)).

مفتاح الاشتراك في خبير لا يعمل هنا. فالباقات مخصّصة للتطبيقات المدعومة، وKilo Code ليس منها. لاستخدام النماذج من Kilo Code أنشئ مفتاح API يُدفع استخدامه من رصيدك.

## أي مزوّد تختار في Kilo Code؟

في نافذة المزوّد المخصّص حقل اسمه Provider API فيه ثلاثة بروتوكولات: OpenAI Compatible وOpenAI Responses وAnthropic Messages. اختر OpenAI Compatible. يقدّم خبير صيغة OpenAI Chat Completions على المسار `/v1` لنماذج Claude وGPT وGemini، فيكفي هذا الخيار لكل النماذج، بشرط أن يطابق المفتاح مزوّد النموذج.

أما خيارا Anthropic وOpenAI الجاهزان في قائمة المزوّدين فمخصّصان للمفاتيح التي تصدرها هاتان الشركتان. صفحتا إعدادهما لا تطلبان إلا مفتاح API، لذلك أضف خبير مزوّدًا مخصّصًا.

| الصيغة | العنوان الأساسي | ترويسة المفتاح |
| --- | --- | --- |
| OpenAI | `https://api.5abeer.ai/v1` | `Authorization: Bearer <KEY>` |
| Anthropic | `https://api.5abeer.ai` | `x-api-key: <KEY>` |
| Gemini | `https://api.5abeer.ai/v1beta` | `x-goog-api-key: <KEY>` |

## إعداد مفتاح Kilo Code في VS Code

### 1. أنشئ مفتاح API في خبير

افتح في لوحة التحكم **API → Keys**، واختر **New key**، ثم حدّد المزوّد. في المثال التالي نختار Claude. انسخ المفتاح عندما يظهر.

### 2. افتح نافذة المزوّد المخصّص

في Kilo Code افتح **Settings** من أيقونة الترس، ثم انتقل إلى تبويب **Providers**. انزل إلى آخر القائمة واضغط **Custom provider**.

### 3. املأ الحقول

- **Provider ID**: معرّف قصير بأحرف صغيرة، مثل `khabeer`. يستخدمه Kilo في الصيغة `provider_id/model_id`.
- **Display name**: الاسم الذي تريد رؤيته في قائمة النماذج، مثل خبير.
- **Provider API**: اختر **OpenAI Compatible**.
- **Base URL**: `https://api.5abeer.ai/v1`
- **API key**: مفتاحك من خبير.
- **Models**: أضف `claude-sonnet-5.5`. اكتب المعرّف كما يظهر في [قائمة النماذج](https://5abeer.ai/ar/models) تمامًا. وإذا جلب Kilo قائمة النماذج بنفسه فطابق كل معرّف مع قائمة النماذج قبل إضافته.
- **Headers**: اتركه فارغًا، فـ Kilo يرسل المفتاح بنفسه.

### 4. احفظ واختر النموذج

اضغط **Submit**. تظهر نماذج المزوّد في قائمة اختيار النموذج. اختر نموذج خبير وأرسل طلبًا قصيرًا. إذا وصلك رد فالإعداد يعمل.

تذكر وثائق Kilo أن حدود التوكنات وخيارات كل نموذج الأخرى تُضبط في ملف الإعداد `kilo.jsonc`. وإذا ضبطت هناك نافذة السياق أو الحد الأقصى للإخراج فخذ القيم من صفحة النموذج، مثل [`claude-sonnet-5.5`](https://5abeer.ai/ar/models/claude-sonnet-5.5)، ولا تخمّنها.

## استخدام Kilo CLI بالمفتاح نفسه

يُثبَّت Kilo CLI بالأمر `npm install -g @kilocode/cli`، ويقرأ ملف `kilo.json` أو `kilo.jsonc` من المجلد `~/.config/kilo/` أو من مجلد مشروعك. عرّف خبير مزوّدًا في الملف العام داخل `~/.config/kilo/`، واحفظ المفتاح في متغيّر بيئة، لأن Kilo لا يقرأ قيم `{env:...}` إلا من الإعداد العام، لا من ملف المشروع:

```json
{
  "model": "khabeer/claude-sonnet-5.5",
  "provider": {
    "khabeer": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.5abeer.ai/v1",
        "apiKey": "{env:KHABEER_API_KEY}"
      },
      "models": {
        "claude-sonnet-5.5": {}
      }
    }
  }
}
```

اضبط المتغيّر `KHABEER_API_KEY` في الطرفية التي تشغّل منها `kilo`. وتأتي قيمة `model` بالصيغة `provider_id/model_id`. يمكنك أن تضيف `name` و`limit` إلى بيانات النموذج، على أن تأخذ الحدود من صفحة النموذج.

## أي نموذج تختار في Kilo Code؟

ابدأ بنموذج [`claude-sonnet-5.5`](https://5abeer.ai/ar/models/claude-sonnet-5.5) للبرمجة اليومية. وانتقل إلى [`claude-opus-5.5`](https://5abeer.ai/ar/models/claude-opus-5.5) في المهام الطويلة والصعبة التي تستحق تكلفتها الأعلى. هذه نماذج Claude الحالية:

| النموذج | المعرّف | الإدخال (سعرنا) | الإخراج (سعرنا) | السياق |
| --- | --- | --- | --- | --- |
| Claude Sonnet 5.5 | `claude-sonnet-5.5` | 0.60 US$ | 3 US$ | 1M |
| Claude Opus 5.5 | `claude-opus-5.5` | 1.20 US$ | 6 US$ | 1M |
| Claude Fable 5.1 | `claude-fable-5.1` | 3 US$ | 15 US$ | — |

السعر الرسمي بجانب سعرنا، مع تاريخ قراءته:

Claude Sonnet 5.5 (`claude-sonnet-5.5`) لكل مليون توكن: الإدخال 0.60 US$ (الرسمي 2 US$)، الإخراج 3 US$ (الرسمي 10 US$). آخر مراجعة للسعر الرسمي: 19 أكتوبر 2026.

ولنماذج GPT أو Gemini تحتاج إلى مفتاح لذلك المزوّد، وتجد معرّفاتها في [قائمة النماذج](https://5abeer.ai/ar/models). التفاصيل في القسم التالي.

## Claude وGPT معًا في Kilo Code: مفتاح لكل مزوّد

كل مفتاح في خبير يعمل مع نماذج مزوّد واحد. فإذا طلبت نموذج GPT بمفتاح Claude يعود الطلب بالخطأ [`MODEL_PLATFORM_NOT_ALLOWED`](https://5abeer.ai/ar/docs/help/errors.md#MODEL_PLATFORM_NOT_ALLOWED).

لاستخدام الاثنين في Kilo Code أنشئ مفتاحًا ثانيًا لـ GPT، وأضف مزوّدًا مخصّصًا ثانيًا، مثل `khabeer-gpt`، بالقيمة نفسها في Provider API وBase URL، ثم أضف إليه معرّفات نماذج GPT. يظهر المزوّدان معًا في قائمة النماذج، ويُخصم استخدام المفتاحين من الرصيد نفسه. والطريقة نفسها تصلح لـ Gemini.

## التحكم في تكلفة Kilo Code

يُدفع كل طلب من رصيدك حسب التوكنات التي يستخدمها، بسعر النموذج في خبير ([الأسعار والرصيد](https://5abeer.ai/ar/docs/start/pricing.md)). وقد يرسل الوكيل طلبات كثيرة في مهمة واحدة، لذلك ضع الحدود على المفتاح نفسه. يمكنك التحكم في كل مفتاح: حد للإنفاق، وتاريخ انتهاء، وقائمة عناوين IP مسموح بها ([التحكم في المفاتيح](https://5abeer.ai/ar/docs/start/keys.md#controls)). ويفيدك كذلك مفتاح خاص بـ Kilo Code في فصل استخدامه عن أدواتك الأخرى في لوحة التحكم.

ويبيع Kilo أيضًا وصولًا مستضافًا خاصًا به. تصف صفحة أسعاره بوابة Kilo Gateway بأنها استدلال مستضاف تدفع فيه حسب الاستخدام دون اشتراك، بأسعار المزوّدين نفسها دون هامش إضافي، مع رسم معالجة نسبته 5% عند شراء الرصيد، وتدعم كذلك استخدام مفاتيحك الخاصة من المزوّدين ([kilo.ai/pricing](https://kilo.ai/pricing)، راجعناها في 2026-11-01). وبالإعداد الموضّح هنا يرسل Kilo الطلبات إلى خبير مباشرة، وتُدفع من رصيدك في خبير.

## الأخطاء الشائعة وحلولها

- [`INVALID_API_KEY`](https://5abeer.ai/ar/docs/help/errors.md#INVALID_API_KEY) أو الخطأ 401: المفتاح خطأ أو أُلغي. الصقه من جديد في نافذة المزوّد. وفي CLI تأكد من ضبط `KHABEER_API_KEY` في تلك الطرفية.
- [`MODEL_PLATFORM_NOT_ALLOWED`](https://5abeer.ai/ar/docs/help/errors.md#MODEL_PLATFORM_NOT_ALLOWED): النموذج يتبع مزوّدًا غير مزوّد المفتاح. استخدم المفتاح المطابق، أو أضف مزوّدًا ثانيًا.
- عنوان أساسي خطأ: مع OpenAI Compatible استخدم `https://api.5abeer.ai/v1`، أي مع `/v1` ودون أي شيء بعدها.
- النموذج غير موجود: في معرّف النموذج خطأ كتابي أو تهجئة مختلفة. انسخه من [قائمة النماذج](https://5abeer.ai/ar/models).
- [`INSUFFICIENT_BALANCE`](https://5abeer.ai/ar/docs/help/errors.md#INSUFFICIENT_BALANCE): رصيدك لا يكفي للطلب. اشحن الرصيد ثم أعد المحاولة.

كل رمز خطأ ومعناه في [الأخطاء وحلولها](https://5abeer.ai/ar/docs/help/errors.md).

## أسئلة شائعة

### هل أستخدم اشتراكي في خبير داخل Kilo Code؟

لا. الباقات تشغّل التطبيقات المدعومة فقط، وKilo Code ليس منها. أنشئ مفتاح API وادفع استخدام Kilo Code من رصيدك.

### هل مزوّد Anthropic الجاهز هو الخيار الصحيح لمفتاح Claude من خبير؟

لا. صفحة إعداد Anthropic في وثائق Kilo تطلب مفتاحًا من Anthropic، ولا تذكر حقلًا للعنوان الأساسي. أضف خبير مزوّدًا مخصّصًا من نوع OpenAI Compatible، فنماذج Claude تعمل عبره بمفتاح Claude.

### لماذا أحتاج إلى مفتاحين لـ Claude وGPT؟

لأن المفتاح في خبير يعمل مع نماذج مزوّد واحد فقط. أنشئ مفتاحًا لكل مزوّد، وأضف مزوّدًا مخصّصًا لكل مفتاح، ويُخصم الاثنان من الرصيد نفسه.

### هل يجلب Kilo Code قائمة نماذج خبير؟

يحاول Kilo جلب النماذج عندما تُدخل العنوان الأساسي والمفتاح، ويمكنك الضغط على **Fetch models** لإعادة المحاولة. وأيًا كان ما تعرضه القائمة، طابق كل معرّف مع قائمة نماذج خبير، أو اكتب المعرّف بنفسك.

### هل أحتاج إلى رصيد Kilo لأستخدم مفتاحي الخاص؟

لا في هذا الإعداد. تذكر صفحة أسعار Kilo استخدام مفاتيحك الخاصة إلى جانب بوابته. وعندما تضيف خبير مزوّدًا مخصّصًا تُدفع الطلبات من رصيدك في خبير.

### هل يُعدّ Kilo CLI بالطريقة نفسها؟

نعم، لكن بملف إعداد بدل النافذة. أضف المزوّد تحت `provider` في `kilo.jsonc`، مع `options.baseURL` و`options.apiKey` ونموذج واحد على الأقل.

> هل أنت مستعد لربط Kilo Code؟ [أنشئ مفتاح API](https://5abeer.ai/ar/docs/start/keys.md#create) للمزوّد الذي تريده، ثم راجع كل النماذج وأسعارها في [صفحة API في خبير](https://5abeer.ai/ar/api). وإذا كنت تُعدّ أداة مشابهة فراجع دليلَي [Cline](https://5abeer.ai/ar/guides/cline-api-key) و[Roo Code](https://5abeer.ai/ar/guides/roo-code-api-key).

## المصادر

راجعناها في 2026-11-01:

- وثائق Kilo Code: [Using OpenAI Compatible providers](https://kilo.ai/docs/ai-providers/openai-compatible) و[Custom models](https://kilo.ai/docs/code-with-ai/agents/custom-models) و[Anthropic](https://kilo.ai/docs/ai-providers/anthropic) و[CLI](https://kilo.ai/docs/cli)
- مصدر وثائق Kilo على GitHub: [Kilo-Org/kilocode](https://github.com/Kilo-Org/kilocode)
- أسعار Kilo: [kilo.ai/pricing](https://kilo.ai/pricing)
- وثائق خبير: [مفاتيح API](https://5abeer.ai/ar/docs/start/keys.md) و[العناوين الأساسية](https://5abeer.ai/ar/docs/start/base-urls.md) و[الأخطاء وحلولها](https://5abeer.ai/ar/docs/help/errors.md)

> خبير خدمة مستقلة، ولا تتبع Kilo Code أو OpenAI أو Anthropic أو Google.