Claude Code怎么配置CLAUDE.md？项目规则、加载检查与冲突排查

Claude Code每次新会话都要重新解释项目命令，或总重复同一个约定错误，可以用CLAUDE.md保存持续上下文。它适合写项目事实和通用规则，不是强制权限配置，也不应承载每次任务的全部历史。本文从一个简短文件开始，讲作用域、加载核对和冲突排查，不把“文件存在”当成规则已经被正确使用。

第一步：选择项目与个人作用域

团队共享规则放项目根目录CLAUDE.md或.claude/CLAUDE.md；个人跨项目偏好放~/.claude/CLAUDE.md。仅当前项目的个人说明可用CLAUDE.local.md并按官方建议加入.gitignore。不要把真实密钥、内部账号或个人私密路径写入将提交的团队规则。

上级目录中的规则会在会话启动时加载，子目录规则按需加载，因此先确认工作目录。仓库若已有AGENTS.md，当前Claude Code也有相应读取规则，先检查现有结构，不再复制出多份互相冲突的说明。不同文件作用域不同，简单地全写一遍会增加维护负担。

第二步：只写可核对的长期事实

# 项目说明（练习模板，按真实仓库填写）
## 常用命令
- 依赖安装：填写锁文件对应命令。
- 验证：填写实际存在的测试或构建命令。
## 目录与约定
- API处理入口：填写已确认路径。
- 修改前检查当前差异，不覆盖无关改动。
## 交付要求
- 只报告实际执行的检查与结果。
- 失败和未验证项明确列出。

模板中的路径和命令必须换成仓库事实，不能留着占位文本就让模型照做。用“使用两空格缩进”一类可检查规则替代“代码写好一点”；多步骤、只针对某类任务的流程适合Skill或路径规则，不必全部塞进每次都会读的文件。

也可用/init生成起点，官方说明它会分析项目，已有文件时建议改进而非直接覆盖；仍需你审阅。项目约定中某个命令已失效时应及时更新，不让自动生成的一次结果长期成为事实来源。保持文件简短，官方建议每份尽量在200行以内。

第三步：检查本次会话是否加载

/context all

在Memory files列表确认目标文件出现，尤其是多仓库、多Worktree或从子目录启动时。全屏界面仅/context可能折叠列表，使用all更便于检查。加载之后用一个只读问题让Claude复述相关命令与依据，不直接用生产写操作测试规则是否生效。

请只读说明本项目的构建与验证命令，指出各自来源文件。若规则与package.json或README冲突，先列出差异，不执行、不修复，也不把占位命令当成可用命令。

模型复述规则不等于执行被系统强制限制。CLAUDE.md与自动记忆都作为上下文使用；真正需要阻止的操作应配置对应权限或适合的Hook。不要在规则里写“禁止任何网络”后就声称整个进程已获得网络隔离。

第四步：审查冲突与过期内容

检查用户、项目、局部文件与.claude/rules是否互相矛盾。引用其他文件可帮助组织，但不会减少加载上下文成本；导入文件中的旧规则也要维护。嵌套目录的说明可能让不同文件采用不同约定，先确认是有意分区还是历史残留。

/doctor prompt-audit

当前官方提供提示审查，要求Claude Code 2.1.283或以上且相关内置能力未关闭。它检查过期引用和冲突，给出建议，不在你要求应用前修改文件。版本不支持时手动核对即可，不为使用一个审查命令随意覆盖全局设置。

第五步：提交前验证有效性与边界

先备份原文件，再仅改确有依据的规则，审阅Git差异，确认没有临时任务、客户内容或秘密混入。启动新的练习会话检查加载与复述，并验证命令确实存在。不要为让说明看起来完整，新增没有实际作用的空测试脚本。

完成标准是规则短、真实、作用域明确，冲突有处理，且你知道它与强制配置的区别。每次发现重复错误时再补一条具体约定，删除已过时内容，比持续堆积聊天记录更能维持可靠上下文。

官方资料

资料核对日期：2026年11月8日。

• Anthropic：Project instructions与memory