Claude Code 源码解读资料收集

收集和整理全网对 Claude Code 51 万行 TypeScript 源码的解读与分析

事件背景

2026年3月31日，Anthropic 发布到 npm 的 Claude Code v2.1.88 遗留了 60MB 的 source map 文件（cli.js.map），导致约 51.2 万行 TypeScript 源码（1,903 个源文件）完全暴露在公网。安全研究者 Chaofan Shou（@Fried_rice）首先发现并公开了此事。

---

源码仓库

仓库	Stars	说明
anthropics/claude-code	105K+	官方仓库
leaked-claude-code/leaked-claude-code	538+	重建版，可构建运行
xorespesp/claude-code	169+	另一重建版
sanbuphy/claude-code-source-code	10.9K+	深度分析，四语言文档
bcefghj/Claude-Code-Source	-	本项目 fork

---

深度解读文章

中文解读

标题	来源	链接
51万行源码泄露：全面解构 Claude Code 如何成为 AI 编程天花板	DEV.to / 曲速导航	链接
Claude Code 源码分析笔记	腾讯云开发者社区	链接
深入剖析 Claude Code 架构：开发者开源14天学习手册与源码图	80AJ	链接
11小时精通 Claude Code：结构化学习指南	掘金	链接

英文解读

标题	来源	链接
Claude Code's Source Code Exposed — Every System Explained	DEV.to	链接
Claude Code Source Leaked: 5 Hidden Features Found	DEV.to	链接
The Claude Code Leak: 512,000 Lines of TypeScript	Medium	链接
Claude Code Agent — Complete Architecture Deep Dive	Gist	链接
The plumbing behind Claude Code	Siddhant Khare	链接
Claude Code Internals: An AI-Assisted Analysis	Victor Antos	链接
How Claude Code Works: Architecture & Internals	Claude Code Guide	链接
Claude Code's Compaction Engine	Barazany.dev	链接
How Prompt Caching Actually Works in Claude Code	Claude Code Camp	链接
I Tore Apart the Claude Code Source Code (3 Parts)	DEV.to	链接

---

主题分类索引

架构概览

• 四个独立入口（CLI、初始化、MCP、SDK）
• src/ 目录结构：工具、命令、服务、UI、协调器、记忆、插件、Hook 等
• 技术栈：Bun 运行时 + TypeScript + 自研 React Ink 渲染器

核心循环（QueryEngine）

• query.ts ~1,730 行，8 步核心循环
• 异步生成器（async generator）模式
• 流式响应、工具调度、预算检查

提示词工程

• getSystemPrompt() 动态拼装
• 静态部分（"系统宪法"）+ 动态部分（"当期政策"）
• SYSTEM_PROMPT_DYNAMIC_BOUNDARY 缓存边界
• Token 缓存经济学（80% 成本节省）

工具系统

• 42 个内置工具，Zod 校验
• 14 步工具治理流水线
• Fail-closed 设计（默认视为高风险）

权限与安全

• 六种权限模式：Default / acceptEdits / Plan / Auto / dontAsk / bypassPermissions
• 七步权限评估管道
• macOS Seatbelt / Linux bubblewrap 沙箱

上下文管理

• 三层压缩：微压缩 → 自动压缩（87%阈值）→ 完全压缩（9节摘要）
• 缓存感知压缩（cache_edits 手术刀式删除）

记忆系统

• 三层记忆：会话 / 项目（CLAUDE.md）/ 自动记忆
• KAIROS "做梦"模式：夜间日志蒸馏
• 双模型协同检索（Sonnet 快速扫描）

多 Agent 系统

• 6 个内建 Agent 角色
• Coordinator 模式（项目经理式调度）
• Verification Agent（"Try to break it" 对抗性验证）
• 反偷懒 + 防无限递归机制

隐藏功能

• Undercover Mode（Anthropic 员工隐身）
• Buddy Pet System（18种宠物、5种稀有度、Mulberry32 PRNG）
• 90+ Feature Flags
• Deep Planning Mode（30分钟深度规划）

性能优化

• Prompt 缓存策略
• 并行预取
• 懒加载与死代码消除
• 子 Agent 缓存优化（前缀匹配）

---

学习教程

项目	Stars	说明
claude-code-ultimate-guide	2.6K+	全面指南，271题测验，232+模板
claude-howto	16K+	周末精通，10模块，117+功能
claude-code-cookbook	-	VitePress 双语教学
claude-code-complete-guide	199	V1 图解指南，12篇114节
claude-code-complete-guide_v2	-	V2 全面升级版（本项目配套）

---

许可

本仓库仅用于教育学习目的。所有链接内容版权归原作者所有。Claude Code 源码版权归 Anthropic, PBC 所有。