tangweigang-jpg/Claude-code-research

# Claude Code 架构深度分析 🌍 **选择语言:** | 语言 | 链接 | |----------|------| | 🇨🇳 中文 | [阅读中文版](zh/00-index.md) | | 🇬🇧 English | [Read in English](en/00-index.md) | | 🇰🇷 한국어 (Korean) | [한국어로 읽기](ko/00-index.md) | | 🇯🇵 日本語 (Japanese) | [日本語で読む](ja/00-index.md) | | 🇪🇸 Español (Spanish) | [Leer en español](es/00-index.md) | | 🇧🇷 Português (Portuguese) | [Ler em português](pt/00-index.md) | | 🇷🇺 Русский (Russian) | [Читать на русском](ru/00-index.md) | ## 关于本项目 这是对 Claude Code 的 **14 章深度架构分析**，基于 2026 年 3 月 31 日公开的 TypeScript 源码快照（约 512K 行代码，约 1,900 个文件）。 **分析方法**：14 个并行的 AI 子代理（5 个 Opus + 9 个 Sonnet）直接根据源文件对各个子系统进行分析，生成带有代码引用的源码级见解。 ## 报告结构 | # | 章节 | 核心主题 | |---|---------|-----------| | 00 | 索引与概述 | 架构全景、阅读指南、术语表 | | 01 | 架构概述 | 入口点、启动序列、并行预取 | | 02 | 查询引擎 | LLM 交互核心、流式传输、重试机制 | | 03 | 工具系统 | 40+ 工具统一抽象、注册、执行 | | 04 | Agent 编排 | Leader-Worker、Coordinator、Team、Worktree | | 05 | 提示工程 | 系统提示结构、缓存优化、动态注入 | | 06 | 技能系统 | Markdown-as-Code、加载机制、内置技能 | | 07 | 命令系统 | 50+ 斜杠命令、注册与执行 | | 08 | 上下文管理 | 4 层压缩、熔断器、缓存经济学 | | 09 | 记忆系统 | 三级记忆、自动提取、智能召回 | | 10 | 安全与权限 | Bash AST 分析、沙箱、Parser Differential 防御 | | 11 | MCP 集成 | MCP 协议、OAuth、动态工具发现 | | 12 | 终端 UI 与渲染 | Ink 双缓冲、Int32Array 缓冲区、Vim 模式 | | 13 | 模型选择与成本 | 模型路由、Fallback、Effort Level | | 14 | 功能标志与可观测性 | 80+ 编译时标志、400+ 运行时标志、Perfetto | ## 核心发现 - **查询引擎**并非通用的 LLM 封装器，而是一个感知推理的协程状态机 - **Agent 编排逻辑存在于系统提示中**，而非代码中——Coordinator 的 4 阶段工作流完全由约 5000 个字符的提示定义 - **提示工程**使用 3 层缓存架构（全局/组织/null），其中每个条件分支必须评估其对缓存变体的 2^N 影响 - **上下文管理**本质上是一种缓存经济学优化——缓存读取（$0.30/M）比缓存未命中（$3/M）便宜 10 倍 - **安全模型**的核心创新是 Parser Differential 防御——系统地防御 AST 解析器与真实 Shell 之间的语义鸿沟 - **功能标志**实际上包含 80 多个编译时标志和 400 多个运行时标志，远超之前发布的分析 ## 与类似项目的对比 | 维度 | [cc-notebook](https://github.com/win4r/cc-notebook) | 本项目 | |-----------|------------|--------------| | 总大小 | ~150 KB / 13 个文件 | **520 KB / 16 个文件** | | 涵盖主题 | 7 | **14** | | 语言 | 仅中文 | **7 种语言** | | 新增覆盖 | — | 提示工程、技能、MCP、工具系统、命令、架构、终端 UI | | 理论基础 | 无 | 每章包含计算机科学理论依据 | | 源码引用 | 是 | 是，带有 文件:行号 格式 | ## 各章节结构 1. **概述与定位** — 在整体架构中的角色 2. **理论基础** — 相关的计算机科学理论与设计模式 3. **架构与数据结构** — 核心类型定义与架构图 4. **核心算法与流程** — 决策树、状态机、代码片段 5. **设计决策分析** — 权衡分析与行业对比 6. **可迁移模式** — 可复用的工程模式 7. **源码索引** — 附带职责说明的文件列表 ## 免责声明 本项目仅供教育和技术研究目的。Claude Code 源代码的知识产权归 Anthropic 所有。本项目不包含原始源文件，仅包含架构分析和代码片段引用。

标签：AI代码分析, C2, Claude Code, DLL 劫持, LLM源码解析, MCP集成, SEO检索, TypeScript, 上下文管理, 人工智能, 命令系统, 国家安全局, 多智能体协同, 多语言翻译, 大语言模型, 安全与权限, 安全插件, 工具系统, 开源分析报告, 技术文档, 技能系统, 数据管道, 架构分析, 查询引擎, 深度学习, 用户模式Hook绕过, 系统架构, 自动化payload嵌入, 记忆系统, 软件工程, 逆向分析