claude.md 使用方法

CLAUDE.md 是给 Claude Code(Anthropic 推出的 AI 编程助手)用的项目级「行为说明书」 ------放在仓库根目录,每次启动会话会自动读取,相当于把团队规范、技术栈、做事风格写成一份持久化、可版本管理的系统提示词。

一、它为什么突然爆火

  • 起源:前特斯拉AI总监、OpenAI 联合创始人 Andrej Karpathy 发推总结了 LLM 写代码的常见坑(乱改、臆测、不澄清、重构成瘾)。
  • 走红项目:开发者 Forrest Chang 把这些观察浓缩成 4 条核心原则 ,写成一个 65 行的 CLAUDE.md,开源在 forrestchang/andrej-karpathy-skills。
  • 数据:2026 年 1 月上线,4--5 月病毒式传播,Star 破 12 万、Fork 超 10 万,成 GitHub 史上涨星最快的 AI 项目之一。

二、核心作用(一句话说清)

不用每次跟 AI 重复交代:

  • 项目用什么技术栈/框架/版本
  • 代码风格、命名规范、目录结构
  • 哪些文件绝对不能碰
  • 怎么写测试、怎么提交、怎么部署
  • 遇到模糊需求要追问,不要瞎猜

它就是 AI 编程时的**「项目宪法」**。

三、Karpathy 版四条黄金法则(精简)

  1. Think Before Coding(先想再写)
    • 先理解需求、边界、依赖;有歧义立刻追问,不要自己脑补。
  2. Simplicity First(简单优先)
    • 能用简单方案就不搞复杂设计;不提前优化、不过度工程化。
  3. Surgical Changes(精准修改)
    • 只改必须改的地方,不"顺手"重构、不扩写无关代码;Git Diff 要干净。
  4. Goal-Driven Execution(目标驱动)
    • 先写测试(TDD),再改代码;每一步都要可验证、可复盘。

四、文件位置与优先级(可多层叠加)

Claude Code 会按顺序加载,后加载的规则优先级更高:

  1. 全局:~/.claude/CLAUDE.md(个人所有项目生效)
  2. 项目:./CLAUDE.md(仓库根目录,提交到 Git,团队共享)
  3. 目录:子目录下的 CLAUDE.md(局部规则)

五、怎么用(30 秒上手)

  1. 在项目根目录新建 CLAUDE.md。
  2. 把 Karpathy 四条规则抄进去,再补充项目专属规则(技术栈、禁改文件、命令等)。
  3. 提交到 Git,团队共享。
  4. 用 Claude Code 打开项目,它会自动读取并遵守。

六、为什么大家疯狂跟风

  • 零成本、零依赖:一个纯文本文件,不用安装、不用配置。
  • 效果立竿见影:显著减少 AI 乱改、重构、臆测的问题,代码质量和开发效率大幅提升。
  • 可复制、可传播:像"AI 编程疫苗"一样,快速在全行业扩散。

要不要我把 Karpathy 原版的 65 行 CLAUDE.md 全文贴给你,你直接复制就能用?

相关推荐
保利威视频SaaS小张4 小时前
企业直播接入笔记 12|企业内训直播怎么做签到和学时统计,防挂机这件事比想象中难
java·前端·数据库·笔记·视频云·polvy·polyv
lcj25116 小时前
[C++] C++11
开发语言·c++·笔记
一条破秋裤7 小时前
【1117】【内存资源管控】【笔记】
android·笔记
qingwufeiyang_5309 小时前
Docker学习笔记2
笔记·学习
Z21-X10 小时前
云原生运维学习笔记:从操作系统底层到 Kubernetes 集群的深度实践
运维·笔记·学习·云原生·kubernetes
星恒随风10 小时前
MySQL 从零入门(七):索引原理与 B+ 树详解——从磁盘 I/O 到 InnoDB 聚簇索引
linux·服务器·数据库·笔记·mysql
希和20271 天前
江科大 51 单片机笔记:DS18B20 温度传感器 + LCD1602 显示代码详解
笔记·单片机·mongodb
Sakura_j_h_1 天前
MCP SDK 2.0 实战:用 MCPServer 搭本地笔记检索服务
开发语言·笔记·python·qt·ai工具·mcp·mcpserver
前进的李工1 天前
Agent 学习笔记 15:Agent 怎样响应事件与中途打断?
人工智能·笔记·agent·openclaw·工具设计·gpt-6 astra·原生异步
希和20271 天前
51 单片机学习笔记:LCD1602、独立按键、I2C 与 AT24C02 掉电存储(江科大课程小白笔记)
笔记·单片机·学习