跳至主要內容

CX-12 Codex CLI 辅助指南：App 用户什么时候需要终端

Mr.Over2026/5/1大约 5 分钟aiaicodex

CX-12 Codex CLI 辅助指南：App 用户什么时候需要终端

主要来源：OpenAI Codex CLI、CLI Slash Commands、Config、MCP、Review 官方文档。

📚 本课学习目标

完成本课学习后，你将能够：

  1. 理解CLI的定位：CLI是App的辅助工具，不是普通用户的第一入口
  2. 掌握CLI常用命令：codex --help、codex exec、codex review、codex mcp list
  3. 理解审批与沙盒参数：--ask-for-approval和--sandbox的组合使用
  4. 使用codex exec无头执行：在CI和脚本中运行一次性只读任务
  5. 使用codex review终端审查：快速检查当前diff，与App Review交叉验证
  6. 掌握CLI slash commands：/status、/permissions、/plan、/compact等常用命令
  7. 用CLI管理MCP和Plugins：排查工具配置、统一团队安装
  8. 理解CI安全原则：最小权限、外部沙箱、不输出密钥、明确范围、人工合并

🗺️ 学习路径导航（先看这里！）

💡 根据你的情况选择学习路径：不用全看！

路径A：快速上手（⏱️ 10分钟）

适合人群：想知道CLI能干什么

只看这些章节：

✅ 第1-2部分：CLI定位 + 常用命令（5分钟）
✅ 第4部分：codex exec（5分钟）

路径B：完整学习（⏱️ 2-3小时）

适合人群：需要用CLI做CI或排查

学习顺序：从头到尾所有章节

1. CLI 的定位

CLI 是 App 的辅助工具，适合：

  • 排查配置。
  • 管理 MCP。
  • 在 CI 中无头执行。
  • 终端中快速 review。
  • 用脚本批处理。
  • Linux 或远程服务器环境。

不适合：

  • 作为普通 App 用户的第一入口。
  • 替代 App Review 面板。
  • 让新手先背所有参数。

2. 常用命令

codex --help
codex
codex app
codex exec "summarize this repo"
codex review
codex mcp list
codex plugin --help
codex features

App 用户学习 CLI 的顺序：

  1. 先会用 codex --help 看本机支持项。
  2. 再会用 codex app 从终端打开或配合 App。
  3. 需要无头任务时再学 codex exec。
  4. 需要审查时再学 codex review。
  5. 需要排查外部工具时再学 codex mcp 和 plugin 命令。

不要先背参数表。CLI 版本变化快，本机 --help 比教程里的静态列表可靠。

3. 审批与沙盒

CLI 常见参数：

codex --ask-for-approval on-request --sandbox workspace-write
codex --ask-for-approval never --sandbox read-only

危险模式只用于外部已经隔离的一次性环境：

codex --dangerously-bypass-approvals-and-sandbox

不要把危险模式写成团队默认推荐。

如果你不知道该选什么，App 用户默认做法是：

场景建议
只读分析read-only / 需要审批
小范围改 docsworkspace-write / 明确目录
跑测试允许普通命令，危险命令仍审批
CI runner只给 PR diff 或目标目录
一次性隔离环境才考虑无审批无沙盒

4. codex exec

无头执行一次任务：

codex exec "read the repo and summarize test commands"

适合：

  • CI。
  • 脚本化只读分析。
  • 生成报告。

不适合：

  • 需要频繁交互的大改。

一个更清楚的无头任务示例：

codex exec "Read package.json and AGENTS.md. Report the install, test, lint, and build commands. Do not modify files."

5. codex review

终端审查当前改动：

codex review

适合：

  • CI PR 审查。
  • 本地提交前快速检查。
  • 与 App Review 交叉验证。

6. CLI slash commands

终端交互模式中可以输入 /help 查看当前 slash commands。不要把命令表写死；以当前 CLI 为准。

App 用户重点掌握：

  • /status
  • /permissions
  • /plan
  • /goal
  • /review
  • /mcp
  • /plugins
  • /compact
  • /resume

如果这些命令没有出现在你本机 /help，以本机输出为准，不要按教程硬敲。

7. CLI 管理 MCP / Plugins

当 App 中看不到工具或需要团队统一配置时：

codex mcp --help
codex plugin --help

CLI 是管理和排查路径，不是普通用户调用外部工具的唯一方式。

CLI 改完 MCP 或插件后，仍要回 App 验收：

  1. App 里能否看到工具或插件。
  2. 线程中能否调用。
  3. 权限提示是否符合预期。
  4. 是否能撤销或禁用。

8. CI 安全原则

原则说明
最小权限CI token 只给需要的仓库权限
外部沙箱无沙盒模式只在 runner 自身可信时使用
不输出密钥日志中不得打印 secret
明确范围只审查 PR diff 或指定路径
人工合并自动评论可以，自动合并要慎重

常见问题

Q1：App 用户不装 CLI 可以吗？

可以，但排查和 CI 会不方便。建议安装，但不先学。

Q2：CLI 和 App 的配置完全共享吗？

不要做绝对假设。看当前版本和官方文档。能通过 App 设置解决的，优先用 App。

Q3：CLI 能替代 Automations 吗？

不能完全替代。CLI 适合脚本和 CI；App Automations 是 App 内的后台/周期任务体验。

📝 总结与检查清单

完成本课后，请确认以下所有项：

如果以上全部勾选，恭喜你掌握Codex CLI辅助！

附录

A. CLI命令速查

命令用途
codex --help查看帮助
codex交互模式
codex app打开或配合App
codex exec "任务"无头执行
codex review审查当前改动
codex mcp list列出MCP工具
codex plugin --help插件管理帮助

B. 推荐学习资源

最近更新: