CLAUDE.md
CLAUDE.md 是 Claude Code 在会话开始时读取的 Markdown 常驻指令文件，其内容会进入该会话发出的每次请求。
它记录无需每次重述的事项，例如构建与测试命令、编码约定、架构决定，以及不应改动的部分。Claude Code 会读取项目根目录的 ./CLAUDE.md 或 ./.claude/CLAUDE.md、个人默认文件 ~/.claude/CLAUDE.md，以及组织管理的文件。它会合并找到的内容，而不是让某个文件覆盖另一个。子目录的文件会在 Claude 读取该目录的内容时才载入。
成本容易被低估。文件在系统提示词之后以消息形式进入会话，而每次请求都会重新发送完整上下文，因此每一行都会在每一轮计入输入。提示缓存有效时读取较便宜，缓存需要重建时则按完整输入价格或更高的写入价格计算。一个每月才用一次的说明，仍可能在每次会话的每次请求中占据位置。
截至 2026 年 9 月，Anthropic 文档建议每个 CLAUDE.md 少于 200 行，原因是较长文件占用更多上下文，也更难让模型遵循。通过 @path 导入其他文件有助于整理内容，却不会缩小启动时载入的总量。更有效的做法是把特定流程的指令移入只在相关任务中加载的技能或按路径生效的规则。Claude Code 在把内容送给模型前，还会去掉块级 HTML 注释。
还要留意加载时机。项目根目录的文件在 /compact 后仍会生效，因为 Claude Code 会从磁盘重新读取。会话中途编辑该文件，则须等到下一次 /clear、/compact 或重新启动才会生效。/context 可以列出实际载入的记忆文件。