راه‌اندازی Kilo Code

اتصال QCode.cc در افزونه Kilo Code در VS Code: از تنظیمات -> ارائه‌دهندگان -> ارائه‌دهنده سفارشی استفاده کنید و Provider API را برای Claude روی Anthropic Messages قرار دهید.

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

آخرین بازبینی: 2026-09-18 · 📄 طبق مستندات رسمی (افزونه Kilo Code؛ مستندات در kilo.ai)

⚠️ مالکیت و رابط کاربری تغییر کرده‌اند: در 2026-07-15 Anaconda اعلام کرد که Kilo Code را خریداری کرده است. از آن زمان Kilo ورودی نقطه پایانی سفارشی را بازطراحی کرده است: دیگر مانند Roo Code «منوی کشویی API Provider + تیک زدن استفاده از Base URL سفارشی» نیست، بلکه تنظیمات → تب ارائه‌دهندگان → پنجره ارائه‌دهنده سفارشی است (که عیناً در صفحه‌های رسمی anthropic و openai-compatible بیان شده است). مراحل زیر از رابط کاربری جدید پیروی می‌کنند.

در یک نگاه¶

Kilo Code یک افزونه متن‌باز کدنویسی با هوش مصنوعی برای VS Code است. این افزونه فورکی از Roo Code است که خودش از Cline فورک شده است — تبار یکسان، رابط‌های واگرا: Kilo از پنجره ارائه‌دهنده سفارشی در تب ارائه‌دهندگان استفاده می‌کند، در حالی که Roo Code و Cline هنوز از منوی کشویی API Provider استفاده می‌کنند. این مراحل را در آن دو ابزار کپی نکنید؛ صفحه‌های خودشان را بخوانید.

کدام پروتکل¶

🔴 هرگز Claude را از طریق OpenAI Compatible فراخوانی نکنید — نقطه پایانی OpenAI در QCode مدل‌های Claude را با model_not_available_on_endpoint رد می‌کند. مستندات رسمی هم به همین ترتیب Anthropic و MiniMax را زیر Anthropic Messages قرار می‌دهند.

نصب¶

در بازار VS Code برای Kilo Code جستجو کنید یا دستورالعمل‌ها را روی kilo.ai دنبال کنید.

پیکربندی Claude (ارائه‌دهنده سفارشی)¶

1. تنظیمات (آیکون چرخ‌دنده) در نوار کناری Kilo Code را باز کنید و به برگه ارائه‌دهندگان بروید
2. به پایین اسکرول کنید و روی ارائه‌دهنده سفارشی کلیک کنید
3. دیالوگ را پر کنید:

1. روی ثبت کلیک کنید؛ مدل‌ها در انتخاب‌کننده مدل ظاهر می‌شوند
2. برای بررسی، یک پیام در چت بفرستید

سرزمین اصلی چین: میزبان را با https://asia.qcode.cc/api تعویض کنید (گره آسیا، نزدیک کره / تایوان / هنگ کنگ)؛ کلید همان می‌ماند. نمونه‌های رسمی Base URL به صورت نسخه‌بندی شده نوشته شده‌اند (چیزی مثل https://api.your-provider.com/v1)، و Kilo لیست مدل را از یک URL معتبر به‌صورت خودکار دریافت می‌کند. برای نقطه پایانی Anthropic Messages پیشنهاد می‌کنیم در /api متوقف شوید و اجازه دهید افزونه /v1/messages را به آن اضافه کند. بدون اسلش انتهایی. آیا یک اسلش اضافی واقعاً یک 404 تولید می‌کند یا خیر، ما آزمایش نکرده‌ایم، بنابراین از فرم پیشنهادی پیروی کنید. هر آنچه که در رابط کاربری تنظیم می‌کنید در یک پرونده پیکربندی ذخیره می‌شود (صفحات رسمی آن را kilo.json در یک مکان و kilo.jsonc در مکان دیگر می‌نامند) و می‌تواند مستقیماً ویرایش شود.

پیکربندی GPT و مدل‌های چینی (OpenAI Compatible)¶

همین دیالوگ ارائه‌دهنده سفارشی، فقط دو فیلد تغییر می‌کند:

1. API ارائه‌دهنده را به OpenAI Compatible تنظیم کنید
2. Base URL: https://api.qcode.cc/openai/v1
3. کلید API: همان کلید cr_
4. مدل‌ها: gpt-6-sol، gpt-5.6-terra یا یک شناسه مدل چینی مثل glm-5.2 را وارد کنید

برای رابط سبک Responses در GPT / xAI، مقدار رسمی OpenAI Responses است؛ مدل‌های Anthropic هنوز فقط از طریق پیام‌های Anthropic (Base URL https://api.qcode.cc/api) کار می‌کنند. این دو نقطه پایانی جایگزین یکدیگر نیستند.

بررسی اتصال¶

ابتدا نقطه پایانی و کلید را با curl بررسی کنید تا بدانید آیا لازم است رابط کاربری افزونه را اشکال‌زدایی کنید:

KEY="cr_your_qcode_key"
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

JSON شامل content به معنای این است که سمت نقطه پایانی سالم است؛ اگر افزونه همچنان اشکال دارد، مشکل در تنظیمات آن است.

رفع اشکال¶

مرتبط¶

• نقاط پایانی و مسیرهای API — جدول پروتکل × خانواده مدل
• پیکربندی Roo Code — پروژه‌ای که Kilo Code از آن شاخه‌گیری کرده است، تنظیمات تقریباً یکسان
• یکپارچه‌سازی Cline — پروژه‌ای که Roo Code از آن شاخه‌گیری کرده است
• مدل‌های چینی

سازمانی ←