Codex 三種工作模式｜雲端、本機與新工作樹的選擇指南

Chapter 01

三種模式快速定義

本機 Local

Codex 直接在目前開啟的專案資料夾工作。它可以讀寫本機檔案，使用電腦已安裝的 Node、Python、字型、資料庫與 Windows 工具，適合工程管理系統單機版、PDF／Excel／圖片測試、本機資料庫與需要 Windows 路徑的任務。缺點是指令下錯時會直接改到目前工作目錄。

新工作樹 Worktree

Worktree 是同一台電腦上的 Git 隔離副本，不是雲端。它適合大型功能、重構或尚未確定是否採用的實驗，例如估價、OCR、甘特圖與權限功能。可以保留目前 baseline，同時在獨立分支修改，完成後審查 Diff 與測試結果，再決定是否合併。

Worktree 不適合需要同時讀取目前本機未提交變更的任務，因為它使用的是另一份工作區與檔案狀態。

雲端 Cloud

Cloud 是 OpenAI 管理的遠端 Codex 執行環境。通常從 GitHub 取得 Repository，在遠端安裝依賴、設定環境變數、修改程式、跑測試，再交付 Diff 或 Pull Request。它不是 Google Drive、OneDrive、NAS、Vercel、Supabase，也不會自動擁有 D 槽檔案、本機資料庫、Windows 軟體、Ollama 模型或未設定到雲端的 .env.local。

Cloud 的前提是專案能從 GitHub 乾淨重建，並且具備 Repository 權限、安裝指令、必要 Secrets 與可驗證的測試流程。

Chapter 02

任務選擇決策表

任務情境	建議模式	原因
修改 UI、修小 Bug	本機	回饋最快，能直接驗證目前畫面
需要本機資料庫、Excel、PDF、中文字型或 Windows 路徑	本機	雲端通常讀不到這些資源
大型功能、重構且怕改壞主線	Worktree	用獨立副本隔離修改
長時間測試、純前端重構、需要 PR	Cloud	可背景執行並留下可審查差異
不想把敏感工程資料送到遠端	本機或 Worktree	保留資料在自己的電腦

判斷原則是：資料越本機、越敏感、越依賴 Windows，就越偏向本機；任務越長、越能由 GitHub 重建，就越適合 Cloud。

Chapter 03

工程管理系統單機版的建議流程

01先在本機確認系統能啟動、能讀檔，並能匯出 PDF／Excel。
02每個大型功能開一個獨立 Worktree，避免直接污染目前版本。
03Cloud 只處理能從 GitHub 重建的測試、重構、PR 或純前端功能。
04合併回本機後，再驗證單機資料、字型、檔案路徑與真實案例。

實務結論：本機是主戰場，Worktree 是保險，Cloud 是背景助理，不是本機資料夾的替代品。

Chapter 04

可直接給 Codex 的指令寫法

本機

請在目前專案中修正 PDF 匯出中文字型錯誤。不要改資料庫 schema。完成後用本機測試資料產生一份 PDF，並回報修改檔案與驗證結果。

Worktree

請建立新的 Git Worktree 重構估價模組，不要影響目前 baseline 分支。完成後列出 Diff、測試結果與建議合併方式。

Cloud

請在 Cloud 檢查這個 GitHub Repo 的前端 build 錯誤，安裝依賴、執行測試，修正後產出可審查的修改差異。不要假設能讀取本機檔案或未設定的 Secrets。

每個指令都應寫清楚「不要改什麼」、「要怎麼驗證」、「完成後要回報什麼」。

Chapter 05

最後檢查

Codex 的產品功能會持續更新，實際可用選項以 Codex App 與帳號方案畫面為準。交給任何模式前，先確認檔案位置、資料敏感度、隔離需求與驗證方式。

#Codex #雲端 #本機 #新工作樹 #工程管理 #AIWorkflow

hansun

目錄