toolin.ai logo
toolin.ai
首页
AI工具
AI技能包
AI资讯
精选推文
AI提示词
提交AI工具提交
toolin.ai logo
toolin.ai

百万AI玩家的创作利器库,发现最佳AI工具组合,提升您的创作效率

AI工具1,209个
技能包11个
产品功能
  • AI工具
  • AI技能包
  • AI资讯
  • 精选推文
关于我们
  • 关于Toolin
  • 联系我们
  • 合作洽谈
  • 更新日志
关注我们
© 2025 toolin.ai. All rights reserved.
服务条款隐私政策

CLAUDE.md 爆火 GitHub:四条规则管住 AI 编程

2026/04/20
·toolin小编

源自 Karpathy 编程经验的 CLAUDE.md 配置文件登上 GitHub 趋势榜第一,6 万开发者抄作业。四条核心原则帮你大幅提升 AI 编程质量。

CLAUDE.md 爆火 GitHub:四条规则管住 AI 编程
CLAUDE.md 爆火 GitHub:四条规则管住 AI 编程
2026/04/20

CLAUDE.md 爆火 GitHub:四条规则管住 AI 编程

源自 Karpathy 编程经验的 CLAUDE.md 配置文件登上 GitHub 趋势榜第一,6 万开发者抄作业。四条核心原则帮你大幅提升 AI 编程质量。

CLAUDE.md 是什么四条核心原则详解原则一:编码前先思考原则二:简约至上原则三:精确编辑原则四:目标驱动怎么用为什么它这么火
AI教程

一个纯文本的 Markdown 文件,没有一行代码,却在 GitHub 上连续三天霸占趋势榜日榜第一,本周新增 44,465 颗星。它叫 CLAUDE.md,一个放在项目根目录的配置文件,里面写了四条规矩,用来管住 AI 编程时最常犯的毛病。

CLAUDE.md 是什么

CLAUDE.md 是一个 Markdown 格式的配置文件,放在项目根目录下,AI 编程 Agent(如 Claude Code、Cursor)会自动读取并遵守其中的规则。它的核心思路是:把资深工程师的隐性知识,打包成 Agent 可以直接理解和执行的指令。

项目地址:https://github.com/forrestchang/andrej-karpathy-skills

GitHub 趋势榜

四条核心原则详解

这个文件的源头是 Karpathy 今年 1 月在 X 上发的长帖,详细吐槽了 AI 编程 Agent 的各种问题。华人开发者 Jiayuan Zhang 将其提炼为四条可执行的规则。

原则一:编码前先思考

问题:你让 AI "加个验证功能",它不会问你验证什么、严格程度如何,而是直接猜一个最复杂的方案写一大堆不需要的代码。

规则:

  • 不确定时必须停下来问,不能猜
  • 存在多种理解时列出选项让你选,而不是替你做决定
  • 发现有更简单的方案时,主动说出来

原则二:简约至上

问题:你想要一个简单功能,AI 给你写一整套企业级架构,附带登录认证、安全校验、流量控制。你说"简单点",它立刻砍掉大半并说"当然可以"。

规则:

  • 没被要求的功能不写
  • 只用一次的代码不建抽象层
  • 没人要求的"灵活性"和"可配置"不加
  • 不可能发生的异常场景不做错误处理

检验标准:一个资深工程师看了会不会说"太复杂了"。会的话,直接砍。

原则三:精确编辑

问题:你让 AI 修一个 bug,它改完 bug 顺手把旁边的代码也重构了,变量名换了,注释删了。改了 30 处,其中 25 处跟你的需求无关。

规则:

  • 只动你被要求动的部分
  • 匹配项目已有的代码风格
  • 看到不相关的问题提一嘴就行,别动手
  • 你的改动导致某些代码不再被使用时清理掉,但之前就存在的问题不要碰

原则四:目标驱动

问题:AI 擅长"循环到达标为止",但你告诉它具体步骤反而限制了它的发挥。

规则:

  • 给验收标准,不给步骤
  • 要加功能:先写测试用例,然后让所有测试通过
  • 要修 bug:先写能复现 bug 的测试,然后让它通过
  • 复杂任务:先列分步计划,每一步带验证方式

这是用 AI 编程时杠杆最大的一条原则。验收标准定得越清晰,AI 能独立执行的时间越长,你需要介入的频率就越低。

四条原则示意

怎么用

  1. 把 CLAUDE.md 文件放在项目根目录
  2. AI 编程 Agent 会自动读取并遵守其中的规则
  3. 也可以根据自己的需求修改和补充规则
# 示例:在 CLAUDE.md 中加入项目特定规则

## 项目约定
- 使用 TypeScript strict 模式
- 组件文件名用 PascalCase
- API 接口统一放在 src/api/ 目录下
- 写新功能前先写测试

为什么它这么火

正如开发者 Kraggich 说的:"一个 Markdown 文件冲上趋势榜第一,说明现在的瓶颈不在模型,而在模型周围的脚手架。这些'胶水'才是产品本身。"

另一位开发者算了一笔账:模型选错了分支,运行了 40 分钟最后碰壁失败。而提前澄清只需要 30 秒。

Karpathy 自己说,短短几周内他的编程工作流从"80% 手写 + 20% AI 辅助"彻底翻转成了"80% 交给 Agent + 20% 自己修补"。这个 CLAUDE.md 就是让这个翻转真正可靠的关键工具。

开发者反馈

所有文章

作者

avatar for toolin小编
toolin小编

分类

  • AI教程
CLAUDE.md 是什么四条核心原则详解原则一:编码前先思考原则二:简约至上原则三:精确编辑原则四:目标驱动怎么用为什么它这么火

相关文章

Step 3.7 Flash:409 tok/s的Agent效率模型
AI产品

Step 3.7 Flash:409 tok/s的Agent效率模型

阶跃星辰新模型输出速度达409 tokens/s,单任务成本为Claude Opus 4.6的1/9,编程能力达其97%,专为Agent高频调用场景设计。

avatar for toolin小编
toolin小编
18小时前
Gemma 4 12B:16G笔记本跑多模态AI模型
AI产品

Gemma 4 12B:16G笔记本跑多模态AI模型

谷歌发布120亿参数开源多模态模型,支持文本、图像、音频输入,仅需9GB显存即可在笔记本本地运行,Apache 2.0协议。

avatar for toolin小编
toolin小编
18小时前
OpenSquilla Meta Skill:把一整套工作流装进一个 Skill
AI产品

OpenSquilla Meta Skill:把一整套工作流装进一个 Skill

OpenSquilla 推出 Meta Skill 功能,一个 Skill 内嵌多个子 Skill,能端到端打通长程工作流,还能省 60-80% 的 Token 成本

avatar for toolin小编
toolin小编
1天前