Codex 接 Kimi K3.1 Pro:配置模板和排错清单

S1哥 今日赠品 · 2026-10-31

配套教程:https://x.com/swordBluesy/status/2116378390727139699

来源:Kimi 开放平台官方文档《在 Codex 里使用 Kimi K3.1 Pro》。配置内容照官方原样抄,不要把 Key 写进 config.toml。

一、先决条件
1. 按 OpenAI 官方说明装好 Codex,并至少启动过一次
2. 在 Kimi 开放平台创建并保存 API Key
3. platform.kimi.ai 创建的 Key 只能配 https://api.moonshot.ai/v1

二、设置 Key(macOS / Linux)
echo "Paste your Kimi API key and press Enter (input is hidden):"
read -s KIMI_API_KEY
export KIMI_API_KEY
想长期有效:把 export 那行加进 ~/.zshrc(bash 用 ~/.bashrc),并设好文件权限(它是明文)。

三、设置 Key(Windows PowerShell)
$env:KIMI_API_KEY="YOUR_KIMI_API_KEY"
长期有效:设置,系统,关于,高级系统设置,环境变量。

四、~/.codex/config.toml(Windows 是 %USERPROFILE%\.codex\config.toml)
model = "kimi-k3.1-pro"
model_provider = "kimi"
model_context_window = 1048576

[model_providers.kimi]
name = "Kimi"
base_url = "https://api.moonshot.ai/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"

五、验证
桌面版:完全退出再启动,模型选择器里选 kimi-k3.1-pro(可能显示 Custom),发 hi;再发 Inspect this repository and summarize its structure.
命令行版:cd /path/to/your/project,然后 codex,确认模型是 kimi-k3.1-pro,发 hello。

六、排错清单(官方)
报 401:Key 无效,或 Key 和地址不是同一平台;检查命令 test -n "$KIMI_API_KEY" && echo set || echo missing
报 400 search_context_size is not supported:删掉这个参数,Codex 默认不发
报 404:base_url 必须正好是 https://api.moonshot.ai/v1;别指向 127.0.0.1 之类的本地地址
报 429:触发速率或并发限制,看官方 Rate limits
警告 Model metadata not found:预期内,不影响使用
改了没生效:退出重启 Codex;确认改的是 ~/.codex/config.toml;检查有没有 -c 参数或 profile 覆盖;用过 CC Switch 的,到它的 Settings 里的 Routing 关掉 Codex

七、提醒
Codex 命令行版没有视频输入通道,要让模型看视频,请直接调用 API 的 Vision Input(官方说明)。

八、可复制提示词(连通后第一件事)
Inspect this repository and summarize its structure. Then list three places that look risky to change, and say why.
S1哥(X @swordBluesy)每天一篇 AI 官方文档编译教程,每篇送一份赠品。粉丝群:t.me/haohanlab|关注 @swordBluesy