最后更新
Codex Kimi:在 Codex 中使用 Kimi K3 与 K2.7
本指南教你如何用 Codex Router 把 Kimi 模型——Kimi K3 与 K2.7 Coding 条目——加进 Codex 模型选择器。Kimi 的特殊之处在于它有两条完全独立的认证与计费路径:Kimi Code CLI OAuth 会话与 Kimi Platform API Key。两条路径都受支持,而且可以共存。
可以添加什么
| 选择器标签 | 模型 ID | 认证方式 |
|---|---|---|
| K2.7 Coding Highspeed (OAuth) | kimi-oauth/kimi-for-coding-highspeed | 已有的 Kimi Code CLI OAuth 会话 |
| K2.7 Coding (OAuth) | kimi-oauth/kimi-for-coding | 已有的 Kimi Code CLI OAuth 会话 |
| Kimi K3 (OAuth) | kimi-oauth/k3 | 已有的 Kimi Code CLI OAuth 会话 |
| Kimi K3 (API) | kimi-api/kimi-k3 | 独立计费的 Kimi Platform API Key |
Kimi K2.7 Code 也可以通过 ollama-cloud/kimi-k2.7-code(Ollama Cloud 账户)获取,单独计费。
选择认证方式
- Kimi Code OAuth 复用官方 Kimi Code CLI 会话。无需额外保存:路由器从
$KIMI_CODE_HOME或~/.kimi-code读取凭据并在跨进程锁下刷新。已经用 Kimi Code 的话选这个。 - Kimi Platform API 使用通过隐藏提示输入的、独立计费的 Kimi Platform API Key。想让 Kimi K3 计入开发者平台账户的话选这个。
两个 Kimi 条目刻意共存:OAuth 与 Platform 是独立的账户与计费体系,路由器绝不在两者之间共享凭据。不要把 OAuth token 复制进密钥文件或环境变量。
启用 Kimi OAuth
先安装官方 Kimi Code CLI(如未安装),然后登录:
kimi login
再在路由器中启用 OAuth 供应商:
./bin/model-router codex providers enable kimi-oauth
./bin/model-router codex doctor
引导式安装会在 CLI 存在时自动运行 kimi login,所以走引导向导的话可能不需要手动这一步。
启用 Kimi API
./bin/model-router codex provider-key kimi-api set
./bin/model-router codex providers enable kimi-api
隐藏提示会关闭终端回显。Windows 上用 ./codex-router.ps1 codex provider-key kimi-api set。
验证集成
./bin/model-router codex doctor
./bin/model-router codex providers
连接后 kimi-oauth 与 kimi-api 都应报告 SHOW 与 ready。然后完全退出 Codex、重新打开、新建任务,在选择器中找 Kimi K3(与 K2.7 条目)。对 OAuth 路由做实时检查:
./bin/test-model 'kimi-oauth/k3' --live --yes
Kimi 请求的行为
Kimi K3 API 请求选择 kimi-k3 上游模型并强制最大推理。Kimi Code OAuth 保留自己的刷新与设备身份行为,长时间会话无需重新登录。原生 GPT 模型与 ChatGPT 登录不受影响——路由器保持内置 OpenAI 供应商原样。
常见坑
- OAuth 不是 API Key。
kimi-oauth显示needs-sign-in就重跑kimi login;kimi-api显示needs-key就设置平台密钥。两者不能互相替代。 - 密钥绝不进对话。 路由器以隐藏方式提示密钥,诊断只报告存在与来源。
- 供应商策略风险。 Moonshot AI 可能限制或封禁代理流量。通过第三方路由器路由 Kimi 风险自负(UAYOR)。
- Windows 用户: Kimi OAuth 在 Windows 可用;但若同时用 Grok OAuth,注意 Smart App Control 的坑。