Waihub Docs

手动配置 Codex ​

参考页中对 Codex 的写法更完整，包含安装、配置目录、config.toml 和 auth.json 两个文件。这里按同样结构整理为 Waihub 版本。

提示

Codex 的关键不是只填 API Key，而是 config.toml 和 auth.json 两个文件要同时存在。很多配置失败，都是因为只写了其中一个。

第一步：安装 Codex ​

如果你使用命令行版 Codex，先安装 CLI：

bash
npm i -g @openai/codex@latest

如果你主要在终端里使用 Codex，先安装 CLI，再继续下面的配置步骤。

第二步：打开 Codex 配置目录 ​

先打开你的终端程序，然后根据系统运行下面的命令，进入 Codex 的配置目录。

CMD 命令行：

bash
start "" "%USERPROFILE%\\.codex"

第三步：创建 config.toml ​

在 ~/.codex 目录下创建 config.toml：

toml
model = "gpt-5.4"
model_provider = "custom"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.custom]
name = "custom"
base_url = "https://waihub.top/v1"
wire_api = "responses"

推荐做法

如果你后续还会接入别的渠道，可以继续在 config.toml 里新增其它 model_providers.* 段落，然后只切换 model_provider 的值，不必整份文件重写。

第四步：创建 auth.json ​

然后创建 auth.json：

json
{
  "OPENAI_API_KEY": "sk-xxxxxxxx"
}

配置结果

当 config.toml 和 auth.json 这两个文件都配置完成后，通常不只是命令行里的 codex 能使用，依赖同一套本地配置的 codex-app 也会自动读取到这些设置。

第五步：启动 Codex 验证 ​

保存后，在终端运行：

bash
codex

如果能正常发起对话，说明配置已生效。

其它可复用场景 ​

除了命令行本体，这套配置思路在一些相关编辑器场景里也能复用。

在 Cursor 中使用 ​

若其调用链路复用本地 Codex 配置或相同 provider 逻辑，也可以沿用这套接入方式。

在 VS Code 中使用 ​

插件或集成终端若走同一套配置，也可以直接复用。建议先确保本机配置生效，再进入编辑器侧验证。

示例界面 ​

Codex App ​

Codex App 配置效果

Codex App 示例图。两份文件配好后，Codex App 通常也会自动继承同一套配置。

Cursor ​

Cursor 中使用 Codex/Waihub

Cursor 示例图。若其调用链路复用本地 Codex 配置或相同 provider 逻辑，也可以沿用这套接入方式。

VS Code ​

VS Code 中使用 Codex/Waihub

VS Code 示例图。

CLI 使用提醒 ​

参考页特别强调了两点，这里同样适用：

  • CLI 启动后尽量不要在当前会话中频繁切换模型
  • 每次修改 config.toml 或 auth.json 后，都需要重启 codex

如果你需要显式指定模型，可使用类似命令：

bash
codex -m gpt-5.4 -c model_reasoning_effort="medium"

注意

每次改完 config.toml 或 auth.json，都要彻底退出后重新启动 codex。否则你很可能看到的还是旧配置效果。

常见问题 ​

  • 如果工具提示 401，一般是 auth.json 中的 key 错误或权限不足
  • 如果工具提示 404，一般是 config.toml 中的 base_url 写错
  • 如果工具提示模型不存在，优先检查 model 是否为 Waihub 当前支持的模型名

Waihub Documentation

Copyright © 2026 Waihub