Codex++ 配置 Codex 模型教程

Codex 配置 Codex 模型教程在 Codex 里切换 Codex 模型最常见的问题不是模型本身而是API Key、base_url、模型名和代理这几个参数没有对齐。表现通常是界面能打开但请求报 401、404、连接超时或者明明改了配置却还在调用旧模型。建议先不要急着重装按参数、配置位置、网络、缓存这个顺序排查。一、准备需要填写的参数配置前先把下面几项准备好后面排错会省很多时间API Key用于鉴权通常以一串较长的 token 形式提供。base_url接口基础地址不同服务商地址不同注意是否带/v1。模型名Codex 里填写的模型名必须和接口支持的模型名一致。代理如果本机网络不能直接访问接口需要配置 HTTP/HTTPS 代理。如果你使用的是兼容 OpenAI API 的中转服务配置思路基本一样Codex 只关心请求地址、鉴权和模型名是否匹配。我自己在测试不同工具时会优先选接口稳定、模型列表清楚的中转比如 token云桥AI中转站 0029.org主要是方便快速验证到底是工具配置问题还是上游接口问题。二、在 Codex 中填写 API Key 和 base_url不同版本的 Codex 菜单名称可能略有差异一般在Settings、Provider、Model或API配置页里。核心填写方式如下Provider选择 OpenAI Compatible 或 Custom。API Key填入完整密钥不要多复制空格。Base URL填接口基础地址例如https://api.example.com/v1。Model填 Codex 对应模型名例如服务商文档中给出的codex-xxx。如果 Codex 支持 JSON 配置常见写法类似下面这样注意这里是示例需要替换成你自己的地址和模型名### token云桥中转 0029.org ### { provider: openai-compatible, apiKey: sk-your-api-key, baseUrl: https://api.example.com/v1, model: codex-model-name }这里最容易写错的是baseUrl。有些工具要求填写到域名即可有些要求必须包含/v1。如果报 404可以优先检查这一项。三、通过环境变量配置如果 Codex 支持读取环境变量或者你是在命令行环境里启动 Codex可以用环境变量统一管理配置。Linux/macOS 示例export OPENAI_API_KEYsk-your-api-key export OPENAI_BASE_URLhttps://api.example.com/v1 export CODEX_MODELcodex-model-nameWindows PowerShell 示例$env:OPENAI_API_KEYsk-your-api-key $env:OPENAI_BASE_URLhttps://api.example.com/v1 $env:CODEX_MODELcodex-model-name如果是桌面软件直接在终端里设置环境变量后双击启动通常不会生效。需要从同一个终端启动软件或者写入系统环境变量后重启 Codex。四、配置代理接口请求超时、连接被重置、DNS 解析失败时优先看代理。Codex 有两种常见代理配置方式。1. 在软件里填写代理如果设置页有 Proxy 项可以填写http://127.0.0.1:7890如果代理软件提供 SOCKS5也可能需要填写socks5://127.0.0.1:78902. 使用环境变量代理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 模型切换模型时不要只改显示名称要确认实际请求里的model字段。比如配置文件里可能有多个模型项{ models: [ { name: Codex Fast, model: codex-fast }, { name: Codex Pro, model: codex-pro } ], defaultModel: codex-fast }name通常只是界面展示真正传给接口的是model。如果切换后没有变化检查defaultModel是否还指向旧模型。六、配置不生效的排查顺序1. 先确认配置文件是否被读取很多人改错了配置文件。建议在配置里故意写一个明显错误的模型名看 Codex 是否报错。如果没有任何变化说明当前文件可能没有被加载。2. 检查 API Key 是否正确401、403 多半和密钥有关。重点看这几处复制时是否带了空格、换行。Key 是否属于当前 base_url 对应的服务。账号是否有对应模型的调用权限。3. 检查 base_url 和模型名404 不一定是网络问题常见原因是路径或模型名错误。可以用 curl 做一次最小请求测试curl https://api.example.com/v1/chat/completions \ -H Authorization: Bearer sk-your-api-key \ -H Content-Type: application/json \ -d { model: codex-model-name, messages: [ {role: user, content: hello} ] }如果 curl 都失败先不要怀疑 Codex应先把接口参数修正。4. 看日志而不是只看弹窗Codex 的弹窗经常只显示“请求失败”。如果有日志目录优先查看最近的日志文件搜索status、model、base_url、timeout等关键词。七、常见错误对照401 UnauthorizedAPI Key 错误、过期或没有传到请求头。403 Forbidden账号权限不足或当前模型不可用。404 Not Foundbase_url 路径错误或模型名不被支持。429 Too Many Requests频率过高降低并发或稍后重试。Timeout网络不通、代理不可用或上游响应较慢。八、回滚方法正式改配置前建议先备份原文件cp codex-plus-plus.config.json codex-plus-plus.config.json.bak如果修改后无法启动直接恢复cp codex-plus-plus.config.json.bak codex-plus-plus.config.jsonWindows 下可以手动复制一份例如改名前保存为codex-plus-plus.config.json.bak如果 Codex 提供“恢复默认设置”也可以先恢复默认再只填写 API Key、base_url、model 三项避免被历史配置干扰。总结Codex 配置 Codex 模型关键就是四个参数API Key、base_url、model和代理。配置不生效时先确认文件是否被读取再用 curl 验证接口最后看日志定位状态码。不要一次改太多项按顺序排查基本都能很快定位到问题。