五个入口里，CLI 是最轻的那个，敲一条命令就能用起来。项目就在本地的时候它最顺手。
先确认机器能跑
装之前先敲三个版本号，node、npm 和 git，各一条命令。这一步过了，后面基本不会卡在依赖上。
如果版本号都出来了还是装不上，问题一般在系统上。macOS 太老的装不了，Linux 这边 Ubuntu 和 Debian 的旧版也一样。Windows 的情况是另一回事，原生终端里它跑不起来，得先把 WSL2 准备好。
内存不是硬门槛，4GB 能跑，8GB 跑长任务更舒服。
一条命令装上
安装本身就一个动作，用 npm 全局装，命令是 npm install -g @openai/codex。
想更新到最新版，把包名后面加上 @latest 再跑一遍。装完用 codex –version 看一眼版本号，出来了就说明装上了。
登录
在终端直接跑 codex，它会给出登录提示，跟着走一遍就行。Codex 可以用 ChatGPT 账号在多个入口之间通用，具体能用到哪些计划、限额和组织策略，以官方的帮助中心说明为准。
装完先让它只读一遍仓库
这一步很多人会跳过，直接开干，结果第一次就翻车。顺序应该是先让它读，不动手。
进入本地项目根目录，跑 codex 启动，给它一段只读指令。指令可以这么写：请先阅读这个仓库的目录结构，README，包管理器配置和测试配置，不要修改文件，再总结项目用途，主要技术栈，安装依赖和运行测试的方法，最后建议三个低风险任务。
它读完会给出一个项目画像。这份东西的价值在于，后面交给它的每个任务，都建立在它真的看懂了这个项目之上。
装不上时对照这几条
codex 命令找不到，多半是 npm 的全局 bin 目录没进 PATH。用 npm bin -g 看一眼路径，把它加进 shell 的环境变量就好。
登录之后仍然提示没权限，通常是账号计划、组织策略或者会话状态的问题。重新登录一次，再对照帮助中心里的计划说明。
Windows 上跑起来不对劲，基本是没走 WSL2，或者 shell 环境不完整。按官方建议换成 Windows 11 加 WSL2。
仓库里的命令跑不起来，一般是项目依赖没装，或者本地缺环境。先把依赖装上，再让它读测试配置。
再往下就是让它动手改代码，那一步比装它要小心得多。
