أدوات البرمجة

Kilo Code

ربط Kilo Code و Kilo CLI بـ TokenLab

نظرة عامة

يدعم Kilo Code مزودي الخدمة المخصصين المتوافقين مع OpenAI في إضافة VS Code و Kilo CLI. يتشارك كلا العميلين في نفس إعدادات المزود والنموذج.

التثبيت

بالنسبة لـ VS Code، ابحث عن Kilo Code في الإضافات (Extensions) وقم بتثبيت قناة ما قبل الإصدار (pre-release). توثق Kilo هذه القناة باعتبارها الإضافة المستقرة والموصى بها حالياً.

بالنسبة لـ CLI، قم بتشغيل:

npm install -g @kilocode/cli@7.7.2
kilo --version

التكوين في واجهة المستخدم

احفظ المزود الحالي والنموذج وإعدادات الاتصال محلياً قبل التعديل. تغير هذه عناصر التحكم اختيار النموذج النشط؛ قم باستعادة قيمك السابقة عند الانتهاء. حافظ على الحسابات المسجلة وصلاحيات الـ Skill دون تغيير. لا تقم بالكتابة فوق اتصال آخر متوافق مع OpenAI دون وجود نسخة احتياطية قابلة للاستعادة.

  1. افتح Settings → Providers في Kilo Code.
  2. مرر للأسفل وانقر على Custom provider.
  3. استخدم القيم التالية:
الحقلالقيمة
Provider IDtokenlab
Display nameTokenLab
Provider APIOpenAI Compatible
Base URLhttps://api.tokenlab.sh/v1
API keyمفتاح TokenLab API الخاص بك
Modelاختر أو أضف claude-sonnet-5-5

تقوم Kilo تلقائياً بالاستعلام عن نقطة النهاية /v1/models الخاصة بـ TokenLab بعد إدخال Base URL والمفتاح. انقر على Submit، ثم اختر tokenlab/claude-sonnet-5-5 من قائمة اختيار النماذج.

تكوين CLI

استخدم تعليمات الطرفية في البدء السريع لأنظمة macOS أو Linux أو WSL أو Windows PowerShell لتعيين TOKENLAB_API_KEY دون وضع المفتاح في سجل الأوامر. قم بتشغيل Kilo من تلك الطرفية. للاستخدام الدائم، استخدم مدير الأسرار المحلي الخاص بك؛ لا تقم بإلحاق مفتاح بنص عادي (plaintext) في ملف تعريف الصدفة (shell profile) الخاص بك.

قبل بدء تشغيل Kilo 7.7.2، قم بنسخ التكوين العالمي النشط احتياطياً وتحقق من permission.bash. يقوم هذا الإصدار بترحيل التكوين الحالي بدون تلك القاعدة الصريحة إلى bash: "allow"، حتى عندما تكون permission["*"] مضبوطة على deny. حافظ على قاعدة الصدفة الحالية الخاصة بك بشكل صريح في الملف العالمي: إذا كانت قاعدة البدل (wildcard rule) الحالية هي deny، فقم بدمج "bash": "deny" في كائن permission الحالي. حافظ على القواعد الأخرى كما هي. ملف المزود المنفصل أدناه لا يمنع ترحيل العميل هذا.

أنشئ ملف ~/.config/kilo/tokenlab.jsonc منفصلاً مع التكوين أدناه. إذا تم تعيين XDG_CONFIG_HOME، فاستخدم kilo/tokenlab.jsonc تحت ذلك الدليل. حافظ على ملفات kilo.json / kilo.jsonc العادية، والحسابات، والنموذج الافتراضي، والصلاحيات دون تغيير: يتم تحميل هذا الملف المنفصل فقط عند الاستدعاء الذي يحدده باستخدام KILO_CONFIG. إذا كان اسم الملف أو المزود ينتمي بالفعل إلى إعداد آخر، فاختر ملفاً/اسماً مختلفاً وقم بتعديل الأوامر.

{
  "$schema": "https://app.kilo.ai/config.json",
  "provider": {
    "tokenlab": {
      "options": {
        "apiKey": "{env:TOKENLAB_API_KEY}",
        "baseURL": "https://api.tokenlab.sh/v1"
      },
      "models": {
        "claude-sonnet-5-5": {
          "name": "Claude Sonnet 5.5",
          "tool_call": true,
          "reasoning": true,
          "modalities": {
            "input": [
              "text",
              "image"
            ],
            "output": [
              "text"
            ]
          },
          "limit": {
            "context": 1000000,
            "output": 128000
          }
        }
      },
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenLab"
    }
  }
}
KILO_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/kilo/tokenlab.jsonc" kilo models tokenlab
KILO_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/kilo/tokenlab.jsonc" kilo --model tokenlab/claude-sonnet-5-5

حفظ الإعدادات أو سرد النماذج لا يتحقق من صحة المفتاح أو اكتمال الطلب. تستخدم المطالبة (prompt) رصيد TokenLab. تحقق من الرد وسجل الطلب المطابق له request record قبل تجربة الـ Skills؛ قد يتم محاسبتك أيضاً على الطلبات الإضافية.

إنشاء الصور والفيديو في نفس الـ Agent

يمكن لـ Kilo أيضاً إنشاء صور ومقاطع فيديو قصيرة باستخدام خادم TokenLab MCP. يتم دفع تكلفة كل عملية إنشاء من نفس رصيد TokenLab. ادمج إدخال mcp هذا في نفس ملف tokenlab.jsonc بجوار provider. تستبدل Kilo القيمة {env:TOKENLAB_API_KEY} بالمتغير من طرفيتك، لذا لا يتم كتابة المفتاح في الملف:

{
  "mcp": {
    "tokenlab": {
      "type": "local",
      "command": ["npx", "-y", "@tokenlabai/mcp-server@0.6.48"],
      "environment": {
        "TOKENLAB_MCP_TOOL_PROFILE": "core",
        "TOKENLAB_API_KEY": "{env:TOKENLAB_API_KEY}"
      },
      "timeout": 30000
    }
  }
}

تمنح قيمة timeout الأطول لـ npx وقتاً لتنزيل الحزمة عند البدء لأول مرة. ابدأ تشغيل Kilo بنفس KILO_CONFIG واطلب منه سرد أدوات tokenlab الخاصة به. ثم جرب:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

تُرجع create_video معرف مهمة (task ID). يقوم الـ Agent باستدعاء get_task_status حتى يصبح الفيديو جاهزاً. راجع خوادم Kilo MCP لمعرفة الإعدادات الأخرى.

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

في هذه الصفحة