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

لاستخدام 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 وحدها (أنشئ مفتاحًا).
• رصيد في حسابك (طرق الدفع).

مفتاح الاشتراك في خبير لا يعمل هنا. فالباقات مخصّصة للتطبيقات المدعومة، و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، لذلك أضف خبير مزوّدًا مخصّصًا.

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

1. 1

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

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

2. 2

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

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

3. 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. اكتب المعرّف كما يظهر في قائمة النماذج تمامًا. وإذا جلب Kilo قائمة النماذج بنفسه فطابق كل معرّف مع قائمة النماذج قبل إضافته.
   • Headers: اتركه فارغًا، فـ Kilo يرسل المفتاح بنفسه.
4. 4

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

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

تذكر وثائق Kilo أن حدود التوكنات وخيارات كل نموذج الأخرى تُضبط في ملف الإعداد kilo.jsonc. وإذا ضبطت هناك نافذة السياق أو الحد الأقصى للإخراج فخذ القيم من صفحة النموذج، مثل claude-sonnet-5.5، ولا تخمّنها.

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

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

{
  "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 للبرمجة اليومية. وانتقل إلى claude-opus-5.5 في المهام الطويلة والصعبة التي تستحق تكلفتها الأعلى. هذه نماذج Claude الحالية:

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

ولنماذج GPT أو Gemini تحتاج إلى مفتاح لذلك المزوّد، وتجد معرّفاتها في قائمة النماذج. التفاصيل في القسم التالي.

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

كل مفتاح في خبير يعمل مع نماذج مزوّد واحد. فإذا طلبت نموذج GPT بمفتاح Claude يعود الطلب بالخطأ MODEL_PLATFORM_NOT_ALLOWED.

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

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

يُدفع كل طلب من رصيدك حسب التوكنات التي يستخدمها، بسعر النموذج في خبير (الأسعار والرصيد). وقد يرسل الوكيل طلبات كثيرة في مهمة واحدة، لذلك ضع الحدود على المفتاح نفسه. يمكنك التحكم في كل مفتاح: حد للإنفاق، وتاريخ انتهاء، وقائمة عناوين IP مسموح بها (التحكم في المفاتيح). ويفيدك كذلك مفتاح خاص بـ Kilo Code في فصل استخدامه عن أدواتك الأخرى في لوحة التحكم.

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

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

• INVALID_API_KEY أو الخطأ 401: المفتاح خطأ أو أُلغي. الصقه من جديد في نافذة المزوّد. وفي CLI تأكد من ضبط KHABEER_API_KEY في تلك الطرفية.
• MODEL_PLATFORM_NOT_ALLOWED: النموذج يتبع مزوّدًا غير مزوّد المفتاح. استخدم المفتاح المطابق، أو أضف مزوّدًا ثانيًا.
• عنوان أساسي خطأ: مع OpenAI Compatible استخدم https://api.5abeer.ai/v1، أي مع /v1 ودون أي شيء بعدها.
• النموذج غير موجود: في معرّف النموذج خطأ كتابي أو تهجئة مختلفة. انسخه من قائمة النماذج.
• INSUFFICIENT_BALANCE: رصيدك لا يكفي للطلب. اشحن الرصيد ثم أعد المحاولة.

كل رمز خطأ ومعناه في الأخطاء وحلولها.

أسئلة شائعة#

هل أستخدم اشتراكي في خبير داخل 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 ونموذج واحد على الأقل.

المصادر#

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

• وثائق Kilo Code: Using OpenAI Compatible providers وCustom models وAnthropic وCLI
• مصدر وثائق Kilo على GitHub: Kilo-Org/kilocode
• أسعار Kilo: kilo.ai/pricing
• وثائق خبير: مفاتيح API والعناوين الأساسية والأخطاء وحلولها