all articles
dev · ZH

Claude Code 上下文管理最佳实践

Nov 20, 2026·6 min read·by Mr Panda·0 阅读

Claude Code 上下文管理最佳实践

你跟 Claude Code 聊了两个小时,修了三个 bug,加了一个功能,中间还顺手查了一次 Stripe 的报错。然后你发现——它开始忘事了。刚定好的约定被推翻,改过的文件又被改回去,回答越来越绕。

问题出在上下文身上,模型本身没变笨。

上下文窗口是 Claude Code 唯一的工作记忆。窗口里塞了什么,它就按什么来思考。试错记录、几千行的工具输出、已经过时的方案,全都会占位置,也全都会干扰判断。很多人的第一反应是“把上下文全部转储到一个 Markdown 文档里,下次再喂回去”。

这基本行不通。


一、Claude Code 自己会存什么

先搞清楚它已经替你做了哪些持久化,才知道还缺什么。

机制 自动吗 存了什么 位置
会话记录 全自动 每次对话的完整记录,包括消息和工具调用 ~/.claude/projects/<项目>/*.jsonl
自动记忆(auto memory) 半自动,由 Claude 判断要不要记 零散的事实、偏好和约定 ~/.claude/projects/<项目>/memory/
CLAUDE.md 手动 项目规则和说明 项目根目录或 ~/.claude/
上下文压缩 自动 长对话早期内容的摘要 只在当前会话内,不落盘

几个容易误解的地方:

  • 会话记录能恢复,但不会被“记住”。 claude --continue 接着上一次,claude --resume 从历史里选一个。新开的会话不会主动读这些记录。
  • 自动记忆只记结论,不记过程。 你纠正过的做法、定下的约定、项目状态的变化,Claude 会判断后写进去;代码结构、git 历史这类仓库里查得到的东西,它不会重复存。每次新会话开始时,MEMORY.md 这个索引会自动加载。
  • 压缩会丢细节。 对话太长时,早期内容会被压成摘要,好让会话继续。摘要不写文件,被压掉的细节也找不回来。

二、为什么不该把上下文原样转储

转储整段对话,看起来最省事,实际有三个问题。

第一,噪音太多。 一次对话里大部分内容是试错、读文件和工具输出。下次全部读回来,会占掉大量窗口,真正有用的几条结论反而被淹没。

第二,容易过时。 代码已经改了,文档还停在旧状态。Claude 按旧文档干活,比什么都不知道更危险——它会很自信地做错。

第三,和现有记录重复。 完整对话本来就在 .jsonl 里,需要时 --resume 就行,没必要再导出一份。

值得长期保存的是“结论”和“下一步”,过程不需要。


三、正确的做法:写一份交接文档

什么时候需要额外写文档?一个任务要跨好几次会话才能做完的时候。比如把会员分档整体重构,或者迁移整个后端。

这时候让 Claude 在 docs/plans/xxx.md 里写一份交接文档,结构固定成五块:

## 目标
## 已做的决定(以及原因)
## 已完成
## 待办(按顺序)
## 踩过的坑

“已做的决定”要写原因。没有原因的决定,下一个会话很可能因为“看起来不合理”就把它推翻。

“踩过的坑”最值钱。它记录的是代码里看不出来、只有试过才知道的东西——某个 API 在 IPv6 下连不上,某个命令要加 --yes 才不会卡住。

新会话开头说一句“读 docs/plans/xxx.md 继续做”,就能接上。任务做完,删掉或者归档,别让它变成下一份过时文档。


四、日常控制上下文的七个习惯

场景 做法
换到一个不相关的任务 /clear,别让上一个任务的内容干扰
对话太长,但任务没做完 /compact 保留XX相关的决定,压缩时说明要保留什么
想看上下文用了多少 /context
需要大范围搜代码、读很多文件 交给子代理去做,它只把结论带回来,主对话保持干净
长期规则 写进 CLAUDE.md,保持精简,详细内容放到 docs/ 再加链接
个人偏好、纠正过的做法 直接说“记住 XXX”,写进 auto memory
跨会话的大任务 用上一节的交接文档

其中最常被忽略的有两条。

一个会话只做一件事。 修完一个 bug,提交,/clear,再开始下一个。CHANGELOG 和 git 提交本身就是最好的持久化——它们准确、带时间、跟代码同步,而且永远不会过时。

CLAUDE.md 要克制。 这个文件每次会话都会完整加载,写进去的每一行都在长期占用窗口。新规则尽量写成一句话加一个 docs/ 链接,细节放到被链接的文档里,需要时再读。


五、该放在哪:一张决策表

拿不准一条信息该放哪,按这个顺序问自己:

这条信息……
  ├─ 从代码 / git 历史里能查到? ──────→ 不用存
  ├─ 整个团队都该遵守? ───────────────→ CLAUDE.md(精简)+ docs/
  ├─ 只是我个人的偏好或约定? ─────────→ auto memory(说“记住”)
  ├─ 只对一个跨会话的任务有用? ───────→ docs/plans/ 交接文档,做完即删
  └─ 只对当前这次对话有用? ───────────→ 什么都不用做

上下文管理的本质是做减法:让窗口里只留下当前任务真正需要的东西。


写在最后

不要指望把所有东西都存下来——存下来的越多,Claude 要读的噪音就越多。

只存结论,只存下一步,用完就清。

━━━ fin ━━━

If you read this far — thank you.
Come tell me what you thought on X.