Karpathy 的 CLAUDE.md 在 GitHub 上獲得 8.2 萬顆星並登上榜首,但大多數開發者仍未閱讀過它。

@0xDepressionn
英語2 個月前 · 2026年5月17日
2.0M
1.3K
146
29
7.3K

TL;DR

學習如何實作 Andrej Karpathy 的 CLAUDE.md 設定,為 Claude Code 提供持久的專案背景、嚴格的行為規則以及決策記憶日誌。

一個名為 CLAUDE.md 的檔案衝上 GitHub 熱門榜第一名。

82,000 顆星。7,800 個分支。

這一切始於 Andrej Karpathy。前 Tesla AI 總監。OpenAI 創始成員。他找出了 4 個會讓 Claude Code 失敗的行為,並將它們寫在一個檔案裡。

一位開發者接手了這 4 條規則,加以擴充,並發布了這個檔案。結果迅速爆紅。

原因在於:程式碼準確率從 65% 提升到了 94%。

大多數每天使用 Claude Code 的開發者從未設定過這個檔案。他們每個工作階段都得從零開始。重複解釋相同的背景資訊。清理那些不必要的範圍變更。還原沒人要求的重構。

這就是完整的檔案內容。

Dep - inline image

多數開發者忽略的設定

每次你開啟 Claude Code,它都是一片空白。

它不知道你的技術棧。你的標準。你的專案背景。你已經嘗試過什麼。你在三個工作階段前明確決定不做什麼。

所以它只能猜測。而當它猜測時,它會重構你沒要求它動的程式碼。它會建議一些會破壞你現有架構的框架。它會不經詢問就刪除檔案。它會與你已經做出的決定互相矛盾。

CLAUDE.md 是一個純文字檔案,你把它放在專案根目錄。Claude Code 會在每個工作階段開始時自動讀取它。

一次設定。零次重複解釋。三類昂貴的錯誤就此解決。

1 / 3 | 預設值:你每週花費 $375 美元在重複自己

一般開發者每天平均花 30 分鐘向 Claude 重複解釋背景資訊。

技術棧。編碼標準。專案背景。已經嘗試過的方法。這些資訊都不會在不同工作階段之間留存,除非你把它寫下來一次,然後讓 Claude 每次都讀取。

每天 30 分鐘,以每小時 $150 美元的開發者費率計算:每週 $375 美元。每位開發者。

對於一個 5 人團隊來說:每週 $1,875 美元就這麼沒了。

Dep - inline image

這 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 美元清理未經授權的變更。

Dep - inline image

這 7 條規則放在你 CLAUDE.md 檔案的行為區塊。

→ 保持在範圍內:

→ 在重大變更前先詢問:

→ 在任何破壞性操作前先確認:

→ 對生產環境的硬性停止:

→ 總是顯示變更了什麼:

→ 未經明確確認絕不行動:

→ 在寫程式碼前先思考:

每週花 1 小時還原不必要的範圍變更:$150 美元/週 每次任務後花 30 分鐘進行手動差異比對:$75 美元/週 每位開發者與行為相關的浪費總計:$225 美元/週 5 人團隊:$1,125 美元/週 CLAUDE.md 行為區塊設定時間:30 分鐘

3 / 3 | 記憶 + 技術棧:讓 Claude Code 真正可靠的設定

Claude 會忘記不同工作階段之間的所有事情。

你做出的每個決定。每種失敗的方法。六個月前你選擇 Prisma 而非 Drizzle 的原因。因為特定客戶需求而存在的限制。

它都會忘記。然後它會建議你已經排除的方案。

這個區塊賦予 Claude 目前最接近真實記憶的能力。同時鎖定你的技術棧,讓它不再提議會破壞你現有架構的工具。

Dep - inline image

→ 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 分鐘。然後隨著你注意到缺少什麼,每週再逐步加入其餘規則。

把這篇存起來,免得之後找不到。如果這對你有幫助,請分享給一個需要它的人。

存到 YouMind

使用 YouMind 深度閱讀爆款文章

保存原文、追問細節、總結觀點,並在一個 AI 工作空間裡把爆款文章沉澱成可複用筆記。

了解 YouMind
寫給創作者

把你的 Markdown 變成乾淨的 𝕏 文章

圖片上傳、表格、程式碼區塊,往 𝕏 上手動重排太痛苦。YouMind 把整篇 Markdown 一鍵轉成乾淨、可直接發佈的 𝕏 文章草稿。

試試 Markdown 轉 𝕏

更多可拆解樣本

近期爆款文章

探索更多爆款文章