安装前检查
官方建议的 CLI 运行环境：
| 项目 | 建议 |
|---|---|
| 操作系统 | macOS 12+、Ubuntu 20.04+ / Debian 10+、Windows 11（WSL2） |
| Git | 推荐 2.23+，便于 PR 辅助能力 |
| 内存 | 4GB 起步，8GB 更稳 |
本地先确认环境：
node -v
npm -v
git --version
安装 CLI
常见安装方式（npm）：
npm install -g @openai/codex
更新到最新版本：
npm install -g @openai/codex@latest
检查版本：
codex --version
💡 也可用官方一键脚本：
curl -fsSL https://chatgpt.com/codex/install.sh | sh，支持 macOS / Windows / Linux。登录方式
运行 codex，根据终端提示用 ChatGPT 账号或 API key 完成登录。
codex
第一次只读任务
进入一个本地项目根目录，先让 Codex 只读仓库、不要改动文件：
cd path/to/your/project
codex
# 在 TUI 中输入：
请先阅读这个仓库的目录结构、README、包管理器配置和测试配置。不要修改文件。请总结：
1. 项目用途
2. 主要技术栈
3. 如何安装依赖和运行测试
4. 你建议我下一步交给你的 3 个低风险任务
安装失败时怎么判断
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
codex 命令找不到 | npm global bin 未进 PATH | 查看 npm bin -g，把目录加入 shell PATH |
| 登录后仍提示无权限 | 账号计划 / 组织策略 / 会话状态 | 重新登录，查看 Help Center 计划说明 |
| Windows 运行异常 | 未用 WSL2 或 shell 环境不完整 | 按官方建议用 Windows 11 + WSL2 |
| 仓库命令跑不起来 | 依赖未装 / 本地环境缺失 | 先安装项目依赖，再让 Codex 读测试配置 |