先说结论：Codex CLI 是跑在终端里的 Codex，适合习惯命令行的开发者。安装只需要一条命令，登录支持 ChatGPT 账号和 API Key 两种方式，计费归属不同。装完之后让它读一遍你的项目、改一个小地方、你验收通过，就算入门了。
CLI 适合谁？和 App 怎么选？
Codex 有多个入口：App（桌面图形界面）、CLI（命令行）、IDE 扩展和 Web 云端。CLI 和 App 能力大致相同，区别在交互方式。
| 对比项 | Codex App | Codex CLI |
|---|---|---|
| 操作方式 | 鼠标 + 键盘，图形界面 | 纯键盘，终端内操作 |
| 适合人群 | 偏好可视化界面的开发者 | 习惯终端工作流的开发者 |
| 项目管理 | 线程列表、侧边栏 | 会话管理（/new、/resume） |
| 脚本化 | 不支持 | 适合写脚本调用 |
| 服务器 / SSH 场景 | 不适合 | 直接在远程终端里用 |
简单说：平时在 VS Code 或 Finder 里干活 → 用 App；平时在终端里 cd、git、vim → 用 CLI。两者共享同一个账号和额度，不冲突。
App 的详细用法参考站内 Codex App 教程。
安装方式
Codex CLI 通过 npm 安装。确保你的机器上已经有 Node.js（建议 v22 或更高版本）。
npm install -g @openai/codex安装完成后终端里输入 codex 或 codex --version 确认是否成功。
如果你用的是 yarn 或 pnpm，对应命令替换包管理器即可。具体安装方式如有变动，以 OpenAI 官方 Codex 文档为准。
常见问题：如果提示权限不足，macOS / Linux 下可以加 sudo 或者配置 npm 的全局安装路径；Windows 下用管理员权限的终端运行。
没有 Node.js？ macOS 可以用 Homebrew 安装（brew install node），Windows 从 nodejs.org 下载安装包。装好后 node --version 确认版本即可。
登录：ChatGPT 账号 vs API Key
CLI 支持两种登录方式，计费归属不同：
| 登录方式 | 计费归属 | 适合场景 |
|---|---|---|
| ChatGPT 账号登录 | 走 ChatGPT 套餐额度（Plus / Pro） | 个人日常开发 |
| API Key 登录 | 走 API 余额，按 token 计费 | 脚本化、CI/CD、团队共享 Key |
ChatGPT 账号登录：首次运行 codex 时，CLI 会引导你在浏览器里完成 ChatGPT 账号授权。登录后，用量从你的 Plus 或 Pro 套餐额度中扣除，和 App 里用 Codex 是同一个额度池。
API Key 登录：设置环境变量 OPENAI_API_KEY，CLI 会自动识别。这种方式不消耗 ChatGPT 套餐额度，而是按 API 的 token 定价单独扣费。适合需要精确控制成本或在服务器上跑的场景。注意：API Key 方式不包含部分云端集成功能。
两种方式可以切换，不需要重新安装。切换前确认当前会话已结束即可。
第一个任务：让它读项目、改一处、你验收
装好了，登录了，下面跑一个真实任务试试手。
第一步：进入项目目录
cd ~/your-project
codexCLI 会启动交互界面。
第二步：让它先读项目
在 CLI 里输入：
请阅读当前项目的结构和 README，告诉我这个项目是干什么的、怎么启动。Codex 会扫描目录、读取关键文件，然后给你一份摘要。这一步不改任何东西，先确认它理解对了。
第三步：给一个小任务
比如：
把 README 里的项目描述改成中文，保留原有格式。Codex 会告诉你它打算怎么改，然后执行。如果你的权限设置是”请求批准”，它会先问你同意再动手。
第四步：验收
用 /diff 命令查看它改了什么：
/diff确认没问题后，你自己决定是否 git commit。Codex 不会自动帮你提交（除非你授权了）。
这就是一个完整的最小流程：读 → 改 → 查 diff → 你验收。
建议第一次用 CLI 时挑一个不重要的项目或测试仓库练手。等熟悉了命令和交互节奏之后，再用到正式项目里。
几个实用建议
- 复杂任务先输
/plan，让 CLI 出方案再执行 - 用
/status随时查看当前额度和模型 - 任务做完了用
/new开新会话，上下文更干净 - 项目根目录放一个
AGENTS.md文件，写清楚项目规则和注意事项，Codex 会自动读取 - 如果会话聊太长感觉 Codex 回答变差，用
/compact压缩上下文 - CLI 和 App 共享额度，两边交替使用不冲突
额度不够用的时候，可以参考 Codex 额度不够用怎么办。升级 ChatGPT Plus 遇到付款问题，可以直接在这里一站式解决：ChatGPT Plus 国内充值升级教程。
套餐、价格、模型以 OpenAI 官网当时显示为准，本文核对日期 2026-09-17。