اتصال Kilo Code به چابکان

Kilo Code چیست؟

Kilo Code یک دستیار برنامه‌نویسی هوش مصنوعی متن‌باز است که در VS Code، ویرایشگرهای سازگار، JetBrains و ترمینال اجرا می‌شود. این ابزار context پروژه را در اختیار مدل قرار می‌دهد و برای تولید کد، refactor، اشکال‌زدایی، مرور تغییرات و خودکارسازی وظایف توسعه به کار می‌رود.

Kilo Code یک coding agent است؛ یعنی علاوه بر گفت‌وگوی متنی می‌تواند بر اساس مجوزهای شما فایل بخواند، تغییر پیشنهاد کند و ابزارهای محلی را فراخوانی کند. مدل روی درگاه چابکان اجرا می‌شود، اما عملیات فایل و terminal را خود Kilo Code روی سیستم شما مدیریت می‌کند.

چرا Kilo Code را به چابکان متصل کنیم؟

Kilo Code از provider سفارشی و API سازگار با OpenAI پشتیبانی می‌کند. با ثبت چابکان به‌عنوان Custom provider می‌توانید Model ID موجود در سرویس خود را انتخاب کنید و همان اتصال را در محیط‌های مختلف Kilo به کار ببرید.

Kilo Code در IDE یا CLI
        ↓ OpenAI Chat Completions
https://ai.chabokan.net/v1
        ↓
مدل انتخابی در سرویس چابکان

این اتصال برای تحلیل codebase، پیاده‌سازی تغییرات چندفایلی، تولید تست، رفع خطا و مرور کد مناسب است. برای کار agentic مدلی انتخاب کنید که context کافی و tool calling پایدار داشته باشد.

۱. آماده‌سازی چابکان

پیش از نصب Kilo Code، راهنمای آماده‌سازی سرویس را انجام دهید و این موارد را آماده کنید:

تنظیم	مقدار
Provider API	`OpenAI Compatible`
Base URL	`https://ai.chabokan.net/v1`
API Key	کلید فعال با پیشوند `sk-chbk-`
Model ID	شناسه دقیق از پنل یا `/v1/models`

اتصال را ابتدا با cURL آزمایش کنید. موفق‌بودن این آزمون کمک می‌کند خطای سرویس را از تنظیمات Kilo Code جدا کنید.

۲. نصب Kilo Code در VS Code

VS Code را باز کنید.
با Ctrl/Cmd + Shift + X وارد Extensions شوید.
عبارت Kilo Code را جست‌وجو کنید.
افزونه رسمی را انتخاب کنید.
مطابق کانال انتشار فعلی Marketplace، از منوی کنار Install گزینه Install Pre-Release Version را انتخاب کنید.
آیکون Kilo Code را از نوار کناری باز کنید.

افزونه runtime موردنیاز خود را دارد و برای استفاده در VS Code لازم نیست CLI را جدا نصب کنید.

۳. افزودن چابکان از رابط Kilo Code

پنل Kilo Code را باز کنید و روی آیکون چرخ‌دنده بزنید.
وارد زبانه Providers شوید.
پایین فهرست providerها روی Custom provider کلیک کنید.
فرم را به این شکل پر کنید:

فیلد مقدار پیشنهادی
Provider ID chabokan
Display name Chabokan AI
Provider API OpenAI Compatible
Base URL https://ai.chabokan.net/v1
API Key کلید ساخته‌شده در پنل چابکان
پس از واردکردن Base URL کمی صبر کنید تا Kilo مدل‌ها را از endpoint سازگار /models دریافت کند.
مدل موردنظر را از فهرست انتخاب کنید. اگر مدل خودکار دیده نشد، Model ID را عیناً و به‌صورت دستی اضافه کنید.
روی Submit بزنید.
از model picker، provider چابکان و مدل ذخیره‌شده را انتخاب کنید.

فیلد	مقدار پیشنهادی
Provider ID	`chabokan`
Display name	`Chabokan AI`
Provider API	`OpenAI Compatible`
Base URL	`https://ai.chabokan.net/v1`
API Key	کلید ساخته‌شده در پنل چابکان

انتخاب پروتکل

برای مسیر عمومی چابکان گزینه OpenAI Compatible را انتخاب کنید. گزینه‌های OpenAI Responses و Anthropic Messages کاربرد متفاوتی دارند و نباید صرفاً بر اساس شرکت سازنده مدل انتخاب شوند.

۴. نصب Kilo Code در JetBrains

نسخه رسمی Kilo Code برای IntelliJ IDEA، WebStorm، PyCharm، PhpStorm، GoLand، Rider، CLion، RubyMine و DataGrip ارائه می‌شود:

در IDE وارد Settings → Plugins شوید.
در زبانه Marketplace عبارت Kilo Code را جست‌وجو کنید.
افزونه را نصب و در صورت درخواست IDE را restart کنید.
پنجره ابزار Kilo Code را باز کنید.
از Settings → Tools → Kilo Code تنظیمات را باز کنید.
provider چابکان را با مقادیر بخش قبل اضافه کنید.

