الانتقال إلى المحتوى الرئيسي
Kilo Code هو وكيل برمجة بالذكاء الاصطناعي مفتوح المصدر متاح في VS Code و JetBrains وسطر الأوامر و Slack و Cloud. يتصل بـ OrcaRouter من خلال Custom provider (المزوّد المخصص) الخاص به (نقطة نهاية متوافقة مع OpenAI). يغطّي هذا الدليل كلًّا من إضافة VS Code (الطريقة الأكثر شيوعًا لاستخدام Kilo Code) وسطر الأوامر (@kilocode/cli، للاستخدام بلا واجهة).
البروتوكول: متوافق مع OpenAI
  • عنوان URL الأساسي: https://api.orcarouter.ai/v1 (يتضمّن /v1)
  • تستخدم معرّفات النماذج صيغة vendor/model — والأبسط هو orcarouter/auto

​
إضافة VS Code

  1. ثبّت Kilo Code من VS Code Marketplace (افتح لوحة Extensions وابحث عن “Kilo Code”)، ثم افتحها من أيقونة Kilo Code في شريط النشاط (Activity Bar) (شريط الأيقونات على اليسار). في اللوحة، انقر على ⚙ الترس (gear) في أعلى اليمين لفتح الإعدادات.
لوحة Kilo Code مع تمييز ترس الإعدادات
  1. انتقل إلى Providers (المزوّدون). ضمن Popular providers (المزوّدون الشائعون)، ابحث عن Custom provider (المزوّد المخصص) (“Add an OpenAI-compatible provider by base URL”) وانقر على + Connect.
مدخل Custom provider في إعدادات Providers الخاصة بـ Kilo Code
  1. املأ حقول المزوّد:
    • Provider ID: orcarouter (أحرف صغيرة وأرقام وشرطات أو شرطات سفلية فقط — بدون شرطات مائلة؛ يُرفض orcarouter/auto هنا).
    • Display name: OrcaRouter (أي اسم تريده).
    • Base URL: https://api.orcarouter.ai/v1
    • API key: مفتاح OrcaRouter الخاص بك (sk-orca-...).
معرّف مزوّد OrcaRouter وعنوان URL الأساسي ومفتاح API في Kilo Code
  1. اختر نماذجك. بمجرد أن يصبح المفتاح وعنوان URL الأساسي صالحين، يجلب Kilo Code قائمة النماذج الحيّة من OrcaRouter — حدّد ما تريده (أو Select all)، ثم انقر على Submit. لاستخدام التوجيه التلقائي، أضِف أيضًا نموذجًا عبر + Add model بمعرّف النموذج ID orcarouter/auto (إنه اسم بديل للتوجيه، لذلك لن يظهر في القائمة المجلوبة).
أداة اختيار النماذج في Kilo Code تعرض النماذج المجلوبة من OrcaRouter
  1. يظهر المزوّد الآن ضمن Connected providers (المزوّدون المتصلون) باسم OrcaRouter (CUSTOM).
OrcaRouter مُدرَج ضمن Connected providers في Kilo Code
  1. اختر نموذج OrcaRouter في أداة اختيار النماذج بلوحة الدردشة وأرسل رسالة اختبار — يؤكّد ردٌّ نجاح الاتصال.
Kilo Code يرد عبر OrcaRouter
في مستودع كبير، قد يسألك Kilo Code أولًا عمّا إذا كنت تريد انتظار تهيئة نظام اللقطات (snapshot) الخاص به — اختر Disable for this project لتخطّيه (لا يزال git يتتبّع كل شيء) كي يمرّ الطلب.
يستخدم مكوّن JetBrains الإضافي نفس Custom provider (المزوّد المخصص) بقيم عنوان URL الأساسي / المفتاح / النموذج المطابقة نفسها.

​
سطر الأوامر

للاستخدام بلا واجهة / المبرمَج، ثبّت أداة سطر الأوامر.

​
التثبيت

npm install -g @kilocode/cli
الأمر هو kilo.

​
الإعداد

ملف الإعداد: ~/.config/kilo/kilo.jsonc (يقبل أيضًا kilo.json؛ ويتجاوزه الملف على مستوى المشروع ./kilo.jsonc). 
{
  "$schema": "https://app.kilo.ai/config.json",
  "provider": {
    "orcarouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OrcaRouter",
      "options": { "baseURL": "https://api.orcarouter.ai/v1", "apiKey": "sk-orca-..." },
      "models": { "orcarouter/auto": { "name": "OrcaRouter Auto" } }
    }
  },
  "model": "orcarouter/orcarouter/auto"
}
استبدله بنموذج محدّد إن فضّلت ذلك، مثل anthropic/claude-opus-4.8 أو google/gemini-2.5-flash. تستخدم معرّفات النماذج صيغة vendor/model.

​
التشغيل

echo "Reply with exactly: OK" | kilo run --auto --format json
المتوقع: حدث JSON يحمل "type":"text" و"text":"OK".

​
ملاحظات

  • يتضمن base_url المسار /v1.
  • تستخدم إشارات النماذج صيغة provider/model. ولأن المزوّد مُسمّى orcarouter ويحمل معرّف النموذج أيضًا بادئة vendor، تتكوّن الإشارة من ثلاثة مقاطع: orcarouter/orcarouter/auto (أو orcarouter/anthropic/claude-opus-4.8).
  • الوضع بلا واجهة هو kilo run "<prompt>" --auto (أو مرّر الموجَّه عبر stdin). ويعطي --format json تدفق أحداث قابلًا للقراءة آليًا.
  • الاستدلال/التفكير: استخدم الخيار --variant <name> لجهد الاستدلال الخاص بالمزوّد (مثل high وmax وminimal)، و--thinking لعرض كتل التفكير.
مشكلة معروفة: أُبلِغ عن حالات تعليق لـ --auto بعد الاكتمال / عند فقدان المفتاح (kilocode issues). غلّفه بـ timeout في بيئة CI وتأكد من تحميل المفتاح.