aga-j/claude-code-deep-dive

# 🔍 Claude Code 源码深度解读 [](./LICENSE) [](#文章目录) [](https://www.typescriptlang.org/) ## 🎯 这个系列是什么 Claude Code 是 Anthropic 官方的 CLI 编码助手，是目前公开可研究的**最完整的生产级 Agentic 系统实现**。 这个系列通过 7 篇深度文章，从架构、循环、工具、多代理、安全、记忆到工程实践，**系统性地拆解一个 AI Agent 系统的每一个关键设计决策**，提炼出可复用的模式和经验。 ### 你将收获 - 🏗️ **架构视角** — 理解一个生产级 Agent 系统的六层架构 - 🔄 **核心循环** — 掌握 AI Agent 的 "心跳" —— 查询循环的设计 - 🛠️ **工具框架** — 学习可扩展的工具系统设计模式 - 🤖 **多代理协作** — 从单 Agent 到 Agent Swarm 的完整路线图 - 🛡️ **安全模型** — 纵深防御的权限设计 - 🧠 **记忆系统** — 让 AI 拥有跨会话的持久记忆 - 📋 **实战清单** — 22 个设计模式 + 四阶段构建检查清单 ## 📚 文章目录 | # | 标题 | 核心内容 | |---|------|---------| | 1 | [**总览与架构哲学**](./01-architecture-overview.md) | 六层蛋糕模型、启动优化、技术栈选择、整体数据流 | | 2 | [**查询循环与上下文管理**](./02-query-loop-and-context.md) | 核心 while(true) 循环、五层递进压缩、五层错误恢复 | | 3 | [**工具系统设计**](./03-tool-system.md) | buildTool 工厂模式、安全默认值、条件编译、工具注册 | | 4 | [**多代理架构**](./04-multi-agent-architecture.md) | 同步/异步/Fork/Teammate 四种模式、Coordinator、Worktree 隔离 | | 5 | [**权限与安全**](./05-permissions-and-security.md) | 三层纵深防御、四种权限模式、ResolveOnce 并发锁、命令分类 | | 6 | [**记忆与状态管理**](./06-memory-and-state.md) | 四类记忆分类法、团队记忆、推测执行、DeepImmutable 设计 | | 7 | [**工程实践启示录**](./07-engineering-insights.md) | 22 个设计模式提炼、Feature Flag 体系、MCP 集成、构建检查清单 | ## 🗺️ 阅读路线 根据你的角色选择最适合的阅读路径： 🎨 产品经理 / AI PM 1 (总览) → 4 (多代理) → 7 (实践) 重点：架构选型、设计模式、对业务系统的启示 💻 后端开发者 1 → 2 → 3 → 4 → 5 → 6 → 7 (全部按序) 重点：代码示例、实现细节、安全机制 🎭 前端开发者 1 (总览) → 3 (工具) → 6 (状态) 重点：React/Ink 渲染、状态管理、推测执行 🏛️ 架构师 1 (总览) → 2 (循环) → 4 (多代理) → 5 (安全) → 7 (实践) 重点：系统设计决策、权衡取舍、扩展性 ## 📊 源码概况 | 指标 | 数据 | |------|------| | 源文件数 | ~1,900 个 | | 代码行数 | 512,000+ 行 | | 语言 | TypeScript (strict mode) | | 运行时 | Bun | | 终端 UI | React + Ink | | CLI 框架 | Commander.js | | Schema 验证 | Zod v4 | ## 🔑 核心发现速览

🏗️ 六层蛋糕架构

┌─────────────────────────────────────┐ │ Layer 6: Presentation (React/Ink) │ ├─────────────────────────────────────┤ │ Layer 5: Coordination (Multi-Agent)│ ├─────────────────────────────────────┤ │ Layer 4: Tool Execution │ ├─────────────────────────────────────┤ │ Layer 3: Query Loop (Core) │ ├─────────────────────────────────────┤ │ Layer 2: State Management │ ├─────────────────────────────────────┤ │ Layer 1: Infrastructure (MCP/API) │ └─────────────────────────────────────┘

🔄 while(true) 核心循环

User Input → System Prompt Assembly → API Call → Parse Response → Tool Execution → Repeat ↑ │ └──────── Loop ────────────────┘ AI Agent 的"心跳"：不断循环，直到没有工具调用或显式停止。

🛡️ 三层纵深防御

Layer 1: 静态规则表 (allow/deny list) ↓ 未匹配 Layer 2: 权限上下文判断 (信任级别) ↓ 需要确认 Layer 3: 用户交互审批 (ResolveOnce 并发锁)

## 🤝 贡献 欢迎通过以下方式参与贡献： - 🐛 **纠错**：发现文章中的技术错误？请提 [Issue](../../issues) - 💡 **补充**：有更深入的分析角度？欢迎提 PR - 🌐 **翻译**：欢迎将文章翻译为英文或其他语言 - ⭐ **传播**：觉得有用就 Star 并分享给朋友 ## 📄 License 本项目采用 [MIT License](./LICENSE)。 本系列文章仅用于学习和研究目的。 ## 👤 作者 **Wyman Wu** · AI Product Manager 探索 AI Agent 在保险科技（InsurTech）领域的深度应用。

如果这个系列帮你理解了 Agentic 系统的设计，请给个 ⭐ Star！

标签：Agentic 系统, Agent 协作, AI 编程助手, Anthropic, Black Hat, CIS基准, Claude Code, CLI 工具, Multi-Agent, TypeScript, 上下文管理, 多代理架构, 安全插件, 工具系统, 工程实践, 技术栈, 权限安全, 架构设计, 查询循环, 源码解读, 生产级系统, 纵深防御, 记忆系统, 设计模式, 软件架构