Codex 官方订阅与中转站 API 无缝切换教程

很多人在配置 Codex 中转站 API 时，会直接改默认配置，导致原本用 ChatGPT 官方订阅登录的 Codex 被覆盖。
本教程的目标是：

默认输入 codex 时，继续使用你的 ChatGPT 官方订阅；需要使用中转站 API 时，输入 codex-proxy 单独启动。

这样两边互不干扰，切换成本最低。

方案一：终端使用 Codex

以下以 macOS + zsh 为例。

1. 创建一套独立的 Codex 配置目录

1

mkdir -p ~/.codex-proxy

这一步是为了把中转站 API 的配置和默认 Codex 配置分开。
默认 Codex 用户配置通常在 ~/.codex/config.toml，Codex 也支持项目级 .codex/config.toml 配置。([OpenAI开发者][2])

2. 写入中转站 API 配置

编辑或创建这个文件：

1

nano ~/.codex-proxy/config.toml

写入以下内容：

1
2
3
4
5
6
7
8

model = "gpt-5.4"
model_provider = "proxy"

[model_providers.proxy]
name = "My proxy"
base_url = "https://your-proxy.example.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

把下面两处改成你自己的：

1
2

model = "你的中转站支持的模型名"
base_url = "你的中转站 API 地址"

Codex 的自定义 provider 可以配置 base_url、认证环境变量、请求协议和 headers；model_provider = "proxy" 会让 Codex 使用你定义的 [model_providers.proxy]。([OpenAI开发者][3])

3. 给中转站单独设置快捷命令

打开 ~/.zshrc：

1

nano ~/.zshrc

在文件末尾加入：

1
2
3

export MY_PROXY_KEY="sk-your-proxy-key"

alias codex-proxy='OPENAI_API_KEY=$MY_PROXY_KEY CODEX_HOME=$HOME/.codex-proxy codex'

保存后执行：

1

source ~/.zshrc

4. 使用方式

以后你有两个入口：

1

codex

使用默认 Codex，也就是你的 ChatGPT 官方订阅登录状态。

1

codex-proxy

使用中转站 API 配置。

两套配置目录分开后，默认 Codex 和中转站 Codex 不会互相覆盖。实际使用时，你只需要记住：

1
2

codex          # 官方订阅
codex-proxy    # 中转站 API

方案二：VS Code 或其他 IDE 使用 Codex 插件

如果你希望某个项目自动走中转站 API，而其他项目继续使用官方订阅，可以使用项目级配置。

Codex 的配置优先级是：CLI 参数和 --config 最高，其次是 profile，然后是项目级 .codex/config.toml，再往后才是用户级 ~/.codex/config.toml。项目级配置只有在项目被标记为 trusted 时才会加载。([OpenAI开发者][4])

1. 进入你的项目目录

1

cd /path/to/your/project

2. 创建项目级 Codex 配置

1
2

mkdir -p .codex
nano .codex/config.toml

写入：

1
2
3
4
5
6
7
8

model = "gpt-5.4"
model_provider = "proxy"

[model_providers.proxy]
name = "My proxy"
base_url = "https://your-proxy.example.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

同样需要把这两处换成你的实际信息：

1
2

model = "你的中转站支持的模型名"
base_url = "你的中转站 API 地址"

3. 在当前 shell 中设置 API Key

1

export OPENAI_API_KEY="sk-your-proxy-key"

然后在这个项目目录里启动 Codex：

1

codex

此时 Codex 会优先读取当前项目里的：

1

.codex/config.toml

所以这个项目会走中转站 API；其他没有 .codex/config.toml 的项目，仍然走你的默认官方 Codex 配置。

注意事项

1. 项目必须被 Codex 信任

如果项目没有被标记为 trusted，Codex 会跳过项目级 .codex/config.toml。
启动 Codex 后，如果看到 trust 相关提示，按提示信任当前项目即可。官方文档也说明，不受信任项目的 .codex/ 配置层会被跳过。([OpenAI开发者][4])

2. 不想再使用中转站 API 时怎么恢复？

如果是终端方案：

1

codex

直接使用默认官方订阅即可，不要输入 codex-proxy。

如果是项目级配置方案，删除项目里的配置文件：

1

rm .codex/config.toml

然后重启 Codex。

3. 不要把 API Key 提交到 Git

.codex/config.toml 可以放项目里，但不要把真实 API Key 写进文件。
推荐只在 shell 环境变量里设置：

1

export OPENAI_API_KEY="sk-your-proxy-key"

.codex/config.toml 里只保留：

1

env_key = "OPENAI_API_KEY"

最终效果

完成后，你可以这样使用：

1

codex

走 ChatGPT 官方订阅。

1

codex-proxy

走中转站 API。

或者在某个项目内放置：

1

.codex/config.toml

让这个项目自动使用中转站 API，其他项目保持官方默认配置。