0xE1337/decode-claude-code-analysis

## 这是什么？ 2026 年 3 月 31 日，Anthropic 发布的 `@anthropic-ai/claude-code@2.1.88` npm 包中包含了一个 59.8MB 的 source map 文件（`cli.js.map`）。该文件内含完整的、未混淆的 TypeScript 源码 — 1,906 个文件，515,029 行代码。 本项目是一份结构化的、逐章节的架构分析，旨在探讨 **Claude Code 如何运作以及为何如此设计**。涵盖完整技术栈：从启动优化到 Agent 循环、System Prompt 设计、工具系统、安全模型、多 Agent 协作以及隐藏功能。 ### 快速指南 **[5 分钟快速指南（英文）](https://0xE1337.github.io/decode-claude-code-analysis/quick-guide.html?lang=en)** — 适合新手的视觉化、故事驱动概览。在 5 分钟内理解完整架构。 ### 完整分析 **[阅读完整的 12 章分析（英文）](https://0xE1337.github.io/decode-claude-code-analysis/?lang=en)** 功能：语法高亮、明暗主题切换、可调字体大小、全文搜索。 ### 章节 | # | 章节 | 核心重点 | |---|------|----------| | 00 | [入口与启动](docs/00-entry-startup.md) | 4 阶段启动、10 项优化策略、import 期间并行 I/O | | 01 | [Agent 循环](docs/01-agent-loop.md) | 3 层 AsyncGenerator、7 个 continue 站点、while(tool_call) 哲学 | | 02 | [System Prompt](docs/02-system-prompt.md) | 静态/动态分区、92% 缓存命中率、内部与外部差异对比 | | 03 | [工具系统](docs/03-tool-system.md) | 40+ 工具、buildTool() fail-closed 工厂、BashTool 18 文件引擎 | | 04 | [命令](docs/04-commands.md) | 80+ 斜杠命令、3 种类型、Prompt 命令注入模式 | | 05 | [上下文管理](docs/05-context-management.md) | 200K/1M tokens、3 级压缩、熔断器 | | 06 | [权限与安全](docs/06-permission-security.md) | 17,885 行代码、23 个 Bash 验证器、双引擎 AST、真实攻击向量 | | 07 | [多 Agent](docs/07-multi-agent.md) | 3 种模式、Fork Agent 缓存共享、协调者哲学 | | 08 | [MCP 与服务](docs/08-mcp-services.md) | 8 种传输方式、4 个 API 后端、OAuth PKCE + XAA | | 09 | [UI 组件](docs/09-ui-components.md) | 389 个组件、自定义 Ink fork、REPL.tsx 核心组件 | | 10 | [Feature Flags](docs/10-feature-flags.md) | 88 个构建时标志、KAIROS、Buddy 宠物、Undercover 模式 | | 11 | [基础设施](docs/11-infrastructure.md) | Task 系统、35 行 Store、Vim 模式、模型演进 | ### 核心数据 | 指标 | 数值 | |--------|-------| | 分析的源文件 | 1,906 | | 代码行数 | 515,029 | | 内置工具 | 40+ | | 斜杠命令 | 80+ | | Feature Flags | 88（构建时） | | 安全代码 | ~17,885 行 | | 上下文窗口 | 200K / 1M tokens | | Prompt 缓存命中率 | 92% | ### 构建 ``` cd docs node build.mjs # 生成 index.html (~394 KB) ``` ### 来源 基于 [`claude-code-sourcemap`](https://github.com/0xE1337/claude-code-sourcemap) 提取的源码进行分析。 ### 免责声明 本项目**仅供教育和研究目的**。Claude Code 的所有知识产权归 Anthropic 所有。本仓库不包含任何原始源码 — 仅包含架构分析和设计评论。 ## 这个项目是什么？ 2026 年 3 月 31 日，Anthropic 发布的 `@anthropic-ai/claude-code@2.1.88` npm 包中包含了一个 **59.8MB 的 source map 文件**（`cli.js.map`）。该文件内含完整的、未混淆的 TypeScript 源码 — 1,906 个文件，515,029 行代码。 本项目是一份结构化的、逐章节的架构分析，回答的核心问题是：**Claude Code 怎么工作、为什么这样设计**。覆盖完整技术栈：从启动优化到 Agent 循环、System Prompt 设计、工具系统、安全模型、多 Agent 协作到隐藏功能。 ### 快速阅读指南 **[5 分钟快速阅读指南（中文）](https://0xE1337.github.io/decode-claude-code-analysis/quick-guide.html?lang=cn)** — 图文并茂的架构速览，适合新手快速理解全貌。 ### 完整分析 **[阅读完整 12 章分析（中文）](https://0xE1337.github.io/decode-claude-code-analysis/?lang=cn)** 支持：代码语法高亮、明暗主题切换、字体大小调节、全文搜索。 ### 章节目录 | # | 章节 | 核心内容 | |---|------|----------| | 00 | [入口与启动优化](docs/00-entry-startup.md) | 4 阶段启动、10 项优化策略、import 期间并行 I/O | | 01 | [Agent Loop 核心循环](docs/01-agent-loop.md) | 3 层 AsyncGenerator、7 个 continue 站点、while(tool_call) 哲学 | | 02 | [System Prompt 设计](docs/02-system-prompt.md) | 静态/动态分区、92% 缓存命中率、内外用户差异 | | 03 | [工具系统](docs/03-tool-system.md) | 40+ 工具、buildTool() fail-closed 工厂、BashTool 18 文件引擎 | | 04 | [命令系统](docs/04-commands.md) | 80+ 斜杠命令、3 种类型、Prompt 命令注入模式 | | 05 | [上下文管理](docs/05-context-management.md) | 200K/1M tokens、三层递进压缩、熔断器保护 | | 06 | [权限与安全](docs/06-permission-security.md) | 17,885 行安全代码、23 个 Bash 验证器、双引擎 AST、真实攻击向量 | | 07 | [多 Agent 协作](docs/07-multi-agent.md) | 3 种模式、Fork Agent 缓存共享、Coordinator 哲学 | | 08 | [MCP 与服务层](docs/08-mcp-services.md) | 8 种传输、4 种 API 后端、OAuth PKCE + XAA | | 09 | [UI 组件系统](docs/09-ui-components.md) | 389 个组件、自定义 Ink fork、REPL.tsx 上帝组件 | | 10 | [Feature Flags](docs/10-feature-flags.md) | 88 个构建时 Flag、KAIROS 助理模式、Buddy 电子宠物、Undercover 卧底模式 | | 11 | [基础设施](docs/11-infrastructure.md) | Task 系统、35 行 Store、Vim 模式、模型演进追踪 | ### 核心数据 | 指标 | 数值 | |------|------| | 分析的源文件数 | 1,906 | | 代码行数 | 515,029 | | 内置工具 | 40+ | | 斜杠命令 | 80+ | | Feature Flags | 88（构建时） | | 安全代码 | ~17,885 行 | | 上下文窗口 | 200K / 1M tokens | | Prompt Cache 命中率 | 92% | ### 构建 ``` cd docs node build.mjs # 生成 index.html（~394 KB） ``` ### 数据来源 基于 [`claude-code-sourcemap`](https://github.com/0xE1337/claude-code-sourcemap) 提取的源码进行分析。 ### 声明 本项目仅用于**教育和研究目的**。Claude Code 的所有知识产权归 Anthropic 所有。本仓库不包含任何原始源码，仅包含架构分析和设计解读。

标签：Agent, Anthropic, CIS基准, Claude Code, DLL 劫持, DNS解析, GNU通用公共许可证, MITM代理, Node.js, npm包, TypeScript, 云资产清单, 代码分析, 凭证管理, 前端工程, 多智能体协调, 大语言模型, 安全插件, 安全模型, 开源项目, 技术栈, 架构分析, 深度学习应用, 源码解析, 自动化payload嵌入, 软件架构, 逆向工程