Claude Code 使用手册 · 第 3 章 记忆系统

Claude Code 使用手册 · 第 3 章 记忆系统

章节摘要:记忆让上下文跨会话持久化,核心载体是 CLAUDE.md,按范围分四级:受管策略(组织级)→ 项目(./CLAUDE.md)→ 目录(子目录/CLAUDE.md)→ 用户(~/.claude/CLAUDE.md),规则就近优先。操作入口有三个:/init(生成项目 CLAUDE.md)、/memory(记忆编辑器)、#(输入前加 # 快速写一条规则)。本章精读三个模板(项目/个人/目录),并给出原书经验的黄金法则:LLM 无状态、少即是多(150-200 条指令上限)、只放通用信息、不把 Claude 当 lint 工具、绝不自动生成。本章共 3 节。

解剖坐标

一句话主线:记忆的物理载体只有一种(CLAUDE.md),作用范围分四级 → 用模板快速起步 → 用黄金法则保证质量。

学习目标

阅读完本章,你应当能够:

1. 背出记忆的四级层级与就近优先规则,说出三个操作入口。
2. 说出目录级记忆的"拼接而非覆盖"特性与 Auto Memory 的加载方式。
3. 复述项目/个人/目录三个模板的章节结构,能照抄改造。
4. 背出 CLAUDE.md 黄金法则至少四条(150-200 指令上限/只放通用/不自动生成等)。
5. 说出记忆最佳实践的应做与不做清单。

子章节导航

01 记忆的载体与四级层级

CLAUDE.md 四级范围(受管策略/项目/目录/用户);三个操作入口(/init、/memory、# 快捷写入);目录级拼接加载;Auto Memory 自动查找与 claudeMdExcludes 排除。

02 三个记忆模板精读

项目级(虚构电商项目:架构/开发规范/Git 工作流/测试/API/数据库/部署/联系人/已知问题);个人级(虚构 8 年全栈开发者:代码偏好/调试偏好/沟通方式/工具链);目录级(API 模块:校验/认证/响应格式/分页/限流/缓存)——均可照抄改造。

03 CLAUDE.md 的黄金法则与最佳实践

LLM 无状态/150-200 条指令上限(系统提示词占约 50)/少即是多/只放通用信息/不把 Claude 当 lint 工具/绝不自动生成;质量约束(<300 行、无风格规则、无任务说明、不重复 README);反模式清单;应做与不做。

前置知识与后续延伸

前置知识:第 1 章三种交互方式(记忆的写入入口涉及斜杠命令)。

后续延伸:第 4 章技能的 claude-md 技能——它是 CLAUDE.md 写作的最佳实践专家,与本章互为表里。