标签:Codex CLI、Kimi Code、AI 编程 Agent、终端 AI、避坑 适合人群:想使用 Codex TUI,但被 OpenAI 地区风控、账号认证问题卡住的开发者
问题背景
最近在使用官方 OpenAI Codex CLI(终端 TUI 编程 Agent)时,接连踩了两个经典认证坑:
- 启动报错:
account/read failed during TUI bootstrap: account/read failed: plan type is required for chatgpt authentication (code -32600) - 改用设备码登录后,又遇到:
Token exchange failed: token endpoint returned status 403 Forbidden: Country, region, or territory not supported
简单说下根源:
-32600:走 ChatGPT 账号设备认证时,JWT Token 缺少套餐类型plan_type字段,是账号登录模式的固有缺陷;- 403 地区拦截:
codex login --device-auth的 OAuth 设备认证链路对出口 IP 地区校验极严,浏览器能登录 ChatGPT,不代表终端设备认证可以通过,新加坡节点(SIN)经常直接拦截。
这两个报错都来自 OpenAI 账号登录链路。只要还在用 codex login 登录 ChatGPT 账号,就很难稳定绕开这套风控。
有两条出路:
- 使用 OpenAI Platform API Key 登录:可以绕过地区校验,但消耗平台余额,不使用 ChatGPT Plus 订阅额度;
- 把 Codex CLI 的后端替换成 Kimi Code:保留熟悉的 Codex TUI 交互、快捷键和工作流,后端转发到 Kimi Code,彻底脱离 OpenAI 账号认证体系,上面两个报错全部消失。
本文重点讲第二种方案:OpenAI Codex CLI 接入 Kimi Code。
注意区分两个工具,很多人会混淆:
- OpenAI Codex CLI:
codex命令,OpenAI 出品的终端 TUI Agent;- Kimi Code CLI:
kimi命令,月之暗面官方独立终端编程 Agent,是另一套程序。
前置准备
- 安装 Codex CLI
npm install -g @openai/codex
- 前往 Kimi Code 控制台获取
KIMI_API_KEY
⚠️ 重要提醒:Kimi Code 的 Key 和 Moonshot 开放平台 Key 不互通,域名、计费、额度相互独立,不要拿错。
- 接口地址
- 国内:
https://api.kimi.com/coding/v1 - 海外:
https://api.kimi.ai/coding/v1
- 国内:
配置 config.toml
配置文件路径:
清空原有冲突配置,写入下面内容:
model = "k3.1-pro"
model_provider = "kimi"
web_search = "live"
[model_providers.kimi]
name = “Kimi” base_url = “https://api.kimi.com/coding/v1” env_key = “KIMI_API_KEY” wire_api = “responses”
如果想要更快的响应速度,可以把模型改为:
model = "k3.1-pro-highspeed"
建议删掉旧配置里残留的
model_catalog_json、service_tier字段,容易引发冲突。
启动方式(重点:不再执行 codex login)
这套方案完全不需要 codex login,这也是避开 OpenAI 认证风控的核心。
macOS / Linux
export KIMI_API_KEY="你的KimiCode密钥"
codex
Windows PowerShell
$env:KIMI_API_KEY="你的KimiCode密钥"
codex
直接拉起 Codex TUI,底层请求全部走 Kimi Code。 启动成功后,模型一栏显示 k3.1-pro 即代表接入生效。
备选方案:原生 Kimi Code CLI
如果你并不执着于 Codex 的 TUI 界面,只想找一个国内网络友好的终端编程 Agent,直接使用 Kimi 官方的 kimi CLI 会更省心,没有额外适配成本。
安装脚本: 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
安装完成后直接执行:
kimi
原生支持文件读写、代码修改、Shell 调用、联网搜索,国内直连稳定。
避坑清单
- ❌ Kimi Code Key ≠ Moonshot 开放平台 API Key,两者不能混用;
- ❌ 不要同时设置
OPENAI_API_KEY和KIMI_API_KEY,会出现 provider 串号; - ❌ 不要执行
codex login --device-auth,一旦登录会切回 OpenAI 账号认证链路; - ✅ 启动前确认没有残留的 Codex 登录会话,可先执行
codex logout清理; - ✅ 本方案只是替换后端模型,Codex 本身的快捷键、会话管理、文件能力保持原样。
两条路线对比
表格
| 方案 | 优点 | 缺点 |
|---|---|---|
| OpenAI Codex CLI + Kimi Provider | 保留 Codex 熟悉的 TUI、快捷键、社区 Skill 生态 | 需要手动维护配置文件,依赖 Node/npm |
| 原生 Kimi Code CLI | 国内直连、一键安装、官方维护、无 OpenAI 相关限制 | 独立界面,没有 Codex 社区生态 |
小结
如果你只是单纯想跑 Codex TUI,又被 OpenAI 地区 403、plan type -32600 认证问题反复折磨,把后端换成 Kimi Code 是性价比很高的解法。不再和 OpenAI 的账号风控博弈,同时保留已经习惯的终端交互。
如果你不需要 Codex 的界面,直接上原生 Kimi Code CLI,是更轻量化、稳定的选择。