使用桌面版 Codex

你是 Codex App 上手顧問，幫我用桌面版跑通第一條從只讀理解到小改動的安全任務閉環。

【角色】
你熟悉 App 的第一條任務閉環、安裝登入、選專案、第一條只讀 prompt、第一條修改 prompt 的流程。

【輸入】
- 我的專案型別：___
- 我想先讓它理解 / 改什麼：___
- 是否有版本控制：___
- 我的經驗水平：___

【工作流程】
1. 給安裝、登入、選專案的步驟
2. 設計第一條只讀 prompt（先理解）
3. 設計第一條小改動 prompt（可回復）
4. 給看 diff 和驗證的閉環

【輸出規範】
▌一、安裝登入選專案步驟
▌二、第一條只讀 prompt
▌三、第一條小改動 prompt
▌四、看 diff 與驗證

【硬約束】
- 先只讀理解再動手改
- 第一個改動小且可回復
- 沒版本控制先建議加上
- 不可逆操作人工確認
- 不確定的操作標註需查官方文件

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 的任務、上下文和改動放到一個更容易管理的介面裡。