Claude Code 共享记忆怎么做:团队项目记忆、本机自动记忆与多工作树共享边界

很多人以为开启 auto memory 就能全组共享记忆,其实自动记忆(MEMORY.md)只存在本机用户目录,仅在同一台电脑的不同 git worktree 间共用。想实现团队级共享记忆,需要靠入库的 CLAUDE.md、.claude/rules/ 以及定期提炼入库流程。

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

结论先说

  1. Claude Code 没有云端自动同步给全组的「隐式聊天记忆池」:官方的自动记忆(auto memory)是纯本地 Markdown 文件,只留在你自己的电脑上,不会自动传给队友。
  2. 你本机的多个 git worktree 默认共享同一份自动记忆:同一个 Git 仓库衍生出的各个工作树与子目录,共用同一个 ~/.claude/projects/<project>/memory/ 目录。
  3. 真正的「团队共享记忆」靠 Git 版本控制实现:载体是仓库根目录的 ./CLAUDE.md(或 ./.claude/CLAUDE.md)以及模块化的 ./.claude/rules/*.md。
  4. 最稳妥的团队记忆流转是「个人自动积累 → 人工筛选提炼 → PR 合入仓库」:平时让自动记忆接住零散纠偏,每周挑出全组通用的经验写进 CLAUDE.md 或 rules/,避免未经审核的个人习惯污染全组上下文。

Claude Code 团队与个人记忆范围对照

图:本站根据 Claude Code 官方文档:How Claude remembers your project 整理的示意图

本文根据 Claude Code 官方文档《How Claude remembers your project》整理,核对日期 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。

适用于谁

  • 搜「claude code共享记忆」「claude code 团队记忆怎么同步」的人;
  • 团队多人维护同一个代码仓库,发现自己纠正过的坑同事那边的 Claude Code 完全不知道的人;
  • 同时开多个 git worktree 并行开发,想知道记忆文件能不能跨工作树共用的开发者。

如果你还不清楚 CLAUDE.md 为什么不会自己改动,可以先看 /guides/claude-md-auto-update-how-to-update;如果你只配个人全局偏好,见 /guides/claude-code-global-claude-md-user-level。本文专门拆解「跨工作树本机共享」与「跨成员团队共享」的边界和落地做法。

一、先分清两层「共享」:同机跨工作树 vs 跨成员跨机器

大家搜「共享记忆」通常指两种完全不同的场景,官方机制对这两者的处理截然不同:

1. 同一台机器上的多会话 / 多工作树共享(自动生效)

当你用 claude --worktree 或 git worktree 同时开三四个并行分支改需求时(用法见 /guides/claude-code-worktree),官方明确说明:属于同一个 Git 仓库的所有工作树和子目录共用同一个自动记忆目录 ~/.claude/projects/<project>/memory/。

目录里有一个主索引 MEMORY.md 和若干按主题拆分的笔记文件。每次新开会话时,Claude Code 自动载入 MEMORY.md 的前 200 行(或前 25KB,以先到为准),其余主题文件在需要时按需读取。因此你在 A 分支纠正过一次「本仓库测试必须带某个环境变量」,切到同仓库的 B 工作树新开会话时,本机的 Claude 依然记得。

2. 团队成员之间的跨机器共享(必须进 Git)

自动记忆保存在你的系统用户主目录下,不在项目仓库里,也不会通过账号在云端同步给其他成员。想让全组所有人的 Claude Code 一拉代码就拥有相同的项目背景,官方指定的唯一共享通道就是随代码提交进 Git 的项目级指令文件。关于团队权限和插件的配套共享,可一并参考 /guides/claude-code-team-collaboration-shared-config。

二、团队项目记忆该怎么组织才不撑爆上下文

如果全组所有人都往根目录同一个 CLAUDE.md 里塞经验,不出一个月文件就会突破几百行,既拖慢每次启动消耗的额度,又容易出现前后矛盾的规则。按官方推荐的拆分方式,建议按「全局必读 + 目录按需」两层存放:

  1. 根目录 CLAUDE.md(控制在 200 行以内):只放全员每次改代码都绕不开的硬信息,例如包管理器与构建测试命令、分层架构红线、提交前必跑检查;
  2. **.claude/rules/.md(按业务域和路径懒加载)*:把只在特定模块才用得到的记忆拆成独立文件,并用 YAML 顶部的 paths 字段限定触发范围。

例如前端表单校验的历史踩坑,可以写进 .claude/rules/frontend-forms.md 并提交 Git:

markdown
---
paths:
  - "src/components/forms/**/*.tsx"
