Karpathy 的 CLAUDE.md 怎麼使用:這份社區文件是什麼、四條原則、三種裝法和注意事項

網上流傳的「Karpathy CLAUDE.md」其實是社區作者 forrestchang 根據 Andrej Karpathy 對大模型寫代碼毛病的公開觀察整理的一份四條原則文件,並非 Karpathy 本人發佈。本文按原倉庫說明它是什麼、四條原則講什麼、怎麼放進項目或全局、裝插件的注意事項,以及怎麼判斷有沒有用。

NNathaniel bigo··原創首發·AI 輔助撰寫
10 分鐘讀完
資料核對於 2026-11-13 · 依據官方文檔與公開資料整理 免費帳號 帳號

結論先說

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

這份 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。

它有代價。 文件開頭自己寫明偏向謹慎而不是速度:更多的澄清提問,更多的驗證步驟。對於改個錯別字這樣的小任務,這些步驟可能顯得多餘。

五、怎麼判斷有沒有用

倉庫給的標準可以直接拿來用:

  1. 同一類任務,用前後各跑一次;
  2. 看 diff 裏有沒有不屬於你要求的改動;
  3. 看 Claude 是先問再做,還是做錯了再改;
  4. 看有沒有因為過度設計而重寫。

沒有官方數據說明這類文件一定更有效,所以以你自己的項目為準。覺得沒用就刪,不會有任何副作用。

六、需要多跑幾輪時的額度

這份準則會讓 Claude 更多地先提問、先寫測試再改代碼,一個任務的輪數可能增加。如果你用訂閱登入 Claude Code,擔心額度不夠,可以看 /chongzhi/claude-code,規則以官方頁面為準。

常見問題

Q:這是 Karpathy 官方發佈的嗎?

不是。倉庫作者是 forrestchang,README 說明內容是根據 Karpathy 的觀察整理的。

Q:要不要每個項目都放一份?

可以放全局,也可以只放需要的項目。官方的用戶級文件對所有項目生效。

Q:它適用於 Codex 或 Cursor 嗎?

README 提到倉庫裏有給 Cursor 的規則文件。Codex 有自己的 AGENTS.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

Nathaniel 的更多內容

  1. 01

    LangGraph 流式輸出(Streaming)詳解:逐字 Token 流、節點進度與自定義事件寫法

    多步智能體如果等全部節點跑完才返回,網頁前端就會白屏乾等十幾秒。本文按 LangGraph 官方文檔講清 updates、messages、custom 與 values 四種 stream_mode 的區別,以及組合訂閱逐字打字機輸出加工具內部實時進度的完整代碼。

    其他 AI 工具0
  2. 02

    LangGraph 持久化與長期記憶怎麼配:Checkpointer、Store 與 PostgreSQL 實戰

    在生產環境跑 LangGraph,單靠 InMemorySaver 一重啟就會丟失全部對話。本文按官方文檔講清線程內短期檢查點(Checkpointer)與跨線程長期記憶(Store)的分工,以及用 langgraph-checkpoint-postgres 對接 PostgreSQL 的完整步驟。

    其他 AI 工具0
  3. 03

    LangGraph 多智能體怎麼寫:Supervisor 主管包與 Subgraph 隔離子圖實戰

    在 LangGraph 裏把單個圖擴展成多智能體協作有兩條官方路線:快速原型用預置包 langgraph-supervisor,大型生產系統用原生子圖(Subgraph)嵌套。本文講清兩種寫法的完整代碼、私有狀態隔離防 Token 膨脹技巧以及檢查點傳播規則。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入審批怎麼寫:interrupt 暫停圖運行與 Command 恢復實戰

    企業之所以選 LangGraph,很大程度看中它能安全掛起等待人工審批(Human-in-the-Loop)。本文按官方最新規範講清 interrupt() 動態暫停、Checkpointer 必備條件、Command(resume=...) 恢復執行,以及防止副作用重複運行的重入規則。

    其他 AI 工具0
  5. 05

    多 Agent 協作平台怎麼選:Dify、釦子(Coze)、n8n 與 LangGraph 多智能體機制對比

    搜「多agent協作平台」時,Dify、釦子、n8n 和 LangGraph 都宣稱支持多智能體,但底層的調度方式完全不同。本文跳過基礎安裝,專門從多 Agent 角色跳轉、子代理工具調用、上下文隔離與私有化部署四個維度幫你一次選準。

    其他 AI 工具0
  6. 06

    企業微信有官方 MCP 和 CLI 嗎:@wecom/cli 安裝初始化、長連接機器人與接入教學

    搜「企業 微信 有 mcp 嗎」不用再東拼西湊民間群機器人腳本了:企業微信官方已推出 @wecom/cli 命令行工具並內置 stdio 模式的 MCP Server。本文按官方開發者文檔講清安裝、智能機器人長連接初始化、業務命令與接入 Claude Code 步驟。

    Claude其他 AI 工具0

同產品的其他教學

  1. 01

    MCP 收費嗎:開源協議免費邊界、第三方 API 帳單與隱形 Token 開銷說明

    搜「mcp 收費 嗎」的人常擔心裝多了插件會被扣費。MCP(模型上下文協議)本身和官方 SDK 採用 MIT 協議完全免費;實際使用中可能產生費用的只有兩處:掛載過多工具佔用的大模型上下文 Token,以及部分外部商業數據源自帶的 API 套餐。

    Claude其他 AI 工具0
  2. 02

    MCP 協議最新版本更新了什麼:無狀態架構、OAuth 2.1、結構化輸出與異步 Tasks 詳解

    搜「mcp 重大 更新」「mcp 協議 更新」想補齊規範演進脈絡?本文對照 modelcontextprotocol.io 官方規範更新日誌,梳理從 Streamable HTTP 到無狀態優先架構、OAuth 2.1 資源伺服器、Elicitation 交互補參與異步 Tasks 擴展的核心變化。

    Claude其他 AI 工具0
  3. 03

    A2A 和 MCP 有什麼區別:工具連接協議與智能體通信協議的邊界和配合

    很多人問「有了 MCP 為什麼還要出 A2A,兩者是不是二選一的競爭關係」。兩份官方規範都明確寫明它們是上下互補關係:MCP 負責給單個智能體掛載工具與數據源,A2A 負責讓多個獨立黑盒智能體跨團隊、跨框架互相派單協作。

    Claude其他 AI 工具0
  4. 04

    LangGraph 怎麼使用 MCP:用 langchain-mcp-adapters 接入本地與遠程工具

    想讓自建的 LangGraph 狀態圖直接調用現成的 MCP 伺服器,官方標準方案是安裝 langchain-mcp-adapters 並使用 MultiServerMCPClient。本文講清 stdio 與 streamable_http 兩種配置寫法、異步圖運行及按節點分工具技巧。

    Claude其他 AI 工具0
  5. 05

    LangGraph 入門教學:Python 安裝、核心概念與跑通第一個狀態圖智能體

    面向搜「python 安裝 langgraph」和「langgraph 中文 文檔」的初學者:本文按 LangChain 官方最新 Graph API 規範,講清安裝步驟、State/Node/Edge 四大概念,並從零寫出第一個帶工具調用循環的 StateGraph。

    Claude其他 AI 工具0
  6. 06

    Claude Agent SDK 子代理怎麼寫:AgentDefinition 配置、權限收斂與 Python/TS 示例

    在 Python 或 TypeScript 裏用 Claude Agent SDK 編排多角色協作,核心是配置 ClaudeAgentOptions 的 agents 字段與 AgentDefinition。本文講清必開的 Agent 委派權限、工具收斂、模型分級與完整代碼示例。

    Claude0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~