Codex App Features：桌面端功能地图

适用场景

这篇手册是 Codex App 的功能地图。它不替代每个细分教程，而是帮助你知道“这个功能解决什么问题、该看哪篇下一步”。

如果你已经能打开 Codex App，但不知道左侧项目、thread、worktree、skills、automation、browser 和 review 分别怎么用，可以从这里开始。

功能总览

| 功能 | 解决什么问题 | 下一步手册 | | --- | --- | --- | | 多项目 | 在一个 App 里管理多个代码库 | codex-app-first-thread | | 多线程 | 把不同任务拆开并行推进 | codex-workflows | | Worktrees | 隔离并行改动，降低冲突 | codex-app-worktrees | | Skills | 复用固定工作流 | codex-app-skills | | Automations | 定时或周期性运行任务 | codex-app-automations | | Git 面板 | 审查和提交 Codex 改动 | codex-app-git-commit | | Review | 检查 diff 和评论 | codex-app-review-diff | | In-app browser | 预览网页并留视觉反馈 | codex-app-in-app-browser | | Computer Use | 操作桌面应用 | codex-app-computer-use | | Appshots | 把 Mac 前台窗口作为上下文 | codex-appshots-guide |

多项目和多线程

Codex App 可以在一个窗口里管理多个 project。每个 project 对应一个工作目录，类似 CLI 在某个目录启动一次 session。

建议：

• 一个大型 monorepo 拆成多个 project。
• 一个任务开一个 thread。
• 长任务用明确标题，避免后续找不到上下文。
• 和当前目标无关的实验另开 thread。

如果你需要让 Codex 管理 thread，例如继续某个旧任务、归档、固定或查找相关 thread，可以直接在 App 里描述目标。

Worktrees

Worktree 适合并行任务，例如一个 thread 修 bug，另一个 thread 补测试，第三个 thread 尝试重构。

使用原则：

• 任务可能改同一批文件时，少开并行 worktree。
• 每个 worktree 都要有明确验证命令。
• 合并前一定看 diff。
• 不要把临时探索直接合并到主分支。

Skills 和 Automations

Skills 用来沉淀可复用工作流。Automations 用来定时或周期性运行任务。

组合示例：

每天早上运行发布检查 skill，总结昨天 main 分支上的失败测试和需要我处理的 PR。

如果任务需要长期保持在同一个上下文里，优先使用 thread automation。

Git、Review 和提交

Codex App 的 Git 功能适合把“生成改动”和“审查改动”放在一个闭环里：

1. Codex 修改代码。
2. 运行验证。
3. 你看 diff。
4. 让 Codex 修正。
5. 生成 commit message。
6. 提交或继续迭代。

不要让 Codex 的总结替代 diff 审查。提交前仍要看关键文件。

Browser 和 Computer Use

In-app browser 适合前端页面预览、视觉反馈和交互检查。Chrome extension 适合需要已登录 Chrome profile 的网页任务。Computer Use 适合操作本地桌面应用。

选择方式：

• 只预览本地网页：in-app browser。
• 需要登录态浏览器：Chrome extension。
• 需要操作桌面软件：Computer Use。
• 需要把当前 Mac 窗口发给 Codex：Appshots。

常见错误

不要把所有功能一次全开。先用 Local、Git、Review 建立基本闭环，再逐步加入 worktree、automation、browser 和 computer use。

不要把 App 项目目录设得过大。项目越大，sandbox 和上下文越难控制。

不要在一个 thread 里混用多个目标。App 的强项是多线程管理，要善用拆分。

小结

Codex App 的功能可以归纳为四类：任务管理、代码改动、验证审查、上下文扩展。先掌握多项目、多线程、Git 和 Review，再逐步使用 Worktrees、Skills、Automations、Browser、Computer Use 和 Appshots，会更稳。