必须提前准备好四个不可替代要素：正确的 Node.js 版本（≥22）、有效的 API Key、兼容 Responses API 的 Base URL（以 /v1 结尾并支持 /responses 路径）、能被 Codex 正确识别的配置文件路径（Windows 为 C:\Users\用户名.codex，macOS/Linux 为 ~/.codex），缺一即报错或静默失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让 Codex 成功调用第三方大模型 API，必须提前准备好四个不可替代的要素：正确的 Node.js 版本、有效的 API Key、兼容 Responses API 的 Base URL，以及能被 Codex 正确识别的配置文件路径。缺一不可，否则启动即报错或静默失败。
确认本地运行环境
打开终端（Windows 用 PowerShell 或 WSL2，macOS/Linux 用 Terminal），执行：
node --version && npm --version
输出必须同时满足：【Node.js ≥ 22】 且 【npm ≥ 10】。低于此版本会导致 codex CLI 安装失败或运行时 panic 报错，不是警告，是直接中断。
若不满足，请卸载旧版 Node.js，前往 https://nodejs.org 下载 LTS 版本重新安装——不要用 brew install node 或 apt install nodejs，它们常提供过时版本。
获取第三方 API 凭证
登录你选用的第三方平台（如 DeepSeek 开放平台、OneAPI 面板、Codeilab 等），进入「API Keys」页面。
创建新密钥时，注意两个硬性要求：
① 密钥类型必须选 【codex】 或明确标注支持 Responses API；
② 分组不能设为“仅限 chat/completions”，必须允许 /v1/responses 路径调用。
复制生成的完整 API Key（以 sk- 开头，长度通常为 51 字符），立即保存到安全位置。该 Key 一旦关闭页面就无法再次查看，重置后旧 Key 立即失效。
验证 Base URL 兼容性
第三方服务提供的 Base URL 必须以 /v1 结尾，例如：
✅ 正确：https://api.deepseek.com/v1、https://oneapi.example.com/v1
❌ 错误：https://api.deepseek.com（缺 /v1）、https://api.example.com/v1/chat/completions（路径错误）
最关键的是确认该地址实际支持 Responses API 协议。可临时用 curl 测试：curl -X POST "$BASE_URL/responses" -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{"model":"gpt-5.5","prompt":"test"}'
返回 404 或 405 表示不支持；返回 400 或 200（含 streaming chunk）才代表可用。很多中转服务默认只开 chat/completions，需在面板里手动开启 Responses 兼容开关。
定位并初始化配置目录
首次启动 Codex 桌面客户端或运行 codex --help 命令，会自动创建默认配置目录：
Windows：C:\Users\你的用户名\.codex
macOS/Linux：~/.codex
进入该目录，检查是否存在 config.toml 和 auth.json。若不存在，手动创建空文件——【不要跳过这步】，Codex 不会自动补全缺失文件，后续所有配置都将被忽略。
注意：Windows 资源管理器默认隐藏 .codex 这类以点开头的文件夹，需在「查看」→「显示」→ 勾选「隐藏的项目」才能看见。
