Claude Code 上下文管理指南#
本文档介绍 Claude Code 的对话上下文管理机制，帮助你更好地理解和利用这些特性。
核心机制#
1. 自动摘要机制#
系统会自动监控对话的上下文长度（token 使用量），当对话内容积累到一定程度时，会触发自动摘要。
智能压缩策略：
- 提取关键信息：重要的用户指令、已完成的任务结果、关键配置和决策
- 精简冗长内容：执行细节、重复内容会被压缩
- 保持对话连贯性：摘要后仍能记住重要上下文
信息保留优先级：
| 优先级 | 内容类型 |
|---|---|
| 高 | 用户明确指令、配置文件内容（CLAUDE.md）、关键决策 |
| 中 | 任务执行结果、重要的代码修改 |
| 低 | 详细执行日志、中间步骤的详细输出 |
2. 上下文管理#
虽然理论上对话有无限上下文（通过自动摘要），但当上下文使用率接近 95% 时，系统会提醒考虑压缩对话或新建对话。
主动控制方式：
| 操作 | 命令/方法 | 说明 |
|---|---|---|
| 压缩对话 | /compact | 手动触发对话压缩 |
| 新建对话 | 退出并重启 claude | 开始全新会话 |
3. 信息保留 — CLAUDE.md#
CLAUDE.md 是实现"持久记忆"的关键：
- 不管对话怎么压缩、怎么新建，CLAUDE.md 的内容每次都会被加载
- 重要的规则、偏好、项目配置都应该写在 CLAUDE.md 里
配置文件位置：
| 作用范围 | 路径 |
|---|---|
| 全局配置 | ~/.claude/CLAUDE.md |
| 项目配置 | 项目根目录/.claude/CLAUDE.md |
实际操作建议#
| 场景 | 推荐操作 |
|---|---|
| 对话太长，响应变慢 | 输入 /compact 压缩 |
| 需要全新开始 | 退出后重新启动会话 |
| 重要规则不想丢失 | 写入 CLAUDE.md |
| 项目级别的配置 | 在项目根目录创建 .claude/CLAUDE.md |
最佳实践#
- 善用 CLAUDE.md：将常用指令、偏好设置、项目规范写入配置文件
- 定期压缩：长时间对话后使用
/compact保持性能 - 分会话处理：不同任务可以开启不同会话，避免上下文混乱
- 关注提醒：当系统提示上下文接近阈值时，及时处理
总结#
- CLAUDE.md = 永久记忆（每次会话都会加载）
/compact= 手动压缩按钮（清理冗余保留核心）- 自动摘要 = 系统自动处理（无需手动干预）
掌握这些机制，可以让你与 Claude Code 的协作更加高效流畅。