跳至主要內容

手动配置 Codex

GoodCode2026/7/8大约 2 分钟

提示

推荐直接在后台密钥列表点击 使用密钥，复制自动生成的配置，无需手写！

前置条件

请先创建一个 OpenAI 分组 的 API Key，见 API 密钥管理。

  1. Codex 安装
Codex CLI

如果你使用命令行版本（Codex CLI），先运行下面命令安装：

npm i -g @openai/codex@latest

Codex CLI 包地址：
https://www.npmjs.com/package/@openai/codex

  1. 找到 Codex 的配置文件夹

首先打开你的终端程序，不管你是 Windows 还是 macOS 系统
然后根据系统，运行下面的命令，打开 Codex 的配置文件夹

Windows

CMD 命令行：

start "" "%USERPROFILE%\.codex"

如目录不存在，可按 Win+R 输入 %userprofile% 后手动创建 .codex 文件夹。

Codex 配置文件夹
Codex 配置文件夹
  1. 手动创建 config.toml 与 auth.json 文件，写入如下内容

注意

请确保以下内容位于 config.toml 文件的开头部分。

config.toml
model_provider = "goodcode"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.goodcode]
name = "GoodCode"
base_url = "https://goodcode.store/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

  1. 在 auth.json 中的 OPENAI_API_KEY 部分填入你在后台生成的 ApiKey，然后保存

  2. 在终端运行 codex，对话查看是否配置成功

Codex 测试
Codex 测试

WebSocket 模式（可选）

GoodCode 网关支持 Codex 的 Responses WebSocket 模式，长会话下连接更稳定。将 config.toml 替换为：

model_provider = "goodcode"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.goodcode]
name = "GoodCode"
base_url = "https://goodcode.store/v1"
wire_api = "responses"
supports_websockets = true
requires_openai_auth = true

[features]
responses_websockets_v2 = true
goals = true

配置生效提醒

  • 每次修改 config.toml 或 auth.json 后，都需要重启 codex 才会生效。
  • 怎么重启：先 Ctrl + C 退出当前 codex，再重新运行 codex。
  • 适用范围：VSCode 插件版 Codex 同样适用这套配置。

多账号 / 粘性会话提醒

Codex 会通过 session_id 请求头维持粘性会话。如果你自己在 GoodCode 前面又套了一层 Nginx 反代，需要在 Nginx 的 http 块中加上 underscores_in_headers on;，否则该请求头会被丢弃，导致多账号环境下会话粘性失效。直连 goodcode.store 则无需关心。

最近更新: