[AI 分享] 善用 CLAUDE.md 與 AGENTS.md 提升 AI 開發效率

[AI 分享] 善用 CLAUDE.md 與 AGENTS.md 提升 AI 開發效率

摘要 : 建立精簡且分層的專案指令，降低溝通與上下文成本

內容:

CLAUDE.md 與 Codex 的 AGENTS.md 功能相近，會在對話開始時自動載入 AI 的 Context Window，成為執行任務的重要指引。設定完善後，便不必在每次新對話中重複說明專案架構、開發規範與工作偏好。

這類指令檔可分為不同層級。User Level 適合放置跨專案通用的個人偏好，例如使用繁體中文、採第一性原理思考，或以金字塔原理組織輸出；Project Level 則記錄整個專案共用的規則，並可隨程式碼提交至 Git，確保團隊使用一致標準。若有不想分享的個人設定，可改放在本機專用的 CLAUDE.local.md。

專案子資料夾也能設置 Nested Level 指令。例如前端使用 React 並遵循特定 UI 規範，後端使用 Python 與另一套開發邏輯，便可各自建立指令檔。AI 會依序疊加使用者、專案與子資料夾規則；距離工作檔案越近的設定，適用範圍越精準，對當前任務的影響也越直接。

建立第一份 CLAUDE.md 最簡單的方法，是在專案資料夾開啟 Claude Code 並輸入 /init。系統會掃描專案，自動整理用途、啟動方式、建置與測試流程、框架、目錄架構及開發規範，產生一份起始模板。

不過，/init 產生的內容往往過於完整。Claude 執行任務時本來就會透過探索機制查看資料夾與設定檔，因此能自行找到的資訊不必重複寫入。否則每次對話都會占用 Token 與 Context Window，專案變動後若未同步更新，還可能讓 AI 受到過期資訊誤導。

最佳做法是只保留 AI 無法自行推斷、容易做錯，或必須嚴格遵守的規則。先區分個人習慣、團隊標準與特定資料夾需求，再放入適當層級，並持續刪除重複、失效或低價值內容，才能有效運用有限的 Instruction Budget。