---

# 表单组件团队约定
- 统一使用项目封装的 `useAppForm` 钩子,不要直接裸调底层校验库
- 异步提交按钮必须绑定返回的 `isSubmitting` 状态防止重复点击

官方说明:不带 paths 的规则文件会在启动时同 CLAUDE.md 一起载入;带了 paths 的文件只有当 Claude 真正读取或编辑匹配路径下的文件时才载入上下文,非常适合沉淀大团队的模块级记忆。

把个人自动记忆沉淀为团队共享记忆

图:本站根据 Claude Code 官方文档:How Claude remembers your project 整理的示意图

三、怎么把个人 MEMORY.md 里的好经验转成团队共享记忆

为什么官方不设计成「所有人的自动记忆直接自动写进仓库」?因为自动记忆里混杂着大量个人偏好(比如某位成员习惯让模型用英文简短回答、或者本机临时连了某个测试端口),直接推给全组反而会互相干扰。

更合理的团队协作习惯是定期做一次「记忆提炼」:

  1. 打开 /memory 查看本机积累:检查当前项目自动记忆里最近记下的 feedback(纠偏)和 project(项目决策)条目;
  2. 区分个人习惯与项目事实:纯个人调试设置留在本机自动记忆或写进已加入 .gitignore 的 CLAUDE.local.md;凡是「新同事接手也会踩坑」的构建细节、接口约定,才需要升级为团队记忆;
  3. 明确指令写入仓库文件:在对话里对 Claude 说「把我自动记忆里关于数据库迁移的注意事项整理成两条精简规则,加到 .claude/rules/db.md」,提交 Pull Request 让队友审阅确认;
  4. 定期跑 /doctor prompt-audit 清理过期记忆:代码重构后旧记忆容易变成误导信息,运行该命令可以让 Claude 扫描仓库里的 CLAUDE.md 与 .claude/rules/,找出指向已删除文件或互相冲突的旧条目报告给你。

团队日常使用若涉及个人订阅开通或续费方案对比,也可查看 /chongzhi/claude-code 的官方订阅层级整理。

常见问题

Q:能用软链接或同步盘把 ~/.claude/projects/<project>/memory/ 强行全组同步吗?

不建议这样做。多人同时在不同机器会话里触发自动记忆写入,极易造成 MEMORY.md 覆盖冲突,而且会把别人的个人角色设定(user 类笔记)混进你的会话。团队共享请始终走 Git 仓库里的 CLAUDE.md 和 .claude/rules/。

Q:某个项目不想让 Claude 往本机写自动记忆,怎么关掉?

如果全组希望某个敏感仓库统一关闭自动记忆,可以在项目共享的 .claude/settings.json 里加上 "autoMemoryEnabled": false,这样所有拉取该仓库的成员在该项目下都不会生成本机自动记忆文件。

Q:公司所有仓库都要遵守同一套安全或合规底线,每个仓库拷一份 CLAUDE.md 太麻烦怎么办?

官方支持组织级(Managed policy)CLAUDE.md,由企业 IT 统一部署到系统级固定路径(如 macOS 的 /Library/Application Support/ClaudeCode/CLAUDE.md 或 Windows 的 C:\Program Files\ClaudeCode\CLAUDE.md),对机上所有项目自动生效。

相关教程

参考资料

  • 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 条评论

登录 后参与评论

还没有评论,来抢沙发~