全部教程 /
在 Codex CLI 中使用 XHuoAPI
Codex CLI 支持在配置文件里添加自定义模型服务。它只用 OpenAI 的 Responses 接口（/v1/responses）发请求，所以通过 XHuoAPI 使用时，能用的是 GPT 系列模型。我们用 codex-cli 0.156.1 实际跑过写文件的任务，下面的配置就是测试时用的那份。
开始之前
先验证一下
curl https://api.xhuoapi.ai/v1/chat/completions \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'
配置步骤
1
安装 Codex CLI。
npm install -g @openai/codex
2
编辑 ~/.codex/config.toml（没有就新建），写入下面的内容。wire_api 必须是 responses。
model = "gpt-5.5" model_provider = "xhuoapi" [model_providers.xhuoapi] name = "XHuoAPI" base_url = "https://api.xhuoapi.ai/v1" env_key = "XHUO_API_KEY" wire_api = "responses"
3
把 API Key 放进 config.toml 里 env_key 指定的环境变量。
export XHUO_API_KEY=YOUR_XHUOAPI_KEY
4
在项目目录里运行 codex 进入交互模式，或者用 codex exec 跑一次性任务。用 -m 可以临时换模型。
codex exec -m gpt-5.4 "Explain what this repository does"
注意事项
wire_api 写成 chat 会直接报错：wire_api = "chat" is no longer supported。新版 Codex 只支持 responses。
实测结果（2026-10-06，让 Codex 新建并写入一个文件）：gpt-5.5、gpt-5.4、gpt-4.1 都能完成。deepseek-v3.2 和 claude-sonnet-4-6 在 Codex 里会反复显示 Reconnecting 后失败，要用这些模型请改用 Claude Code、Cline 等工具。
同一次测试里，gpt-5.3-codex 回复说文件已经建好，但实际没有生成，Codex 还提示找不到这个模型的元数据。建议优先用 gpt-5.5 或 gpt-5.4。
模型名必须与定价页里的 ID 完全一致（例如 deepseek-v4-pro，不是 DeepSeek V4 Pro）。大小写、连字符都算。