国内使用Codex需通过合规中转服务，且必须满足网络可达、协议兼容、认证适配三条件；先确认Node.js和npm已正确安装并加入PATH，再全局安装Codex CLI，配置auth.json与config.toml（含正确base_url、wire_api="responses"及model_provider一致），最后实测codex ask命令返回真实文件名才表示链路打通。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
国内网络环境下 Codex 启动后反复报错、连接超时、响应中断，根本原因不是安装失败，而是请求链路被阻断或中转接口能力不匹配。官方接口直连不可行，必须通过合规中转服务接入，且需同时满足网络可达性、API 协议兼容性、认证方式适配三重条件。
确认基础环境是否就绪
打开终端，依次执行两行命令：
node -v → npm -v
若任一命令返回 command not found，说明 Node.js 未安装或未加入系统 PATH，此时 Codex 安装必然失败，必须先解决此问题再继续。
Mac 用户可直接运行 brew install node；Windows 用户请下载 Node.js 22+ 安装包并勾选“Add to PATH”选项；Linux 用户建议用 apt 或 yum 安装，避免使用 snap 版本——它常导致全局命令不可见。
安装 Codex CLI 并验证
执行全局安装命令：
npm install -g @openai/codex
安装完成后立即验证：
codex --version
如果输出类似 v1.4.2 的版本号，说明 CLI 已就位；若提示 codex: command not found，请先检查 npm 全局 bin 路径是否已加入 shell 配置文件（如 ~/.zshrc 或 ~/.bash_profile），并执行 source 刷新。
创建配置目录与认证文件
手动创建 ~/.codex 目录（若不存在）：
mkdir -p ~/.codex
进入该目录，新建 auth.json 文件，内容仅一行：
{"OPENAI_API_KEY":"sk-xxx"}
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
【注意：此处的 sk-xxx 必须来自支持 Codex Responses API 的中转服务商，不能是普通 Chat Completions 类 Key】
若你用的是讯飞 Coding Plan、LetAiCode 或 Tokenfty 等平台，请在控制台创建时明确选择「Codex 兼容模式」或「Responses API 支持」分组，否则后续所有配置都将无法触发模型调用。
配置中转服务参数（config.toml）
在 ~/.codex/ 下新建 config.toml，填入以下最小可用配置：
[model_providers.api111]
base_url = "https://api.letaicode.com/v1"
wire_api = "responses"
requires_openai_auth = false
model_provider = "api111"
第一步：model_provider 值必须与 [model_providers.xxx] 中的 xxx 完全一致，字母大小写、下划线、数字均不可差错，否则 Codex 启动时会静默忽略该 provider。
第二步：base_url 只写到 /v1 结尾，【绝不可包含 /chat/completions 或 /responses 等路径后缀】，Codex 内部会自动拼接 wire_api 指定的子路径。
第三步：wire_api 固定填 "responses"，这是 Codex 执行代码任务时唯一识别的接口形态，填错将导致任务卡在“正在思考”状态且无日志输出。
启动并实测任务流
进入任意空项目目录，执行：
codex init
等待初始化完成，再运行：
codex ask "列出当前目录下的所有 .js 文件"
这一步必须真实执行，不能只看启动成功。只有返回具体文件名（如 index.js、utils.js），才代表中转链路真正打通；若返回空、超时或 JSON 解析错误，说明 base_url 或 wire_api 配置有误，或所选中转站未启用 Responses API 能力。
