claude-code-notes

<div align="center">

**🌐 English Version** | **🇨🇳 中文版本**

[](https://www.anthropic.com/claude-code) [](#-目录大纲) [](./INTERVIEW_QA.md) [](https://creativecommons.org/licenses/by-nc/4.0/) [](#)

*面向工程面试复习与高级全栈源码学习的”硬核”分析笔记*<br> *(基于 Claude Code v2.1.88 npm 发布包 source map 还原版本)*

<br/>

</div>

<br/>

本项目是一套系统性解读 Anthropic Claude Code (v2.1.88) 内部引擎与架构的开源笔记。通过 8 个核心模块的切分，共产出 56 篇高质量的技术解析文档。旨在帮助深入理解当前顶尖前沿 AI Agent 框架的落地实现、交互架构与安全设计。

文档特点：

• 🔍 源码级剖析：深入到每一行关键代码的实现细节。
• 🏗️ 架构可视化：大量的高质量 Mermaid 架构图、数据流图。
• 💡 面试与思考 Q&A：每篇文章均附带“设计决策”、“权衡与优化”等高频 Q&A，将理论与实战思考结合。
• 🇨🇳 全中文语境：降低深度技术的阅读门槛。

---

若您是第一次来到本项目，强烈建议从总览开始阅读： 👉 [00-全局架构总览](./00-全局架构总览.md) —— 包含 7 大核心架构设计、宏观数据流以及模块依赖拓扑图。

📋 [面试题大全 484 题](./INTERVIEW_QA.md) —— 全部文章 Q&A 汇总索引，按设计决策 / 原理分析 / 权衡优化 / 实战应用四类分组，一站式备考。

本项目依据源码的物理模块划分为了 8 大专区。你可以直接点击对应子目录查看深入的分析报告：

• 🚀 [01-核心入口](./01-核心入口/)：探究 CLI 引导程序、并行防抖启动机制与双路径路由引擎（MDM/Keychain）。
• 🛠️ [02-工具系统](./02-工具系统/)：揭秘 MCP 动态加载、BashTool 沙箱防御机制以及 ToolDef 工厂模式体系。
• ⚡️ [03-命令系统](./03-命令系统/)：解读三路优先级指令链、故障注入策略 (bridge-kick) 与缓存零痕迹 (btw) 处理。
• 🧠 [04-Agent协调](./04-Agent协调/)：核心剖析！QueryLoop 生命周期、强大的四级上下文压缩流水线及原子通知机制；三层多 Agent 协作架构（Swarm 进程内运行器、Coordinator 纯编排模式、Task 系统与权限传递）；Fork 子 Agent 机制与消息构建策略最大化 Prompt Cache 命中率。
• 🔌 [05-扩展系统](./05-扩展系统/)：掌握外部世界联动能力：插件联合分派机制、状态机技能设计以及组合键和弦输入。
• 🧱 [06-服务与基础](./06-服务与基础/)：全局视角：7级证书优先