本文档记录如何将 kimi-cli 从官方 Kimi 服务切换到第三方 OpenAI 兼容中转 API。
最后更新时间：2026/05/08

---

一、核心原理

kimi-cli 支持两种协议：

• kimi：Kimi 官方原生协议
• openai_legacy：OpenAI 兼容协议（大多数第三方中转站使用此协议）

关键：第三方中转通常只提供 OpenAI 兼容接口，因此必须使用 openai_legacy 类型。

---

二、配置步骤

步骤 1：修改 config.toml

文件路径：C:\Users\admin\.kimi\config.toml

添加新的 provider 和 model：

[providers.proxy]
type = "openai_legacy"
base_url = "https://你的中转域名/v1"
api_key = "sk-你的第三方API密钥"

[models.proxy-model]
provider = "proxy"
model = "kimi-k2.6"
max_context_size = 262144

将默认模型改为新配置：

default_model = "proxy-model"

步骤 2：设置系统环境变量（重要）

kimi-cli 会优先读取 OPENAI_BASE_URL 和 OPENAI_API_KEY 环境变量，如果这两个变量存在且指向错误地址，config.toml 会被覆盖。

在 PowerShell 中执行：

[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://你的中转域名/v1", "User")
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-你的第三方API密钥", "User")

执行后必须重启终端才能生效。

步骤 3：验证配置

启动 kimi：

kimi

进入交互界面后输入：

/config

或观察顶部状态栏，确认当前使用的是 proxy-model。

---

三、保留官方配置（方便切换）

建议在 config.toml 中保留官方配置，需要切回时只需改一行 default_model：

# 切回官方 Kimi
default_model = "kimi-for-coding"

# 使用第三方中转
default_model = "proxy-model"

---

四、常见问题

1. 报错 401 - Invalid Authentication

原因：系统环境变量 OPENAI_API_KEY 或 OPENAI_BASE_URL 与 config.toml 不一致，环境变量优先级更高。

解决：

• 检查环境变量：Get-ChildItem Env: | Select-String -Pattern "OPENAI"
• 确保环境变量指向正确的第三方中转地址和 Key

2. 报错 404 - model_not_found

原因：model 名称与中转商实际支持的模型 ID 不匹配。

解决：将 model = "kimi-k2.6" 改为中转商提供的实际模型名。

3. 报错 404 - Not Found

原因：base_url 路径不对。

解决：尝试去掉 /v1，改为 base_url = "https://你的中转域名"。

---

五、快速回滚

如果配置出现问题，恢复原始配置：

cp ~/.kimi/config.toml.bak.* ~/.kimi/config.toml

然后修改 default_model 为 "kimi-for-coding"。

---

六、配置优先级（由高到低）

1. CLI 参数（如 kimi --model xxx）
2. 当前进程环境变量（OPENAI_BASE_URL / OPENAI_API_KEY）
3. config.toml 配置文件

注意：环境变量优先级高于配置文件，这是最容易踩坑的地方。