一個名為 CLAUDE.md 的檔案衝上 GitHub 熱門榜第一名。
82,000 顆星。7,800 個分支。
這一切始於 Andrej Karpathy。前 Tesla AI 總監。OpenAI 創始成員。他找出了 4 個會讓 Claude Code 失敗的行為,並將它們寫在一個檔案裡。
一位開發者接手了這 4 條規則,加以擴充,並發布了這個檔案。結果迅速爆紅。
原因在於:程式碼準確率從 65% 提升到了 94%。
大多數每天使用 Claude Code 的開發者從未設定過這個檔案。他們每個工作階段都得從零開始。重複解釋相同的背景資訊。清理那些不必要的範圍變更。還原沒人要求的重構。
這就是完整的檔案內容。

多數開發者忽略的設定
每次你開啟 Claude Code,它都是一片空白。
它不知道你的技術棧。你的標準。你的專案背景。你已經嘗試過什麼。你在三個工作階段前明確決定不做什麼。
所以它只能猜測。而當它猜測時,它會重構你沒要求它動的程式碼。它會建議一些會破壞你現有架構的框架。它會不經詢問就刪除檔案。它會與你已經做出的決定互相矛盾。
CLAUDE.md 是一個純文字檔案,你把它放在專案根目錄。Claude Code 會在每個工作階段開始時自動讀取它。
一次設定。零次重複解釋。三類昂貴的錯誤就此解決。
1 / 3 | 預設值:你每週花費 $375 美元在重複自己
一般開發者每天平均花 30 分鐘向 Claude 重複解釋背景資訊。
技術棧。編碼標準。專案背景。已經嘗試過的方法。這些資訊都不會在不同工作階段之間留存,除非你把它寫下來一次,然後讓 Claude 每次都讀取。
每天 30 分鐘,以每小時 $150 美元的開發者費率計算:每週 $375 美元。每位開發者。
對於一個 5 人團隊來說:每週 $1,875 美元就這麼沒了。

這 7 條規則放在你的 CLAUDE.md 檔案最上方。
→ 刪除廢話:
→ 根據任務調整長度:
→ 在行動前先展示選項:
→ 在造成損失前承認不確定性:
→ 我是誰以及我知道什麼:
→ 當前專案背景:
→ 鎖定你的語氣:
每天花在重複解釋背景的時間:30 分鐘 以每小時 $150 美元的開發者費率計算:每天 $75 美元 每週:每位開發者 $375 美元 5 人團隊:每週 $1,875 美元 本節的 CLAUDE.md 設定時間:總計 45 分鐘
要避免的錯誤:不要從頭開始撰寫你的 CLAUDE.md。先使用這個提示詞,然後再編輯輸出內容:
2 / 3 | 行為:你未授權的每小時 $150 美元變更
你要求 Claude 修復一個函式。
它卻重構了三個檔案,重新命名了你的變數,重新整理了導入語句,並改寫了你精心撰寫的註解。
這一切都不經詢問。
花 1 小時審查並還原不必要的變更:$150 美元。每週三次:每週 $450 美元。每位開發者。
對於一個 5 人團隊來說:每週花費 $2,250 美元清理未經授權的變更。

這 7 條規則放在你 CLAUDE.md 檔案的行為區塊。
→ 保持在範圍內:
→ 在重大變更前先詢問:
→ 在任何破壞性操作前先確認:
→ 對生產環境的硬性停止:
→ 總是顯示變更了什麼:
→ 未經明確確認絕不行動:
→ 在寫程式碼前先思考:
每週花 1 小時還原不必要的範圍變更:$150 美元/週 每次任務後花 30 分鐘進行手動差異比對:$75 美元/週 每位開發者與行為相關的浪費總計:$225 美元/週 5 人團隊:$1,125 美元/週 CLAUDE.md 行為區塊設定時間:30 分鐘
3 / 3 | 記憶 + 技術棧:讓 Claude Code 真正可靠的設定
Claude 會忘記不同工作階段之間的所有事情。
你做出的每個決定。每種失敗的方法。六個月前你選擇 Prisma 而非 Drizzle 的原因。因為特定客戶需求而存在的限制。
它都會忘記。然後它會建議你已經排除的方案。
這個區塊賦予 Claude 目前最接近真實記憶的能力。同時鎖定你的技術棧,讓它不再提議會破壞你現有架構的工具。

→ MEMORY.md 決策記錄:
→ 工作階段結束摘要:
→ ERRORS.md 失敗記錄:
→ 永久事實列表:
→ 鎖定你的技術棧:
→ 針對困難決策的延伸思考:
→ 爆紅的 4 條規則:
Karpathy 找出了 4 個會讓 Claude Code 失敗的行為。一位開發者將它們濃縮成這 4 行程式碼。程式碼準確率從 65% 提升到了 94%。
每週花 2 小時從被遺忘的決策和錯誤建議中恢復:每位開發者 $300 美元/週 錯誤的技術棧建議和不兼容的工具:$75 美元/週 每位開發者與記憶相關的浪費總計:$375 美元/週 5 人團隊:$1,875 美元/週 MEMORY.md + ERRORS.md + 技術棧設定時間:20 分鐘
結論
以下是完整的計算。
每個工作階段重複解釋背景:$375 美元/週 還原未經授權的變更:$225 美元/週 從被遺忘的決策中恢復:$375 美元/週 每位開發者的浪費總計:$975 美元/週
5 人開發團隊:$4,875 美元/週 每年:$253,500 美元
CLAUDE.md 設定時間:總計 2 小時 僅 Karpathy 的 4 條規則:程式碼準確率從 65% 提升到 94%
一個純文字檔案。21 條規則。兩小時的工作。
設定好這個檔案的開發者,正在使用的是一個能記住決策、保持在範圍內、在破壞任何東西前先確認、絕不建議會破壞你架構的框架的 Claude 版本。
而那些還沒設定的開發者,每週正花費 $975 美元在重複自己。
p.s. 從 Karpathy 的 4 條規則開始。就那 4 條。把它們貼到一個名為 CLAUDE.md 的新檔案中,放在你的專案根目錄。這只需要 2 分鐘。然後隨著你注意到缺少什麼,每週再逐步加入其餘規則。
把這篇存起來,免得之後找不到。如果這對你有幫助,請分享給一個需要它的人。





