主题
Codex CLI
OpenAI 官方的终端编码 Agent。快米兔 API 同时支持它需要的两种线路协议：Responses API（/v1/responses）和 Chat Completions（/v1/chat/completions）。
安装
bash
npm install -g @openai/codex
codex --versionbash
brew install codex需要 Node.js ≥ 20。
配置快米兔 API
Codex CLI 通过 ~/.codex/config.toml 定义 provider。
toml
model = "gpt-5.5"
model_provider = "kmt"
[model_providers.kmt]
name = "快米兔 API"
base_url = "https://api.52pay.com/v1"
env_key = "KMT_API_KEY"
wire_api = "responses"toml
model = "gpt-5.4"
model_provider = "kmt"
[model_providers.kmt]
name = "快米兔 API"
base_url = "https://api.52pay.com/v1"
env_key = "KMT_API_KEY"
wire_api = "chat"然后把令牌放进环境变量：
bash
echo 'export KMT_API_KEY="<您的令牌>"' >> ~/.zshrc
exec $SHELLpowershell
[Environment]::SetEnvironmentVariable("KMT_API_KEY", "<您的令牌>", "User")
# 关闭 PowerShell 重开fish
set -Ux KMT_API_KEY "<您的令牌>"base_url 必须带 /v1
Codex 会在你给的 base_url 后面直接拼 /responses 或 /chat/completions。 填 https://api.52pay.com 会打到 https://api.52pay.com/responses → 404。
wire_api 该选哪个
responses：官方主线协议，支持 reasoning 摘要、更完整的工具调用语义。优先用这个。chat：兼容性最好。如果responses下遇到模型不支持、报Unsupported endpoint，换成chat再试。
本站的 grok-4.3、grok-4.20-* 系列同时支持 openai 与 openai-response 两种 endpoint；GPT-5 系模型建议用 responses。
验证
bash
codex exec "Reply with exactly one word: pong"或直接用 curl 验证 Responses 协议是否通：
bash
curl https://api.52pay.com/v1/responses \
-H "Authorization: Bearer <您的令牌>" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.4","input":"ping"}'日常使用
bash
cd ~/your-project
# 交互模式
codex
# 一次性执行
codex exec "给 utils.py 补充单元测试"
# 指定模型
codex --model gpt-5.5
# 指定推理强度（GPT-5 系）
codex --config model_reasoning_effort="high"
# 全自动模式（谨慎，会直接改文件、跑命令）
codex --full-auto支持的模型
| 模型 ID | 定位 | 上下文 |
|---|---|---|
gpt-5.6-sol | 最新旗舰 | — |
gpt-5.6-terra | 均衡档 | — |
gpt-5.6-luna | 轻量快速档 | — |
gpt-5.5 | 上一代旗舰，长上下文 | 1.1M |
gpt-5.4 | 稳定主力 | 400K |
gpt-5.4-mini | 性价比 | 400K |
gpt-5.4-nano | 最便宜 | 400K |
建议令牌选 Openai 分组。完整清单见 模型与分组。
进阶配置
多 provider 并存、审批策略、沙箱级别、推理强度等，见 Codex 进阶配置。
常见错误
| 现象 | 原因 / 处理 |
|---|---|
404 Not Found | base_url 少了 /v1 |
401 Unauthorized | env_key 指向的环境变量没设，或令牌写错 |
Unsupported endpoint / 模型不支持该接口 | 该模型没开 openai-response，把 wire_api 改成 "chat" |
| 一直转圈不出字 | 见 流式无输出 |
stream error: unexpected EOF | 网络中断或上游超时，重试；持续出现联系客服 |
报 model not found | 模型名拼错，或当前分组没开该模型 |