TsekaLuk/claude-code-notes

## 📖 项目简介 本项目是一套系统性解读 **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 汇总索引，按设计决策 / 原理分析 / 权衡优化 / 实战应用四类分组，一站式备考。 ## 📚 目录大纲 (56 篇全覆盖) 本项目依据源码的物理模块划分为了 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级证书优先级的安全验证、Zod防向后循环引用以及不可变Store层；**System Prompt 分段缓存架构**（`SYSTEM_PROMPT_DYNAMIC_BOUNDARY`、CLAUDE.md 层级发现、MCP 增量注入）；**四层上下文压缩策略**详解（工具结果截断/图片替换/Context Collapse/AutoCompact 互斥机制）。 - 🎨 **[07-UI与交互](./07-UI与交互/)**：React 19 自定义协调前端、Yoga WASM 高性能 Flex 布局以及确定性的 Buddy 伴侣算法。 - 🌐 **[08-网络与远程](./08-网络与远程/)**：探析 KAIROS 守护观察机制、BoundedUUIDSet 去重、Protobuf 定制化封包与上游代理隧道。 - 🛠️ **[09-实战指南](./09-实战指南/)**：基于源码架构的动手实践指南，从零搭建轻颗粒 Agent 客户端，覆盖 QueryLoop、工具系统、上下文压缩与流式输出的完整实现路径。

标签：AI框架, Anthropic, CIS基准, Claude Code, Mermaid图表, npm逆向, 前端架构, 技术图谱, 数据管道, 暗色界面, 深度学习笔记, 源码分析, 系统架构, 软件工程, 面试八股