配置 Codex
Codex 使用 OpenAI 协议,需要把 API 地址指向本站的 OpenAI 兼容端点。
方式一:环境变量(最简单,通用)
bash
export OPENAI_BASE_URL="https://kuaiapi.net/v1"
export OPENAI_API_KEY="sk-你的密钥"然后正常使用 Codex CLI 即可。
方式二:Codex CLI 配置文件(推荐长期使用)
编辑 ~/.codex/config.toml:
toml
model_provider = "sub2api"
[model_providers.sub2api]
name = "Sub2API"
base_url = "https://kuaiapi.net/v1"
env_key = "SUB2API_API_KEY"
wire_api = "responses"并在 shell 中设置:
bash
export SUB2API_API_KEY="sk-你的密钥"方式三:VS Code 插件
- 安装 Codex 插件
- 在插件设置中选择/新增自定义 Provider
- Base URL 填
https://kuaiapi.net/v1,API Key 填你的密钥 - 选择模型后即可对话
验证
bash
codex exec "你好"正常返回即成功。报错时对照 故障排查 检查。
TIP
- 推荐配置页(Use Key)会自动生成当前分组适配的 Codex 配置,优先使用
- 模型名以分组模型列表为准
故障排查:工具调用返回 400(parallel_tool_calls)
现象:Codex 对话正常,但一旦需要调用工具(执行命令/写文件等)就返回 400,错误信息类似:
X-OpenAI-Internal-Codex-Responses-Lite requires `parallel_tool_calls` to be false.原因:Codex 新版对 GPT-5.6 等模型使用 Responses Lite 协议模式,该模式约定"单工具调用",请求中 parallel_tool_calls 必须显式为 false。部分 Codex 版本(尤其是 alpha 预览版,或开启了「为所有模型启用并行工具调用」选项时)会发送 parallel_tool_calls: true(或省略该字段),平台网关按协议要求会拒绝该请求并返回上述 400。
解决步骤(按顺序尝试):
- 在 Codex 设置中关闭「并行工具调用」(Enable parallel tool calls for all model prompts)后重启 Codex;
- 若仍失败,换用 Codex 稳定版(非 alpha/preview 通道),稳定版默认已按 Lite 协议发送合规请求;
- 以上都不生效时,联系客服(QQ 629567931)反馈 codex-tui 版本号,我们会协助处理。
说明:该问题为 Codex 新协议与平台网关的适配问题,我们已经向网关维护方反馈并跟进自动兼容,后续版本升级后无需任何手动设置。
