---

Claude Code 官方文档里有一页专门讲「Claude 如何记住你的项目」。每个会话都从空白上下文开始，跨会话传递知识靠两个机制：

1. **CLAUDE.md 文件**：你写的持久指令
2. **Auto memory**：Claude 根据你的纠正和偏好，自己写的笔记

---

## 一、一个关键区分：记忆是上下文，不是配置

文档里有一句容易被忽略但至关重要的话：

> Claude 把指令当上下文，不是强制配置。要阻止某个动作，用 PreToolUse hook。

这意味着 CLAUDE.md 写得再好，Claude 也可能不遵守——它是在「读」指令，不是在「执行」规则。**写得越具体越简洁，遵守率越高。** 这是设计哲学的根本区别。

---

## 二、CLAUDE.md 的加载层级

文件可以放在多个位置，按从广到专的顺序加载：

| 位置 | 范围 | 用途 |
|------|------|------|
| `/Library/Application Support/ClaudeCode/CLAUDE.md` | 全组织（IT 管理） | 编码标准、安全策略、合规要求 |
| `~/.claude/CLAUDE.md` | 你（所有项目） | 个人偏好、工具快捷键 |
| `./CLAUDE.md` | 项目（团队共享） | 项目架构、构建命令、工作流 |
| `./CLAUDE.local.md` | 你（当前项目，gitignore） | 沙箱 URL、个人测试数据 |

大项目可以用 `.claude/rules/` 做路径级规则——指令只在 Claude 处理匹配文件时加载，控制上下文消耗。

---

## 三、什么时候该写进 CLAUDE.md

文档给了一个很实用的启发式清单：

- Claude **第二次犯同一个错**时
- 代码审查发现 Claude 本该知道的项目知识时
- 你在聊天里输入了**和上次一样的纠正**时
- 一个新同事需要这些上下文才能干活时

反过来说：多步骤流程、只影响代码库一部分的内容，应该放到 skill 或路径规则里，别塞进 CLAUDE.md。

---

## 四、写作规范：200 行红线

CLAUDE.md 每个会话开头都进上下文窗口，占用 token。三个原则：

- **长度**：目标 200 行以内。更长 = 更多上下文消耗 + 更低遵守率
- **结构**：markdown 标题和 bullet 分组。Claude 扫描结构的方式和读者一样
- **具体性**：写「用 2 空格缩进」，不写「规范格式化代码」——具体到可验证

`/init` 可以自动生成起点：Claude 分析代码库，产出构建命令、测试说明、项目约定。

---

## 五、Auto memory：Claude 自己记笔记

第二个机制是自动记忆——**Claude 根据你的纠正写笔记**：

| | CLAUDE.md | Auto memory |
|--|-----------|-------------|
| 谁写 | 你 | Claude |
| 内容 | 指令和规则 | 学习到的模式 |
| 范围 | 项目/用户/组织 | 每仓库 |
| 加载 | 每会话全部 | 每会话（前 200 行或 25KB） |

用 `/memory` 查看和编辑。子 Agent 也可以维护自己的自动记忆。

它捕捉的是「项目上下文里代码推不出来的东西」：你的偏好、你反复给的纠正。写指令靠人，学习靠模型自己。

---

## 结语

Agent 的「记忆」正在形成标准范式：**人写持久指令，模型自动积累学习**。CLAUDE.md 是前者——分层、限长、具体可验证；auto memory 是后者——从纠正中长出来，可审计可编辑。

值得记住的是那个根本区分：这些是上下文，不是代码。想让 Agent 可靠地遵守规则，记忆只是辅助，hook 才是保证。


Claude Code 官方文档里有一页专门讲「Claude 如何记住你的项目」。每个会话都从空白上下文开始，跨会话传递知识靠两个机制：

Claude Code 的记忆机制：CLAUDE.md 分层指令 + 自动记忆

Claude Code 官方文档里有一页专门讲「Claude 如何记住你的项目」。每个会话都从空白上下文开始，跨会话传递知识靠两个机制： 1. CLAUDE.md 文件：你写的持久指令

软件研发

编程语言

人工智能

开发工具

ClaudeCode记忆机制核心：CLAUDE.md是分层加载的持久指令，按全组织、用户、项目、本地四层从广到专生效，需控制在200行内且具体可验证；Automemory由模型根据用户纠正自动生成偏好笔记。两者均为上下文而非配置，可靠执行规则依赖PreToolUse hook而非记忆。

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Claude Code 的记忆机制：CLAUDE.md 分层指令 + 自动记忆-腾讯云开发者社区-腾讯云

Claude Code 的记忆机制：CLAUDE.md 分层指令 + 自动记忆

Claude Code 的记忆机制：CLAUDE.md 分层指令 + 自动记忆

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