用途
该项目提供一个单一的 CLAUDE.md 文件，用于改善 Claude Code 的行为。其内容源自 Andrej Karpathy 对 LLM 编码陷阱的观察，目的是让编码代理在非平凡任务中减少代价高昂的错误。
Karpathy 指出，模型会替用户做出错误假设并直接执行而不检查；它们不管理自己的困惑，不寻求澄清，不暴露不一致，不呈现权衡，该反驳时不反驳。模型还喜欢过度复杂化代码和 API，膨胀抽象，不清理死代码，本可用 100 行实现却写成 1000 行。此外，它们有时会改动或删除自己并未充分理解的注释和代码，即使这些与任务无关。
主要能力：四条原则
1. 编码前先思考
不要假设，不要隐藏困惑，要呈现权衡。该原则要求显式推理：明确陈述假设，不确定时询问而非猜测；存在歧义时呈现多种解释，不要默默选择；有更简单方案时提出反驳；感到困惑时停下，指出不清楚之处并请求澄清。
2. 简单优先
用解决问题所需的最少代码，不做任何投机性设计。对抗过度工程倾向：不添加未被要求的功能；不为一次性代码创建抽象；不添加未被要求的“灵活性”或“可配置性”；不为不可能的场景编写错误处理；如果 200 行可以写成 50 行，就重写。检验标准：资深工程师是否会认为这过于复杂？如果是，就简化。
3. 外科手术式修改
只触碰必须触碰的部分，只清理自己造成的混乱。编辑现有代码时：不要“改进”相邻代码、注释或格式；不要重构没有坏掉的东西；匹配现有风格，即使自己会采用不同写法；如果注意到无关的死代码，提及它但不要删除。当自己的改动产生孤儿代码时：移除因自己的改动而变得未使用的导入、变量、函数；除非被要求，否则不要移除预先存在的死代码。检验标准：每一行改动都应能直接追溯到用户的请求。
4. 目标驱动执行
定义成功标准，循环直到验证通过。将命令式任务转化为可验证的目标：对于多步骤任务，陈述简要计划。强成功标准让 LLM 能独立循环；弱标准（如“让它工作”）则需要不断澄清。
使用方式
选项 A：Claude Code 插件（推荐）
在 Claude Code 中，先添加市场，然后安装插件。这会将指南作为 Claude Code 插件安装，使该技能在所有项目中可用。
选项 B：CLAUDE.md（按项目）
对于现有项目，可追加到 CLAUDE.md 中。
与 Cursor 配合使用
该仓库包含一个已提交的 Cursor 项目规则（.cursor/rules/karpathy-guidelines.mdc），因此在 Cursor 中打开项目时同样适用这些指南。关于设置、在其他项目中使用该规则以及它与 Claude Code 的关系，请参见 CURSOR.md。
适用场景
这些指南设计为与项目特定指令合并使用。可将其添加到现有 CLAUDE.md 或创建新的 CLAUDE.md。对于项目特定规则，可添加相应章节。
这些指南偏向谨慎而非速度。对于琐碎任务（简单拼写修正、显而易见的一行代码），请自行判断——并非每个改动都需要完整流程。目标是减少非平凡工作中的代价高昂错误，而不是拖慢简单任务。
如何判断是否生效
如果出现以下情况，说明这些指南正在生效：差异中不必要的改动更少，只出现被请求的改动；因过度复杂化而重写的情况更少，代码第一次就很简单；澄清性问题出现在实现之前，而不是错误之后；PR 干净、最小，没有顺手重构或“改进”。
限制
资料未提供该项目的许可证、维护状态、兼容的 Claude Code 版本、安装命令的具体内容、价格或收费信息。
