03 - Project 與 Thread 工作方式

← 02-安裝與第一次啟動 | 00-Index | 下一篇 → 04-權限與安全設定

先搞懂兩個核心名詞

Thread

Thread 可以把它理解成 Codex 裡的一段工作對話。官方說法是：thread 很像 ChatGPT 裡的一個 chat，你在裡面來回跟 Codex 協作、修正方向、補充要求。

Project

Project 是工作容器。它會連到你電腦上的一個資料夾。當你在 local mode 工作時，Codex 只會修改那個 folder 裡的檔案。

這件事非常重要，因為它同時是：

組織工作的方式
安全邊界的一部分

依 OpenAI Academy 的 Working with Codex：

左側 sidebar 讓你切換 threads、projects、tools
你可以建立 standalone thread
也可以把 thread 放進某個 project 裡
Search 可以找回過去的 tasks 與 projects

實際使用上，可以把它想成：

Project = 資料夾級別的工作空間
Thread = 針對某個任務的對話與執行紀錄

為什麼要優先用 Project

官方建議多數時候在 project 裡工作，原因很實際：

範圍清楚
檔案集中
比較容易 review
對權限管理更安全

如果你只是要做一次性的小聊天或腦力激盪，standalone thread 也可以。但只要任務牽涉檔案、文件、程式碼、輸出物，project 幾乎都比較適合。

在 Thread 裡怎麼互動最有效

OpenAI 的說法很友善：你不需要完美 prompt，也不必一開始就給很技術化的指令。

比較好的做法是直接講清楚三件事：

你要它做什麼
要用哪些檔案或範圍
done 長什麼樣

例如：

幫我閱讀這個資料夾中的 Markdown，整理成一份 1 頁摘要。
請不要改原始檔，只新增一個 summary.md。
完成後列出你引用了哪些檔案。

Steer：中途修正方向

如果你任務下到一半才想到要補充條件，不需要整個重來。官方教學提到可以用 Steer 在執行途中修正方向。

適合用 Steer 的情況：

忘了補充限制
想改輸出格式
發現它誤會你的意思
想加一個新條件，但不必整個重開任務

同時跑多個任務

官方也提到，多數使用者會同時跑多個 task。這代表你可以：

一個 thread 整理資料
一個 thread 寫文件
另一個 thread 修 bug

這也是 Codex 跟單純聊天工具差很多的地方：它更接近工作佈局，而不只是單一對話。

用 AGENTS.md 把專案規範交給 Codex

在 local / cloud 工作時，最划算的一招是在 repo 根目錄放一個 AGENTS.md。它的角色很像「給 agent 看的 README」：你把專案的固定規則、慣例、雷區寫進去，Codex 開始任務前會讀，等於每個 thread 都自帶一份 context，不必每次在 prompt 重講。

適合寫進 AGENTS.md 的東西：

專案是什麼、目錄結構、重要檔案在哪
「改 X 一定要同步改 Y」這種隱性規則（最容易踩雷、最值得寫）
程式風格、commit message 格式、測試怎麼跑
不可碰的目錄 / 檔案（例如部署設定、framework 內部檔）
驗證方式（哪個指令算「綠燈」）

實務心得：

AGENTS.md 可以分層。repo 根目錄一份全域的，子目錄也能放各自的；越靠近檔案的規則優先。
它不是寫越多越好。寫「Codex 不知道、且做錯會痛」的事；通用常識不用寫。
規範一旦改了，記得回頭更新 AGENTS.md，否則 agent 會照舊規則做，變成沉默的錯誤來源。

醫學筆記庫實例：本 vault 根目錄就有 CLAUDE.md（同類角色），明文寫死「絕不捏造 PMID」「寫檔後必更新 _wiki_meta/」「圖片用 ![[檔名]] 不要用相對路徑」這類規則。這些都是 agent 不會自己知道、但做錯會造成破圖或知識圖譜斷裂的雷區——正是該寫進專案規範檔的內容。

Local 與 Cloud task 的差異（先建立觀念）

同樣是「下一個任務」，跑在 local 還是 cloud，行為差很多：

面向	Local（你的電腦）	Cloud task（隔離環境）
檔案範圍	你選的資料夾 / repo	clone 一份到隔離容器
執行時間	開著就跑，電腦睡眠可能中斷	背景跑長任務不怕關視窗
網路	依本機環境	agent phase 預設擋外網（見 04-權限與安全設定）
適合	即時來回、要看本機結果	長任務、平行多 agent、可離線等結果

簡單原則：要盯著看、要即時改 → local；要放長線、要平行、可以晚點收 → cloud。權限細節留到 04-權限與安全設定講。

重點整理

Thread 是任務對話；Project 是資料夾級工作空間。
Local mode 下，Project 也決定 Codex 可修改的本地範圍。
你不需要完美 prompt，但要說清楚目標、範圍、done。
用 Steer 可以在中途修正方向。
多個 thread 並行，是 Codex 很值得用的地方。

參考資料