[claude code] 06 高级篇：记忆系统与工作流优化

06 高级篇记忆系统与工作流优化让 Claude Code 跨会话记住你的偏好优化工作流榨干每一分 token。6.1 记忆系统架构Claude Code 的记忆系统由多个层次组成CLAUDE.md 文件持久化手动/自动 ├── 全局 ~/.claude/CLAUDE.md ├── 项目 CLAUDE.md ├── 项目 CLAUDE.local.md └── 子目录 CLAUDE.md Rules 规则文件持久化条件加载 ├── ~/.claude/rules/*.md └── .claude/rules/*.md Auto Memory自动记忆 └── ~/.claude/projects/project/memory/*.md 对话上下文临时会话内 └── 当前对话的完整历史记忆加载优先级全局 CLAUDE.md始终加载项目 CLAUDE.md CLAUDE.local.md项目工作时加载子目录 CLAUDE.md访问目录时加载Rules 规则文件按条件加载Auto Memory 文件新会话启动时加载对话上下文当前会话6.2 Auto Memory 自动记忆Claude Code 会在对话过程中自动学习你的偏好并保存到记忆文件中。记忆文件位置~/.claude/projects/project-hash/memory/ ├── MEMORY.md # 记忆索引 ├── user_role.md # 用户角色信息 ├── feedback_testing.md # 反馈记忆 ├── project_status.md # 项目状态 └── reference_links.md # 外部引用四种记忆类型类型用途何时保存示例user用户角色、偏好、知识了解用户信息时“用户是后端工程师熟悉 Python”feedback用户反馈的规则被纠正或确认时“不要在测试中 Mock 数据库”project项目状态和决策了解项目进展时“认证模块正在重写”reference外部资源指针发现外部系统时“Bug 追踪在 Linear INGEST 项目”记忆文件格式--- name: feedback_testing description: 测试相关的用户反馈规则 type: feedback --- 集成测试必须使用真实数据库不要 Mock。 **Why:** 上季度 Mock 测试通过但生产迁移失败造成事故。 **How to apply:** 涉及数据库操作的测试使用测试数据库而非 Mock。MEMORY.md 索引文件# Memory Index - [User Role](user_role.md) — 后端工程师Python 专家 - [Testing Feedback](feedback_testing.md) — 测试必须用真实数据库 - [Project Status](project_status.md) — 认证模块重写中 - [References](reference_links.md) — 外部系统链接最佳实践记忆文件保持简洁每条不超过 150 字MEMORY.md 索引不超过 200 行定期清理过时的记忆不要在记忆中存储可从代码推导的信息6.3 /memory 命令在对话中直接管理记忆# 打开记忆文件编辑/memory# 让 Claude 记住某件事记住这个项目用 poetry 管理依赖不用 pip# 让 Claude 忘记某件事忘记之前关于测试框架的偏好什么值得记忆值得记忆不值得记忆用户偏好和反馈代码模式可从代码推导项目决策和原因Git 历史可从 git log 获取外部系统引用文件路径可从项目结构推导非显而易见的约定临时任务状态6.4 上下文压缩策略上下文生命周期正常 (0-87%) → AutoCompact (~87%) → 强制压缩 (90-95%) → 硬限制 (100%)AutoCompactClaude 自动压缩旧对话保留关键信息强制压缩更激进的压缩可能丢失细节硬限制对话被阻塞必须压缩或清空手动压缩技巧# 基本压缩/compact# 保留特定内容/compact 保留数据库 schema 和 API 接口定义# 压缩并指定重点/compact 重点保留1)认证流程2)错误处理方案3)待办事项上下文优化策略策略操作效果任务隔离一个对话一个任务减少无关上下文及时压缩每 30 分钟/compact保持上下文新鲜精确引用用file代替让 Claude 搜索减少搜索开销清空重启切换任务时/clear彻底释放上下文子代理分流搜索任务交给子代理保护主上下文6.5 工作流优化技巧技巧一任务分解大型任务分解为小步骤逐步完成# 差一次性要求太多 重构整个认证模块添加 OAuth2、JWT、2FA 支持 # 好分步执行 第一步分析现有认证模块的结构 完成后 第二步设计新的认证架构 完成后 第三步实现 OAuth2 支持 完成后 ...技巧二计划模式先行大型变更前先用计划模式规划 /plan 重构认证模块 # Claude 输出计划后审查确认 # 然后切换到执行模式技巧三利用 TodoWrite 跟踪进度 帮我完成以下任务用 todo 跟踪进度 1. 添加用户注册 API 2. 添加邮箱验证 3. 编写注册流程测试 4. 更新 API 文档技巧四管道模式批量处理# 批量代码审查forfileinsrc/api/*.py;doclaude-p审查 $file的安全问题review-report.mddone# 批量生成测试forfileinsrc/*.py;doclaude-p为 $file生成单元测试tests/test_$(basename$file)done技巧五非交互模式集成 CI# 在 CI 中运行 Claude Codeclaude-p检查最近的提交是否有安全问题--output-format json# 自动生成变更日志claude-p根据 git log 生成变更日志--output-format textCHANGELOG.md6.6 性能与成本优化Token 节省策略策略节省量操作精简 CLAUDE.md10-20%控制在 100 行以内用 引用代替搜索5-15%明确指定文件路径及时 /compact15-30%防止上下文膨胀简单任务用 Haiku50-80%按任务复杂度选模型子代理分流10-20%搜索任务交给子代理模型选择与成本模型输入成本输出成本适用场景Haiku最低最低简单查询、格式化Sonnet中等中等日常开发默认Opus最高最高复杂推理、架构设计/cost 监控# 查看当前会话的 token 使用和成本/cost上下文检查# 查看上下文使用情况和优化建议/context6.7 高级工作流模式模式一TDD 驱动开发 先写测试用户注册 API 的测试用例 测试写完后 实现让测试通过的代码 实现完后 运行测试修复失败的用例 重构代码确保测试仍然通过模式二代码审查循环 审查 src/auth.py列出所有问题 修复 Critical 级别的问题 修复 Warning 级别的问题 再次审查确认所有问题已解决模式三渐进式重构 分析 src/ 目录的代码质量给出重构优先级 按优先级 重构第一个模块确保测试通过 重构第二个模块确保测试通过 ...模式四文档驱动开发 先设计 API 接口文档 文档确认后 根据文档实现 API 根据文档编写测试 验证实现与文档一致6.8 小结概念关键要点记忆系统CLAUDE.md Rules Auto Memory 三层Auto Memory自动学习偏好四种类型/memory手动管理记忆上下文管理定期 /compact任务切换 /clear工作流优化任务分解、计划先行、TodoWrite 跟踪成本优化精简 CLAUDE.md、 引用、按需选模型上一篇05 实战篇MCP 服务器与技能扩展下一篇07 速查手册命令与快捷键