Codex CLI Features：终端功能地图

适用场景

这篇手册是 Codex CLI 的功能地图。你可以用它判断一个任务该用交互式 TUI、resume、exec、review、subagents、cloud task 还是 MCP。

如果你已经能运行 codex，下一步就是学会按任务选择功能。

功能总览

| 功能 | 用法 | 适合场景 | | --- | --- | --- | | Interactive mode | codex | 边聊边改、实时审查 | | Initial prompt | codex "..." | 快速启动一次会话 | | Resume | codex resume | 继续旧会话 | | Image inputs | 附加截图或设计稿 | UI、报错、视觉问题 | | Local review | 独立 Codex agent 审查改动 | 提交前质量检查 | | Subagents | 并行拆任务 | 大型调查和多模块分析 | | Web search | 搜索当前信息 | 需要最新外部信息时 | | Cloud tasks | 从终端发起云端任务 | 长任务或远端环境 | | Exec | codex exec | 非交互自动化 | | MCP | 外部工具和上下文 | 内部系统、数据库、文档 | | Approval modes | 控制命令和写入权限 | 风险治理 |

Interactive mode

运行：

codex

会进入全屏终端 UI。适合需要多轮沟通、审查计划、批准命令、看 diff 的任务。

也可以带初始 prompt：

codex "Explain this codebase to me"

Resume

Codex 会在本地保存 transcript。继续旧会话时：

codex resume

常见变体：

codex resume --all
codex resume --last

适合继续一个还没完成的任务，避免重新解释上下文。

图片输入

CLI 可以接收截图、错误窗口、设计稿等图片输入。适合：

• 分析 UI 截图。
• 根据设计稿实现页面。
• 解释错误弹窗。
• 对比前后视觉差异。

仍然要注意隐私，截图里不要包含密钥、客户数据或个人信息。

Local review

在提交或推送前，可以让一个独立 Codex agent 审查当前改动。适合发现：

• 逻辑漏洞。
• 未处理边界。
• 测试缺口。
• 无关改动。
• 安全风险。

review 不是合并许可，最终仍要人工判断。

Subagents

Subagents 适合并行探索。例如一个 agent 查前端入口，一个查 API，一个查测试失败。使用时要给清楚分工，并要求最后合并结论。

不要让 subagents 同时随意写同一批文件。并行写入容易冲突。

Exec 和自动化

非交互任务使用：

codex exec "检查这个仓库的 lint 配置并输出需要修复的文件列表"

适合脚本化、CI、日报、扫描、迁移检查。prompt 要包含输出格式和停止条件。

MCP 和 approval modes

MCP 让 Codex 访问外部工具和上下文。Approval modes 控制它何时能运行命令、写文件、联网或越过 sandbox。

组合使用时要谨慎：

• MCP 连接内部系统时，先确认权限和数据边界。
• 高权限 approval mode 不应作为默认。
• 自动化脚本里要保留审计日志。

常见错误

不要用交互式 TUI 做本应固定输出的 CI 任务。CI 更适合 codex exec。

不要把 resume 当成万能记忆。项目状态变化后，仍然要让 Codex 重新检查关键文件。

不要让 web search 替代官方文档或仓库事实。涉及当前 API、价格或规则时仍要核对权威来源。

小结

Codex CLI 的能力不止聊天。交互式模式适合人机协作，resume 适合继续上下文，exec 适合自动化，review 适合提交前检查，MCP 和 approval modes 则决定它能安全访问什么。