深入解析 Claude Code 架构
架构概览核心的 Agent 循环是一个简单的 while 循环。绝大部分代码存在于环绕它的各子系统之中。每个 Coding Agent 都必须回答的四个设计问题设计问题Claude Code 的回答替代方案推理能力放在哪里模型负责推理运行框架负责执行约束。约 1.6% 的 AI 决策逻辑98.4% 为基础设施代码。LangGraph显式状态图。Devin多步骤规划器。有多少个执行引擎一个queryLoop服务所有界面CLI、SDK、IDE。针对不同界面使用独立的模式化引擎。默认的安全姿态是什么拒绝优先deny ask allow。最严格的规则优先。容器隔离SWE-Agentgit 回滚Aider。核心资源约束是什么约 200K token 的上下文窗口。每次模型调用前运行 5 种压缩策略。计算预算、显式草稿本。高层系统结构7 大组件高层系统结构用户— 提交提示词、审批权限、审查输出交互界面— 交互式 CLI、无头 CLIclaude -p、Agent SDK、IDE/桌面端/浏览器端Agent 循环—query.ts中的queryLoop异步生成器模型调用 → 工具分发 → 结果收集 → 循环重复权限系统— 拒绝优先规则 自动模式 ML 分类器 Hook 拦截工具— 最多 54 个内置工具 MCP 提供的工具通过assembleToolPool组装状态与持久化— 仅追加写入的 JSONL 会话记录、提示词历史、子 Agent 侧链执行环境— Shell带沙箱、文件系统、网络请求、MCP 连接所有界面都汇聚到同一个queryLoop——交互式 CLI、无头模式、SDK 和 IDE 共享同一条代码路径。QueryEngine是一个对话包装器而非引擎本身。5 层子系统分解21 个子系统层级职责核心组件表现层入口与渲染CLI、无头模式、SDK、IDEReact Ink 终端 UI核心层上下文组装与 Agent 循环queryLoop、5 阶段压缩管线、子 Agent 生成安全/动作层权限与工具7 种权限模式、自动模式分类器、27 种 Hook 事件、工具池、Shell 沙箱状态层运行时状态与持久化JSONL 会话记录、CLAUDE.md 层级结构、自动记忆、侧链文件后端层执行环境Shell 执行、MCP 连接7 种传输类型、42 个工具子目录七层独立安全机制一个请求必须通过所有适用的层级——任何单一层级都可以阻止它工具预过滤— 从模型视角中完全移除被全面拒绝的工具拒绝优先规则评估— deny 始终覆盖 allow即使 allow 规则更具体权限模式约束— 当前激活的模式决定了基础处理方式自动模式 ML 分类器— 独立的 LLM 调用单独评估安全性Shell 沙箱— 对 Shell 命令进行文件系统与网络隔离会话恢复时不还原权限— 权限永远不会跨会话边界持久化基于 Hook 的拦截— PreToolUse Hook 可以修改或阻止操作轮次执行9 步管线运行时轮次流程每个轮次遵循一个9 步管线设置解析 → 2. 状态初始化 → 3. 上下文组装 → 4. 五个模型前上下文塑形器 → 5. 模型调用 → 6. 工具分发 → 7. 权限关卡 → 8. 工具执行 → 9. 终止条件检查五个模型前上下文塑形器在每次模型调用前按顺序执行从成本最低的开始阶段策略触发条件预算削减每条消息的大小上限始终激活裁剪修剪较早的历史记录特性门控HISTORY_SNIP微压缩缓存感知的细粒度压缩始终执行基于时间可选缓存感知路径上下文折叠读取时的虚拟投影非破坏性特性门控CONTEXT_COLLAPSE自动压缩完整的模型生成摘要最后手段当其他所有方式都失败时恢复机制最大输出 token 递增每个轮次最多重试 3 次反应式压缩每个轮次最多触发一次提示词过长处理尝试上下文折叠溢出 → 反应式压缩 → 终止流式回退与备选模型切换权限系统深入解析权限关卡概览7 种权限模式模式行为信任等级plan执行前用户审批所有计划最低default标准交互式审批低acceptEdits文件编辑 文件系统 Shell 操作自动批准中autoML 分类器评估工具安全性高dontAsk不弹出提示但仍执行拒绝规则更高bypassPermissions跳过大部分提示安全关键检查仍保留最高bubble内部使用子 Agent 向父级升级特殊授权管线4 阶段流程预过滤从模型视角中移除被拒绝的工具→PreToolUse Hook可返回permissionDecision→规则评估拒绝优先→权限处理器4 个分支协调器、集群 Worker、推测性分类器、交互式自动模式分类器yoloClassifier.ts加载基础系统提示词 权限模板分为内部和外部。两阶段评估快速过滤 思维链。将预计算的分类结果与超时时间进行竞争。扩展性MCP、插件、技能与 HookAgent 循环中的三个注入点四种扩展机制递增的上下文成本机制上下文成本核心能力Hook零成本27 种事件、4 种执行类型Shell、LLM、Webhook、子 Agent 验证器技能低成本SKILL.md 文件支持 15 个 YAML 前置字段通过 SkillTool 元工具注入插件中等成本10 种组件类型命令、Agent、技能、Hook、MCP、LSP、样式等MCP 服务器高成本通过 7 种传输类型stdio、SSE、HTTP、WebSocket、SDK、IDE提供外部工具工具池组装5 步管线基础枚举最多 54 个工具→ 模式过滤 → 拒绝规则预过滤 → MCP 集成 → 去重三个注入点assemble()— 模型能看到什么CLAUDE.md、技能描述、MCP 资源、Hook 注入的上下文model()— 模型能调用什么内置工具、MCP 工具、SkillTool、AgentToolexecute()— 操作是否/如何执行权限规则、PreToolUse/PostToolUse Hook、Stop Hook上下文构建与记忆上下文构建与记忆层级9 个有序上下文来源系统提示词 → 环境信息 → CLAUDE.md 层级结构 → 路径范围规则 → 自动记忆 → 工具元数据 → 对话历史 → 工具结果 → 压缩摘要CLAUDE.md 层级结构4 层层级路径作用范围托管层/etc/claude-code/CLAUDE.md全系统企业级用户层~/.claude/CLAUDE.md每个用户项目层CLAUDE.md、.claude/CLAUDE.md、.claude/rules/*.md每个项目本地层CLAUDE.local.md个人使用被 gitignore关键设计决策CLAUDE.md 是用户上下文概率性遵从而非系统提示词确定性执行。权限规则提供了确定性的执行保障层。基于文件的记忆没有嵌入、没有向量数据库——使用基于 LLM 的记忆文件头部扫描按需选择最多 5 个相关文件完全可被用户检查、编辑和版本控制子 Agent 委托子 Agent 委托架构6 种内置类型 自定义 Agent内置类型Explore探索、Plan规划、General-purpose通用、Claude Code Guide指南、Verification验证、Statusline-setup状态栏配置。自定义类型.claude/agents/*.md通过 YAML 前置字段支持工具、模型、权限、Hook、技能等配置。关键设计SkillTool vs AgentToolSkillTool将指令注入当前上下文成本低同一上下文窗口AgentTool生成新的隔离上下文窗口成本高约 7 倍 token但上下文安全三种隔离模式模式机制默认WorktreeGit worktree文件系统隔离否Remote远程执行仅限内部使用否In-process共享文件系统、隔离的对话是侧链会话记录每个子 Agent 写入各自的.jsonl文件。只有摘要返回给父 Agent。完整历史永远不会进入父上下文。多实例协调通过 POSIXflock()实现——零外部依赖。会话持久化会话持久化与压缩三条持久化通道通道格式用途会话记录仅追加写入的 JSONL完整对话链式修补的压缩边界全局提示词历史history.jsonl跨会话的提示词回溯反向读取用于上箭头键子 Agent 侧链每个子 Agent 独立的 JSONL隔离的子 Agent 历史安全性恢复会话时不还原权限信任始终在当前会话中重新建立。这以用户体验摩擦为代价维持了安全不变性。设计权衡仅追加写入的 JSONL 优先考虑可审计性和简洁性而非查询能力。每个事件都是人类可读的、可版本控制的并且无需专用工具即可重建。学AI大模型的正确顺序千万不要搞错了2026年AI风口已来各行各业的AI渗透肉眼可见超多公司要么转型做AI相关产品要么高薪挖AI技术人才机遇直接摆在眼前有往AI方向发展或者本身有后端编程基础的朋友直接冲AI大模型应用开发转岗超合适就算暂时不打算转岗了解大模型、RAG、Prompt、Agent这些热门概念能上手做简单项目也绝对是求职加分王给大家整理了超全最新的AI大模型应用开发学习清单和资料手把手帮你快速入门学习路线:✅大模型基础认知—大模型核心原理、发展历程、主流模型GPT、文心一言等特点解析✅核心技术模块—RAG检索增强生成、Prompt工程实战、Agent智能体开发逻辑✅开发基础能力—Python进阶、API接口调用、大模型开发框架LangChain等实操✅应用场景开发—智能问答系统、企业知识库、AIGC内容生成工具、行业定制化大模型应用✅项目落地流程—需求拆解、技术选型、模型调优、测试上线、运维迭代✅面试求职冲刺—岗位JD解析、简历AI项目包装、高频面试题汇总、模拟面经以上6大模块看似清晰好上手实则每个部分都有扎实的核心内容需要吃透我把大模型的学习全流程已经整理好了抓住AI时代风口轻松解锁职业新可能希望大家都能把握机遇实现薪资/职业跃迁这份完整版的大模型 AI 学习资料已经上传CSDN朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】