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

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

> **⚠️ مالکیت و رابط کاربری تغییر کرده‌اند**: در 2026-07-15 [Anaconda اعلام کرد که Kilo Code را خریداری کرده است](https://www.anaconda.com/press/anaconda-acquires-kilo-code). از آن زمان Kilo ورودی نقطه پایانی سفارشی را بازطراحی کرده است: دیگر مانند Roo Code «منوی کشویی API Provider + تیک زدن استفاده از Base URL سفارشی» نیست، بلکه تنظیمات → تب **ارائه‌دهندگان** → پنجره **ارائه‌دهنده سفارشی** است (که عیناً در صفحه‌های رسمی [anthropic](https://kilo.ai/docs/ai-providers/anthropic) و [openai-compatible](https://kilo.ai/docs/ai-providers/openai-compatible) بیان شده است). مراحل زیر از رابط کاربری جدید پیروی می‌کنند.

## در یک نگاه

| مورد | جزئیات |
|---|---|
| مدل‌های قابل استفاده | Claude ✅ (**Provider API = Anthropic Messages**) · GPT ✅ · مدل‌های چینی ✅ (**Provider API = OpenAI Compatible**) · Gemini ❌ (هیچ مسیری برای Gemini در این صفحه مستند نشده است) |
| پروتکل و Base URL | Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai/v1` |
| محل پیکربندی | تنظیمات افزونه (چرخ‌دنده) → تب **ارائه‌دهندگان** → تا پایین اسکرول کنید → پنجره **ارائه‌دهنده سفارشی** |
| مستندات رسمی | [kilo.ai](https://kilo.ai) |

[Kilo Code](https://kilo.ai) یک افزونه متن‌باز کدنویسی با هوش مصنوعی برای VS Code است. این افزونه فورکی از [Roo Code](/docs/ide/roo-code) است که خودش از [Cline](/docs/ide/cline) فورک شده است — **تبار یکسان، رابط‌های واگرا**: Kilo از پنجره ارائه‌دهنده سفارشی در تب ارائه‌دهندگان استفاده می‌کند، در حالی که Roo Code و Cline هنوز از منوی کشویی API Provider استفاده می‌کنند. این مراحل را در آن دو ابزار کپی نکنید؛ صفحه‌های خودشان را بخوانید.

## کدام پروتکل

| مدل‌هایی که می‌خواهید | Provider API | Base URL |
|---|---|---|
| Claude | `Anthropic Messages` | `https://api.qcode.cc/api` |
| GPT و چهار خانواده چینی | `OpenAI Compatible` | `https://api.qcode.cc/openai/v1` |
| GPT / xAI به سبک Responses | `OpenAI Responses` | [نقاط پایانی و قالب‌های API](/docs/getting-started/endpoints-and-api-paths) را ببینید |

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

در بازار VS Code برای **Kilo Code** جستجو کنید یا دستورالعمل‌ها را روی [kilo.ai](https://kilo.ai) دنبال کنید.

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

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

   | فیلد | چه چیزی باید وارد شود |
   |---|---|
   | **شناسه ارائه‌دهنده** | یک شناسه منحصر به فرد، مثلاً `qcode` |
   | **نام نمایشی** | نامی که در رابط کاربری نمایش داده می‌شود، هر چیزی که دوست دارید |
   | **API ارائه‌دهنده** | **پیام‌های Anthropic** را برای Claude انتخاب کنید |
   | **Base URL** | `https://api.qcode.cc/api` |
   | **کلید API** | کلید QCode شما (با `cr_` شروع می‌شود) |
   | **مدل‌ها** | آن را وارد کنید یا از فهرستی که به‌صورت خودکار دریافت می‌شود انتخاب کنید (مثل `claude-sonnet-5`) |
   | **هدرهای HTTP** | هدرهای HTTP سفارشی اختیاری به‌صورت جفت‌های کلید-مقدار |

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

> **سرزمین اصلی چین**: میزبان را با `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` یا یک [شناسه مدل چینی](/docs/usage/cn-models) مثل `glm-5.2` را وارد کنید

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

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

```bash
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` به معنای این است که سمت نقطه پایانی سالم است؛ اگر افزونه همچنان اشکال دارد، مشکل در تنظیمات آن است.

## رفع اشکال

| نشانه | علت | راه حل |
|---------|-------|-----|
| `model_not_available_on_endpoint` | دسترسی به Claude از طریق OpenAI Compatible | به ارائه‌دهنده Anthropic با `/api` تغییر دهید |
| `Invalid API key` | کلید اشتباه یا فاصله اضافی | پیشوند `cr_` را بررسی کنید و فاصله‌های اضافی را حذف کنید |
| 404 | اسلش انتهایی در Base URL یا مسیر اشتباه | با جدول بالا مقایسه کنید |
| شناسه مدل شما در فهرست کشویی نیست | در فهرست داخلی افزونه وجود ندارد | آن را در فیلد شناسه مدل سفارشی وارد کنید |

## مرتبط

- [نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths) — جدول پروتکل × خانواده مدل
- [پیکربندی Roo Code](/docs/ide/roo-code) — پروژه‌ای که Kilo Code از آن شاخه‌گیری کرده است، تنظیمات تقریباً یکسان
- [یکپارچه‌سازی Cline](/docs/ide/cline) — پروژه‌ای که Roo Code از آن شاخه‌گیری کرده است
- [مدل‌های چینی](/docs/usage/cn-models)