结论先说
- 全局 CLAUDE.md 就是用户级指令文件,路径是
~/.claude/CLAUDE.md,官方的用途描述是「对所有项目生效的个人偏好」,只有你自己能看到。 - 它和项目 CLAUDE.md 是叠加关系,不是覆盖。所有找到的文件会拼接进上下文,越靠近你启动目录的越后读。
- 只写个人偏好,不写项目细节。 项目细节放项目里的 CLAUDE.md,经版本控制给团队共享。
- 文件变长就拆:个人规则可以拆到
~/.claude/rules/下按主题分文件,同样对所有项目生效。 - 项目里的私人偏好用
CLAUDE.local.md,并加入.gitignore。

图:本站根据 Claude Code 官方文档:How Claude remembers your project 整理的示意图
本文根据 Claude Code 官方文档《How Claude remembers your project》整理,资料核对于 2026-11-13。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 搜「全局 claude md 配置」的人;
- 每个项目都要重复告诉 Claude 同样偏好(比如回答风格、提交习惯)的人;
- 想弄清全局、项目、个人几种指令文件各管什么的人。
一、几种指令文件的分工
官方表格按加载顺序从最宽的范围排到最具体的:
| 范围 | 位置 | 用途 | 谁能看到 |
|---|---|---|---|
| 组织级(Managed policy) | macOS:/Library/Application Support/ClaudeCode/CLAUDE.md;Linux 和 WSL:/etc/claude-code/CLAUDE.md;Windows:C:\Program Files\ClaudeCode\CLAUDE.md | IT 统一管理的组织级指令 | 组织内所有用户 |
| 用户级(User) | ~/.claude/CLAUDE.md | 对所有项目生效的个人偏好 | 只有你 |
| 项目级(Project) | ./CLAUDE.md 或 ./.claude/CLAUDE.md | 团队共享的项目指令 | 团队,经版本控制 |
| 本地(Local) | ./CLAUDE.local.md | 当前项目里的个人偏好,要加入 .gitignore | 只有你,当前项目 |
所以「全局 CLAUDE.md」对应的是用户级这一行。官方表格写得很清楚:项目指令会出现在用户指令之后,所以同一件事上项目指令更靠后,更接近你的实际工作目录。
二、怎么建这个文件
按官方文档:
- 在用户目录下的
.claude文件夹里新建CLAUDE.md(官方写作~/.claude/CLAUDE.md;Windows 上就是你的用户文件夹里的.claude文件夹); - 用 markdown 写,用标题和列表分组;
- 用
/memory确认:官方说该命令会列出你的 CLAUDE.md、CLAUDE.local.md 等位置,包括还不存在的用户和项目级文件,选中不存在的会先创建再打开; - 新开会话验证。

图:本站根据 Claude Code 官方文档:How Claude remembers your project 整理的示意图
三、全局里该写什么
官方对用户级文件的举例是「代码风格偏好、个人工具快捷方式」。按官方写作原则推断,适合放全局的是:
- 你和 Claude 的协作方式:先给计划再动手、不确定时先问;
- 你固定的代码风格偏好:比如缩进、命名习惯;
- 你的常用工具:习惯用哪个包管理器、哪个编辑器的约定;
- 回答格式偏好:先给结论、再给细节。
不适合放全局的:某个项目的构建命令、目录结构、业务口径。这些放项目 CLAUDE.md,换了项目就不会误用。
写法依旧是官方的原则:具体到可验证,不要「好好写代码」这类口号,每个文件尽量不超过 200 行,互相矛盾的删掉。语言用中文还是英文,见 /guides/claude-md-chinese-or-english。
四、拆分:用户级规则目录
个人规则多了,可以放进 ~/.claude/rules/。官方说:这里的个人规则对你机器上的每个项目生效,适合不属于某个项目的偏好,目录结构比如:
text
~/.claude/rules/
├── preferences.md # 个人编码偏好
└── workflows.md # 偏好的工作流
官方还说,所有 .md 文件都会被递归发现,没有 paths 前置字段的规则在启动时载入,优先级与 .claude/CLAUDE.md 相同。带 paths 的规则则只在处理匹配文件时才载入,用法见 /guides/claude-code-large-repo-focus-directories。
五、导入其他文件
CLAUDE.md 里可以用 @路径 导入别的文件,被导入的文件会和引用它的 CLAUDE.md 一起载入。官方示例里有这样一行,从用户目录导入:
text
# Individual Preferences
- @~/.claude/my-project-instructions.md
要点:
- 相对路径相对于包含这条导入的文件,不是工作目录;
- 可以递归导入,最多四层;
- 路径含空格要在空格前加反斜杠;
- 代码块和行内代码里的
@不会被当成导入; - 官方提醒:导入只是帮你整理长文件,不会减少上下文占用,因为被导入的文件会一起载入。
对于项目级文件里指向工作目录之外的导入,Claude Code 第一次遇到会弹出批准对话框;官方写明用户级的记忆文件(如 ~/.claude/CLAUDE.md)不受这个对话框的保护逻辑约束,因为它们是你自己的。
六、加载顺序与叠加
官方说明:Claude Code 从当前工作目录和它上面的每一级目录加载 CLAUDE.md 和 CLAUDE.local.md,所有找到的文件拼接进上下文,而不是互相覆盖,顺序是从文件系统根目录一路到你的工作目录,所以离你启动位置越近的越后读。每个目录里 CLAUDE.local.md 排在 CLAUDE.md 之后。子目录里的文件在 Claude 访问那里时再按需载入。
这就是为什么全局指令和项目指令冲突时,要自己检查:两条矛盾的指令,Claude 可能随便选一个。
七、几个常见疑问
- 要不要把全局文件放进 git? 它在你的用户目录,不在仓库里,本来就不会被提交。想备份,可以自己放到私有仓库管理;
- 全局文件会不会拖慢每次会话? 它每次都完整载入,越长占用的上下文越多,所以保持精简;
- 想让某个项目不受全局文件影响? 官方有
claudeMdExcludes之类的排除设置,具体用法见 /guides/claude-code-large-repo-focus-directories; - 额度不够? 订阅登录的用量和重置,见 /chongzhi/claude-code 里关于 Claude Code 订阅的说明,以官方页面为准。
常见问题
Q:全局 CLAUDE.md 和 settings.json 有什么区别?
CLAUDE.md 是写给 Claude 读的指令,settings.json 是配置项,比如权限、环境变量。后者见 /guides/claude-code-settings-json。
Q:我在不同机器上怎么保持一致?
官方说用户级的记忆文件只在本机。需要同步,要自己管理这个文件。
Q:团队想统一全局规则怎么办?
官方有组织级的 CLAUDE.md,由 IT 部署到系统目录,对所有用户生效,见上表第一行。
相关教程
- /guides/claude-md-auto-update-how-to-update:CLAUDE.md 会自动更新吗
- /guides/claude-md-agents-md:CLAUDE.md 与 AGENTS.md
参考资料
- Claude Code 官方文档:How Claude remembers your project — https://code.claude.com/docs/en/memory
0 条评论
还没有评论,来抢沙发~