Claude Code 源码解析

Appearance

Claude Code 源码解析深度解析 Anthropic AI 编程助手

所有内容皆由Claude Code亲自编写

开始阅读
目录索引

总架构概览

全局分层图、核心数据流时序、目录结构、设计理念

Agent Loop

query 生成器、流式对话、状态机、错误恢复全解析

Tool 系统

30+ 内置工具、并发执行器、权限链、MCP 代理

扩展机制

Skills / Plugins / Hooks / MCP 四大扩展点

阅读指南 ​

如果你是第一次接触这个代码库，建议按以下顺序阅读：

  1. 01 总架构概览 — 理解全局分层、核心数据流、目录结构。这是所有后续章节的地图。
  2. 02 入口与启动流程 — 了解应用从 main.tsx 启动到渲染 REPL 的全过程。
  3. 03 状态管理 → 04 REPL 与 Query 循环 → 05 Agent Loop 实现详解 — 核心三连：先理解状态结构，再看循环概念，最后深入实现。
  4. 按需深入 — 工具执行看 06，服务层看 07，子代理看 09，扩展机制看 13，UI 渲染看 11。

目录 ​

章节页面概述
01总架构概览全局分层图、核心数据流时序、目录结构、设计理念
02入口与启动流程main.tsx → setup.ts → replLauncher.tsx 完整启动链路
03状态管理AppState Store、Tool 上下文、子代理状态隔离
04REPL 与 Query 循环REPL 主屏、query 生成器、流式对话、错误恢复
05Agent Loop 实现详解queryLoop 状态机、单次迭代生命周期、流式工具执行、所有 continue/return 路径
06Tool 系统30+ 内置工具、并发执行器、权限链、MCP 代理
07服务层API 调用、MCP、LSP、Compact 压缩、Analytics
08权限与安全四层权限检查、四方竞速决策、沙箱、Hooks
09Agent / Swarm / Task子代理分叉、Teammate 协作、后台任务生命周期
10命令系统90+ 斜杠命令的注册、路由、执行机制
11TUI 渲染引擎自研终端 React 框架：Yoga 布局、渲染管线、事件系统
12Bridge / RemoteIDE 集成、远程会话、传输层
13扩展机制Skills / Plugins / Hooks / MCP 四大扩展点，以及 Vim、快捷键、Memory、Voice 等

技术栈速览 ​

层面技术说明
RuntimeBunTypeScript 执行环境，利用 bun:bundle feature flags 做编译期死代码消除
UI自研 Ink基于 React Reconciler + Yoga Flexbox 的终端渲染引擎
APIAnthropic SDKClaude Messages API (Beta)，streaming SSE
协议MCP / LSP外部工具/代码智能扩展
CLICommander.js命令行参数解析
状态自研 Store轻量级 Pub/Sub 响应式容器，无第三方依赖
安全Sandbox + HooksmacOS sandbox-exec + 用户可配置 Shell 钩子