Codex 配置

Codex 自定义提供商使用 OpenAI Responses API。配置文件应放在用户目录的 ~/.codex/config.toml；提供商和认证配置放在项目内 .codex/config.toml 会被 Codex 忽略。

1. 设置令牌

export NEWAPI_API_KEY="sk-替换为你的令牌"

需要长期使用时，可由 shell 的安全环境配置或密码管理器在启动时注入。不要把令牌直接写入项目仓库。

2. 配置 ~/.codex/config.toml

先从可用模型了解本站模型，再把 YOUR_MODEL_ID 替换为当前令牌通过 /v1/models 查询到、并已验证支持 Responses API 的模型。

model = "YOUR_MODEL_ID"
model_provider = "fq_hx"

[model_providers.fq_hx]
name = "NewAPI"
base_url = "https://newapi.fq-hx.com/v1"
env_key = "NEWAPI_API_KEY"
wire_api = "responses"

wire_api 当前只支持 responses。如果所选渠道只实现 /v1/chat/completions，该模型不适合用于 Codex。

3. 验证 Responses API

curl -sS "https://newapi.fq-hx.com/v1/responses" \
  -H "Authorization: Bearer $NEWAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "input": "只回复 OK"
  }'

请求成功后运行：

codex

如果出现模型不存在、协议不支持或流式响应错误，先用上面的 /v1/responses 请求排除 Codex 本地配置问题。

常见问题

现象	优先检查
找不到自定义 provider	配置是否位于用户目录 ~/.codex/config.toml
返回 401	NEWAPI_API_KEY 是否在启动 Codex 的同一环境中存在
返回接口或格式错误	所选模型渠道是否真正支持 /v1/responses
能生成文本但工具失败	模型与渠道是否支持 Codex 所需的工具调用和流式事件

官方资料

• Codex Advanced Configuration
• Codex Configuration Reference