必须先正确配置auth.json和config.toml两个文件：auth.json仅含{"OPENAI_API_KEY":"sk-xxx"}，config.toml需严格按Ace Data Cloud要求设置model_provider、base_url等参数，且均须置于用户目录下~/.codex（Windows为C:\Users\用户名.codex），配置后须重启终端并验证codex --version及codex --ask命令。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在本地终端用 Codex CLI 完成代码阅读、文件修改、命令执行和任务拆解，必须先让工具连上可用模型——这一步卡住的人最多，不是装不成功，而是装完跑不起来，报 401、提示 API Key 无效、config.toml 改了也不生效，根源全在 auth.json 和 config.toml 这两个文件的位置、格式和内容是否严格匹配当前系统路径与模型服务商要求。
确认系统环境与安装前提
Windows 用户必须先装 Git Bash，否则后续沙箱权限和路径解析会出错；macOS 用户需确保 ~/.zshrc 或 ~/.bash_profile 已加载；Linux 用户注意 /home/用户名/.codex 是唯一有效配置路径，不要写成 /root/.codex 或 ./codex。
打开终端，依次运行：
node -v → 输出必须 ≥ 22.0.0
npm -v → 输出必须 ≥ 10.0.0
不满足任一条件，停止后续操作，先升级 Node.js。npm install -g @openai/codex 命令只对 Node.js 22+ 有效，低版本会静默失败，但不报错。
安装 Codex CLI（三平台统一指令）
无论 Windows、macOS 还是 Linux，都优先执行：
npm install -g @openai/codex
安装完成后，关闭当前终端窗口，重新打开——这是关键动作。PATH 环境变量不会自动刷新，旧终端里执行 codex --version 一定报 command not found。
新终端中运行：
codex --version
看到类似 codex 0.131.0 的输出，说明安装完成。如果仍报错，请检查 npm 全局 bin 路径是否已加入 shell 配置文件（如 ~/.zshrc 中是否有 export PATH="$(npm config get prefix)/bin:$PATH"）。
创建并配置 .codex 目录与核心文件
第一步：手动创建配置目录
macOS/Linux 执行：
mkdir -p ~/.codex
Windows 执行（在 Git Bash 中）：
mkdir -p "$HOME/.codex"
【注意】Windows 资源管理器默认隐藏以点开头的文件夹，.codex 不会显示在 C:\Users\用户名 下，必须用 Git Bash 或 PowerShell 进入 $HOME 目录查看或创建。
第二步：生成 auth.json
进入 ~/.codex 目录，用任意文本编辑器新建 auth.json，内容仅且必须为：
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
{"OPENAI_API_KEY":"sk-xxx"}
其中 sk-xxx 替换为你从 Ace Data Cloud 控制台获取的真实 API Token。不要加空格、换行、逗号、注释，JSON 格式必须严格合法，多一个引号都会导致 401。
第三步：生成 config.toml
在同一目录下新建 config.toml，粘贴以下内容：
model_provider = "acedatacloud"
model = "gpt-5.6-sol"
sandbox_mode = "workspace-write"
web_search = "disabled"
[model_providers.acedatacloud]
name = "Ace Data Cloud"
base_url = "https://api.acedata.cloud/v1"
env_key = "ACEDATACLOUD_API_KEY"
wire_api = "responses"
这个配置专为国内 Ace Data Cloud 服务定制，不可混用七牛云或 LetAiCode 的 base_url 和 env_key。改错一行，请求就会发往错误域名，返回 404 或 403。
启动 Codex CLI 并验证连接
方法一：直接启动（推荐新手）
进入任意 Git 仓库根目录，运行：
codex
首次运行会自动检测 ~/.codex/auth.json 和 ~/.codex/config.toml，读取后连接 Ace Data Cloud。看到 Welcome to Codex CLI! 和 > 提示符，说明已就绪。
方法二：带项目上下文启动
codex --project .
该命令强制 Codex 加载当前目录全部文件结构，适合首次调试时确认它能否正确识别 package.json、src/、tests/ 等路径。若提示 “Failed to list files”，说明 sandbox_mode 权限未生效或目录权限被系统拦截。
方法三：快速测试模型响应
codex --ask "print the current date in ISO format as a JavaScript string"
终端应立即返回类似 new Date().toISOString() 的结果。不卡顿、无报错、有合理输出，证明模型通路完全打通。
