用熟了 Codex App 之后，很多人会想更进一步，把 Codex 用到真实项目开发里。这时候就轮到 Codex CLI 出场了。它是 Codex 的命令行版本，装在 PowerShell、Terminal 和 iTerm 这类终端里，能力上比图形界面更贴近工程师的日常工作流。这篇从安装到登录到常用命令，一次讲完。
安装：npm 一行命令搞定
Mac 和 Linux有两种方式。方式一用 npm：先确认装了 Node.js（终端输 node -v 和 npm -v 能看到版本号），然后执行：
npm install -g @openai/codex
方式二用 Homebrew：brew install --cask codex。装过 Node 就用 npm，习惯 Homebrew 就用 brew，效果一样。
Windows用户建议用 PowerShell 或 Windows Terminal：先装 Node.js，然后同样执行 npm install -g @openai/codex，最后 codex --version 确认安装成功。
一个重要提醒：第一次运行别在系统目录里跑。C 盘根目录，桌面，下载文件夹，重要资料文件夹都不要直接操作，建议先建一个练习目录，比如 D:\AI-Codex-Projects\hello-codex。
登录：两种方式选一种
第一次输入 codex 会提示登录，有两种方式：
ChatGPT 账号登录（新手首选）：运行 codex login，选 Sign in with ChatGPT，浏览器自动打开登录页，登录成功后结果传回终端就能用了。走的是 ChatGPT 套餐额度。
API Key 登录（开发者向）：适合自动化脚本，CI/CD，服务器任务。先去 OpenAI Platform 创建 Key，然后设置环境变量登录。Windows PowerShell 写法：
$env:OPENAI_API_KEY=”你的_API_Key”
$env:OPENAI_API_KEY | codex login –with-api-key
注意 API Key 按 Platform API 用量计费，别不清楚费用规则就长时间跑任务。Key 本身非常敏感，不写进代码，不发给别人，不截图公开，不传 GitHub。万一泄露，立刻去 OpenAI Platform 删除重新生成。
终端命令：新手记住这 10 个就够
CLI 命令分两类：终端命令在 PowerShell/Terminal 里输入，斜杠命令在进入 Codex 之后的输入框里输入。新手最常用的终端命令：
- codex：启动 CLI
- codex login / codex login status / codex logout：登录，查状态，退出
- codex doctor：环境出问题时自动生成诊断报告，启动异常先用它
- codex –version：查版本，确认装没装好
- codex resume –last：接着上次任务继续
- codex archive：归档不用的任务，让列表干净
- codex update：更新版本
- codex exec “任务”：一次性执行任务，跑完就结束，适合自动化场景
还有几个实用技巧：启动时直接带任务 codex "请解释这个项目结构"。带图分析 codex -i ./error.png "分析这个报错"。指定目录启动 codex --cd 项目路径。
斜杠命令：会话里的快捷操作
进入 Codex 后，输入 / 可以用这些命令：
- /model：切换模型和推理强度。普通任务默认模型加中推理，复杂 bug 用高推理，改文案用低推理
- /diff：查看 Codex 到底改了什么，改完文件必看
- /plan：计划模式，复杂任务先要方案再动手
- /permissions：调整权限，控制能不能改文件，联网，跑命令
- /init：生成 AGENTS.md 项目规则文件，新项目第一次用 Codex 时跑一下
- /compact：对话太长时压缩上下文
- /status：查当前模型，权限，上下文状态
- /quit：退出
沙盒与权限：新手推荐组合
CLI 的沙盒模式分三档：read-only 只能看不能改，适合纯分析。workspace-write 当前项目可读写，日常推荐。danger-full-access 完全放开限制，新手不要用。
新手最推荐的启动组合是：
codex –sandbox workspace-write –ask-for-approval on-request
意思是：Codex 可以在当前项目里干活，但敏感操作必须先问我。
这几条危险命令见到要停手
有些参数和命令风险很高，新手直接跳过。--sandbox danger-full-access（放开文件和网络限制）--yolo（跳过审批和沙盒）rm -rf（可能删除大量文件）git reset --hard（可能丢失未保存改动）curl xxx | sh（下载脚本直接执行），这些都别碰。
看到拿不准的命令，先问 Codex：「请解释这条命令的作用、风险，以及有没有更安全的替代方案。」
新手标准工作流
把上面的命令串起来，就是一个完整的工作流：
- cd 进项目目录
- git status 看当前状态
- codex 启动
- 输入任务让它干活
- /diff 查看改动，git diff 再检查一次
- 满意后 git add . 、git commit 保存版本
- codex archive 归档任务或 /quit 退出
下一篇讲另外两个入口：装在编辑器里的 IDE 插件，和跑在云端的 Codex Web。
