技能包

Karpathy 指南:用一份 CLAUDE.md 让 Claude Code 先谨慎再改代码

适合要减少 Claude Code 常见编码陷阱的人,但指南偏向谨慎而非速度,简单拼写或单行修改不必走满全套。

官方来源 · andrej-karpathy-skills

安装

/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills

适合谁

如果你主要在 Claude Code 里改仓库,并且希望它少踩那些 LLM 常见的编码坑,这份材料更合适。它就是一份 CLAUDE.md,用来改善 Claude Code 的行为,来源是 Andrej Karpathy 对 LLM 编码陷阱的观察:

https://x.com/karpathy/status/2015883857489522876

页面写到:四条原则写在同一个文件里,用来直接对应这些问题。摘录没有列出这四条的名称或正文,因此不要自行给它们起名,也不要编一套口令。你需要的是已经在用 Claude Code、并接受安装插件的人。只想读推文、不打算改本机 Claude Code 配置的人,看上面的链接即可。

3 分钟完成第一次尝试

官方推荐安装是连续两步,缺一步都不算装完。先在 Claude Code 里执行:

/plugin marketplace add forrestchang/andrej-karpathy-skills

然后立刻安装插件:

/plugin install andrej-karpathy-skills@karpathy-skills

这会改 Claude Code 的插件配置,不是只读查看。执行前确认当前就是你要写入的 Claude Code 环境,并且两步都做完。不要只加 marketplace 却不 install。

装好后先做一次对照,不要马上大改仓库。选一个非琐碎的改动意图,让 Claude Code 先根据这份指南说明它打算怎么改、会动哪些文件,你点头后再允许写代码。成功信号是:它表现出「谨慎优先于速度」,会先讲清楚再动手,而不是直接铺开大补丁。若它开始重构无关模块,先停下来。

使用案例

案例一:处理非琐碎的编码任务。指南存在的理由是改善 Claude Code 面对 LLM 编码陷阱时的行为。把任务限定为「先对照 CLAUDE.md 再改」。摘录没有写这四条原则的标题,所以你不能要求它按某个自造原则名执行;你能要求的是:读这一份文件,再给出改动范围。验收看两点:它读的是这份指南,以及它先给出范围而不是先改文件。

案例二:判断要不要上满严谨流程。页面写明这些指南偏向谨慎而非速度;对琐碎任务(简单拼写、一目了然的单行修改)要自己判断,不是每次都上满全套。当你只是改一个明显错字时,应明确告诉它「这是琐碎修改,不要把流程铺开」。它没有定义「明显」的自动规则,也没有写哪些文件类型可以例外。因此边界只能由你当场判定;Agent 若把改错字升级成重构,就已经离开这个案例。

使用边界

这是一份给 Claude Code 用的 CLAUDE.md,不是通用编辑器规则包。页面没有写把它改名给其他产品使用的步骤。四条原则在同一个文件里,但摘录只停在「有四条、用来对应这些问题」,没有原则清单。不要补名称,也不要假装已经引用了文件里的原句。

推荐安装就是上面的 marketplace add 再 plugin install。两步都要做。不要再并列另一套安装器。来源观察在 Karpathy 的帖子里;指南本身是衍生用法,不能代替那条帖子的上下文。

第一次停在「先说明再改」。任何超出当前任务的重构、批量重排或新加抽象,都要先让它列出将改文件和理由,你确认后再继续。琐碎修改则主动降级流程,避免为了一个拼写走完整套。