乐于分享
好东西不私藏

《Claude Code 源码解读》总览

《Claude Code 源码解读》总览

本目录包含 Claude Code 源码的完整解读文章,按模块章节组织,适合深入学习和后续改造参考。

章节目录

章节
标题
核心内容
第 1 章
项目总览
是什么、核心能力、技术栈、主要依赖
第 2 章
整体架构分层
六层架构、目录结构、关键数字
第 3 章
启动流程
三阶段启动、特性开关、运行模式
第 4 章
查询引擎
LLM 请求管理、工具调用循环、上下文压缩
第 5 章
工具系统
Tool 接口、工具池、执行引擎、并发管理
第 6 章
命令系统
斜杠命令、注册机制、典型命令实现
第 7 章
权限系统
决策链、规则来源、钩子系统
第 8 章
UI 渲染架构
自定义 Ink、布局引擎、终端 I/O、事件系统
第 9 章
服务层
API 客户端、MCP 集成、OAuth 认证
第 10 章
配置管理
七层优先级、Schema 验证、原子性写入
第 11 章
状态管理
AppState、核心状态、更新模式
第 12 章
关键设计模式
AsyncGenerator、工厂、策略、中间件链、DCE
第 13 章
构建、部署与使用
环境准备、构建、安装、认证、使用场景
第 14 章
记忆系统
CLAUDE.md 层级文件、Auto Memory、会话记忆、相关性检索
第 15 章
协议层
模型消息协议、工具协议、Agent 通信协议、流式 Delta 事件
第 16 章
流式管道设计
流式返回、中断设计、HITL人机协作、运行中内容补充

学习路径建议

快速了解(1-2 小时)

  1. 第 1 章:项目总览 — 了解项目定位和技术栈
  2. 第 2 章:整体架构 — 建立整体概念图

深入核心(半天)

  1. 第 3 章:启动流程 — 理解程序如何运行起来
  2. 第 4 章:查询引擎 — 核心 AI 对话循环
  3. 第 5 章:工具系统 — AI 如何调用工具

扩展能力(按需选读)

  • 第 6 章:命令系统 — 添加自定义斜杠命令
  • 第 7 章:权限系统 — 控制工具执行权限
  • 第 8 章:UI 渲染 — 修改终端界面
  • 第 9 章:服务层 — 接入新的 AI 提供商或 MCP 服务
  • 第 15 章:协议层 — 理解消息/工具/Agent 的信息传递格式
  • 第 16 章:流式管道设计 — 流式返回、中断、HITL 与运行中内容补充

工程化(按需选读)

  • 第 10 章:配置管理 — 理解配置体系
  • 第 11 章:状态管理 — 理解全局状态
  • 第 12 章:设计模式 — 核心模式总结
  • 第 13 章:构建部署 — 本地搭建和定制化部署

项目基本信息

  • 版本来源:https://github.com/instructkr/claude-code
  • 规模:1,884 个 TS/TSX 文件,约 512,664 行代码
  • 运行时:Bun(高性能 Node.js 替代品)
  • UI 框架:React + 自定义 Ink 终端渲染器