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 ~/.zshrc

Windows 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_KEY

Windows：

echo $env:CODEX_API_KEY

2. 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_PROXY

Windows 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 有效、地址正确、模型名匹配、网络可达，基本就能稳定跑起来。

企业官网建设流程全解析