Claude Code 记忆与上下文机制详解¶

┌─────────────────────────────────────────────────┐
│                每次对话开始                        │
│                                                   │
│  自动加载 ─┬─ CLAUDE.md（规则指令）    ← 每次消耗  │
│            └─ MEMORY.md（索引）        ← 很小     │
│                                                   │
│  按需读取 ─┬─ 记忆文件（*.md）        ← 相关时读   │
│            ├─ recent.md（每日记录）    ← 规则触发   │
│            └─ 项目文件（代码/文档）    ← 任务需要   │
│                                                   │
│  对话进行中                                        │
│            ├─ 用户消息                              │
│            ├─ 工具调用结果                           │
│            └─ Claude 回复                           │
│                │                                   │
│                ▼ 上下文接近窗口上限时                 │
│            旧消息被压缩（丢失细节）                   │
│                                                   │
│  对话结束 ── 一切消失，除非写入了文件                 │
└─────────────────────────────────────────────────┘

# 好的 — 按主题拆分，只读需要的
memory/
├── reference_openclaw.md      # 只在问 OpenClaw 时读
├── reference_shennong.md      # 只在问神农时读
└── user_security_learner.md   # 只在需要了解用户背景时读

# 坏的 — 全部塞一个文件
memory/
└── everything.md              # 每次都要读完

daily/
├── recent.md           # ≤ 7 天，每次对话读取
└── archive/2026-04.md  # 旧数据，不自动读取

# 好的 — 说你要什么
"把 UserService 的数据库查询改成批量获取，减少 N+1 问题"

# 差的 — 手把手教步骤
"打开 user_service.py，找到第 42 行，把 for 循环改成..."

# 好的 — 完整堆栈
"运行 pytest 报错：
  File 'tests/test_api.py', line 23
  AssertionError: expected 200, got 403
  ..."

# 差的 — 模糊描述
"测试跑不过"

看一下 @src/auth/middleware.ts 里的鉴权逻辑有没有绕过风险

# 好的 — 有验收标准
"添加分页功能，要求：测试通过、和现有 handler 风格一致、支持 limit/offset 参数"

# 差的 — 开放式
"加个分页"

# 好的 — 精确纠正
"这样改会破坏公开 API，保持函数签名不变，只改内部实现"

# 差的 — 重新描述整个需求