CLAUDE.md 与项目记忆

CLAUDE.md 是 Claude Code 的长期项目记忆。把重复出现的规则写进去，可以减少沟通成本并提高输出稳定性。

CLAUDE.md 应该写什么

项目简介和主要目录。
常用构建、测试、lint 命令。
编码风格、命名约定和禁止事项。
部署、权限和安全边界。
团队希望 Claude Code 遵守的交付格式。

# Project instructions
- Run `npm test` before finalizing JS changes.
- Do not edit generated files under `public/`.
- Prefer small scoped patches and summarize verification.

维护方式

先让 Claude Code 读取项目并提出 CLAUDE.md 草稿。
人工确认命令和边界。
随着项目变化持续更新。
把团队通用规则提交到仓库，把个人偏好留在本地配置。

常见问题

CLAUDE.md 会不会泄露秘密？

不要写 API key、密码、私钥或客户敏感信息。只写规则、命令和非敏感上下文。

参考来源

内容基于 Anthropic 官方 Claude Code 文档、Claude Code 最佳实践文章和 Model Context Protocol 官方资料整理，并改写为中文教程站结构。