大多数使用 Claude Code 的人,都忽略了那個 AI 在開始任何任務前一定會讀取的唯一檔案。
那個檔案叫做「CLAUDE.md」。
Anthropic 的官方文件清楚說明:如果在資料夾中存在 CLAUDE.md 檔案,Claude Code 一定會在開始工作前載入它——即使你沒有要求它這麼做。
換句話說,你在這裡寫下的內容,會 100% 改變 AI 的初始行為。當你每次都需要重新輸入提示詞時,CLAUDE.md 一旦寫好,就能跨越多個對話持續發揮作用。
影響力完全不在同一個層級。
相反地,除非你組織好這個檔案,否則無論你把提示詞打磨得多麼完美,效果幾乎都會是零。AI 每次都會偏離主題。你每次都必須重新解釋前提。即使是同樣的任務,輸出品質也會每天不同。原因不在於模型或你的提示技巧——問題就出在這個檔案。
今天,我將完整揭露在 CLAUDE.md 中「該寫些什麼以及如何寫」,包括可以直接複製貼上的範例。
對於表現不佳的人來說,CLAUDE.md 就只是「備忘錄」
老實說,我一開始也很掙扎。
有一段時間,X 平台上有很多文章說「資料夾內容很重要」或「CLAUDE.md 很重要」。我看了之後也打開了我的資料夾。
內容亂成一團。
我不知道什麼東西放在哪裡。類似的資料散落在各處。AI 找不到它需要的知識,每次產出的結果都不是我想要的答案。
CLAUDE.md 也是一樣。關於什麼東西該存到哪裡的規則沒有定案。我甚至一開始就不了解 CLAUDE.md 是什麼。所以,我只是不斷地想到什麼指令就往最上面加。
結果,它膨脹到了三、四百行。輕鬆超過了 200 行。
建議將 CLAUDE.md 控制在最多 200 行以內。
一個太長的 CLAUDE.md 會變成「AI 不知道哪些重要的長篇文字」。
在這種狀態下,AI 每次都會重新讀取整個檔案,並試圖猜測:「那麼,這個任務適用哪一部分?」一旦涉及猜測,不一致性就會隨之而來。這是很自然的。
CLAUDE.md 不是「記事本」。它是 AI 每次都會參考的「判斷地圖」。改變你對這個的看法,就成功了一半。
只在 CLAUDE.md 中寫這 5 件事
你不需要把事情搞得太複雜。一個強大的指揮中心必定包含這五個要素:
- ① 優先規則:在任何輸出之前必須遵守的首要宣告
- ② 關鍵字 → 位置路由表:哪項工作該去哪裡
- ③ 位置的決策樹:如何判斷表格中沒有的項目
- ④ 任務處理:如何記錄以及在哪裡記錄需要完成的事
- ⑤ 機密資訊處理:劃定哪些絕對不能分享的界線
當這五項就定位時,AI 就會停止「猜測」,開始「參考」。不一致性的根源就此消失。
現在,讓我們透過實際範例來看看每一項該如何撰寫。
設定 ① 在最上方宣告「優先規則」
首先要寫的是一個固定 AI 初始動作的宣告。這是一個警告:「在你思考之前,請先遵循以下規則。」
▼ 撰寫範例
優先順序:在輸出或儲存任何內容之前,務必先檢查以下規則再行動。 位置必須使用下方的「關鍵字表」和「決策樹」來決定。 如果無法決定,不要自行處理,請提出詢問。
只要把這段放在最上方,AI 就會停止「盲目行動」。它會在每次行動前檢查規則。這就固定了起點。
設定 ② 加入「關鍵字 → 位置」對照表
下一個最有效的是工作分配表。使用關鍵字將「如果收到這個要求,就放在這裡/來這裡查詢」連結起來。
▼ 撰寫範例
關鍵字 → 位置 ・部落格/文章 → Publishing/Blog/ ・費用/收據 → Accounting/Vouchers/ ・會議記錄/會議備忘錄 → Records/Minutes/
祕訣在於,要用你平常使用的詞彙來寫。AI 會查看表格中的詞彙,並能毫不猶豫地選擇位置。
分配軸的提示是,按「功能(任務)」而非「業務」來切分。這樣一來,即使業務或產品增加,表格也不會失效。
設定 ③ 加入「決策樹」以備迷路時使用 ← 這是最有效的
在這五項中,這個的影響最大。用來處理不在表格中的事情或模糊不清的情況。
無論是人還是 AI,在迷失的時候都會停下來。他們會因為迷失而偏離方向。所以,只要消除猶豫的空間即可。讓他們從上方開始遵循 YES/NO 路徑。
▼ 撰寫範例
儲存前,請依序遵循以下步驟: Q1. 這是機密資訊(API 金鑰/密碼)嗎? → 是:放到 .env。結束。 Q2. 這是剛從外部下載的原始資料嗎? → 是:放到 Assets/。 Q3. 這是哪項工作? → 放入其中之一:Publishing / Sales / Accounting / Records。 → 如果在最後仍無法確定單一位置,不要繼續進行,請提出恰好 2 個問題。
那麼,加入決策樹前後,行為會有什麼改變?具體來說,有兩點。
改變 1:對於相同的要求,每次都會執行相同的動作。
Claude Code 是基於機率運作的。當聊天對話改變時,它不會記住先前的對話。因此,沒有決策樹的話,即使是相同的「儲存會議記錄」要求,也會有波動。
沒有決策樹的情況:
- 第 1 次 → 儲存到 Meeting/
- 第 2 次 → Memo/Minutes/
- 第 3 次 → 不知為何跑到 Assets 資料夾
有決策樹的情況:
- 每次都會遵循相同的路徑:Q1→Q2→Q3 → 每次都是同一個地方
行為從「機率波動」轉變為「固定程序」。可重現性意味著你可以在其基礎上進行建構。
改變 2:它會停止在迷路時過於自信地犯錯。
AI 最可怕的行為就是「自信滿滿地給出錯誤答案」。像是把影片錄影檔和從中產生的會議記錄丟進同一個地方。
- 透過猜測強行處理 → ❌
- 停下來用 2 個問題確認 → ✓
最後一行微妙地有效。只要寫下「如果你無法決定,不要急,提出詢問」,就能在結構上減少產出偏離目標成果的情況。
AI 越聰明,當給予「範本」而非完全自由時,它的表現就越好。
設定 ④ 和 ⑤ 任務處理與機密性
剩下兩項可以寫得簡短。但你必須寫下來。
④ 確定「在哪裡以及如何留下」任務。沒有這個,待辦事項會隨著每次對話而分散。
▼ 撰寫範例
任務處理 ・將所有待辦事項集中到一個「tasks.md」檔案中。 ・完成時,不要刪除,將其移動到「已完成」並留下一行結果。
⑤ 清楚地寫出機密資訊的界線。這是預防意外的生命線。
▼ 撰寫範例
機密資訊 ・僅在 .env 中寫入 API 金鑰/密碼。 ・切勿將它們貼到聊天、程式碼或記錄中。
有了這兩項,任務就不會分散,不該外流的東西也會留在原地。它們就像你的兩道防禦盾牌。
保持 CLAUDE.md「在 200 行以內」。如果超出,請搬到另一個檔案。
你們有些人可能已經意識到,如果你把所有東西都寫在 CLAUDE.md 裡,它會越來越長。
沒錯。這點很重要。如果你讓 CLAUDE.md 變得太長,它實際上會變得更沒有效果。因為 AI 每次都會從頭到尾讀取這個檔案,如果太長,「什麼是重要的」這個感覺就會被稀釋。
指導原則是保持在 200 行以內。
如果放不下,請將詳細規則移到一個單獨的檔案(例如「rules_detail.md」)。然後,在 CLAUDE.md 的最上方,給出「何時讀取它」的指示。
▼ 撰寫範例(只要在最上方的宣告中加一行)
優先順序:在輸出/儲存前,務必遵循以下規則。 僅在撰寫部落格文章時,才讀取「rules_detail.md」。
這裡的訣竅是加入像「只有在...時」這樣的條件,而不是「總是讀取」。這樣一來,對於不相關的任務,AI 就不會開啟那個檔案,但對於必要的任務,它會遵循「CLAUDE.md → rules_detail.md」的路徑。
這保持了主體的精簡,同時允許你隨意添加任意數量的詳細規則。關鍵在於讓它成為一個按需呼叫的系統。
CLAUDE.md 是「入口和指揮官」,而細節是「按需呼叫的獨立檔案」。如果你記住這個角色劃分,無論規則增加多少,你的規則體系都不會崩潰。
老實說,它不會在短時間內脫胎換骨
我在這裡要坦白說。
我將一個 300-400 行的混亂內容重組為 5 個區塊。在那之後,我的第一個感覺並非「戲劇性的改變」。
首先,它只是不再迷失方向了。僅此而已。
世界不會在一瞬間改變。它是逐漸發揮作用的。它對相同的要求回傳相同的動作,偏離目標的結果減少了,知識也累積起來了。不知不覺中,它的運作方式就像換了一個東西一樣。這就是它的運作方式。
如果你期待華麗的魔法,你會失望的。但可重現性肯定會建立起來。
總結:給那些覺得做所有事情都很麻煩的人
別想得太複雜。你今天需要做的就是打開你的 CLAUDE.md(如果沒有的話就建立一個)。就這樣。
對於那些覺得做所有事情都很麻煩的人,這裡是附有時間估算的優先級列表:
- 前 5 分鐘:為 ③ 決策樹寫下 3 個問題(影響最大)
- 再加 7 分鐘:加入 ① 優先規則和 ② 路由表
- 再加 3 分鐘:加入 ④ 任務和 ⑤ 機密性界線
總計 15 分鐘。這會讓它們按照 ①→②→③→④→⑤ 的順序到位。如果看起來會超過 200 行,就把細節搬到一個單獨的檔案,並讓它從最上方被讀取。就這樣。
你不需要塞得太滿。只需要整理一下。僅此一項,你昨天還在使用的同一個 Claude Code 就會開始像其他的東西一樣運作。
想要改進 Claude Code 表現的人,總是在尋找提示技巧。但真正的槓桿作用點是在更上游的地方。就是那個 AI 每次都會第一個讀取的檔案。
頂尖的 5% 和其餘的 95% 之間的差異,不是天賦或提示技巧。差別只在於他們是否整理了一個 CLAUDE.md 檔案,還是放任它不管。
從複製貼上這篇文章中的 3 個決策樹問題開始。
最後
最後,讓我坦白一件事。
我通常發布的投影片全部都是由 AI 製作的。我已經沒有一張投影片是親手做的了。

