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