核心数据
- 82,000 stars,7,800 forks
- 编码准确率从 65% → 94%
- 每个开发者每周浪费 $975 在重复工作上
- 团队 5 人:每年浪费 $253,500
问题本质
每次打开 Claude Code,它从零开始。不知道你的技术栈、标准、项目背景、之前尝试过什么、明确决定不做什么。
所以它猜。猜就出错:重构你没让碰的代码、建议破坏现有架构的框架、删除文件不请示、 contradict 你已做的决定。
CLAUDE.md 是什么
项目根目录下的纯文本文件,Claude Code 每次会话自动读取。
一次设置,零重复解释。
三大模块
1. Defaults — 省掉 $375/周的重复解释
7 条规则置顶:
- Kill the filler:禁止"Great question!"等开场废话,直接给答案
- Match length to task:简单问题简短回答,复杂任务详细展开
- Show options before acting:重大任务先给 2-3 种方案,等用户选
- Admit uncertainty:不确定就明说,绝不编造
- Who I am:用户背景、强项、短板,调整回答深度
- Current project context:项目目标、受众、技术栈、避坑清单
- Lock your voice:写作风格、句式长度、常用/禁用词
2. Behavior — 阻止 $225/周的未授权修改
7 条行为锁:
- Stay in scope:只改与当前任务直接相关的代码
- Ask before big changes:重写、删除、重构前必须描述并等待确认
- Confirm before destructive:删除文件、覆盖代码、删库前必须显式确认
- Hard stops for production:部署、迁移、外部 API 调用必须当前消息确认
- Always show what changed:任务结束后列出所有改动文件
- Never act without explicit confirmation:禁止代发邮件、日历、文档
- Think before you write:架构决策、复杂调试前先展示推理过程
3. Memory + Stack — 终结 $375/周的遗忘损失
- MEMORY.md:重大决策日志(决定了什么、为什么、拒绝了什么)
- Session end summary:会话结束时写入工作摘要
- ERRORS.md:失败日志(什么没奏效、什么替代方案有效)
- Permanent facts:项目永久约束、架构决策
- Lock your tech stack:语言、框架、包管理器、数据库、测试、样式——锁死
Karpathy 的 4 条黄金规则
- Ask, don't assume. 不清楚就问,绝不默默假设。
- Simplest solution first. 先实现最简单的可行方案,不加未要求的抽象。
- Don't touch unrelated code. 与当前任务无关的文件/函数,绝不碰。
- Flag uncertainty explicitly. 没把握就说,自信而不确定比承认空白更有害。
渐进式采纳建议
先只贴 Karpathy 的 4 条规则。2 分钟搞定。剩下的每周补一点,发现缺什么就加什么。
快速生成提示词
Based on what I've told you about myself, my project, and how I want to work:
write me a complete CLAUDE.md file. Include: who I am, my tech context,
my communication preferences, and default behaviors for every session.
Be specific. Plain text. Under 500 words.