نسخه JetBrains همان فایل‌های مشترک kilo.jsonc را می‌خواند؛ بنابراین provider ذخیره‌شده در config عمومی می‌تواند میان CLI، VS Code و JetBrains مشترک باشد. با این حال تنظیمات Auto-Approve هر محیط را پس از نصب بازبینی کنید.

۵. نصب و تنظیم Kilo CLI

برای استفاده در ترمینال، Kilo CLI نسخه ۱ یا جدیدتر را نصب کنید:

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

سپس وارد پوشه پروژه شوید و رابط ترمینالی را اجرا کنید:

cd /path/to/project
kilo

در TUI می‌توانید فرمان /connect را اجرا و provider سفارشی را اضافه کنید. اگر روش دستی را ترجیح می‌دهید، فایل global زیر را بسازید:

سیستم‌عامل	مسیر پیشنهادی
macOS و Linux	`~/.config/kilo/kilo.jsonc`
Windows	`%USERPROFILE%\.config\kilo\kilo.jsonc`
فقط پروژه	`./kilo.jsonc` یا `./.kilo/kilo.jsonc`

نمونه زیر را در config عمومی و مورداعتماد قرار دهید:

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "openai-compatible/chabokan-coding",
  "provider": {
    "openai-compatible": {
      "options": {
        "apiKey": "{env:CHABOKAN_AI_API_KEY}",
        "baseURL": "https://ai.chabokan.net/v1"
      },
      "models": {
        "chabokan-coding": {
          "id": "openai/gpt-4o-mini",
          "name": "Chabokan - Coding Model",
          "tool_call": true
        }
      }
    }
  }
}

فیلد id شناسه‌ای است که واقعاً برای چابکان ارسال می‌شود؛ آن را با Model ID واقعی جایگزین کنید. chabokan-coding فقط alias داخلی Kilo است. tool_call را نیز فقط برای مدلی true بگذارید که در مشخصات چابکان ابزارخوانی را پشتیبانی می‌کند. کلید را در JSONC ننویسید و پیش از اجرا در environment قرار دهید:

export CHABOKAN_AI_API_KEY="sk-chbk-کلید-واقعی-شما"

محل امن تنظیمات

Kilo ارجاع {env:...} را فقط در config مورداعتماد، مانند ~/.config/kilo/kilo.jsonc، resolve می‌کند. config داخل repository نمی‌تواند با این روش secret محیط را بخواند. credential provider را global نگه دارید و فقط تنظیمات غیرمحرمانه پروژه را commit کنید.

۶. آزمون امن اتصال

در نخستین درخواست بنویسید:

فقط ساختار پروژه را بررسی کن و بدون تغییر فایل یا اجرای فرمان،
زبان‌ها و روش احتمالی اجرای تست‌ها را توضیح بده.

پس از پاسخ:

نام مدل فعال را در Kilo بررسی کنید.
درخواست متناظر را در گزارش درخواست‌های پنل چابکان پیدا کنید.
یک tool call فقط‌خواندنی را آزمایش کنید.
سپس یک تغییر کوچک در branch آزمایشی بخواهید و diff را پیش از تأیید بخوانید.

۷. مجوزها و امنیت

برای Kilo Code یک کلید مستقل با سقف مصرف بسازید.
API Key را با reference نوع {env:...} از environment بخوانید.
تنظیمات Auto-Approve را بازبینی و shell و فایل‌های حساس را نیازمند تأیید نگه دارید.
در macOS و Linux در صورت نیاز sandbox افزونه را فعال کنید.
فایل global دارای secret و فایل پروژه دارای تنظیم عمومی باشد.
فایل‌های .env، credentialهای cloud و کلیدهای production را از context عامل دور نگه دارید.

۸. خطاهای رایج Kilo Code

مشکل	علت احتمالی	راه‌حل
مدل‌ها دریافت نمی‌شوند	کلید یا Base URL اشتباه است	`/v1/models` را با cURL آزمایش کنید
`401`	کلید نرسیده، ناقص یا غیرفعال است	environment یا فیلد API Key را بررسی کنید
`404`	`/v1` حذف یا مسیر دوبار اضافه شده است	Base URL را دقیقاً `https://ai.chabokan.net/v1` بگذارید
Chat کار می‌کند اما ویرایش نه	مدل tool calling مناسب ندارد	مدل agentic دیگری انتخاب کنید
مدل اشتباهی فراخوانی می‌شود	قالب `provider_id/model_id` نادرست است	مقدار `model` و کلید داخل `models` را یکسان کنید
context زود پر می‌شود	limits مدل تعریف نشده یا کوچک است	ظرفیت واقعی مدل را از پنل بگیرید و در config ثبت کنید

منابع رسمی: معرفی Kilo Code، نصب VS Code، نصب JetBrains، مدل و provider سفارشی، Kilo CLI

Kilo Code چیست؟​

چرا Kilo Code را به چابکان متصل کنیم؟​

۱. آماده‌سازی چابکان​

۲. نصب Kilo Code در VS Code​

۳. افزودن چابکان از رابط Kilo Code​

۴. نصب Kilo Code در JetBrains​

۵. نصب و تنظیم Kilo CLI​

۶. آزمون امن اتصال​

۷. مجوزها و امنیت​

۸. خطاهای رایج Kilo Code​