Codex CLI 安装：Windows、macOS、Linux 与首次登录
Codex CLI 可通过官方独立安装器、npm 或 Homebrew 安装。
Codex CLI 是终端里的编程工具，可以读取项目、修改文件和运行命令。先选择操作系统与安装方式，再验证版本和登录；Windows 目前已有官方原生安装器，WSL 不再是所有用户的前提。
| 环境 | 官方说明中的方式 | 选择提示 |
|---|---|---|
| macOS / Linux | 独立安装器、npm，macOS 可用 Homebrew | 不同方式避免重复安装造成 PATH 混乱 |
| Windows | 原生 PowerShell 安装器或 npm | 新开 PowerShell，检查安装输出 |
| WSL | 在 Linux 环境安装 | 工具链在 WSL 时保持项目和命令环境一致 |
无需同时使用所有方法。已有 npm 的用户可使用：
npm install -g @openai/codexmacOS 使用 Homebrew 时，官方说明为：
brew install --cask codex独立安装脚本请从官方安装文档取得并审查，不从网盘、群文件或第三方下载站运行。
安装后关闭并重新打开终端，运行：
codex --versionmacOS / Linux 使用 which codex，Windows PowerShell 使用 Get-Command codex，确认实际运行的命令路径。若版本不符，检查是否同时安装了多个副本。
更新应沿用原安装方式，npm 为 npm install -g @openai/codex，Homebrew 为 brew upgrade --cask codex。更新完成后再次检查版本。
进入测试项目目录，执行 codex。首次启动按提示选择 ChatGPT 登录或其他可用认证方式，登录与 API 计费请核对官方认证说明。
先给一个只读任务：
请说明这个项目的目录、启动方式和现有测试。
先读取 README 与项目配置，不修改文件。
指出需要进一步确认的信息。检查解释是否与项目一致，然后再授权一个范围明确的修改。运行前后建立 Git 检查点，查看差异和测试结果；不要让工具一次改整个仓库。
| 问题 | 检查方向 |
|---|---|
| 找不到命令 | 新终端、PATH、安装输出和所用 shell |
| npm 安装失败 | Node/npm 版本、目录权限和包管理器配置 |
| 浏览器登录失败 | 原登录方式、服务状态、支持范围和错误文本 |
| WSL 找不到文件 | Windows 与 Linux 路径、当前工作目录 |
| 型号不可用 | 登录方式、账号计划、工作区和 /model 列表 |
| 命令被拒绝 | 当前权限模式与任务授权范围，不盲目关闭保护 |
遇到问题保留版本、系统、完整错误和最小复现步骤；日志中隐藏密钥、凭证与私有路径。
在编辑器内操作，阅读Codex VS Code插件教程：安装、登录、Cursor/Windsurf使用与常见问题；需要重复工作流，阅读Codex Skills怎么安装和创建？SKILL.md目录、触发方式与安全检查。选择型号前查看AI 模型怎么选：Chat、Work、Codex 与 API 的区别。
使用时遵守当地法律法规和平台条款，代码和组织数据应按授权范围处理。
官方资料与核验记录#
官方正文核验日期：2026-10-12。