全局 CLAUDE.md 怎么配:~/.claude/CLAUDE.md、用户级规则、个人偏好和项目指令怎么分工

想让 Claude Code 在所有项目里都遵守你的个人偏好,就配全局 CLAUDE.md。本文按官方文档讲清它放在哪(~/.claude/CLAUDE.md)、和项目 CLAUDE.md、CLAUDE.local.md、~/.claude/rules/ 的分工、加载顺序、怎么导入其他文件,以及什么该写进全局。

NNathaniel bigo··原创首发·AI 辅助撰写
9 分钟读完
资料核对于 2026-11-13 · 依据官方文档与公开资料整理 免费账号 账号

结论先说

  1. 全局 CLAUDE.md 就是用户级指令文件,路径是 ~/.claude/CLAUDE.md,官方的用途描述是「对所有项目生效的个人偏好」,只有你自己能看到。
  2. 它和项目 CLAUDE.md 是叠加关系,不是覆盖。所有找到的文件会拼接进上下文,越靠近你启动目录的越后读。
  3. 只写个人偏好,不写项目细节。 项目细节放项目里的 CLAUDE.md,经版本控制给团队共享。
  4. 文件变长就拆:个人规则可以拆到 ~/.claude/rules/ 下按主题分文件,同样对所有项目生效。
  5. 项目里的私人偏好用 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.mdIT 统一管理的组织级指令组织内所有用户
用户级(User)~/.claude/CLAUDE.md对所有项目生效的个人偏好只有你
项目级(Project)./CLAUDE.md 或 ./.claude/CLAUDE.md团队共享的项目指令团队,经版本控制
本地(Local)./CLAUDE.local.md当前项目里的个人偏好,要加入 .gitignore只有你,当前项目

所以「全局 CLAUDE.md」对应的是用户级这一行。官方表格写得很清楚:项目指令会出现在用户指令之后,所以同一件事上项目指令更靠后,更接近你的实际工作目录。

二、怎么建这个文件

按官方文档:

  1. 在用户目录下的 .claude 文件夹里新建 CLAUDE.md(官方写作 ~/.claude/CLAUDE.md;Windows 上就是你的用户文件夹里的 .claude 文件夹);
  2. 用 markdown 写,用标题和列表分组;
  3. 用 /memory 确认:官方说该命令会列出你的 CLAUDE.md、CLAUDE.local.md 等位置,包括还不存在的用户和项目级文件,选中不存在的会先创建再打开;
  4. 新开会话验证。

配置全局 CLAUDE.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 部署到系统目录,对所有用户生效,见上表第一行。

相关教程

参考资料

  • Claude Code 官方文档:How Claude remembers your project — https://code.claude.com/docs/en/memory

