Dive into Claude Code 上下文管理深度教程5级压缩管线9个上下文源搞定200K窗口难题【免费下载链接】Dive-into-Claude-CodeA Systematic Analysis and Discussion of Claude Code for Designing Todays and Future AI Agent Systems项目地址: https://gitcode.com/gh_mirrors/di/Dive-into-Claude-CodeClaude Code 是 Anthropic 出品的 AI 编程智能体而它的上下文管理机制正是支撑长任务不失忆的核心。Dive-into-Claude-Code 项目对 Claude Code v2.1.88约 1900 个 TypeScript 文件、51 万行代码做了源码级系统分析揭示了 9 个有序上下文源、4 级 CLAUDE.md 记忆文件层级以及一套 5 级上下文压缩管线——它们共同应对约 200K token 的上下文窗口瓶颈。本教程带你逐层拆解这套机制让你理解并设计出同样可靠的 AI Agent 上下文策略。为什么 Claude Code 需要精细的上下文管理大模型有一个硬约束上下文窗口是有限的旧模型约 200K tokenClaude 4.6 系列约 1M。一次编码会话里对话历史、工具输出、文件读取结果会不断累积很快就会挤爆窗口。更关键的洞察来自项目的核心发现Claude Code 的代码库中只有 1.6% 是 AI 决策逻辑其余 98.4% 都是确定性基础设施——权限闸门、上下文管理、工具路由与恢复逻辑。上下文管理就是其中最重要的基础设施之一。它的两条设计原则是上下文是稀缺资源不是粗暴截断而是分级流水线graduated pipeline每一级都在自己的触发条件下工作记忆文件化所有记忆都是用户可见、可编辑、可版本控制的 Markdown 文件没有黑盒数据库9 个上下文源上下文窗口里到底装了什么每次调用模型前Claude Code 按固定顺序组装上下文共9 个来源顺序上下文源说明1System prompt系统提示定义模型行为基调2Environment info环境信息操作系统、工作目录等3CLAUDE.md hierarchy记忆层级项目规则与偏好作为用户上下文注入4Path-scoped rules路径规则.claude/rules/*.md按文件路径生效5Auto-memory自动记忆LLM 扫描记忆文件头按需选取6Tool metadata工具元数据工具描述与调用结果7Conversation history对话历史累积的用户/助手消息8Tool results工具结果命令输出、文件读取等9Compact summaries压缩摘要取代被压缩掉的长历史注意一个精妙设计指令与执行是分离的。CLAUDE.md 只是引导模型应该怎么做真正的访问限制由权限检查和沙箱在执行时强制——不依赖模型自觉。CLAUDE.md 的 4 级记忆文件层级记忆文件按优先级分层加载范围从大到小层级路径作用范围 Managed/etc/claude-code/CLAUDE.md系统级企业管控 User~/.claude/CLAUDE.md个人全局 ProjectCLAUDE.md、.claude/CLAUDE.md、.claude/rules/*.md单个项目 LocalCLAUDE.local.md个人私有被 gitignore记忆检索也很朴素但可靠不走向量嵌入而是让 LLM扫描记忆文件头按需选取最多 5 个相关文件——透明且零基础设施成本。5 级压缩管线上下文快满了怎么办这是本教程的核心。在每次模型调用之前管线按顺序检查 5 个阶段每一级只在自己的触发条件满足时才动手从轻到重逐级升级级别阶段策略触发条件1️⃣Budget Reduction对单条消息的工具结果做大小上限裁剪预算机制开启且超限2️⃣Snip修剪较老的对话历史功能门控HISTORY_SNIP3️⃣Microcompact清理较早的工具结果主线程请求达到时间阈值4️⃣Context Collapse读时虚拟投影非破坏性磁盘数据不动功能门控CONTEXT_COLLAPSE5️⃣Auto-Compact由模型生成整段摘要替换长历史开启且超过阈值时设计思想值得借鉴⚡先省后删能用投影读时折叠就不真删能清理工具噪音就不动对话内容失败兜底若仍提示 prompt 过长按Context Collapse 溢出 → 反应式压缩每轮至多一次→ 终止逐级降级恢复机制最大输出 token 升级重试每轮最多 3 次、流式回退与备用模型切换压缩如何不丢数据JSONL 持久化 链式补丁很多人担心压缩会丢历史。Claude Code 的答案是追加式 JSONL 转录 链式补丁所有事件以只追加方式写入会话转录.jsonl磁盘上从不破坏性编辑压缩发生时边界处记录headUuid/anchorUuid/tailUuid三个锚点会话加载器在读取时把消息链补丁成压缩后的视图文件历史检查点~/.claude/file-history/支持--rewind-files回退三条持久化通道各司其职会话转录完整对话、全局提示历史history.jsonl支持上箭头召回、子代理侧链每个子代理独立.jsonl中间过程不进父上下文。每轮对话的 9 步管线压缩卡在哪一步理解整体节奏只需记住这条 9 步流水线设置解析 → 状态初始化 →上下文组装→条件式上下文管理5 级管线→ 模型调用 → 工具分发 → 权限闸门 → 工具执行 → 停止条件检查每轮结束有 5 种停止条件无工具调用、达到最大轮数、上下文溢出、Hook 干预、显式中止。上下文管理不是独立后台任务而是嵌入每轮调用的固定环节——这就是它条件触发、逐级升级的原因。新手实践3 条优化你 Agent 上下文的建议基于这套架构如果你在设计自己的 AI Agent可以直接借鉴把记忆写成文件像 CLAUDE.md 层级那样分层组织规则组织 → 个人 → 项目 → 本地让用户可审查、可版本控制避免黑盒向量库✂️压缩要分级不要一上来就整段摘要。先裁工具输出噪音占大头再折叠历史最后才动用模型摘要——既省 token 又保住缓存命中率压缩不删盘原始对话以追加日志落盘压缩只改变读时视图天然支持审计、回滚与分叉延伸阅读完整架构深度解析英文docs/architecture.md中文架构文档docs/architecture_zh.md论文全文 PDFpaper/Dive_into_Claude_Code.pdf项目中文说明README_zh.md相关资源清单docs/related-resources_zh.md【免费下载链接】Dive-into-Claude-CodeA Systematic Analysis and Discussion of Claude Code for Designing Todays and Future AI Agent Systems项目地址: https://gitcode.com/gh_mirrors/di/Dive-into-Claude-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考