使用桌面版 Codex

Codex App 是桌面端 Codex 工作臺，適合管理專案、threads、worktrees、diff review、automations 和本地/雲端任務。第一次使用時，不要急著並行多個 agent，先完成一個可審查的小任務閉環。

第一條任務閉環

flowchart LR
    Install["安裝 App"] --> Login["登入"]
    Login --> Project["選擇專案"]
    Project --> Read["只讀了解專案"]
    Read --> Small["限定一個小任務"]
    Small --> Verify["執行驗證"]
    Verify --> Review["審查 diff"]

這個閉環能證明三件事：

• App 能正確訪問你的專案。
• Codex 理解當前 repo 的上下文和規則。
• 你能審查並控制它的改動。

安裝和登入

從官方 Quickstart 下載當前平臺版本。

登入方式通常有兩類：

• ChatGPT 登入：適合日常互動、App、Cloud 和 workspace 許可權場景。
• API key 登入：適合某些本地或程式化場景，但功能和計費路徑可能不同。

如果你在企業 workspace 中使用 Codex，登入方式和可用功能可能由管理員控制。

選擇專案

選擇專案目錄時要保守：

• 只選擇本次要處理的 repo 或子專案。
• 大型 monorepo 可以拆成多個 App projects。
• 不要把無關目錄放進同一個工作邊界。
• 進入專案後先看當前工作樹狀態。

Project 邊界會影響上下文、sandbox、diff review 和任務管理。

第一條只讀 prompt

先讓 Codex 只讀分析：

请只读分析这个项目，不要修改文件。
输出：
- 项目用途
- 技术栈
- 主要目录职责
- 启动和测试命令
- 你确认的事实和仍然不确定的点

如果它能正確描述專案，說明上下文和專案邊界基本有效。

第一條修改 prompt

再做一個小而可驗證的任務：

请修复一个很小的问题或整理一处文档格式。

约束：
- 只改你列出的 1-2 个文件。
- 不新增依赖。
- 不做无关重构。
- 改完说明验证方式。

不要第一天就讓它重構模組、升級依賴或批次改全站。

審查 diff

App 的價值之一是 diff review。

審查時看：

• 是否只改了約定範圍。
• 是否有無關格式化。
• 是否觸碰配置、依賴、憑據或生成物。
• 是否有測試或驗證證據。
• 是否還有未驗證風險。

對具體 diff 寫反饋，比重新發一段泛泛 prompt 更有效。

Local、Worktree、Cloud 怎麼選

Local：

• 直接在當前 project directory 中工作。
• 適合簡單、本地、可快速驗證的任務。

Worktree：

• 把任務放到 Git worktree 中隔離。
• 適合並行任務、實驗性改動或避免汙染當前工作樹。

Cloud：

• 在遠端 environment 中執行。
• 適合非同步任務、GitHub workflow 或不依賴本機的長任務。

第一天建議從 Local 的只讀和小改動開始。熟悉後再用 Worktree 和 Cloud。

App 中的常用能力

常用能力包括：

• 多 project 和多 thread 管理。
• Worktree 隔離。
• Integrated terminal。
• Diff review、stage、commit、push。
• In-app browser。
• Automations。
• Skills。
• Artifacts preview。
• IDE extension sync。

每個能力都要配合任務邊界使用。尤其是 browser、computer use、automations 和 cloud tasks，不應在還沒理解許可權邊界時預設開啟。

新手不要做什麼

不要：

• 一上來同時開多個大任務。
• 讓 Codex 自動處理不可逆 Git 操作。
• 把 App 當作生產後臺操作工具。
• 忽略當前已有未提交改動。
• 不看 diff 就提交或推送。
• 把 API key、token、賬號資訊貼進任務。

Codex App 的正確起點是一個小任務閉環，而不是大規模自動化。

下一步

完成第一天閉環後，繼續學習：

• Worktrees：隔離並行任務。
• App core：掌握工作臺能力。
• Automations：把穩定重複任務放到後臺。
• Security：理解 sandbox、approval 和 cloud environment。

App 不是替代工程審查的工具，而是把 Codex 的任務、上下文和改動放到一個更容易管理的介面裡。