結論先說
- 它不是 Karpathy 本人寫的文件。 倉庫 README 寫的是:一份 CLAUDE.md,用來改善 Claude Code 的行為,「derived from」Andrej Karpathy 對大模型寫代碼毛病的觀察(出自他在 X 上的一條帖子)。作者是 GitHub 用戶 forrestchang。
- 內容很短,只有四條原則:先想後寫、簡單優先、外科手術式修改、目標驅動。
- 用法有三種:存成項目根目錄的
CLAUDE.md;追加到已有的 CLAUDE.md;或者按 README 的/plugin命令裝成插件。 - 它偏向謹慎而不是速度。文件開頭自己寫明:這些準則傾向於「謹慎優先於速度」,瑣碎任務請自行判斷。
- 用之前先讀一遍:它會成為你每個會話的指令。官方也提醒,CLAUDE.md 是上下文而不是強制配置,是否被遵守沒有保證。

圖:本站根據 forrestchang/andrej-karpathy-skills 倉庫 整理的示意圖
本文根據 GitHub 倉庫 forrestchang/andrej-karpathy-skills 的 README 和 CLAUDE.md、Claude Code 官方文檔《How Claude remembers your project》整理,資料核對於 2026-11-13。配圖為本站整理的示意圖,不是介面截圖。該倉庫是社區項目,不是 Anthropic 或 Karpathy 的官方發佈;本站(bigolab.com)也不是 Anthropic 官方網站。
適用於誰
- 搜「karpathy claude.md 如何使用」,想知道這是什麼、怎麼用的人;
- 用 Claude Code 寫代碼,覺得它愛過度設計、愛順手亂改的人;
- 想找一份簡短的通用指令來補充自己 CLAUDE.md 的人。
一、它從哪來
README 開頭說明:這是一份單獨的 CLAUDE.md,靈感來自 Andrej Karpathy 對 LLM 寫代碼時常見問題的觀察,並引用了他的原帖作為出處。README 摘錄的原話大意是三類毛病:
- 模型替你做了錯誤的假設,也不檢查就一路執行,不管理自己的困惑、不求證、不指出不一致、不擺出權衡、該反駁時不反駁;
- 愛把代碼和接口搞複雜,抽象膨脹,不清理死代碼,100 行能解決的寫成 1000 行;
- 有時會把自己沒完全理解的註釋和代碼當作副作用改掉或刪掉,哪怕和任務無關。
倉庫的做法,是把這些觀察翻成四條寫給 Claude 的指令。注意:這是社區作者的二次整理,不是 Karpathy 的項目,也不是 Anthropic 的官方內容。
二、四條原則講什麼
下面是對原文的中文概括,具體措辭請看倉庫裏的英文原文。
1. 先想後寫(Think Before Coding)。 不要假設,不要藏起困惑,把權衡擺出來。動手前要說明自己的假設,不確定就問;如果有多種理解,列出來,不要悄悄選一種;有更簡單的做法就說出來,該反駁時反駁;不清楚就停下,指出哪裏不清楚並詢問。
2. 簡單優先(Simplicity First)。 用最少的代碼解決問題,不做沒被要求的推測:不加沒要求的功能,不為只用一次的代碼做抽象,不加沒被要求的「靈活性」和「可配置性」,不為不可能的場景寫錯誤處理;寫了 200 行本可以 50 行,就重寫。自問:資深工程師會不會覺得這太複雜?
3. 外科手術式修改(Surgical Changes)。 只動必須動的,只清理自己造成的混亂。不「順手改進」相鄰的代碼、註釋、格式,不重構沒壞的東西,沿用現有風格,哪怕你會用別的寫法;發現無關的死代碼,指出來而不是刪;自己的改動造成的孤兒(沒用了的導入、變量、函數)要清理。檢驗標準是:每一行改動都能直接追溯到用戶的要求。
4. 目標驅動執行(Goal-Driven Execution)。 先定義成功標準,再循環到驗證通過。把任務變成可驗證的目標:「加校驗」變成「為非法輸入寫測試,再讓它們通過」;「修 bug」變成「先寫一個能復現的測試,再讓它通過」;「重構」變成「確保前後測試都通過」。多步任務先說一個簡短計劃,每步帶驗證方法。強的成功標準能讓 Claude 自己循環,弱的(「讓它能跑」)則需要不停澄清。
文件末尾還寫了「怎麼算起作用」:diff 裏不必要的改動變少,因過度複雜而重寫的次數變少,澄清問題出現在動手之前而不是犯錯之後。
三、三種用法

