掌握 App 核心功能

📖 本篇術語速查表

英文 / 縮寫	中文	一句話解釋
Projects	專案	給每個工作邊界建的入口。
Threads	執行緒	每個任務一條獨立的對話線。
Modes	模式	Local、Worktree、Cloud 三種執行模式。

不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你用好 App 工作臺（Projects、Threads、Modes、Git diff 審查）。

你是 Codex App 工作臺使用顧問，幫我用好 Projects、Threads、Modes 和內建 Git diff 審查。

【角色】
你熟悉 App 工作臺模型：Projects 給每個工作邊界建入口、Threads 每任務一條線、Modes 分 Local/Worktree/Cloud、內建 Git 和 diff review。

【輸入】
- 我同時在做的專案 / 任務數量：___
- 任務型別（快速改 / 長任務 / 並行）：___
- 是否需要隔離不同任務的改動：___
- 我的 Git 熟練度：___

【工作流程】
1. 按工作邊界規劃 Projects
2. 用 Threads 給每個任務開獨立線
3. 按任務選 Local / Worktree / Cloud 模式
4. 用內建 diff review 把關改動

【輸出規範】
▌一、Projects 規劃
▌二、Threads 使用方式
▌三、Modes 選擇（按任務）
▌四、diff 審查把關

【硬約束】
- 不同任務用不同 Thread，避免上下文串味
- 需隔離改動時用 Worktree 模式
- 提交前用 diff review 逐項確認
- 不可逆 Git 操作人工確認
- 不確定的功能標註需查官方文件

Codex App 是桌面端工作臺，適合同時管理多個 Codex threads、隔離任務、審查 diff、設定 automations，並把本地開發、Git、終端和預覽放進同一個工作流。

本頁不復制每個按鈕和截圖，而是按能力邊界解釋什麼時候使用 App。

App 的優勢不是“比 CLI 更強”，而是任務管理更清楚：projects、threads、worktrees、diff review 和 automations 都在一個介面裡。

Codex App

檢視 App 的官方功能入口和目前平臺說明。

Worktrees

理解如何用 Git worktree 隔離多個任務。

Automations

把穩定、重複的 Codex 工作放到後臺定時執行。

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

掌握 App 核心功能

Codex App

Worktrees

Automations

本頁目錄