Codex 0.80与最新版差异？API接口协议适配全解析【解答】-人工智能-PHP中文网

codex接入自定义api的关键是版本与wire_api协议严格匹配：0.80.0及以下必须用"chat"，0.81.0及以上只能用"responses"；api key须通过env_key指定环境变量，base_url须为http且末尾无斜杠。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

codex 0.80与最新版差异？api接口协议适配全解析【解答】

想把 Codex 接到本地 Qwen 或公司内部的 AI 服务上，却在第一步就卡住——不是网络不通，也不是密钥写错，而是版本和 wire_api 协议根本对不上。0.80.0 是个硬分界线，跨过去就换了一套通信语言，配错直接报 wire_api = chat is no longer supported，连请求都发不出去。

协议类型与版本强绑定

Codex 不是“配置对了就能用”，而是“版本选对了，配置才有意义”。0.80.0 及以下只认 Chat Completions API；0.81.0 及以上只认 Responses API。二者完全不兼容，没有中间态。

方法一：查当前版本
运行 codex --version，如果输出是 0.81.0 或更高，且你的 API 服务（比如 Ollama、vLLM 旧版、Qwen 的本地 API）只暴露 /v1/chat/completions 路径，那必须降级。

方法二：强制锁定 0.80.0 版本
npm install -g @openai/codex@0.80.0。这一步不可跳过，否则后续所有配置都是无效劳动。

注意：【npm install 命令必须加 -g 参数，否则全局命令 codex 仍指向旧版本】。局部安装不会覆盖 shell 中的可执行文件路径。

配置文件中 wire_api 的填写规则

wire_api 不是可选项，是协议开关。填错等于告诉 Codex：“请用西班牙语跟讲粤语的人对话”。它不报语法错，只沉默失败。

步骤一：确认你的 API 服务支持哪种协议
用 curl 测试：访问 http://localhost:8080/v1/chat/completions 成功 → 支持 chat；访问 http://localhost:8080/v1/responses 返回 404 → 不支持 responses。

步骤二：按版本严格填写
0.80.0 及以下 → wire_api = "chat"；0.81.0 及以上 → wire_api = "responses"。大小写、引号、拼写全需一致，"Chat" 或 chat （尾部空格）都会加载失败。

Codex Imagen

通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存

下载

步骤三：删掉配置中所有多余字段
新版文档里出现的 allow_insecure、timeout_ms 等字段，在 0.80.0 配置中会被忽略甚至引发解析错误。只保留必要项：base_url、wire_api、env_key。

API Key 必须走环境变量

config.toml 里不能出现任何明文密钥。Codex 会主动忽略 api_key = "xxx" 这类写法，只读取 env_key 指定的环境变量值。

方法一（推荐）：Linux/macOS 终端临时设置
export CUSTOM_API_KEY="sk-xxxxx"，然后在同一终端运行 codex 命令。

方法二：写入 shell 配置文件
在 ~/.zshrc 或 ~/.bash_profile 中追加 export CUSTOM_API_KEY="sk-xxxxx"，再执行 source ~/.zshrc 生效。

【env_key 字段填的是变量名，不是密钥本身。填错变量名会导致 Codex 读到空值，报 401 错误】

base_url 的协议与路径细节

本地服务必须用 http，不能用 https。哪怕你用 nginx 反向代理加了证书，Codex 0.80.0 默认不校验 SSL，但会因协议栈不匹配直接连接拒绝。

正确写法：base_url = "http://localhost:8080/v1"
错误写法：base_url = "https://localhost:8080/v1" 或 base_url = "http://localhost:8080/v1/"（末尾斜杠会拼出 //v1//chat/completions 导致 404）。

如果你的服务监听在非标准端口（如 11434 对应 Ollama），确保端口开放且无防火墙拦截。Windows 用户需确认 WSL2 的端口转发是否启用。