---
title: "掌握 App 核心功能"
description: "按 projects、threads、worktrees、automations、Git、terminal 和 browser 理解 Codex App 的桌面工作台能力。"
verifiedAt: "2026-05-06"
---

import { Cards, Card } from 'fumadocs-ui/components/card';

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

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

> [!NOTE]
> App 的优势不是“比 CLI 更强”，而是任务管理更清楚：projects、threads、worktrees、diff review 和 automations 都在一个界面里。

<Cards>
  <Card title="Codex App" href="https://developers.openai.com/codex/app">
    查看 App 的官方功能入口和当前平台说明。
  </Card>
  <Card title="Worktrees" href="https://developers.openai.com/codex/app/worktrees">
    理解如何用 Git worktree 隔离多个任务。
  </Card>
  <Card title="Automations" href="https://developers.openai.com/codex/app/automations">
    把稳定、重复的 Codex 工作放到后台定时运行。
  </Card>
</Cards>

## App 工作台模型

```mermaid
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 从“一次对话”升级成“可管理的任务工作台”。
