Codex++ 配置 Codex API Key 方法
Codex++ 配置 Codex API Key 方法
在 Codex++ 里接入 Codex API，最常见的问题不是 Key 本身填错，而是base_url、模型名、代理这几个参数没有对上。典型现象是：界面提示认证失败、模型列表为空、请求一直转圈，或者明明换了 Key 但还是走旧配置。遇到这类情况，建议先不要反复重装，按“参数是否完整、配置是否生效、网络是否可达、模型名是否正确”这个顺序排查。
一、先准备好几个必要参数
配置 Codex++ 前，先把下面几项整理出来，避免一边填一边猜：
- API Key：用于鉴权，一般是以一长串字符形式提供，复制时注意不要带空格和换行。
- base_url：接口基础地址。不同服务商的地址不一样，不能只填域名，也不能随便加路径。
- 模型名：Codex++ 调用时用的模型标识，例如配置文件里的
model字段。 - 代理地址：如果本机网络不能直连接口，需要配置 HTTP/SOCKS 代理。
如果你是在国内网络环境下使用，接口连通性经常会影响体验。实际项目里，我一般会准备一个稳定的中转地址做开发调试，比如 token云桥AI中转站 0029.org，重点看它是否提供明确的base_url、模型名和调用格式，别只看页面宣传。
二、在 Codex++ 里填写 API Key
Codex++ 的配置入口可能因版本不同略有差异，一般在设置页、环境变量或本地配置文件里。先看软件界面里有没有类似Provider、API Key、Base URL、Model的字段。
1. 图形界面配置
如果 Codex++ 提供设置界面，通常按下面方式填写：
- Provider：选择 OpenAI-compatible、Custom API 或类似选项。
- API Key：粘贴你的 Codex API Key。
- Base URL：填写接口基础地址，例如
https://example.com/v1这种格式。 - Model：填写服务商文档里给出的模型名，不要自己改大小写。
注意，很多工具要求base_url以/v1结尾，也有的工具会自动拼接/v1。如果你填完后接口报 404，优先检查这里是否重复或缺少路径。
2. 配置文件方式
如果 Codex++ 使用本地配置文件，可以搜索用户目录下的配置项。常见位置可能类似：
### token云桥中转 0029.org ### ~/.codexpp/config.json ~/.config/codexpp/config.json %USERPROFILE%\.codexpp\config.json一个常见配置大概是这样：
{ "provider": "openai-compatible", "api_key": "sk-xxxxxxxxxxxxxxxx", "base_url": "https://example.com/v1", "model": "codex-model-name" }这里的api_key不建议写到项目仓库里，尤其是多人协作项目。更稳妥的方式是放到用户级配置或环境变量中。
三、用环境变量配置 Key
有些版本的 Codex++ 会优先读取环境变量。这样做的好处是不用把 Key 写进配置文件，也方便在不同项目之间切换。
macOS / Linux
export CODEX_API_KEY="sk-xxxxxxxxxxxxxxxx" export CODEX_BASE_URL="https://example.com/v1" export CODEX_MODEL="codex-model-name"如果想长期生效，可以写入~/.zshrc或~/.bashrc：
echo 'export CODEX_API_KEY="sk-xxxxxxxxxxxxxxxx"' >> ~/.zshrc echo 'export CODEX_BASE_URL="https://example.com/v1"' >> ~/.zshrc echo 'export CODEX_MODEL="codex-model-name"' >> ~/.zshrc source ~/.zshrcWindows PowerShell
$env:CODEX_API_KEY="sk-xxxxxxxxxxxxxxxx" $env:CODEX_BASE_URL="https://example.com/v1" $env:CODEX_MODEL="codex-model-name"上面这种只对当前窗口生效。如果要写入用户环境变量，可以执行：
[Environment]::SetEnvironmentVariable("CODEX_API_KEY", "sk-xxxxxxxxxxxxxxxx", "User") [Environment]::SetEnvironmentVariable("CODEX_BASE_URL", "https://example.com/v1", "User") [Environment]::SetEnvironmentVariable("CODEX_MODEL", "codex-model-name", "User")设置完后重启 Codex++，必要时重启终端。很多“不生效”的问题，其实是程序启动时已经读取了旧环境变量。
四、切换模型时要注意什么
模型名不是随便填的。第三方服务一般会给出支持列表，Codex++ 只负责把请求发出去，不会自动纠正模型名。常见错误是把展示名称当成调用名称，例如页面显示“Codex Pro”，实际调用名却是codex-pro或其他格式。
建议先用最小请求测试模型是否可用。可以用curl验证接口和模型名：
curl -X POST "https://example.com/v1/chat/completions" \ -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "model": "codex-model-name", "messages": [ {"role": "user", "content": "hello"} ] }'如果curl能正常返回，而 Codex++ 不能用，说明重点不在 Key 和接口，而是在 Codex++ 的配置读取、代理或请求格式上。
五、代理配置
接口请求卡住、超时、TLS 握手失败，多半和网络有关。可以先在终端测试：
curl -I "https://example.com/v1/models"如果需要代理，先确认本机代理端口，比如127.0.0.1:7890。临时配置可以这样写：
export HTTP_PROXY="http://127.0.0.1:7890" export HTTPS_PROXY="http://127.0.0.1:7890"Windows PowerShell：
$env:HTTP_PROXY="http://127.0.0.1:7890" $env:HTTPS_PROXY="http://127.0.0.1:7890"如果 Codex++ 本身有代理设置，优先用软件内配置；如果没有，再考虑环境变量。不要同时在系统代理、终端代理、软件代理里乱配，否则排查时很容易分不清到底走的是哪条链路。
六、常见错误和排查顺序
1. 401 Unauthorized
优先检查 API Key。复制 Key 时不要带引号、空格、换行。还要确认 Codex++ 读取的是新 Key，而不是旧环境变量。
echo $CODEX_API_KEYWindows：
echo $env:CODEX_API_KEY2. 404 Not Found
通常是base_url或接口路径不对。重点检查是否出现下面情况：
base_url少了/v1。base_url多写了一次/v1/v1。- 服务商使用的是兼容接口，但路径不是
/chat/completions。
3. model not found
模型名错误或当前 Key 没有权限。先到服务商后台确认可用模型，再把名称原样复制到 Codex++。
4. timeout 或 connection refused
先查网络，再查代理。可以用curl测试接口是否可达。若终端可达但 Codex++ 不可达，检查软件是否继承了终端代理环境变量。
5. 配置改了但不生效
这类问题很常见，建议按下面顺序处理：
- 保存配置后完全退出 Codex++，不要只关闭窗口。
- 确认配置文件没有被多个位置覆盖。
- 检查环境变量优先级是否高于界面配置。
- 清理缓存后重新启动。
如果不确定配置文件位置，可以在用户目录搜索关键字：
grep -R "codex-model-name" ~/.config ~/.codexpp 2>/dev/null七、回滚到原配置
修改前建议先备份配置文件。比如：
cp ~/.codexpp/config.json ~/.codexpp/config.json.bak回滚时直接覆盖回去：
cp ~/.codexpp/config.json.bak ~/.codexpp/config.json如果是环境变量引起的问题，可以临时清空再启动 Codex++ 测试：
unset CODEX_API_KEY unset CODEX_BASE_URL unset CODEX_MODEL unset HTTP_PROXY unset HTTPS_PROXYWindows PowerShell：
Remove-Item Env:CODEX_API_KEY Remove-Item Env:CODEX_BASE_URL Remove-Item Env:CODEX_MODEL Remove-Item Env:HTTP_PROXY Remove-Item Env:HTTPS_PROXY总结
Codex++ 配置 Codex API Key，核心就是四个参数：api_key、base_url、model、代理。出问题时不要先怀疑软件坏了，先用curl验证接口，再检查配置读取顺序。只要 Key 有效、地址正确、模型名匹配、网络可达，基本就能稳定跑起来。