国内开发者需通过兼容OpenAI Responses API的第三方服务接入Codex，先用curl验证/v1/responses端点返回HTTP 200及{"id":开头JSON，再配置Node.js≥22、初始化目录、正确设置auth.json或环境变量、严格按格式编写config.toml，最后用codex ask测试连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
国内开发者想用 Codex 但没有 OpenAI 账号，又不想被手机验证卡住，必须通过第三方 API 接入才能启动桌面客户端或 CLI 工具——这一步不走通，后续所有代码审查、多文件任务、上下文感知功能全部无法触发。
确认服务兼容性
先别急着填密钥和地址，第三方服务必须真正支持 OpenAI Responses API，不是“能返回文本”就行。只兼容 Chat Completions 的接口会卡在工具调用或流式响应阶段，导致 Codex 启动后立即报错 Failed to fetch response stream。
打开终端，用 curl 发一条最小验证请求：
curl -s -w "\nHTTP %{http_code}\n" "https://api.example.com/v1/responses" -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" -d '{"model":"gpt-5.5","input":"hi"}'
返回 HTTP 200 且响应体含 {"id": 开头的 JSON 才算初步通过；若返回 404，说明该服务商根本没实现 /v1/responses 端点，直接放弃。
准备配置环境
第一步：确认本地已安装 Node.js ≥ 22 和 npm ≥ 10。版本过低会导致 codex --version 报错或 CLI 安装失败。
第二步：运行一次 Codex 桌面客户端或执行 codex login（CLI），让程序自动生成默认配置目录。未初始化前，~/.codex（macOS/Linux）或 C:\Users\用户名\.codex（Windows）可能不存在。
第三步：检查 CODEX_HOME 环境变量是否已设置。如果设过，配置文件实际路径是 $CODEX_HOME/config.toml，不是默认路径——【很多人改了 config.toml 却不生效，就是因为误判了真实读取路径】。
填写 auth.json 认证文件
方法一：明文写入（仅限本地开发机）
在配置目录下新建 auth.json，内容严格为单字段 JSON：
{"OPENAI_API_KEY":"sk-你的完整密钥"}
⚠️ 注意：不能多加逗号、不能换行、不能包含 MODEL 或其他字段，否则会触发 403 Forbidden 错误。
方法二：环境变量注入（推荐生产环境）
删除或清空 auth.json，在系统中设置环境变量：
macOS/Linux：在 ~/.zshrc 或 ~/.bash_profile 末尾添加 export OPENAI_API_KEY="sk-xxx"，然后 source ~/.zshrc；
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
Windows：在系统环境变量中新增 OPENAI_API_KEY，值为密钥字符串。
配置 config.toml 模型路由
第一步：打开 config.toml，在文件顶部添加或修改三行全局配置：
model = "gpt-5.5"
model_provider = "myapi"
preferred_auth_method = "apikey"
第二步：在文件末尾新增模型提供方区块，注意方括号名称必须与 model_provider 值完全一致：
[model_providers.myapi]
name = "My Third-Party API"
base_url = "https://api.fenno.ai/v1"
wire_api = "responses"
requires_openai_auth = false
第三步：保存文件。不要用记事本另存为 UTF-8-BOM 格式，否则 Codex 会解析失败——用 VS Code、Notepad++ 或 vim 直接保存即可。
验证是否连通
关闭所有 Codex 进程，重新启动桌面客户端或运行：codex ask "test connection"（CLI）。
若终端输出完整响应且无 Connection refused 或 Invalid model 错误，则配置成功；若提示 Failed to refresh token，请回头检查 auth.json 格式或环境变量是否生效。
