掌握 App 核心功能

Codex App 是桌面端工作台，适合同时管理多个 Codex threads、隔离任务、审查 diff、配置 automations，并把本地开发、Git、终端和预览放进同一个工作流。

本页不复制每个按钮和截图，而是按能力边界解释什么时候使用 App。

App 工作台模型

flowchart TB
    App["Codex App"]
    Projects["Projects<br/>项目入口"]
    Threads["Threads<br/>任务会话"]
    Modes["Modes<br/>Local / Worktree / Cloud"]
    Review["Review<br/>diff / comments / Git"]
    Tools["Tools<br/>terminal / browser / artifacts"]
    Automation["Automations<br/>重复任务"]

    App --> Projects
    Projects --> Threads
    Threads --> Modes
    Threads --> Review
    Threads --> Tools
    Projects --> Automation

把 App 当成任务管理器，而不是单个聊天窗口，会更容易理解它的价值。

Projects：给每个工作边界建入口

Project 是 App 中的工作边界。一个 project 通常对应一个 repo、一个 package 或一个你希望 Codex 操作的目录。

建议：

• 大仓库中不同应用可以拆成不同 projects。
• 只把当前任务需要的目录纳入 project。
• 不要为了方便把无关目录都放进同一个边界。
• 每个 project 都应有清楚的启动、测试、构建命令。

Project 边界越清楚，sandbox、上下文和验证越容易控制。

Threads：每个任务一条线

Thread 是一次任务的上下文容器。它保存计划、对话、工具调用、diff 和反馈。

适合一条 thread 的任务：

• 修一个 bug。
• 做一个小功能。
• 审查一组改动。
• 维护一篇或一组文档。
• 跟踪一个长期但边界明确的问题。

不要把所有任务都塞进同一条 thread。上下文越杂，判断越容易漂移。

Modes：Local、Worktree、Cloud

App 中的任务通常会在不同 mode 下运行：

• Local：直接在当前 project directory 中工作。
• Worktree：为任务创建 Git worktree，隔离修改。
• Cloud：在配置好的 cloud environment 中远程执行。

选择方式：

• 当前工作树就是目标，且没有并发冲突，用 Local。
• 想尝试方案、并行任务或避免污染当前目录，用 Worktree。
• 任务较长、希望远程异步处理，用 Cloud。

多人或多 agent 同时工作时，优先考虑 worktree 或更窄的文件边界。

Built-in Git 和 diff review

App 的 diff pane 适合在任务中途审查 Codex 的改动。

你可以做的事：

• 查看文件级和 chunk 级 diff。
• 给具体位置写反馈。
• stage 或 revert 局部改动。
• 提交、推送或创建 PR。
• 把 review feedback 继续交给 Codex 处理。

原则：

• 复杂 Git 操作仍建议谨慎，必要时回到终端确认。
• 不要让 Codex 自动处理不可逆 Git 操作。
• 多人并发时先确认当前 worktree 和 branch。

Integrated terminal

每个 thread 可以打开作用域限定的 terminal，用来运行测试、构建、脚本和 Git 检查。

适合：

• 跑 git status。
• 跑项目测试或类型检查。
• 观察开发服务器输出。
• 复现错误。
• 让 Codex 读取终端输出后继续修正。

如果某个命令经常运行，可以把它做成本地环境 action，让 App 提供快捷入口。

Skills 和 Automations

App 支持 skills，也支持 automations。

使用方式：

• Skill 定义“怎么做”。
• Automation 定义“什么时候做”。
• Thread automation 适合需要保留同一条上下文的长期任务。
• Project automation 适合每次从固定项目新启动的重复任务。

适合自动化：

• 定期扫描错误。
• 总结最近 commits。
• 起草 release notes。
• 检查某类文档格式。

不适合自动化：

• 需要大量人工判断的功能开发。
• 高权限生产操作。
• 缺少验证标准的开放任务。

Browser、computer use 和 artifacts

App 也可以处理预览和非代码产物。

In-app browser 适合：

• 预览本地开发服务器。
• 标注页面上的具体问题。
• 检查不需要登录的公开页面。
• 对文件预览做反馈。

Computer use 适合：

• 需要 GUI 操作才能复现的问题。
• 桌面应用、模拟器或浏览器流程检查。
• 插件和 API 覆盖不到的交互。

Artifacts 适合：

• 预览 PDF、表格、文档、演示稿等非代码产物。
• 检查输出结构和可读性。

这些能力都会扩大 Codex 的操作面。用之前要明确任务范围和审批边界。

App 使用建议

适合优先用 App 的情况：

• 同时推进多个 Codex 任务。
• 需要 worktree 隔离。
• 希望集中审查 diff。
• 想把重复任务做成 automation。
• 需要把 thread、terminal、browser、artifact 放在同一个界面里。

不一定需要 App 的情况：

• 只是在终端跑一次任务。
• 正在编辑器里做局部代码修改。
• 非工程用户只想发一个 cloud task。

App 的核心价值是把 Codex 从“一次对话”升级成“可管理的任务工作台”。