最后更新

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。两条路径都受支持,而且可以共存。

KimiKimiOAuthAPI 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-oauthkimi-api 都应报告 SHOWready。然后完全退出 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 loginkimi-api 显示 needs-key 就设置平台密钥。两者不能互相替代。
  • 密钥绝不进对话。 路由器以隐藏方式提示密钥,诊断只报告存在与来源。
  • 供应商策略风险。 Moonshot AI 可能限制或封禁代理流量。通过第三方路由器路由 Kimi 风险自负(UAYOR)。
  • Windows 用户: Kimi OAuth 在 Windows 可用;但若同时用 Grok OAuth,注意 Smart App Control 的坑

官方链接

相关:模型总览Codex 中的 DeepSeekCodex 中的 GLM安装