而今天,我要送出一個能夠以完全相同品質製作它們的 AI。
如果你已經讀到這裡,你可能已經發現了。我在這篇文章中談論的一切,都歸結為一件事:
「不要讓 AI 迷失方向。」
AI 失敗不是因為能力不足。它失敗是因為它迷失了方向。
給它背景脈絡。設計好指令。不要留任何讓 AI 困惑的空間。換句話說,像訓練秘書一樣訓練它。在這篇文章中,我們透過 Claude Code 做到了這一點。
我即將要發布的是一個 ChatGPT GPTs。為了確保沒有誤會:主要文章是關於 Claude Code 的,而這是一個 ChatGPT GPTs。工具不同。
但根源是相同的。需要的不是技術。只是一個不讓 AI 迷失方向的設計。
這個 GPTs 是在「投影片製作」這個單一領域中,將該理念推向極致的成品。我已經完成了設計背景脈絡的所有工作。
我保證。你所需要做的就是輸入主題。之後,經過徹底設計的 GPTs 會毫不猶豫地產出投影片。
首次介紹這個 GPTs 的文章記錄了 40 萬次曝光。這就是有多少人反應說「這個不一樣」。
https://x.com/masaki_aihack/status/2068646555524223366
而且,在限定時間內,我要送出一個包含這個 GPTs 在內的「20 個獎勵」組合包。
接收方式很簡單。從下方加入 LINE 開放聊天室即可。
我坦白說:這個 GPTs 並非一蹴可幾。我失敗了超過 50 次。花了一個星期的時間,才終於讓它達到「任何人都能使用」的地步。我要把那份使用手冊原封不動地送給你。
讓我再說一次。需要的不是技術。只是不讓 AI 迷失方向的巧思。
何不今天就結束製作投影片的疲憊感呢?





