Codex CLI 接入 CCSub：config.toml 和 OPENAI_BASE_URL 怎么写

model = "gpt-5.5"
model_provider = "ccsub"

[model_providers.ccsub]
name = "CCSub"
base_url = "https://www.ccsub.net/api/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

Codex CLI 是 OpenAI 的终端编程助手。它走的是 OpenAI Responses 接口（请求路径 /responses），所以接 CCSub 时用的是 OpenAI 兼容地址 https://www.ccsub.net/api/v1，和 Claude Code 的 https://www.ccsub.net 不一样，这一点最容易搞混。

先看版本，决定用哪种写法

Codex 的配置方式在 2026 年变过一次。先在终端执行 codex --version：

不确定的话直接用下面的 config.toml 写法，新旧版本都适用。

推荐写法：在 config.toml 里加一个自定义提供方

第一步，把 Key 放进环境变量 OPENAI_API_KEY（和 CCSub 安装文档用的是同一个变量名）：

echo 'export OPENAI_API_KEY="sk-你的密钥"' >> ~/.zshrc
source ~/.zshrc

Windows 在 PowerShell 里执行：

[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', 'sk-你的密钥', 'User')

第二步，编辑 ~/.codex/config.toml（Windows 是 %USERPROFILE%\.codex\config.toml，没有就新建）：

model = "gpt-5.5"
model_provider = "ccsub"

[model_providers.ccsub]
name = "CCSub"
base_url = "https://www.ccsub.net/api/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

几个字段的意思：base_url 是请求地址，Codex 会在后面拼 /responses；wire_api 只能写 responses，旧教程里的 chat 在新版本会直接报错；env_key 告诉 Codex 从哪个环境变量读 Key。自定义提供方默认不需要 OpenAI 账号登录，所以启动时不会再弹出 ChatGPT 登录界面。

旧版本写法：环境变量

Codex 0.118 及以前，可以只用两个环境变量，这也是 CCSub 安装文档 里的写法：

echo 'export OPENAI_BASE_URL="https://www.ccsub.net/api/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="sk-你的密钥"' >> ~/.zshrc
source ~/.zshrc

升级到 0.119 之后这个变量会被忽略，请求又会发回 OpenAI 官方，表现为要求登录或者 401。遇到这种情况改用上面的 config.toml 写法即可。

还有一种写法是在 config.toml 顶部写一行 openai_base_url = "https://www.ccsub.net/api/v1"，改的是 Codex 内置 openai 提供方的地址。内置提供方要求先登录，需要再执行一次 printenv OPENAI_API_KEY | codex login --with-api-key。步骤比自定义提供方多，一般不推荐。

启动和切换型号

cd ~/你的项目
codex

model 可填 gpt-5.5 等，全部可用型号 ID 见 型号列表。改 config.toml 里的 model，或者在 Codex 里输入 /model 都可以切换。发一句话后，到 CCSub 控制台的「使用记录」里能看到这次请求，就说明配置成功。

几个容易踩的坑

• 项目目录里的配置不算数。 项目级 .codex/config.toml 里的 model_provider、model_providers、openai_base_url 会被忽略，必须写在用户目录的 ~/.codex/config.toml。
• 从桌面图标启动读不到变量。 Codex 的桌面应用或编辑器插件如果是从程序坞、开始菜单启动的，可能读不到你在 shell 里 export 的 OPENAI_API_KEY。先从终端启动排除这个原因。
• 不要和 Claude Code 的地址混用。 Claude Code 填 https://www.ccsub.net，Codex 填 https://www.ccsub.net/api/v1。两个工具共用同一把 CCSub Key 没问题。

经常在多个服务之间切换的话，可以用 CC Switch，它的预设列表里有 CCSub，会自动帮你写好 Codex 的配置。终端里还想用 Claude 的话，见 Claude Code 接入教程。