# راه‌اندازی Kimi Code CLI

> **آخرین بازبینی**: 2026-11-10 · 📄 بر اساس مستندات رسمی (Kimi Code CLI 2.5.2، تغییرات مورخ 2026-11-06؛ Kimi Code Desktop 1.3.2، تغییرات مورخ 2026-11-06) · ✅ دسترسی QCode با Kimi Code CLI 2.5.2 آزمایش شده است (2026-11-10)

## در یک نگاه

| مورد | جزئیات |
|---|---|
| مدل‌های قابل استفاده | Claude ✅ (`type = "anthropic"`) · GPT ✅ (`type = "openai"` یا `type = "openai_responses"`) · مدل‌های چینی ✅ (`type = "openai"`) · Gemini ❌ — QCode خانواده Gemini را ارائه نمی‌دهد؛ لطفاً از Claude، GPT یا یک مدل چینی استفاده کنید |
| پروتکل و Base URL | Anthropic Messages: `https://api.qcode.cc/api` · OpenAI Chat Completions: `https://api.qcode.cc/openai/v1` · OpenAI Responses: `https://api.qcode.cc/openai/v1` · هر سه ✅ با Kimi Code CLI 2.5.2 آزمایش شده‌اند (2026-11-10) |
| محل پیکربندی | `~/.kimi-code/config.toml` — یک جدول `[providers.<name>]` به‌ازای هر پروتکل، یک ورودی `[models.<alias>]` به‌ازای هر مدل |
| ورود به حساب کاربری Kimi | لازم نیست: آزمایش فقط با نوشتن `~/.kimi-code/config.toml` و بدون `kimi login` انجام شد |
| مستندات رسمی | [ارائه‌دهندگان و مدل‌ها](https://www.kimi.com/code/docs/en/kimi-code-cli/configuration/providers.html) · [متغیرهای محیطی](https://www.kimi.com/code/docs/en/kimi-code-cli/configuration/env-vars.html) · [بازنویسی پیکربندی](https://www.kimi.com/code/docs/en/kimi-code-cli/configuration/overrides.html) · [GitHub](https://github.com/MoonshotAI/kimi-code) |

[Kimi Code CLI](https://github.com/MoonshotAI/kimi-code) عامل کدنویسی Moonshot AI است که در ترمینال اجرا می‌شود. مستندات خودش سه روش برای تأمین مدل توصیف می‌کند: سرویس مدیریت‌شده Kimi Code با ورود یک‌کلیکی، «اتصال Claude با کلید API Anthropic، یا اتصال سرویس‌های استنتاج شخص ثالث از طریق پروتکل سازگار با OpenAI». همین دو مورد آخر دقیقاً همان نقاط پایانی هستند که QCode ارائه می‌دهد، بنابراین یک کلید QCode هم Claude، هم GPT و هم خانواده‌های چینی را در همان ابزار پوشش می‌دهد. در 2026-11-10 با Kimi Code CLI 2.5.2 آزمایش شد: بدون ورود به حساب کاربری Kimi، `type = "anthropic"` با `https://api.qcode.cc/api`، `type = "openai"` با `https://api.qcode.cc/openai/v1` و `type = "openai_responses"` با `https://api.qcode.cc/openai/v1` همگی پاسخ دادند. در همان تاریخ، تغییرات CLI و بسته npm `@moonshot-ai/kimi-code` هر دو 2.5.2 (2026-11-06) را به‌عنوان جدیدترین انتشار فهرست می‌کنند و تغییرات Desktop نیز 1.3.2 (2026-11-06) را فهرست می‌کند. این صفحه CLI را پوشش می‌دهد؛ اینکه Kimi Code Desktop چگونه پیکربندی خود را به اشتراک می‌گذارد در [Desktop و CLI](#desktop-and-the-cli) نزدیک انتهای صفحه توضیح داده شده است.
## کدام پروتکل

فیلد `type` در جدول `[providers.<name>]` پیاده‌سازی پروتکل را انتخاب می‌کند. مرجع رسمی شش مقدار را فهرست می‌کند — `kimi`، `anthropic`، `openai`، `openai_responses`، `google-genai`، `vertexai` — و سه پروتکل QCode از سه مورد از آن‌ها استفاده می‌کنند. هر ردیف در 2026-11-10 با Kimi Code CLI 2.5.2، به‌ترتیب با `claude-haiku-5-5`، `deepseek-v4-flash` و `gpt-6.1-terra` آزمایش شد:

| مدل‌هایی که می‌خواهید | `type` | `base_url` |
|---|---|---|
| `claude-sonnet-5`، `claude-opus-5`، `claude-haiku-5-5` | `anthropic` | `https://api.qcode.cc/api` |
| `gpt-6.1-sol`، `gpt-6-sol`، و خانواده‌های چینی | `openai` | `https://api.qcode.cc/openai/v1` |
| `gpt-6.1-terra`، `gpt-6.1-sol` از طریق پروتکل Responses | `openai_responses` | `https://api.qcode.cc/openai/v1` |

🔴 **هرگز مدل Claude را به نقطه پایانی سازگار با OpenAI متصل نکنید.** QCode خانواده Claude را فقط روی نقطه پایانی Anthropic Messages ارائه می‌دهد؛ شناسه `claude-*` که به `https://api.qcode.cc/openai/v1` فرستاده شود رد می‌شود. این دو نقطه پایانی قابل‌جایگزینی نیستند — به [نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths) مراجعه کنید.

Base URL را دقیقاً همان‌طور که در بالا آمده بنویسید: در `/api` یا `/openai/v1` توقف کنید، `/v1/messages` یا `/chat/completions` را **اضافه نکنید**، و **اسلش پایانی را باقی نگذارید**.

## نصب

مستندات دو روش ارائه می‌دهند: اسکریپت نصب رسمی، که توصیه می‌شود چون به Node.js از پیش نصب‌شده نیاز ندارد، و نصب سراسری با npm.

```sh
# macOS / Linux
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

# Windows (PowerShell)
irm https://code.kimi.com/kimi-code/install.ps1 | iex

# npm — check your runtime first with: node --version
npm install -g @moonshot-ai/kimi-code
```

روش npm **به Node.js 22.19.0 یا جدیدتر نیاز دارد**. اسکریپت آخرین انتشار را دانلود می‌کند، چک‌سام را بررسی می‌کند و فایل اجرایی `kimi` را در `PATH` شما قرار می‌دهد. باینری را تأیید کنید، سپس به دایرکتوری پروژه خود بروید و `kimi` را اجرا کنید تا رابط کاربری تعاملی باز شود:

```sh
kimi --version
cd your-project
kimi
```

## config.toml حداقلی (آزمایش‌شده)

این همان فایلی است که در آزمون 2026-11-10 با Kimi Code CLI 2.5.2 استفاده شد: یک ارائه‌دهنده برای هر پروتکل و یک نام مستعار مدل روی هر کدام. `api_key_env` باعث می‌شود CLI در هر درخواست کلید را از `QCODE_API_KEY` بخواند، بنابراین خود فایل هیچ کلیدی نگه نمی‌دارد؛ نام متغیر به خود شما بستگی دارد.

```toml
# ~/.kimi-code/config.toml
default_model = "qcode-haiku"

[providers.qcode-anthropic]
type = "anthropic"
base_url = "https://api.qcode.cc/api"
api_key_env = "QCODE_API_KEY"

[providers.qcode-openai]
type = "openai"
base_url = "https://api.qcode.cc/openai/v1"
api_key_env = "QCODE_API_KEY"

[providers.qcode-responses]
type = "openai_responses"
base_url = "https://api.qcode.cc/openai/v1"
api_key_env = "QCODE_API_KEY"

[models.qcode-haiku]
provider = "qcode-anthropic"
model = "claude-haiku-5-5"
max_context_size = 200000

[models.qcode-dsflash]
provider = "qcode-openai"
model = "deepseek-v4-flash"
max_context_size = 128000

[models.qcode-terra]
provider = "qcode-responses"
model = "gpt-6.1-terra"
max_context_size = 128000
```

کلید را تنظیم کنید و بدون باز کردن TUI برای هر نام مستعار یک prompt بفرستید:

```sh
export QCODE_API_KEY=cr_your_qcode_key
kimi -p "Reply with exactly: OK"
kimi -p "Reply with exactly: OK" -m qcode-dsflash
kimi -p "Reply with exactly: OK" -m qcode-terra
```

`kimi -p` یک prompt واحد را به‌صورت غیرتعاملی اجرا می‌کند و پاسخ را چاپ می‌کند؛ `-m` یک نام مستعار مدل انتخاب می‌کند و بدون آن از `default_model` استفاده می‌شود. در آزمون، هر سه خط `• OK` را چاپ کردند (CLI متن دستیار را با `•` پیشوند می‌کند). بخش‌های زیر فیلدها و نحوه افزودن مدل‌ها را توضیح می‌دهند؛ قطعه‌کدهای آن‌ها نام‌های ارائه‌دهنده `qcode-anthropic`، `qcode-openai` و `qcode-responses` را دوباره استفاده می‌کنند، بنابراین این فایل را گسترش می‌دهند نه اینکه جایگزین آن شوند.
## پیکربندی Claude (`type = "anthropic"`)

اطلاعات ورود فقط در فایل پیکربندی قرار می‌گیرند. مستندات صراحتاً می‌گویند که CLI «به‌طور خودکار به متغیرهای محیطی شل **رجوع نمی‌کند**: اجرای `export KIMI_API_KEY` در ترمینال کلید را به هیچ ارائه‌دهنده‌ای نمی‌دهد» — یا کلید در فایل نوشته می‌شود، یا `api_key_env` نام متغیری را مشخص می‌کند که CLI در هر درخواست می‌خواند.

در فایل کمینه، بخش Claude شامل `[providers.qcode-anthropic]` به‌همراه نام مستعار `qcode-haiku` است. برای افزودن مدل Claude دیگر، یک نام مستعار دیگر اضافه کنید که به همان ارائه‌دهنده اشاره کند، و اگر باید پیش‌فرض باشد، `default_model` را روی آن تنظیم کنید:

```toml
[models."claude-sonnet-5"]
provider = "qcode-anthropic"
model = "claude-sonnet-5"
max_context_size = 262144
```

برای امتحان کردن یک مدل بدون تغییر فایل، از خانواده `KIMI_MODEL_*` استفاده کنید: وقتی `KIMI_MODEL_NAME` تنظیم شده باشد، CLI یک ارائه‌دهنده موقت در حافظه می‌سازد و هیچ چیز در `config.toml` نوشته نمی‌شود. `KIMI_MODEL_NAME` و `KIMI_MODEL_API_KEY` الزامی‌اند؛ `KIMI_MODEL_PROVIDER_TYPE` (`kimi`، `anthropic` یا `openai`، پیش‌فرض `kimi`)، `KIMI_MODEL_BASE_URL` و `KIMI_MODEL_MAX_CONTEXT_SIZE` اختیاری‌اند. گزینه `-m <alias>` هنگام شروع همچنان بالاترین اولویت را دارد.

```sh
export KIMI_MODEL_NAME=claude-sonnet-5
export KIMI_MODEL_API_KEY=cr_your_qcode_key
export KIMI_MODEL_PROVIDER_TYPE=anthropic
export KIMI_MODEL_BASE_URL=https://api.qcode.cc/api
export KIMI_MODEL_MAX_CONTEXT_SIZE=262144
kimi
```

`qcode-anthropic` فقط نام ارائه‌دهنده‌ای است که خودتان برای آن انتخاب می‌کنید — هر ورودی `[models.<alias>]` از طریق فیلد الزامی `provider` خود به آن اشاره می‌کند. اگر ترجیح می‌دهید هیچ متغیر محیطی نداشته باشید، `api_key_env` را با `api_key = "cr_your_qcode_key"` جایگزین کنید؛ مستندات اشاره می‌کنند که این مقدار به‌صورت متن ساده در فایل پیکربندی ذخیره می‌شود، و این دو فیلد جایگزین‌های متقابلاً انحصاری‌اند — دقیقاً یکی را تنظیم کنید.

| فیلد | جدول | چه چیزی در آن قرار می‌گیرد |
|---|---|---|
| `type` | providers | `anthropic`، ارائه‌دهنده‌ای که مستندات برای «اتصال به Claude API» معرفی کرده است |
| `base_url` | providers | `https://api.qcode.cc/api`؛ اگر حذف شود، نوع از پیش‌فرض Anthropic SDK پیروی می‌کند |
| `api_key` / `api_key_env` | providers | خود کلید، یا نام متغیری که آن را نگه می‌دارد |
| `custom_headers` | providers | جدول اختیاری سرصفحه‌های HTTP اضافی که به هر درخواست پیوست می‌شوند |
| `provider` | models | الزامی — نام ارائه‌دهنده‌ای که بالا تعریف شد |
| `model` | models | الزامی — شناسه‌ای که به سرور فرستاده می‌شود، مثلاً `claude-sonnet-5` |
| `max_context_size` | models | الزامی، حداقل 1 توکن — `262144` در مثال بالا یک جای‌نگهدار است؛ از طول زمینه‌ای استفاده کنید که مدل شما واقعاً مستند کرده است |
| `max_output_size` | models | سقف خروجی اختیاری که به `max_tokens` نگاشت می‌شود؛ در حال حاضر فقط ارائه‌دهنده `anthropic` آن را می‌خواند |

> **سرزمین اصلی چین**: نقطه پایانی Anthropic همچنین روی `https://asia.qcode.cc/api` و `https://us.qcode.cc/api` با همان کلید پاسخ می‌دهد — میزبان را در `base_url` عوض کنید و هیچ چیز دیگری را.
> **قابلیت‌ها**: نام‌های استاندارد مدل Claude خودبه‌خود بینایی، استفاده از ابزار و Thinking را دارند؛ نامی که CLI پوشش نمی‌دهد باید `capabilities` را به‌صراحت روی `[models.<alias>]` اعلام کند (`thinking`، `image_in`، `tool_use`، …)، و این برچسب‌ها فقط اضافه می‌شوند و هرگز حذف نمی‌شوند.
## پیکربندی GPT و مدل‌های چینی (`type = "openai"`)

همان فایل، نقطه پایانی دیگر. نوع `openai` برای پروتکل OpenAI Chat Completions مستند شده است، «و همچنین هر سرویس شخص ثالثی که با آن پروتکل سازگار باشد (در صورت نیاز `base_url` را بازنویسی کنید)» — بازنویسی آن است که این اتصال را به‌جای اتصال OpenAI، به QCode تبدیل می‌کند، زیرا مقدار پیش‌فرض توکار `https://api.openai.com/v1` است.

فایل حداقلی از پیش `[providers.qcode-openai]` را با نام مستعار `qcode-dsflash` تعریف می‌کند. هر مدل GPT یا چینی دیگر، یک نام مستعار دیگر روی همان ارائه‌دهنده است:

```toml
[models."gpt-6.1-sol"]
provider = "qcode-openai"
model = "gpt-6.1-sol"
max_context_size = 262144

[models."deepseek-v4.1-flash"]
provider = "qcode-openai"
model = "deepseek-v4.1-flash"
max_context_size = 262144

[models."qwen3.8-max"]
provider = "qcode-openai"
model = "qwen3.8-max"
max_context_size = 262144
```

- **نام‌های مستعاری را که شامل نقطه هستند، درون گیومه قرار دهید.** `gpt-6.1-sol` و `qwen3.8-max` باید به‌صورت `[models."qwen3.8-max"]` نوشته شوند؛ در حالت بدون گیومه، TOML نقطه را به‌عنوان جداکننده جدول تودرتو می‌خواند. نام‌های فیلد خودشان در همه‌جا snake_case هستند (`default_model`، `max_context_size`).
- اعداد بالا جای‌نگهدارهایی برای یک فیلد الزامی هستند — از طول زمینه‌ای استفاده کنید که خود مدل مستند می‌کند. هزینه‌دهی به‌ازای توکن است؛ نرخ‌های هر مدل در [qcode.cc/models](https://qcode.cc/models) فهرست شده‌اند.
- هر سه ارائه‌دهنده می‌توانند در یک پیکربندی هم‌زیستی داشته باشند. مدل را برای هر نشست با `-m <alias>` انتخاب کنید؛ مستندات آن را بالاتر از فایل پیکربندی قرار می‌دهد اما فقط برای همان راه‌اندازی معتبر است، یا داخل TUI با `/model` جابه‌جا شوید. `default_model` باید یکی از نام‌های مستعاری باشد که تعریف کرده‌اید.
- خروجی استدلال: CLI خودش فیلد `reasoning_content` و تزریق `reasoning_effort` را برای مدل‌های استدلالی شخص ثالث مدیریت می‌کند؛ اگر یک درگاه آن محتوا را با نام فیلد غیراستاندارد برگرداند، `reasoning_key` را روی نام مستعار مدل تنظیم کنید.
- **پروتکل Responses.** نوع `openai_responses` به‌عنوان رابط جدیدتر Responses در OpenAI مستند شده است، همیشه به‌صورت جریانی، با این توضیح که «پیکربندی همانند `openai` است». بنابراین `[providers.qcode-responses]` در فایل حداقلی همان `base_url = "https://api.qcode.cc/openai/v1"` را می‌گیرد که در 2026-11-10 با `gpt-6.1-terra` آزمایش شده است؛ شناسه‌های بیشتر GPT، نام‌های مستعار بیشتری روی همان ارائه‌دهنده هستند. خانواده‌های چینی روی Responses ارائه نمی‌شوند، بنابراین آن‌ها را روی `qcode-openai` نگه دارید.
- شناسه‌های بیشتر برای این نقطه پایانی در [مدل‌های چینی](/docs/usage/cn-models) آمده است. شناسه‌های `claude-*` در اینجا **کار نمی‌کنند**.
## بررسی

فایل‌ها را بدون راه‌اندازی TUI بررسی کنید:

```sh
kimi doctor
kimi doctor config
```

`kimi doctor` فایل‌های `config.toml` و `tui.toml` را بدون راه‌اندازی TUI یا تغییر هر یک از این دو فایل اعتبارسنجی می‌کند، و وقتی هر فایل بررسی‌شده معتبر یا نادیده‌گرفته‌شده باشد با `0` خارج می‌شود، و وقتی یکی از آن‌ها موجود نباشد یا نامعتبر باشد با `1` خارج می‌شود. دامنه مستندشده اعتبارسنجی همان دو فایل است؛ مستندات آن را به‌عنوان آزمون این موضوع که نقطه پایانی پاسخ می‌دهد یا نه توصیف نمی‌کند.

بررسی کنید CLI در واقع چه چیزی را ثبت کرده است:

```sh
kimi provider list
```

سپس TUI را باز کنید و `/provider` را تایپ کنید. این همان مدیر ارائه‌دهنده تعاملی است: ↑/↓ مکان‌نما را حرکت می‌دهد، `d` ارائه‌دهنده فعلی را پس از تأیید `[y/N]` حذف می‌کند، و فشار دادن Enter روی ردیف `[ Add New Platform ]` یک مورد جدید اضافه می‌کند (از کاتالوگ models.dev، یا از یک URL رجیستری سفارشی). ارائه‌دهندگانی که با `/login` متصل شده‌اند آنجا ظاهر نمی‌شوند. این همان جایی است که ارائه‌دهندگان پیکربندی‌شده را مشاهده، اضافه و حذف می‌کنید؛ `kimi provider` معادل غیرتعاملی آن برای اسکریپت‌ها و CI است.

سپس یک prompt واقعی از طریق CLI بفرستید، یک بار برای هر نام مستعار: `kimi -p "Reply with exactly: OK" -m <alias>`. در آزمون 2026-11-10، هر نام مستعار در فایل حداقلی با `• OK` پاسخ داد.

در پایان، نقطه پایانی را مستقیماً آزمایش کنید (کلید خودتان را جایگزین کنید):

```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"}]}'
```

این درخواست curl کلید و نقطه پایانی Anthropic را خارج از ابزار بررسی می‌کند: یک پاسخ JSON دارای محتوا یعنی هر دو درست هستند، و بدنه خطا مسیر نادرست یا کلید نادرست را از مدلی که در آن نقطه پایانی ارائه نمی‌شود جدا می‌کند.

> یک میان‌بر شخص ثالث وجود دارد، `kimi provider catalog add anthropic --api-key sk-ant-... --default-model claude-opus-4-7`، که در آن کاتالوگ پروتکل، Base URL و فهرست مدل را تأمین می‌کند و `--base-url` نقطه پایانی را بازنویسی می‌کند (`--default-model` مقدار `default_model` را به‌صورت `<providerId>/<modelId>` می‌نویسد). شناسه در آن مثال از کاتالوگ عمومی می‌آید، نه از QCode، و این صفحه تأیید نکرده است که QCode در آنجا فهرست شده است یا نه، بنابراین مسیر TOML بالا چیزی است که این صفحه توصیه می‌کند.

## عیب‌یابی و محدودیت‌های شناخته‌شده

| نشانه | آنچه مستندات می‌گویند | چه کاری انجام دهید |
|---|---|---|
| راه‌اندازی شکست می‌خورد و شکایت می‌کند که یک ارائه‌دهنده اعتبارنامه ندارد | اولویت با `api_key` یا `api_key_env` است (دقیقاً یکی را تنظیم کنید)، سپس کلید `[providers.<name>.env]`، و اگر همه غایب باشند راه‌اندازی با خطا شکست می‌خورد | نام‌های متعارف برای این نوع `ANTHROPIC_API_KEY` و `ANTHROPIC_BASE_URL` هستند، که داخل `[providers.qcode-anthropic.env]` نوشته می‌شوند — این‌ها کلیدهای فایل پیکربندی هستند، نه جستجوهای پوسته. هنگام بازآوری `/models`، ارائه‌دهنده‌ای با متغیر تنظیم‌نشده به‌عنوان ناموفق گزارش می‌شود بدون آنکه روی بقیه تأثیر بگذارد |
| به نظر می‌رسد `export ANTHROPIC_API_KEY=…` نادیده گرفته می‌شود | متغیرهای پوسته یک جایگزین عمومی نیستند؛ دو کانالی که واقعاً پوسته را می‌خوانند `api_key_env` یک ارائه‌دهنده و خانواده `KIMI_MODEL_*` هستند | از `api_key_env` استفاده کنید. `KIMI_MODEL_PROVIDER_TYPE` مقادیر `kimi`، `anthropic`، `openai` را می‌پذیرد، و تنظیم `KIMI_MODEL_NAME` یک ارائه‌دهنده موقت در حافظه می‌سازد که با راه‌اندازی مجدد ناپدید می‌شود |
| ویرایش فایل به نظر می‌رسد هیچ کاری نمی‌کند | گزینه‌های راه‌اندازی برای نشست فعلی از فایل اولویت بالاتری دارند؛ فایل در زمان راه‌اندازی خوانده می‌شود | `kimi` را دوباره راه‌اندازی کنید، یا `/reload` را اجرا کنید تا آخرین `config.toml` در نشست در حال اجرا اعمال شود |
| خطای پیکربندی یا پیدا نشدن نام مستعار وقتی یک نام مستعار نقطه‌دار بدون گیومه رها می‌شود | `default_model` باید در `models` تعریف شده باشد، و یک نام مستعار نقطه‌دار بدون گیومه به یک جدول تودرتو تبدیل می‌شود | نام مستعار را داخل گیومه قرار دهید: `[models."qwen3.8-max"]` |
| `404` یا خطای مسیر | مستندات چیزی درباره اینکه یک دروازه شخص ثالث چگونه مسیر را می‌سازد نمی‌گویند | `base_url` باید در `/api` (Claude) یا `/openai/v1` (GPT، چینی) متوقف شود، بدون اسلش انتهایی و بدون افزودن مسیر API |
| Claude در ارائه‌دهنده `openai` رد شد | — | QCode خانواده Claude را در آنجا ارائه نمی‌دهد؛ آن را به `type = "anthropic"` منتقل کنید |
| یک پروژه به نقطه پایانی متفاوتی نیاز دارد | هیچ سازوکار فایل پیکربندی در سطح پروژه وجود ندارد — Kimi Code یک فایل واحد در سطح کاربر می‌خواند، با نام `config.toml`، هر جا که باشد | پیش از راه‌اندازی، `KIMI_CODE_HOME` را روی یک پوشه داده مخصوص هر پروژه تنظیم کنید |
| `kimi doctor` هشدار می‌دهد `Unknown top-level key ignored by the v2 engine: auto_session_title.` | صفحه فایل‌های پیکربندی، `auto_session_title` را به‌عنوان یک فیلد سطح بالا فهرست می‌کند | فقط یک هشدار است: 2.5.2 آن کلید را نادیده می‌گیرد و همچنان پیکربندی را معتبر می‌داند؛ می‌توانید آن خط را حذف کنید |

فراتر از خود ابزار:

- **ورود**: `kimi login` و `/login` به سرویس مدیریت‌شده Kimi Code وارد می‌شوند؛ راه‌اندازی QCode در این صفحه به هیچ‌کدام نیاز ندارد (با 2.5.2 در 2026-11-10 آزمایش شده است).
- **Gemini**: Kimi Code یک نوع `google-genai` برای دسترسی مستقیم به Google Gemini دارد، اما QCode خانواده Gemini را ارائه نمی‌دهد. از Claude، GPT یا یک مدل چینی استفاده کنید.
- **luna**: QCode مدل `gpt-6-luna` یا `gpt-5.6-luna` را ارائه نمی‌دهد؛ شناسه GPT دیگری مانند `gpt-6.1-sol`، `gpt-6-sol` یا `gpt-5.6-terra` انتخاب کنید.
- `max_output_size` فقط توسط ارائه‌دهنده `anthropic` خوانده می‌شود، بنابراین سقف خروجی تنظیم‌شده روی یک نام مستعار `openai` اثری ندارد.
- اینکه برای کدام کار کدام مدل را انتخاب کنید در [انتخاب مدل](/docs/usage/model-selection) پوشش داده شده است؛ اگر درخواست به دلایلی خارج از این ابزار شکست بخورد، [عیب‌یابی](/docs/reference/troubleshooting) را دنبال کنید.
## دسکتاپ و CLI

Kimi Code Desktop و CLI پیکربندی محلی را به اشتراک می‌گذارند. مستندات دسکتاپ می‌گویند این دو «می‌توانند روی همان ماشین نصب شوند و برخی از پیکربندی‌های محلی، مانند حساب کاربری، مدل، ارائه‌دهنده و تنظیمات مرتبط با افزونه را به اشتراک بگذارند» و `~/.kimi-code/` را محل نگهداری «پیکربندی، اعتبارنامه‌های حساب کاربری، نشست‌ها و گزارش‌ها (مشترک با CLI)» معرفی می‌کنند. مستندات می‌افزایند که دامنه دقیق اشتراک‌گذاری تابع تنظیمات و فایل‌های پیکربندی هر محصول است. این صفحه فقط مسیر `config.toml` را پوشش می‌دهد و مراحل Settings دسکتاپ را ارائه نمی‌دهد، زیرا صفحات رسمی راه‌اندازی در سطح فیلد را برای آن‌ها توصیف نمی‌کنند.

## kimi-cli قدیمی‌تر

ابزار قدیمی‌تر مبتنی بر Python، kimi-cli، از `~/.kimi/config.toml` استفاده می‌کرد. صفحه رسمی «What's new» بیان می‌کند که Kimi Code CLI از `~/.kimi-code/config.toml` استفاده می‌کند و قالب آن ناسازگار است؛ `kimi migrate` پیکربندی، نشست‌ها و تعریف‌های MCP موجود kimi-cli را در یک مرحله منتقل می‌کند. راهنماهایی که برای فایل قدیمی نوشته شده‌اند، برای جدول‌های بالا کاربرد ندارند.

## مرتبط

- [نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths) — پروتکل در برابر خانواده مدل
- [سازگاری ابزارها](/docs/ide/tool-compatibility) — کدام ابزارها با کدام پروتکل ارتباط برقرار می‌کنند
- [مدل‌های چینی](/docs/usage/cn-models) — شناسه‌ها و مسیرها برای نقطه پایانی OpenAI
- [انتخاب مدل](/docs/usage/model-selection) — تطبیق مدل با وظیفه
- [راه‌اندازی OpenCode](/docs/ide/opencode) — یک عامل ترمینالی دیگر روی همان دو نقطه پایانی
- [راه‌اندازی MiniMax Code](/docs/ide/minimax-code) — اپلیکیشن دسکتاپ و CLI `mcode`، آزمایش‌شده روی همان سه نقطه پایانی