---
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 從“一次對話”升級成“可管理的任務工作臺”。