Nathaniel 的更多内容

  1. 01

    LangGraph 流式输出(Streaming)详解:逐字 Token 流、节点进度与自定义事件写法

    多步智能体如果等全部节点跑完才返回,网页前端就会白屏干等十几秒。本文按 LangGraph 官方文档讲清 updates、messages、custom 与 values 四种 stream_mode 的区别,以及组合订阅逐字打字机输出加工具内部实时进度的完整代码。

    其他 AI 工具0
  2. 02

    LangGraph 持久化与长期记忆怎么配:Checkpointer、Store 与 PostgreSQL 实战

    在生产环境跑 LangGraph,单靠 InMemorySaver 一重启就会丢失全部对话。本文按官方文档讲清线程内短期检查点(Checkpointer)与跨线程长期记忆(Store)的分工,以及用 langgraph-checkpoint-postgres 对接 PostgreSQL 的完整步骤。

    其他 AI 工具0
  3. 03

    LangGraph 多智能体怎么写:Supervisor 主管包与 Subgraph 隔离子图实战

    在 LangGraph 里把单个图扩展成多智能体协作有两条官方路线:快速原型用预置包 langgraph-supervisor,大型生产系统用原生子图(Subgraph)嵌套。本文讲清两种写法的完整代码、私有状态隔离防 Token 膨胀技巧以及检查点传播规则。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入审批怎么写:interrupt 暂停图运行与 Command 恢复实战

    企业之所以选 LangGraph,很大程度看中它能安全挂起等待人工审批(Human-in-the-Loop)。本文按官方最新规范讲清 interrupt() 动态暂停、Checkpointer 必备条件、Command(resume=...) 恢复执行,以及防止副作用重复运行的重入规则。

    其他 AI 工具0
  5. 05

    多 Agent 协作平台怎么选:Dify、扣子(Coze)、n8n 与 LangGraph 多智能体机制对比

    搜「多agent协作平台」时,Dify、扣子、n8n 和 LangGraph 都宣称支持多智能体,但底层的调度方式完全不同。本文跳过基础安装,专门从多 Agent 角色跳转、子代理工具调用、上下文隔离与私有化部署四个维度帮你一次选准。

    其他 AI 工具0
  6. 06

    企业微信有官方 MCP 和 CLI 吗:@wecom/cli 安装初始化、长连接机器人与接入教程

    搜「企业 微信 有 mcp 吗」不用再东拼西凑民间群机器人脚本了:企业微信官方已推出 @wecom/cli 命令行工具并内置 stdio 模式的 MCP Server。本文按官方开发者文档讲清安装、智能机器人长连接初始化、业务命令与接入 Claude Code 步骤。

    Claude其他 AI 工具0

同产品的其他教程

  1. 01

    MCP 收费吗:开源协议免费边界、第三方 API 账单与隐形 Token 开销说明

    搜「mcp 收费 吗」的人常担心装多了插件会被扣费。MCP(模型上下文协议)本身和官方 SDK 采用 MIT 协议完全免费;实际使用中可能产生费用的只有两处:挂载过多工具占用的大模型上下文 Token,以及部分外部商业数据源自带的 API 套餐。

    Claude其他 AI 工具0
  2. 02

    MCP 协议最新版本更新了什么:无状态架构、OAuth 2.1、结构化输出与异步 Tasks 详解

    搜「mcp 重大 更新」「mcp 协议 更新」想补齐规范演进脉络?本文对照 modelcontextprotocol.io 官方规范更新日志,梳理从 Streamable HTTP 到无状态优先架构、OAuth 2.1 资源服务器、Elicitation 交互补参与异步 Tasks 扩展的核心变化。

    Claude其他 AI 工具0
  3. 03

    A2A 和 MCP 有什么区别:工具连接协议与智能体通信协议的边界和配合

    很多人问「有了 MCP 为什么还要出 A2A,两者是不是二选一的竞争关系」。两份官方规范都明确写明它们是上下互补关系:MCP 负责给单个智能体挂载工具与数据源,A2A 负责让多个独立黑盒智能体跨团队、跨框架互相派单协作。

    Claude其他 AI 工具0
  4. 04

    LangGraph 怎么使用 MCP:用 langchain-mcp-adapters 接入本地与远程工具

    想让自建的 LangGraph 状态图直接调用现成的 MCP 服务器,官方标准方案是安装 langchain-mcp-adapters 并使用 MultiServerMCPClient。本文讲清 stdio 与 streamable_http 两种配置写法、异步图运行及按节点分工具技巧。

    Claude其他 AI 工具0
  5. 05

    LangGraph 入门教程:Python 安装、核心概念与跑通第一个状态图智能体

    面向搜「python 安装 langgraph」和「langgraph 中文 文档」的初学者:本文按 LangChain 官方最新 Graph API 规范,讲清安装步骤、State/Node/Edge 四大概念,并从零写出第一个带工具调用循环的 StateGraph。

    Claude其他 AI 工具0
  6. 06

    Claude Agent SDK 子代理怎么写:AgentDefinition 配置、权限收敛与 Python/TS 示例

    在 Python 或 TypeScript 里用 Claude Agent SDK 编排多角色协作,核心是配置 ClaudeAgentOptions 的 agents 字段与 AgentDefinition。本文讲清必开的 Agent 委派权限、工具收敛、模型分级与完整代码示例。

    Claude0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~