# Kimi

來源: https://docs.aicentos.com/zh-TW/clients/kimi

Language: zh-TW

> 在 Kimi Code CLI 中使用 aicentos —— 透過 config.toml 註冊 OpenAI 相容 provider

Kimi Code CLI 允許把任意 OpenAI 相容服務註冊成 provider。把 `base_url` 指向 aicentos、填入 API Key，就能在終端機介面裡直接呼叫 aicentos 接入的模型。

## 準備工作

先在控制台「API Key」頁面為 Kimi Code 建立一個專用 Key（建議命名 `kimi-cli`，方便追蹤用量）。

* 控制台：[https://aicentos.com](https://aicentos.com)
* 建立 Key：[https://aicentos.com/keys](https://aicentos.com/keys)
* 錢包儲值：[https://aicentos.com/wallet](https://aicentos.com/wallet)
* 文件站：[https://docs.aicentos.com](https://docs.aicentos.com)

設定檔預設位於 `~/.kimi/config.toml`，首次執行 Kimi Code 時會自動建立。

## 需要填寫的設定

| 欄位          | 值                                    |
| ----------- | ------------------------------------ |
| provider 類型 | `openai_legacy`（Chat Completions 協定） |
| base\_url   | `https://aicentos.com/v1`            |
| api\_key    | 控制台建立的 Key                           |
| model       | 控制台「模型廣場」中的模型名稱                      |

如果 aicentos 側走的是 Responses 協定，把類型換成 `openai_responses` 即可。

## 設定步驟

開啟 `~/.kimi/config.toml`，追加一個自訂 provider 和一個模型別名：

```toml
default_model = "aicentos-gpt-4o"

[providers.aicentos]
type = "openai_legacy"
base_url = "https://aicentos.com/v1"
api_key = "sk-你的Key"

[models.aicentos-gpt-4o]
provider = "aicentos"
model = "gpt-4o"
max_context_size = 128000
```

* provider 名（`aicentos`）和模型別名（`aicentos-gpt-4o`）都可以自訂，`default_model` 裡寫的是別名，不是伺服器端模型 ID。
* 別名裡如果帶 `.`（例如 `gpt-4.1`），TOML 裡必須加引號：`[models."gpt-4.1"]`，否則 `.` 會被當成表的分隔符。
* 不想手寫 TOML 的話，在 TUI 裡輸入 `/provider` 開啟供應商管理器，在 `[ Add New Platform ]` 一行按 Enter，按精靈指示新增。

也可以只走環境變數（對 `openai_legacy` / `openai_responses` 類型生效）：

```bash
export OPENAI_BASE_URL="https://aicentos.com/v1"
export OPENAI_API_KEY="sk-你的Key"
```

## 測試

啟動 `kimi`，在 TUI 裡傳送一句簡單提示詞，能正常回應即接入成功。用 `/model` 確認目前選中的是剛才設定的別名。

## 注意事項

* provider 憑證按 `api_key` 欄位 > `[providers.<name>.env]` 子表 > 啟動報錯 的順序解析；除 `openai_legacy` / `openai_responses` 外，設定檔裡的憑證不會從 shell 環境變數自動補齊。
* `type = "kimi"` 是給 Moonshot 官方端點用的，接入 aicentos 請用 `openai_legacy` 或 `openai_responses`。
* `max_context_size` 不要填低於模型實際視窗的值，填小了會提前觸發上下文壓縮。
* Base URL 只填到 `/v1`，不要補成 `/v1/chat/completions` 完整路徑。
* 模型名稱以控制台「模型廣場」為準（參考 [支援的模型](https://docs.aicentos.com/zh-TW/billing/models-list)）。