圖:本站根據該倉庫 README 和 Claude Code 官方文檔 整理的示意圖
用法一:放進單個項目。 README 的做法是把文件下載為項目根目錄的 CLAUDE.md;已有 CLAUDE.md 的項目,則把它追加到末尾。你也可以直接打開倉庫頁面,複製內容到自己的文件裏。項目級 CLAUDE.md 的位置和寫法,官方說明見 /guides/claude-md-agents-md。
用法二:做成全局偏好。 這四條原則不是某個項目特有的,放進 ~/.claude/CLAUDE.md 就對你所有項目生效,具體見 /guides/claude-code-global-claude-md-user-level。這是本文的推斷用法,README 沒有這樣寫,但官方對用戶級文件的定位正好適合通用的個人偏好。
用法三:裝成插件。 README 推薦的方式是先在 Claude Code 裏添加插件市場,再安裝插件,命令以倉庫 README 為準。這樣技能會在你所有項目裏可用。插件的裝法和風險,可以參考 /guides/claude-code-install-superpowers-plugin。
不管哪種方式,裝完後用 /memory 確認文件被載入,並新開一個會話再試。
四、使用前後的注意事項
先讀,再用。 它會作為指令進入你每個會話的上下文。照搬別人的文件之前,要確認每一條你都認同。比如「發現無關的死代碼只指出、不刪除」適合保守的團隊,不一定適合你正在做的大重構。
別和自己的文件衝突。 官方說,兩條互相矛盾的指令,Claude 可能隨便選一個。如果你的項目 CLAUDE.md 裏寫了「順手把周邊代碼也規範化」,就和第三條衝突,要改掉一邊。
控制篇幅。 官方建議每個 CLAUDE.md 盡量不超過 200 行。這份文件本身很短,但你把它和自己的規則合併時要注意總長度。
第三方內容要自己把關。 倉庫和插件都是第三方的,作者以後可能改動內容。裝插件前看一眼代碼和權限,通用的安全習慣見 /guides/ai-coding-security-secrets-permissions。
它有代價。 文件開頭自己寫明偏向謹慎而不是速度:更多的澄清提問,更多的驗證步驟。對於改個錯別字這樣的小任務,這些步驟可能顯得多餘。
五、怎麼判斷有沒有用
倉庫給的標準可以直接拿來用:
- 同一類任務,用前後各跑一次;
- 看 diff 裏有沒有不屬於你要求的改動;
- 看 Claude 是先問再做,還是做錯了再改;
- 看有沒有因為過度設計而重寫。
沒有官方數據說明這類文件一定更有效,所以以你自己的項目為準。覺得沒用就刪,不會有任何副作用。
六、需要多跑幾輪時的額度
這份準則會讓 Claude 更多地先提問、先寫測試再改代碼,一個任務的輪數可能增加。如果你用訂閱登入 Claude Code,擔心額度不夠,可以看 /chongzhi/claude-code,規則以官方頁面為準。
常見問題
Q:這是 Karpathy 官方發佈的嗎?
不是。倉庫作者是 forrestchang,README 說明內容是根據 Karpathy 的觀察整理的。
Q:要不要每個項目都放一份?
可以放全局,也可以只放需要的項目。官方的用戶級文件對所有項目生效。
Q:它適用於 Codex 或 Cursor 嗎?
README 提到倉庫裏有給 Cursor 的規則文件。Codex 有自己的 AGENTS.md,思路相近,本文不展開。
相關教學
- /guides/claude-md-chinese-or-english:CLAUDE.md 用中文還是英文
- /guides/claude-code-takeover-old-project-claude-md:接手老項目
參考資料
- GitHub:forrestchang/andrej-karpathy-skills — https://github.com/forrestchang/andrej-karpathy-skills
- Andrej Karpathy 的原帖(倉庫引用)— https://x.com/karpathy/status/2015883857489522876
- Claude Code 官方文檔:How Claude remembers your project — https://code.claude.com/docs/en/memory
0 條評論
還沒有評論,來搶沙發~