话说回来，

上个月我在文章里留了个留言区。说「你们在 Claude Code 上遇到的问题，尽管丢过来」。结果后台收到了将近 条消息，很多问题反复出现——CLAUDE.md 到底怎么写、Token 消耗太快怎么办、MCP 是个什么东西。

与其在留言区逐条回复，不如把高频问题集中回答一次。这 个问题覆盖了从入门到进阶的主要困惑，每个回答都附带我自己用了半年的真实经验。说起来，

1. CLAUDE.md 到底怎么写？写了真的有用吗，

痛点： 新手不知道如何利用 CLAUDE.md 提高开发效率，担心配置无效或过于复杂

这个问题被问的频率排第一。几乎所有用 Claude Code 的人第一个困惑就是：这个文件是干什么的？不写行不行，

一句话回答：CLAUDE.md 就是你项目的「团队公约」。 Claude Code 启动时会自动读取它，把你写的规则当成团队共同约定来遵守。 不写也能用，但等于你招了一个能力很强但完全不了解你们项目的新人。每次沟通都要从头交代背景。

一个实用的 CLAUDE.md 模板长这样：

## 项目简介
使用者订单程序，Spring Boot + MyBatis-Plus + MySQL
## 常用命令
- 启动: `mvn spring-boot:run`
- 测试: `mvn test`
- 建立: `mvn clean package -DskipTests`
## 代码规范
- 命名: 驼峰命名。表名用下划线分隔
- 分层: Controller 只做参数校验和路由，业务逻辑全部在 Service 层
- 数据库: 禁止在代码里写 SQL，统一用 XML mapper
## 已知坑点
- 订单表的 create_time 字段用的是 UTC，前端展示需要转东八区
- 第三方支付回调地址必须用 HTTPS，本地调试用 ngrok

为什么有效？话说回来， Claude Code 的是有限的。如果你不写 CLAUDE.md，它每次都要通过读代码、问你问题来理解项目。写了之后相当于把「新员工入职手册」直接拍在桌上，省掉大量来回对话的 Token。

我在一个万行的 Java 项目里测试过：写 CLAUDE.md之前每次让 Claude Code 改代码平均需要 - 轮对话交代背景；写完之后第一轮就能给出符合项目规范的方案。Token 消耗直接砍掉将近一半。

CLAUDE.md 作用范围解析