必须先安装Node.js 18 +并确保npm加入PATH，再用npm install -g @openai/codex全局安装CLI，接着创建~/.codex目录及config.toml配置文件，最后通过环境变量或auth.json配置API密钥。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在本地终端直接调用 Codex 模型写代码、解释错误或生成文档，但卡在第一步——根本装不上 Codex CLI，npm 报错、命令找不到、Windows 找不到 .codex 文件夹，这些都得从零理清楚。
安装 Node.js 与基础环境
Codex CLI 依赖 Node.js 运行，必须先装好 Node.js 18 + 版本，低于此版本会提示“Unsupported engine”并拒绝安装。访问 nodejs.org 下载最新 LTS（当前为 v20.15.1），双击安装，全程点“Next”即可。
安装完立刻验证：打开终端（Windows 用 PowerShell 或 Git Bash，macOS/Linux 用默认 Terminal），输入 node -v && npm -v。如果只输出 node 版本而 npm 报 command not found，说明安装包没勾选“Add to PATH”，需重装并确保勾选该选项。
这一步跳过会导致后续所有 npm 命令失效，不是警告，是硬性前提。
全局安装 Codex CLI
在终端中执行：
npm install -g @openai/codex
国内用户若遇到超时或 ECONNRESET 错误，改用淘宝镜像源安装更快：
npm install -g @openai/codex --registry=https://registry.npmmirror.com
安装过程无任何交互提示，完成后不要手动关闭终端——接下来要立刻验证。
验证是否安装成功
运行：
codex --version
正常应输出类似 codex-cli 0.46.0 的版本号。如果提示 command not found: codex，说明 npm 全局 bin 路径未加入系统 PATH。Windows 用户需检查安装时是否勾选了“Automatically install the necessary tools”，macOS/Linux 用户可运行 echo $PATH | grep -q "node_modules" || echo "PATH missing" 快速判断。
创建配置目录与文件
第一步：创建 .codex 目录
macOS/Linux 执行：mkdir -p ~/.codex
Windows 执行：mkdir %USERPROFILE%\.codex（在 PowerShell 中运行）
注意：Windows 资源管理器默认隐藏以点开头的文件夹，不能通过图形界面手动新建“.codex”文件夹，必须用命令行创建，否则 Codex 启动时会静默失败。
通过 codex-reset-radar.pages.dev 监控 Codex 使用重置窗口。轮询 current.json，检测窗口开启/关闭、预测等级变化以及概率跳变。
第二步：进入该目录，新建空文件 config.toml
macOS/Linux 可用：touch ~/.codex/config.toml
Windows 可用：type nul > %USERPROFILE%\.codex\config.toml
第三步：向 config.toml 写入最简可用配置
macOS/Linux（用 nano 编辑）：nano ~/.codex/config.toml → 粘贴以下内容 → Ctrl+O 保存 → Ctrl+X 退出
Windows（用记事本）：右键 → “编辑” → 粘贴 → 保存为 UTF-8 编码，文件名必须带英文引号防止自动加 .txt："config.toml"
model_provider = "openai"model = "gpt-5-codex"
配置 API 密钥（二选一）
方法一：环境变量方式（推荐 macOS/Linux）
编辑 shell 配置文件：nano ~/.zshrc（macOS）或 nano ~/.bashrc（Linux）
末尾追加一行：export OPENAI_API_KEY="sk-xxx"（把 sk-xxx 替换为你从 LetAiCode 或 Ace Data Cloud 获取的真实密钥）
保存后立即生效：source ~/.zshrc
方法二：auth.json 文件方式（Windows 用户首选）
在 %USERPROFILE%\.codex\ 目录下新建文件 auth.json，内容严格为：
{"OPENAI_API_KEY":"sk-xxx"}（前后无空格、无注释、无逗号，JSON 格式必须合法）
这一步写错一个引号或漏掉大括号，Codex 启动时会报 invalid character 并退出，不提示具体哪一行出错。
