日常工作流 / CLI

CLI 安装与登录

这一节先把 Codex CLI 跑起来：确认本地环境，安装命令行工具，完成登录，并在真正改代码前准备好一个可回滚、可验证的工作区。

章节：12 预计阅读：4 分钟最后调整：2026.6.22

安装前检查

先确认你是在适合命令行工作的环境里。macOS、Linux 和 Windows WSL2 通常最稳；如果直接在 Windows 里运行，也建议优先使用 PowerShell 或 Windows Terminal。

项目	建议
操作系统	macOS、Linux，或 Windows 11 + WSL2
Git	推荐 2.23+，方便查看 diff、提交和协作
Node.js	如果采用 npm 安装路径，先准备可用的 Node 与 npm
工作区	选择一个已有 Git 仓库，或新建一个测试仓库先练手

node -v
npm -v
git --version

如果你使用 npm，全局安装后就可以在任意目录调用 codex 命令：

npm install -g @openai/codex

安装完成后检查版本和帮助信息：

codex --version
codex --help

小提示：如果终端提示找不到 codex，先关闭当前终端，重新打开再试。仍然不行时，检查 npm 的全局 bin 目录是否在系统 PATH 里。

第一次运行 Codex CLI 时，通常会引导你完成浏览器登录。按终端提示打开链接、登录 OpenAI / ChatGPT 账号，再回到终端确认即可。

codex

登录后可以先让 Codex 解释当前目录，不要急着授权大范围修改：

codex "请先阅读当前项目结构，只总结你看到的目录和可能的启动命令，不要修改文件。"

1. 选择低风险仓库

优先选文档、Demo 或个人项目，别把第一次尝试放在生产仓库里。

2. 保持 Git 干净

运行前先看 git status，确认哪些改动是你已有的。

3. 明确任务边界

告诉 Codex 只读、只改某个文件，或必须先汇报计划。

4. 设定验证方式

提前写清楚要跑哪些测试、构建命令或页面检查。

git status
codex "帮我阅读 README，找出本项目的启动命令和测试命令。先不要改文件。"

第一次给 Codex 的任务要小，最好是解释、补文档、修一个明确的报错。这样你能观察它如何读文件、运行命令、申请权限和汇报结果。

安全边界：涉及凭据、生产数据库、服务器部署、批量删除、付费 API 调用时，先停下来确认授权范围。CLI 很适合做真实工作，但前提是你给它清楚边界。

codex "请检查 package.json，告诉我这个项目有哪些脚本，以及哪个脚本最适合用来验证改动。不要修改文件。"

重新打开终端，确认 npm 全局 bin 目录在 PATH 里。Windows 用户也可以换到 PowerShell 或 Windows Terminal 重试。

检查浏览器是否完成登录、终端是否等待回调。如果网络环境复杂，先换一个更干净的网络环境验证。

回到任务目标判断：只读操作通常风险较低；写文件、联网、安装依赖、删除文件、访问外部服务都需要更谨慎。