آموزش‌ها / آموزش Kilo Code با API سفارشی llmapi

آموزش Kilo Code با API سفارشی llmapi

به‌روزرسانی: 2026-10-06

Kilo Code یک ایجنت برنامه‌نویسی متن‌باز است که به‌صورت CLI و افزونهٔ VS Code و JetBrains عرضه می‌شود. هر سه یک فایل تنظیمات مشترک دارند، پس با یک بار تنظیم همه به llmapi وصل می‌شوند.

راه‌اندازی با یک دستور

macOS و Linux:

curl -fsSL https://llmapi.cheap/install.sh | sh

Windows (PowerShell):

irm https://llmapi.cheap/install.ps1 | iex

Node.js لازم نیست. فقط Kilo Code (macOS/Linux):

curl -fsSL https://llmapi.cheap/install.sh | sh -s -- --only kilo

این دستور چه چیزهایی را تغییر می‌دهد؟

در ~/.config/kilo/kilo.jsonc (یا مسیر KILO_CONFIG):

  • provider به نام llmapi با پکیج @ai-sdk/openai-compatible اضافه می‌شود؛ providerهای دیگر حفظ می‌شوند.
  • همهٔ مدل‌های llmapi با tool_call: true و سقف context و خروجی ثبت می‌شوند.
  • مدل پیش‌فرض روی llmapi/gemini-3.8-flash-high قرار می‌گیرد.

نسخهٔ پشتیبان kilo.jsonc.llmapi-backup کنار فایل ساخته می‌شود.

راه‌اندازی دستی

این را در ~/.config/kilo/kilo.jsonc بگذارید:

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "llmapi/gemini-3.8-flash-high",
  "provider": {
    "llmapi": {
      "npm": "@ai-sdk/openai-compatible",
      "options": { "baseURL": "https://llmapi.cheap/v1", "apiKey": "YOUR_API_KEY" },
      "models": { "claude-sonnet-4-6": { "tool_call": true }, "gemini-3.1-pro-high": { "tool_call": true } }
    }
  }
}

برای استفاده از Gemini 3.8 Flash در فهرست مدل‌ها، "gemini-3.8-flash-high": { "tool_call": true } را هم زیر models اضافه کنید.

تغییر مدل

  • از انتخابگر مدل در افزونه یا CLI یکی از مدل‌های llmapi/… را انتخاب کنید.
  • یا مقدار model را در kilo.jsonc عوض کنید.

مدل‌های Claude و GPT-OSS فقط در پلن‌های پولی فعال‌اند.

مشکلات رایج

  • ایجنت ابزارها را صدا نمی‌زند: برای هر مدل "tool_call": true را در تنظیمات بگذارید.
  • خطای 404: baseURL باید https://llmapi.cheap/v1 باشد.
  • خطای 401: کلید را از داشبورد دوباره کپی کنید.
  • تغییرات دیده نمی‌شود: ویرایشگر یا CLI را دوباره باز کنید.

سؤالات متداول

Kilo در JetBrains هم با همین فایل کار می‌کند؟

بله. CLI و افزونه‌های VS Code و JetBrains همه ~/.config/kilo/kilo.jsonc را می‌خوانند.

کامنت‌های فایل jsonc من حفظ می‌شوند؟

اسکریپت فایل را می‌خواند و به‌صورت JSON مرتب بازنویسی می‌کند، پس کامنت‌ها در فایل جدید نمی‌مانند؛ نسخهٔ اصلی در فایل پشتیبان هست.

کدام مدل را انتخاب کنم؟

برای شروع gemini-3.8-flash-high؛ برای کارهای سخت‌تر gemini-3.1-pro-high یا در پلن پولی claude-sonnet-4-6.

شروع کنید

ثبت‌نام کنید و با یک ساعت آزمایش رایگان شروع کنید؛ کلید API خودکار ساخته می‌شود و فقط یک دستور تا اتصال Kilo Code فاصله دارید.