大约 1 分钟常见问题
Codex 常见问题
安装相关
Q: npm install -g @openai/codex 失败
参考 Claude Code 常见问题 - 安装相关 的通用解决方法。
配置相关
Q: 报 404 Not Found
通常是 wire_api 配置错误。
确认 ~/.codex/config.toml 中：
[model_providers.huiliu]
wire_api = "responses" # 必须是 responses，不是 chat
base_url = "https://www.huiliuapi.com/v1" # 必须带 /v1Q: 报 OPENAI_API_KEY is not set
环境变量未生效。
解决：
# 检查是否设置
echo $OPENAI_API_KEY
# 重新设置并 source
echo 'export OPENAI_API_KEY="sk-你的令牌"' >> ~/.bashrc
source ~/.bashrcWindows 用 setx 后必须重启终端。
Q: 配置 config.toml 后没生效
检查文件路径：
- Linux / macOS：
~/.codex/config.toml - Windows：
%USERPROFILE%\.codex\config.toml
确认是 TOML 文件（.toml），不是 .json。
Q: 模型一直走不掉 / 一直转圈
可能是推理强度太高，模型在深度思考。
降低 reasoning effort：
model_reasoning_effort = "medium" # 或 low调用相关
Q: 报 401 Unauthorized
- 令牌错误或拼写错误
- 令牌必须选 Codex 分组
- 令牌已被禁用 / 过期
Q: 报 403 Forbidden: model not available in your group
分组不匹配。Codex 的令牌必须创建在 Codex 分组下。
Q: 流式输出乱码
wire_api = "chat" 模式下不完全支持新版流式格式。切回 responses：
wire_api = "responses"模型相关
Q: 推荐用哪个模型？
| 场景 | 推荐 |
|---|---|
| 一般编程 | gpt-5-codex |
| 复杂推理 | o3 |
| 通用对话 | gpt-4o |
| 低成本 | gpt-4o-mini |
Q: 怎么切换模型？
修改 ~/.codex/config.toml：
model = "gpt-5-codex"保存后重启 codex 即可。
Q: Codex 支持图像吗？
支持。在对话中拖入图片或使用 /image 命令。