← 回找觀念
觀念總論|AI 協作方法

第 6 篇|專案的「自動記憶體」:CLAUDE.md 與 Agent.md 的底層邏輯

CLAUDE.md/agent.md 是專案層級的工作指引,能降低重複說明成本,但不是不可違背的安全邊界。

2026-07-14 · 作者整理:Lucas · 資安審稿後整理
資安審稿註記:本文已把「保證安全」「最強防線」等過度承諾改成保守表述;凡涉及金鑰、權限、刪除、提交、外部發送與自動化執行,均保留人工確認、沙盒或測試環境前提。

當我們與 AI 進行高強度協作時,最常讓人感到氣餒的痛點,莫過於 AI 的「健忘」與「失憶」。每一次當你在編輯器中開啟新的對話視窗(Session)時,AI 就會像一個突然得了健忘症的新進實習生一樣,對你眼前的專案一無所知。你被迫一遍又一遍地向它碎碎念:「我們這個專案是用 React 寫的喔」、「請使用繁體中文回答」、「存檔時要注意特殊的排版格式」。

這種每一次開啟新對話都要經歷的「冷開機(Cold Start)」過程,不僅極大地消耗了人類的耐心,更在無形中堆疊了高昂的溝通成本(Communication Tax)與 Token 帳單。為了解決這個嚴重的痛點,現代 AI 協作編輯器與開發環境(如 Cline、Cursor、Codex 等)引入了一項最具複利價值的技術——專案的自動記憶體。在 Cline 或 Cursor 的生態系中,這個核心檔案被命名為 CLAUDE.md;而在 Codex 系統中,它則被稱為 agent.md。這份檔案的配置與持續優化,正是你與 AI 協作時投資報酬率最高的一件事。

+-------------------------------------------------------------+
|               CLAUDE.md / agent.md 自動讀取機制              |
+-------------------------------------------------------------+
|                                                             |
|   1. 讀者點擊「開啟新對話」(New Session)                       |
|                  |                                          |
|                  v                                          |
|   2. 系統在專案根目錄自動偵測 CLAUDE.md 或 agent.md         |
|                  |                                          |
|                  v                                          |
|   3. 無條件將檔案內容直接注入 AI 的 Context Window      |
|                  |                                          |
|                  v                                          |
|   4. AI 帶著這份「專案憲法」,開始執行你的第一條指令     |
|                                                             |
+-------------------------------------------------------------+

實戰步驟一:理解自動注入機制與「最高憲法」的制約

要將 CLAUDE.md 轉化為專案的防護網,你必須先深刻理解系統底層是如何加載這份檔案的:

無條件的預載注入(Pre-loading Injection):在你的專案根目錄下,一旦建立了 CLAUDE.md(或在 Codex 中建立 agent.md),系統就會將其視為自動觸發的記憶體。每當你點擊開啟新對話、輸入第一句 Prompt 之前,底層系統已經悄悄且強制地把這份檔案的內容,完整讀取並直接注入到 AI 的上下文視窗(Context Window)中。這代表在你下達任何指令前,AI 已經被迫預先讀完了這份說明書。

不容妥協的最高憲法(Immutable Constitution):注入大腦後,AI 會在系統指令層級被賦予一項死規定:必須將 CLAUDE.md 中的所有條款,視為不可違背的最高指導原則。這意味著它不再是「供 AI 參考的閒聊背景」,而是類似於系統的物理邊界。不論你在對話中多麼隨性地下指令(Vibe Coding),AI 的每一次讀檔、改寫代碼與調用外部工具,都必須在 CLAUDE.md 劃定的鐵軌上運行,絕對不容出軌。

實戰步驟二:擺脫重複的「溝通稅」,實現零摩擦冷開機

當你建立好這份檔案後,你的日常協作流程將會發生本質上的改善:

徹底消除「冷開機」的說明成本:你不再需要在新 Session 開始時輸入一堆防呆詞。所有關於程式庫規範、工作偏好與語言設定的死規定,都會永久且安全地固化在 CLAUDE.md 的靜態記憶體中。你只需要專注在眼前的業務邏輯,一開工,AI 就已經處於最懂專案、最符合你習慣的高效狀態。

拉高 First-Pass 成功率,節省海量 Token:每一次對話的來回,都是按 Token 數收費的。有了這份自動預載的「專案地圖」,AI 做出決策與撰寫代碼的「首發成功率(First-Pass Rate)」會大幅提升,直接避免了因為資訊不對稱而導致的「AI 亂猜 -> 寫錯 -> 你貼錯誤 Log 叫它重改 -> 再次改錯」的惡性燃燒 Token 循環。這不僅是工程上的優雅,更是財務上的精打細算。

← 看更多觀念總論
取得 AI 實戰工具與更新

之後會不定期整理:新方法、指令包(Prompt Pack)、Checklist 與模板。免費、無廣告;正式寄送前會先寄確認信,隨時可來信要求刪除。