写好 CLAUDE.md：给 Claude Code 一份项目说明书

在项目文件夹里启动 Claude Code，然后输入：

/init

它会分析项目，生成一份包含构建命令、测试命令和代码约定的 CLAUDE.md。如果文件已经存在，它会给出改进建议，不会直接覆盖。

好的说明书要短。官方建议单个文件控制在 200 行左右。优先写这几类：

• 常用命令，比如怎么运行、怎么测试
• 不看代码猜不出来的约定
• 明确不能做的事
• 输出和沟通偏好

下面是一个小网站项目的例子：

# 项目说明

个人作品集网站，纯静态页面。

## 常用命令
- 本地预览：npm run dev
- 构建：npm run build

## 约定
- 页面文案使用简体中文
- 不引入新的依赖，除非先问我
- 图片放在 public/images/

## 完成标准
- 改完后运行构建，确认没有报错
- 回复时说明改了哪些文件

CLAUDE.md 可以放在不同位置，作用范围也不同：

• ~/.claude/CLAUDE.md：对你的所有项目生效，放个人习惯。
• 项目根目录的 CLAUDE.md：只对这个项目生效，可以提交到 Git 和团队共享。
• 项目根目录的 CLAUDE.local.md：放个人的项目设置，记得加入 .gitignore。

这些文件是叠加生效的，不是互相覆盖。

内容变多时，可以用 @路径 引用其他文件，保持主文件简短：

项目背景见 @README.md
发布流程见 @docs/deploy.md

在 Claude Code 里输入 /memory，可以查看和编辑当前加载的说明文件。

一个实用的维护习惯：Claude 第二次犯同样的错时，就把正确做法加进 CLAUDE.md。说明书不用一次写完，边用边补就好。

资料来源

• 核对自 Claude Code 记忆文档↗
• 多工具共享上下文的思路参考了 陈大黄 在 X 上的分享↗