返回博客
claude-codememoryhow-toclaude-mdcontext

Claude Code 记忆:跨会话保留上下文(CLAUDE.md)

Claude Code 记忆怎么工作:CLAUDE.md 存你写的规则,自动记忆存 Claude 自己记的笔记,每次启动都会加载。各自存在哪、该用哪个。

C
Crewly Team
阅读约 4 分钟
分享

目录

Claude Code 的记忆靠两样东西,每次会话开始时都会加载。CLAUDE.md 存你写的指令。自动记忆存 Claude 根据你的纠正自己写的笔记。新会话从空的上下文窗口开始,你之前说过的其他话不会在里面。claude --continue 或 claude --resume 可以重新打开旧对话,但进入全新会话的只有 CLAUDE.md 和自动记忆。

CLAUDE.md 文件自动记忆
谁来写你Claude
存什么指令和规则学到的经验和模式
范围项目、用户或组织每个仓库,各 worktree 共用
何时加载每个会话每个会话(前 200 行或 25KB)

来源:Claude Code 记忆文档,2026 年 10 月 9 日读取。Claude 把两者都当作上下文,而不是强制配置。

新会话里能带过去的东西:CLAUDE.md 和自动记忆新会话里能带过去的东西:CLAUDE.md 和自动记忆

CLAUDE.md:你总在重复的规则

  • 控制在 200 行以内。 文件越长,占用的上下文越多,遵守程度越低。只适用于部分代码的规则,放进 .claude/rules/,只有 Claude 处理匹配文件时才加载。
  • 导入只是整理,不会变短。 用 @path/to/file 导入的文件同样在启动时加载。
  • 写具体。 指令越简洁具体,Claude 越能稳定地遵守。

自动记忆:Claude 自己写的笔记

每个项目有一个 ~/.claude/projects/<project>/memory/,里面是 MEMORY.md 索引,加每个主题一个文件。

  • 只在本机。 同一 git 仓库的所有 worktree 共用;其他机器不共享。
  • 索引有上限。 MEMORY.md 只加载前 200 行或 25KB。每条记忆一行,细节放主题文件。
  • 你可以查看和修改。 文件是普通 Markdown。/memory 会列出它们,并有开关。

怎么选

你想要……用
固定构建和测试命令、约定、禁碰的文件夹CLAUDE.md
让 Claude 记住你纠正过一次的事自动记忆
只对部分文件夹生效的规则.claude/rules/ 里的文件
和队友共享规则提交项目的 CLAUDE.md(自动记忆留在你的机器上)
保证某件事绝不发生PreToolUse hook,不要靠记忆
共享多个 agent 在同一项目里学到的东西Crewly 的 remember 和 recall(见下)

五分钟设置

  1. 在项目根目录写一个简短的 CLAUDE.md:构建命令、测试命令、约定、禁碰的文件夹。
  2. 运行 /memory,确认 CLAUDE.md 在列表里,自动记忆是开着的。
  3. 用大白话纠正 Claude 一次,比如“这个仓库用 check 脚本跑测试,不是 test”,然后去记忆文件夹里看有没有保存的笔记。
  4. 一周后打开 MEMORY.md,删掉过时的行,合并重复的。

当你运行多个 agent

CLAUDE.md 和自动记忆默认是一个人、一个会话。我们做的开源工具 Crewly 为 agent 团队加了两个技能。remember 保存一条笔记,范围是 agent(个人)或 project(项目内所有 agent 共享)。recall 搜索已保存的笔记。新决定可以用 --supersedes 指明它取代了哪一条旧决定,这样 agent 不会再把旧的当作现行答案。它不取代 CLAUDE.md。搭建方法见:如何在 Claude Code 里运行多个 agent。

常见问题

Claude Code 会在会话之间记住东西吗?

会,靠两种机制:你写的 CLAUDE.md,和 Claude 自己写的自动记忆。两者都在每次新对话开始时加载。进入全新会话的只有它们;想接着旧对话,用 claude --continue 或 --resume。

Claude Code 的自动记忆存在哪里?

在 ~/.claude/projects/<project>/memory/,里面有 MEMORY.md 索引。它只在本机,同一仓库的所有 worktree 共用。

MEMORY.md 能有多大?

每次对话开始时加载前 200 行或 25KB。超出的部分不会加载,所以每条记忆写一行。

来源

How Claude remembers your project,2026 年 10 月 9 日读取。Crewly 记忆:Crewly 仓库中 remember 和 recall 的技能定义,2026 年 10 月 9 日核对。

准备好编排你的 AI 团队了吗?

开始使用 Crewly,把多个 Claude Code、Codex 或 Antigravity agent 组成一支协同工作的团队来运行。

curl -fsSL https://crewlyai.com/install.sh | bash阅读文档 →

然后打开一个新的终端,运行:

crewly start

相关文章