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 条评论

登录 后参与评论

还没有评论,来抢沙发~