Skip to content

配置 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 插件

  1. 安装 Codex 插件
  2. 在插件设置中选择/新增自定义 Provider
  3. Base URL 填 https://kuaiapi.net/v1,API Key 填你的密钥
  4. 选择模型后即可对话

验证

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。

解决步骤(按顺序尝试):

  1. 在 Codex 设置中关闭「并行工具调用」(Enable parallel tool calls for all model prompts)后重启 Codex;
  2. 若仍失败,换用 Codex 稳定版(非 alpha/preview 通道),稳定版默认已按 Lite 协议发送合规请求;
  3. 以上都不生效时,联系客服(QQ 629567931)反馈 codex-tui 版本号,我们会协助处理。

说明:该问题为 Codex 新协议与平台网关的适配问题,我们已经向网关维护方反馈并跟进自动兼容,后续版本升级后无需任何手动设置。

仅用于合法合规用途,请遵守服务条款与当地法律法规。