codex cli怎么使用第三方api-人工智能-PHP中文网

必须先确认 codex 实际读取的配置路径，再按 responses api 协议正确填写 config.toml 字段，最后用最小请求验证端点响应；默认路径为 ~/.codex/config.toml（macos/linux）或 %userprofile%.codex\config.toml（windows），但优先读取 codex_home 指定路径。

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

codex cli怎么使用第三方api

国内用户配置 Codex CLI 使用第三方 API 时，常卡在找不到生效的 config.toml、不敢把密钥写进文件、分不清“配置能加载”和“请求真成功”这三个环节。你得先确认当前终端里 Codex 实际读取的是哪个配置路径，再按 Responses API 协议填对字段，最后用最小请求验证端点是否真正响应。

确认 Codex 实际读取的配置文件位置

默认路径是 ~/.codex/config.toml（macOS/Linux）或 %USERPROFILE%\.codex\config.toml（Windows），但如果你设置过 CODEX_HOME 环境变量，它会优先读取该目录下的 config.toml。别凭 Finder 或资源管理器搜索结果判断——直接在准备运行 codex 的终端里执行：
echo $CODEX_HOME（macOS/Linux）或 echo %CODEX_HOME%（Windows）。如果输出为空，就用默认路径；如果有值，就去那个目录找 config.toml。

这一步漏掉会导致你改了半天文件，Codex 根本没读到。

编辑 config.toml 配置第三方 provider

打开 config.toml，按以下结构填写（以 EasyAPI 为例，其他服务商只需替换 base_url 和 env_key）：

model = "gpt-5.5"
model_provider = "easyapi"

[model_providers.easyapi]
name = "EasyAPI 聚合"
base_url = "https://token.easyapi.com/v1"
env_key = "EASYAPI_KEY"
wire_api = "responses"

【base_url 必须以 /v1 结尾】，少一个斜杠或写成 /v1/ 都会报 404；【wire_api 必须写死为 "responses"】，Codex 0.80+ 已移除 chat 模式，填错直接启动失败。

model_provider 的值（如 easyapi）必须和方括号里的段名 [model_providers.easyapi] 完全一致，大小写敏感，拼错一个字母就无法关联到 provider 配置。

php获得文件的mime type类

下载

安全存放 API Key

方法一：用 .env 文件（推荐）
在同级目录 ~/.codex/（Windows 是 %USERPROFILE%\.codex\）下新建 .env 文件，写入：
EASYAPI_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
注意不要加引号，也不要有多余空格。

方法二：用 auth.json（权限更严）
创建 ~/.codex/auth.json，内容为：
{"OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxx"}
然后在 config.toml 的对应 provider 段里删掉 env_key 行，并加上：
requires_openai_auth = true
接着给 auth.json 设置仅属主可读写：
chmod 600 ~/.codex/auth.json（macOS/Linux）

两种方式不能共存——Codex 会优先读 env_key 指向的环境变量，如果没设或为空，才 fallback 到 auth.json 的 OPENAI_API_KEY 字段。

验证第三方 API 是否真正可用

第一步：确保终端已加载 .env 中的变量
macOS/Linux 执行：
source ~/.codex/.env
Windows CMD 执行：
set /p dummy=

第二步：发送最小 curl 请求
复制并执行（替换 YOUR_MODEL_ID）：
curl -s -w "\nHTTP %{http_code}\n" \
"https://token.easyapi.com/v1/responses" \
-H "Authorization: Bearer $EASYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","input":"hi"}'

看到 HTTP 200 且返回 JSON 响应体，说明端点通了；若返回 404，检查 base_url 是否漏 /v1；若返回 401，确认 EASYAPI_KEY 变量是否真被加载、Key 是否复制完整（尤其开头 sk- 不要漏）。

第三步：用 Codex 发起真实调用
执行：
codex "用一句话介绍你自己"
如果返回合理文本，说明整个链路打通；如果卡住或报 stream disconnected before completion，问题出在服务端未正确发送 response.completed 事件，需联系中转服务商确认 Responses API 兼容性。