国内开发者需绕过网络限制并配置中转API密钥才能本地运行OpenAI Codex CLI：先验证Node/npm/Git版本达标，再全局安装CLI，最后配置auth.json和config.toml（指定model_provider="api111"及model="gpt-5.4"）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
国内开发者想在本地终端直接用 OpenAI Codex 执行代码生成、调试、Git 操作等任务，必须绕过网络限制并确保 CLI 工具能稳定调用模型服务，否则执行 codex 命令时会卡在连接超时或报 403 错误，根本无法进入交互界面。
检查并安装基础运行环境
打开终端，依次运行三行命令验证当前环境：
node --version → 输出需为 v22.12.0 或更高；npm --version → 需 ≥ 10.9.0；git --version → 需 ≥ 2.43.0。
任一版本不达标，立即修复：macOS/Linux 用户执行 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash && sudo apt-get install -y nodejs；Windows 用户必须启用 WSL2（运行 wsl --install），在 Linux 子系统中操作，【原生 Windows CMD/PowerShell 不支持 Codex CLI】。
全局安装 Codex CLI 工具
在终端中执行：npm install -g @openai/codex。
安装完成后运行 codex --version，看到类似 0.81.3 的输出即成功。
若提示 command not found: codex，重启终端或执行 source ~/.bashrc（Linux/macOS）刷新 PATH。
配置 API 密钥与模型服务
第一步：创建配置目录并进入：mkdir -p ~/.codex && cd ~/.codex。
第二步：生成认证文件：echo '{"OPENAI_API_KEY":"sk-xxx"}' > auth.json，把 sk-xxx 替换为你从第三方中转平台获取的可用密钥（注意：不是 OpenAI 官方平台生成的 key，官方 key 在国内直连无效）。
第三步：新建 config.toml：touch config.toml，填入以下内容：
model_provider = "api111"
model = "gpt-5.4"
model_reasoning_effort = "high"
⚠️ 这里不能填 gpt-5.5 —— 当前 Codex CLI 0.81.x 默认不兼容该模型，强行指定会导致启动后无响应；如需使用 gpt-5.5，请改用 Codex Desktop App，而非 CLI。
启动 Codex 并验证连接
方法一（推荐）：进入任意项目文件夹，运行 codex，等待几秒后出现欢迎提示和光标即可。
方法二：强制指定配置路径启动，用于排查问题：codex --config ~/.codex/config.toml。
首次运行若卡住超过 15 秒，立刻按 Ctrl+C 中断，检查 auth.json 是否存在、key 是否粘贴完整、config.toml 文件末尾是否有多余空格——这三个地方出错率最高。
