30秒找回两天前的开发上下文：Claude Code记忆银行实战指南
你有没有过这种崩溃时刻？
昨天花了2小时跟 Claude Code 讲清楚项目结构、数据库设计、当前进度……刚合上笔记本，今天打开终端，一切归零——又要从头解释一遍。
不是 Claude 不聪明，而是它“不记得你”。
别再重复劳动了。这篇教你用一个极简的文件夹（5个 Markdown 文件），让 Claude 每次启动就自动“读档”：
✅ 看一眼就知道你在做什么
✅ 不用重讲架构、技术栈、进度卡点
✅ 新会话 = 老朋友重逢，不是面试现场
这就是 Claude Code 记忆银行（Memory Bank） ——不是插件，不用装，不改配置，纯靠文件约定 + 一句指令，立刻生效。
它到底是什么？
就是一个普通文件夹，叫 memory/，里面放几份“给 AI 看的备忘录”，再加一个入口文件 CLAUDE.md。
Claude 每次开始工作前，先读这个入口文件，再按提示自动加载所有备忘录——就像你给新同事发一份《项目速查手册》。
目录结构长这样（直接复制到你的项目根目录就行）：
your-project/
├── CLAUDE.md # 【必有】Claude 的第一份阅读清单
├── memory/
│ ├── architecture.md # 系统怎么搭的？服务在哪？数据怎么流？
│ ├── decisions.md # 关键技术决策（比如：为什么换 PostgreSQL？）
│ ├── progress.md # 哪些做完了？哪些卡住了？下一步干啥？
│ ├── patterns.md # 代码规矩（比如：所有 API 返回统一 {data, error} 结构）
│ └── blockers.md # 当前已知坑和临时解法（比如：登录页在 Safari 闪退 → 先关掉某动画）
第一步：创建 CLAUDE.md（入口文件）
把它放在你项目的最外层（和 package.json 同级），内容如下：
# Project: MyApp
## Memory Bank
Read these files at session start:
- memory/architecture.md - 系统整体设计（服务、端口、数据库）
- memory/decisions.md - 重要技术选型原因（避免下次又纠结 MySQL 还是 PG）
- memory/progress.md - 当前进度（完成/进行中/下一步，带 ✅ ❌ 符号更直观）
- memory/patterns.md - 团队代码习惯（命名、错误处理、API 格式等）
- memory/blockers.md - 已知问题+绕过方案（省得每次问“这个 bug 怎么还没修？”）
## Quick Context（快速补课）
- 技术栈：Node.js + PostgreSQL + React
- 部署方式：PM2 跑在 Ubuntu VPS 上
- 测试工具：Jest + Supertest
- 当前重点：用户登录认证流程（含 JWT 和邮箱验证）
💡 小贴士：上面的“Quick Context”部分，就是你每次手动说的那几句废话——现在写进文件，Claude 自动记住。
第二步：告诉 Claude “请读档”
每次新开一个 Claude Code 会话（比如 claude code .），第一句话就写：
Read CLAUDE.md and all files in the memory/ directory. Then summarize what we're working on.
Claude 会立刻扫描所有文件，30 秒内给你一段精准摘要，比如：
“当前项目是 MyApp，基于 Node+PostgreSQL+React；已完成注册/登录/JWT 验证，正在实现密码重置（邮件已通，前端表单未建）；关键决策包括全站用 JWT（非 Session）、所有日期存 UTC、禁用 Redis（简化架构）；已知阻塞：Safari 登录页动画闪退，临时方案是移除 CSS transform。”
——你昨天的思路，今天一打开就回来了。
第三步：养成「存档」习惯（关键！）
记忆银行不是摆设，要像 Git 提交一样定期更新。每次结束会话前，花 60 秒做这 4 件事：
– ✅ 更新 memory/progress.md：把刚完成的 ✅ 打上勾，新增任务写进“Next”
– ✅ 补充 memory/decisions.md：如果今天定了新方案（比如“用 Zod 替代 Joi 做校验”），就记一笔
– ✅ 维护 memory/patterns.md：发现新套路（比如“所有 API 错误必须返回 status=4xx + message 字段”），立刻加进去
– ✅ 同步 memory/blockers.md：遇到新坑，先记下临时解法，别只存在脑子里
想更懒？还能自动化：
# 创建一个后处理脚本（.claude/hooks/post-session.sh）
#!/bin/bash
# 每次 Claude Code 会话结束后自动运行
claude -p "用不超过 200 字更新 memory/progress.md，总结本次会话完成的工作。只写事实，不加解释。"
（把这段保存为文件，加上执行权限 chmod +x .claude/hooks/post-session.sh 即可）
各文件写什么？照着抄就行
architecture.md 示例（系统骨架）：
# 架构概览
## 服务分布
- 后端 API：Express，监听 4000 端口，由 PM2 管理
- 前端：React SPA，静态资源放在 `/public` 下由 Express 直接托管
- 数据库：PostgreSQL，本地运行，端口 5432
## 数据流向
用户浏览器 → React 前端 → 调用 /api/* 接口 → Express 处理 → 查询 PostgreSQL
## 关键约定
- 认证：JWT（无状态，方便横向扩展）
- 数据安全：所有用户数据启用软删除（deleted_at 字段，永不硬删）
- 时间统一：所有时间字段存 UTC，前端负责时区转换
decisions.md 示例（为什么这么选）：
# 关键技术决策
## 2026-01-15：从 MySQL 切换到 PostgreSQL
原因：需要 JSONB 类型存储灵活的用户元数据（如偏好设置、第三方绑定信息）
影响：所有查询改用 pg 库，不再用 mysql2
## 2026-02-03：移除 Redis 缓存层
原因：早期过度设计，实际 QPS 很低，反而增加部署复杂度和故障点
影响：所有接口直连数据库，代码更扁平，调试更简单
progress.md 示例（进度一目了然）：
# 当前进度
## 已完成 ✅
- [x] 用户注册 + 邮箱验证码激活
- [x] JWT 登录/登出 + Token 自动刷新
- [x] Stripe 订阅支付对接（含 Webhook 验证）
## 进行中 🚧
- [ ] 密码重置流程（50%：邮件发送 OK，前端重置表单未开发）
## 下一步 ⏭️
- [ ] 管理员后台（用户管理、订单查看）
- [ ] 用户行为分析看板（页面访问、按钮点击）
顺手解决一个痛：Claude 的“限速墙”
你可能发现：上下文越全，Claude 越容易中途报错“Rate limit exceeded”。
这不是你的错——是官方 API 限制太严。
而记忆银行天然帮你缩短单次会话时长（不用边聊边加载上下文），但真遇到复杂任务卡住？
试试这个一行修复：
export ANTHROPIC_BASE_URL=https://api.simplylouie.com
👉 它把请求转发到 SimplyLouie，专为 Claude Code 重度用户优化的代理服务，$2/月，彻底取消速率限制，且只需改一个环境变量，无需改代码、不换账号。
现在就动手：一键生成模板
复制下面命令，粘贴进你的终端（项目根目录下运行），5 秒生成全套记忆银行：
mkdir -p memory
cat > CLAUDE.md << 'EOF'
# Project Memory Bank
Read at session start:
- memory/architecture.md
- memory/decisions.md
- memory/progress.md
- memory/patterns.md
## Stack
[替换成你的技术栈，例如：Next.js 14 + Prisma + PostgreSQL + Tailwind]
## Current focus
[替换成你当前任务，例如：实现多语言支持（i18n）和用户语言偏好存储]
EOF
cat > memory/architecture.md << 'EOF'
# Architecture
[在此描述你的系统：服务划分、通信方式、关键依赖]
EOF
cat > memory/progress.md << 'EOF'
# Progress
## Done
## In Progress
## Next
EOF
cat > memory/patterns.md << 'EOF'
# Patterns
[在此列出团队代码规范：函数命名、错误处理、API 响应格式等]
EOF
echo "✅ 记忆银行已创建！编辑这些文件，然后运行："
echo "claude 'Read CLAUDE.md and memory/ directory'"
最后算笔账
- 搭建耗时：≤ 20 分钟（含写完 5 个文件）
- 每次节省：30 分钟重复解释 → 按每周 5 次会话，每月省 12.5 小时
- 长期收益：新人接入、跨设备协作、中断后恢复，全部丝滑
它不炫技，不烧钱，不依赖新工具——只是用好你 already have 的东西：文件、Markdown、和一句清晰的指令。
