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 KeyCodex 的配置入口可能因版本不同略有差异一般在设置页、环境变量或本地配置文件里。先看软件界面里有没有类似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 / Linuxexport CODEX_API_KEYsk-xxxxxxxxxxxxxxxx export CODEX_BASE_URLhttps://example.com/v1 export CODEX_MODELcodex-model-name如果想长期生效可以写入~/.zshrc或~/.bashrcecho export CODEX_API_KEYsk-xxxxxxxxxxxxxxxx ~/.zshrc echo export CODEX_BASE_URLhttps://example.com/v1 ~/.zshrc echo export CODEX_MODELcodex-model-name ~/.zshrc source ~/.zshrcWindows PowerShell$env:CODEX_API_KEYsk-xxxxxxxxxxxxxxxx $env:CODEX_BASE_URLhttps://example.com/v1 $env:CODEX_MODELcodex-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_PROXYhttp://127.0.0.1:7890 export HTTPS_PROXYhttp://127.0.0.1:7890Windows PowerShell$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890如果 Codex 本身有代理设置优先用软件内配置如果没有再考虑环境变量。不要同时在系统代理、终端代理、软件代理里乱配否则排查时很容易分不清到底走的是哪条链路。六、常见错误和排查顺序1. 401 Unauthorized优先检查 API Key。复制 Key 时不要带引号、空格、换行。还要确认 Codex 读取的是新 Key而不是旧环境变量。echo $CODEX_API_KEYWindowsecho $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 PowerShellRemove-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 有效、地址正确、模型名匹配、网络可达基本就能稳定跑起来。