Claude Code 源码学习文档
基于 Claude Code CLI (v2.1.116) 泄露版源码，深入分析其架构设计、核心模块与智能体开发方法。
了解 Claude Code 的技术栈、目录结构和整体设计
项目概览深入理解核心架构、消息流和状态管理
架构设计学习 Tool 抽象层和 40+ 内置工具的实现
工具系统API 调用、MCP 协议、上下文压缩与会话记忆
服务层React Hooks 设计模式与 Shell Hooks 扩展机制
Hooks 体系掌握基于 Claude Code 开发自定义智能体的方法
智能体开发为什么学习 Claude Code 源码
Claude Code 是 Anthropic 官方的 CLI 智能体，代表了当前最成熟的终端 AI Agent 实现之一。通过学习它的源码，你可以：
- 理解生产级 Agent 架构：从入口到工具调用的完整链路
- 掌握 Tool Use 模式：如何设计和实现 40+ 工具的抽象层
- 学习流式交互：Ink + React 的终端 UI 渲染方案
- MCP 协议实践：如何集成 Model Context Protocol
- 权限与安全：Agent 的权限模型和安全边界设计
- 多智能体协作：Team、SubAgent、Swarm 的实现方式
技术栈速览
| 类别 | 技术 |
|---|---|
| 运行时 | Bun (TypeScript) |
| 终端 UI | Ink (React for CLI) |
| AI SDK | @anthropic-ai/sdk |
| 协议 | MCP (Model Context Protocol) |
| Schema | Zod v4 |
| 构建 | Bun bundle + feature flags |
| 状态管理 | 自定义 AppState (React hooks) |
| Observability | OpenTelemetry |
文档导航
Last updated on