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

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

AI工具961个
技能包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 是什么四条核心原则详解原则一:编码前先思考原则二:简约至上原则三:精确编辑原则四:目标驱动怎么用为什么它这么火

相关文章

AI短剧制作全流程实操指南
AI教程

AI短剧制作全流程实操指南

从剧本到成片,用豆包、小云雀、Vidu等工具零基础制作AI短剧,附工具对比和费用参考。

avatar for toolin小编
toolin小编
2天前
Claude Opus 4.7 上线实测:编程第一、视觉翻3倍,但这些坑别踩
AI产品

Claude Opus 4.7 上线实测:编程第一、视觉翻3倍,但这些坑别踩

Claude Opus 4.7 全面上线,编程 SWE-bench Pro 达 64.3% 超越 GPT-5.4,视觉分辨率翻 3 倍,但 token 消耗上涨 35%,长上下文能力暴跌。升级前必看这篇实测指南。

avatar for toolin小编
toolin小编
3天前
Anthropic 负责人的 Vibe Coding 大师课
AI教程

Anthropic 负责人的 Vibe Coding 大师课

Anthropic 研究员 Erik Schluntz 分享生产环境中负责任地使用 Vibe Coding 的实战经验,涵盖 22000 行代码合并案例、叶子节点策略和进阶技巧。

avatar for toolin小编
toolin小编
1天前