Dive into Claude Code 核心揭秘为什么98.4%的代码是基础设施而非AI【免费下载链接】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-CodeDive into Claude Code 是对 AI 编程智能体 Claude Code 源码架构的系统级分析项目它拆解了约 1900 个 TypeScript 文件、51.2 万行代码揭示出只有 1.6% 的代码是 AI 决策逻辑其余 98.4% 都是权限门控、上下文管理、工具路由等确定性基础设施。如果你正在学习 AI Agent 系统如何设计这份源码级剖析会给你一份完整的参考答案。一句话结论智能体循环只是一个简单的 while 循环真正的工程复杂性藏在它周围的安全、状态与恢复系统里。Claude Code 架构全景7 大组件如何协作从用户输入一句提示到任务完成请求要穿越 7 个组件。下图展示了这套「用户 → 接口 → 智能体循环 → 权限系统 → 工具 → 状态持久化 → 执行环境」的高层结构值得注意的是所有入口交互式 CLI、headless 模式、SDK、IDE最终汇聚到同一个queryLoop。不是一套引擎跑一个界面而是一份代码路径服务所有场景——这是整个系统能保持行为一致的关键。5 层子系统分解基础设施代码藏在哪里如果继续往下拆Claude Code 由 21 个子系统组成 5 个架构层。这张分层图回答了「98.4% 的基础设施代码到底写在哪」层职责关键组件表层入口与渲染CLI、SDK、IDEReact Ink 终端 UI核心层上下文组装与智能体循环queryLoop、5 阶段压缩管道、子智能体生成安全/行动层权限与工具7 个权限模式、auto 模式分类器、27 个钩子事件、shell 沙箱状态层运行时状态与持久化JSONL 转录稿、CLAUDE.md 层级、侧链文件后端层执行环境Shell 执行、MCP 连接7 种传输类型、42 个工具子目录 看这张图就能理解论文的核心论点模型只负责「推理」而「强制执行」的能力几乎全部来自核心层、安全层和状态层的配合。Agent 循环一个 while 循环如何跑完所有事智能体循环本身简单得让人意外组装上下文 → 调用模型 → 分派工具 → 权限检查 → 执行 → 重复。每个轮次遵循 9 步管道下图展示了多轮迭代中工具请求、权限裁决与压缩机制的运行时流程真正费工的是循环外的保障机制五个预模型上下文整形阶段预算削减 → 裁剪 → 微压缩 → 上下文折叠 → 自动压缩各阶段只在满足自身条件时才生效恢复机制输出超限重试、反应式压缩、流式后备、后备模型切换5 种停止条件无工具调用、达到最大轮数、上下文溢出、钩子干预、显式中止拒绝优先权限系统AI Agent 如何守住安全底线权限系统是最典型的基础设施。它的决策原则是拒绝优先deny ask allow任何一条宽泛的 deny 规则都会覆盖具体的 allow 规则最严格的规则永远胜出。系统提供 7 个权限模式形成一条渐进信任光谱模式行为信任级别plan执行前批准所有计划最低default标准交互批准低acceptEdits文件编辑自动批准中autoML 分类器评估安全性高dontAsk无提示仍强制拒绝规则较高bypassPermissions跳过大多数提示最高bubble子智能体向父级上报特殊其中auto模式由独立的 LLM 分类器yoloClassifier做两阶段评估——快速过滤加思维链。研究还发现 2 个 CVE 共享同一根因扩展在信任对话框出现之前就已执行暴露出「预信任窗口」这一结构性风险。上下文管理与记忆AI Agent 最稀缺的资源上下文窗口是智能体最根本的资源约束。Claude Code 按 9 个有序来源构建上下文并按 6 个可访问性等级组织几个反直觉的设计选择记忆是文件而非向量库没有嵌入、没有向量相似度由 LLM 扫描记忆文件头、最多挑 5 个相关文件。好处是你可以直接查看、编辑并纳入版本控制4 级 CLAUDE.md 层级托管/etc/→ 用户~/.claude/→ 项目CLAUDE.md→ 本地CLAUDE.local.md指令按优先级合并指令与执行约束分离CLAUDE.md 只引导模型行为真正的硬约束由权限检查和沙箱在执行时实施子智能体委托隔离复杂度保护主上下文当任务复杂到需要分工Claude Code 会把工作委托给子智能体。每个子智能体拥有独立上下文沙箱6 个内置类型Explore、Plan、General-purpose 等加自定义智能体关键设计在SkillTool 与 AgentTool 的区分前者把技能指令注入当前对话后者在独立上下文中执行子任务只有精简的结果回传给父级——中间过程不会污染主上下文。多实例协调甚至直接用了 POSIXflock()零外部依赖。新手阅读指南从这里开始如果你想动手深挖建议按以下路径阅读本仓库你的角色起点接着读智能体构建者架构总览中文主文档安全研究者英文架构文档论文 PDF产品/研究人员项目主页相关资源目录带走三个启示循环容易抄harness 难复制——hooks、分类器、压缩与隔离机制才是护城河推理归模型执行归代码——把不确定的判断留给模型把确定性的边界交给基础设施上下文是预算不是容器——每个阶段都有自己的触发条件按需整形而非一刀切这正是 Dive into Claude Code 的核心价值它不教你某个工具怎么用而是把生产级 AI Agent 系统的设计空间摊开给你看——5 个价值观、13 条设计原则、直至每一行源码的选择全部可追溯。【免费下载链接】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），仅供参考