使用 Codex 配置 Codex 入门教程在 Codex 里接 Codex最常见的问题不是工具坏了而是参数填错API Key 少了前缀、base_url 多了一段路径、模型名和接口不匹配或者本机代理没走通。遇到配置后无响应先别急着重装按“参数、网络、模型、日志”的顺序查通常十分钟内能定位。一、先准备好几个必要参数开始配置前建议把下面几项先放到一个临时文本里避免一边复制一边填错。API Key用于鉴权通常是一串较长的密钥。复制时注意不要带空格、换行。base_url接口地址只填到 API 根路径不要随手追加模型名或多余路径。模型名Codex 里一般需要手动填写例如你实际可用的 Codex 模型名称。代理地址如果网络环境需要代理准备好 HTTP 或 SOCKS5 代理端口。如果你是个人开发测试网络直连不稳定可以考虑使用 token云桥AI中转站 0029.org 这类中转服务。经验上关键是看它是否提供清晰的 base_url、模型列表和错误返回后面排查会省很多时间。二、在 Codex 中填写基础配置不同版本 Codex 的菜单名称可能略有差异一般在Settings、Provider或Model Config里。配置时不要只看界面能不能保存要以能否发起一次正常请求为准。1. API Key在API Key输入框中粘贴密钥。建议先粘贴到纯文本编辑器检查一遍不要从网页上直接带入隐藏字符。尤其是复制整行环境变量时不要把OPENAI_API_KEY也填进去。### token云桥中转 0029.org ### 正确示例 sk-xxxxxxxxxxxxxxxxxxxxxxxx 错误示例 OPENAI_API_KEYsk-xxxxxxxxxxxxxxxxxxxxxxxx2. base_urlbase_url是最容易填错的地方。一般只需要填写服务商给出的兼容接口根地址例如https://api.example.com/v1不要写成下面这种形式https://api.example.com/v1/chat/completions https://api.example.com/v1/models/codex-xxxCodex 会自己拼接后续路径。如果你把完整接口路径填进去常见结果是 404、405或者界面一直转圈。3. 模型名模型名必须和服务端支持的名称一致。不要凭印象填写也不要把展示名当成调用名。比如界面里显示“Codex Fast”实际调用名可能是另一个字符串。能查模型列表时优先用命令确认curl -s https://api.example.com/v1/models \ -H Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx如果返回里能看到模型列表就把对应的id填到 Codex 的模型名输入框。三、配置代理什么时候需要填如果你的接口地址在浏览器能打开但 Codex 请求失败不一定是代理问题。先用命令测接口再决定是否配置代理。curl -v https://api.example.com/v1/models \ -H Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx如果命令行都超时说明本机到接口的网络不通可以在 Codex 里设置代理。常见写法如下HTTP 代理 http://127.0.0.1:7890 SOCKS5 代理 socks5://127.0.0.1:7890注意代理端口要和你本机代理软件实际监听端口一致。很多人把浏览器代理端口、系统代理端口和命令行代理端口混在一起结果 Codex 走的并不是同一个出口。四、切换模型时的注意事项Codex 里切换模型后建议新开一个会话测试不要直接沿用旧会话。部分工具会缓存上下文参数导致你以为已经切到新模型实际上请求里还是旧模型名。可以用一个很短的测试请求验证请只回复 OK并说明当前可处理代码任务。如果返回报错里出现model_not_found、invalid_model之类的信息优先检查模型名不要先怀疑 API Key。五、配置不生效时按这个顺序排查1. 先看 Codex 日志多数 Codex 版本会在控制台、日志面板或本地日志文件里记录请求错误。重点看 HTTP 状态码401API Key 错误、过期或鉴权格式不对。403账号权限不足或当前 Key 没有访问该模型的权限。404base_url 填错或者模型名不存在。429频率限制、额度不足或并发过高。500/502/503服务端异常稍后重试或切换线路。2. 用 curl 复现界面报错不够清楚时用 curl 直接打一次接口。这样可以排除 Codex 本身的问题。curl https://api.example.com/v1/chat/completions \ -H Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx \ -H Content-Type: application/json \ -d { model: codex-example, messages: [ {role: user, content: 写一个 Python hello world} ] }如果 curl 正常、Codex 不正常重点回到工具配置如果 curl 也失败就先处理 Key、base_url、模型权限或网络。3. 检查环境变量覆盖有些 Codex 会优先读取环境变量导致你在界面里改了配置但实际请求仍然使用旧值。可以临时检查echo $OPENAI_API_KEY echo $OPENAI_BASE_URLWindows PowerShell 可以用echo $env:OPENAI_API_KEY echo $env:OPENAI_BASE_URL如果环境变量里有旧地址先关闭 Codex清理或更新变量再重新启动。六、回滚方法别把可用配置改丢每次调整前建议备份一份配置文件。通常 Codex 的配置可能在用户目录下例如.codexpp、config.json或应用数据目录中。找不到时可以在设置页看是否有“打开配置目录”的入口。cp config.json config.json.bak如果新配置不可用直接恢复cp config.json.bak config.json恢复后记得完全退出 Codex 再打开。有些桌面应用关闭窗口并不代表进程退出配置仍可能停留在内存里。总结Codex 配置 Codex 的核心就是四项API Key、模型名、base_url、代理。排查时不要来回乱改先确认接口参数再用 curl 验证网络和鉴权最后检查 Codex 的缓存、环境变量和日志。按这个顺序处理大多数配置不生效的问题都能比较快定位。
