Appearance
Claude Code深度进阶：记忆系统与并行开发完整指南
Claude Code 的记忆系统不是传统「记住你是谁」的人格记忆，而是面向工程协作的项目记忆层。掌握它，你的 AI 助手会越来越懂你的项目。
一、主动记忆系统：CLAUDE.md
1.1 CLAUDE.md 是最核心的「显式记忆」
CLAUDE.md 是一个 Markdown 文件，Claude Code 在每次会话开始时读取，用来保存你希望它长期遵守的项目规则：
- 构建和测试命令
- 代码规范
- 项目架构约定
- 命名规则
- 固定工作流
1.2 作用域分层
| 位置 | 作用范围 | 用途 |
|---|---|---|
| 项目根目录/CLAUDE.md | 当前项目 | ⭐ 最常用 项目专属配置 |
| ~/.claude/CLAUDE.md | 所有项目 | 个人全局偏好设置 |
| 子目录/CLAUDE.md | 该子目录 | 模块级别的特殊配置 |
优先级：全局 → 项目根目录 → 子目录，内容叠加生效。
1.3 细粒度规则管理
除了顶层 CLAUDE.md，还支持：
.claude/rules/— 按目录、文件类型、主题拆分规则@path/to/file— 在 CLAUDE.md 里导入别的文件- 兼容已有
AGENTS.md
1.4 怎么写才有效
官方建议：
- 控制在 200 行以内
- 每条规则问自己：「去掉这条，Claude 会出错吗？」不会就删
- 反复纠正过两次的事情，就应该写进去
- 太长就拆到
.claude/rules/或导入文件里
1.5 创建与编辑方法
- 手动创建、编辑
/memory命令快速打开- 命令行输入
#快速添加规则 /init自动生成
二、被动记忆系统：auto memory
2.1 auto memory 是「隐式记忆」
Claude Code 会根据你的纠正、偏好、反复出现的模式，自动记下一些 learnings：
- 常用构建命令（如反复用
pnpm dev） - 项目结构理解（如
/src/api放接口） - 你对它的纠正（如「不要用 class，用函数组件」）
- 调试结论（如「这个错误是因为 env 没加载」）
关键点：它不会什么都记，只记「重复 + 明确」的东西。
2.2 如何训练 auto memory
方法1：重复 + 明确纠正
不要使用 class component，一律用 React function component然后纠正 2~3 次，它就会把这条当成「稳定偏好」记下来。
方法2：固定工作流
多做几次相同的流程，Claude 会自动优先用这个流程。
方法3：让它总结
把我们刚才的开发约定总结一下，作为以后默认规则方法4：把调试结论变成记忆
记住：Vite 在 build 时不会自动加载 .env.production，需要手动指定2.3 什么情况下不会记
- ❌ 一次性对话：只说一次的东西不记
- ❌ 太模糊：「代码写好一点」完全不会记
- ❌ 高频但不稳定：一会儿用 npm，一会儿用 pnpm，不会形成记忆
2.4 auto memory vs CLAUDE.md
| 对比 | auto memory | CLAUDE.md |
|---|---|---|
| 可见性 | 不可见 | 可见可编辑 |
| 控制权 | 系统自动 | 你手动控制 |
| 用途 | 习惯训练 | 规则锁定 |
结论：重要规则写进 CLAUDE.md，使用习惯交给 auto memory。
2.5 auto memory 存放路径
~/.claude/memory/
├── MEMORY.md # 内存索引文件
├── user_identity.md # 习惯信息
└── *.md # 各类记忆文件三、权限模式切换
通过快捷键（Shift+Tab 或 Alt+m）切换三种模式：
3.1 自动编辑模式
免确认批量操作，适合无需逐次确认的文件创建、修改。
3.2 Plan 模式
只规划不执行。面对复杂问题时，先梳理方案框架，确认后再动手。
3.3 Yolo 模式
bash
claude --dangerously-skip-permissions最高权限，完全放手，适合重构代码、启动新项目或修复复杂 bug。
四、worktree 多任务并行开发
4.1 核心思路
「一个任务一个 worktree + 一个 Claude 会话」，每个任务都有自己的文件状态和分支，不会互相覆盖。
4.2 使用命令
bash
# 开新 worktree
git worktree add ../app-login-refactor -b feature/login-refactor
# 查看已有 worktree
git worktree list
# 删除 worktree
git worktree remove ../app-login-refactor
# 清理失效记录
git worktree prune4.3 并行开发示例
bash
# 终端1：登录功能
cd ../app-login
claude
# 终端2：崩溃修复
cd ../app-crash-fix
claude
# 终端3：网络层重构
cd ../app-network-refactor
claude4.4 最佳实践
- 一个 worktree 只做一件事
- 目录名和分支名对应
- 在 worktree 内单独跑构建和测试
五、subagents 单任务内部分工
5.1 创建 agent
bash
/agents
# 选择 Create new agent
# 选择项目级别或全局级别
# 输入 agent 描述
# 配置权限
# 选择模型
# 选择颜色
# 配置记忆空间5.2 subagents vs skills
| 对比 | subagents | skills |
|---|---|---|
| 本质 | 独立的小 Agent | 能力模块 |
| 特点 | 有角色定位、行为规则 | 只执行，不做决策 |
| 类比 | 人（专家） | 技能（能力） |
例子：
- Subagents：架构师、性能专家、Bug 专家
- Skills：Log 分析、内存分析、代码生成
六、Skills 技能管理
6.1 查看可用 Skills
列出全局的 skills 和该项目下的 skills6.2 控制模型调用
在 SKILL.md 文件中：
yaml
disable-model-invocation: true # 模型禁止调用
disable-model-invocation: false # 模型可以调用6.3 控制是否出现在 / 命令中
yaml
user-invocable: true # 出现在 / 命令中
user-invocable: false # 不出现七、会话管理
7.1 暂停与回滚
- 按 ESC 键停止当前操作
- 按两次 ESC 查看历史对话节点
- 说「回滚到上次的代码」自动回滚
7.2 上下文溢出
当提示「Context left until auto-compact: 3%」时：
bash
/compact手动压缩上下文，续命继续工作。
7.3 恢复历史对话
bash
claude -c # 直接进入上次对话
claude -r # 打开历史对话记录八、升级
bash
# 直接升级
claude update
# npm 方式
npm update -g @anthropic-ai/claude-code
# 强制最新
npm install -g @anthropic-ai/claude-code@latest总结
| 模块 | 核心要点 |
|---|---|
| 记忆系统 | CLAUDE.md 显式记忆 + auto memory 隐式记忆 |
| 权限模式 | 自动编辑 / Plan / Yolo 三种模式 |
| 并行开发 | git worktree + 多终端 + 多会话 |
| 分工协作 | subagents 扮演专家，skills 提供能力 |
| 会话管理 | ESC 暂停、/compact 压缩、-r 恢复 |
掌握这些进阶功能，Claude Code 不只是写代码的助手，而是真正能理解项目、持续进化、并行协作的 AI 团队成员。
关键词：Claude Code进阶, CLAUDE.md配置, auto memory自动记忆, git worktree并行开发, subagents子代理, skills技能, 权限模式
