从入门到精通的完整技术指南
本白皮书是基于 Claude Code 2.1.31 版本反编译源码编写的完整技术文档，旨在帮助新手小白和技术人员快速学习掌握 Claude Code 源码和使用技巧。
注意：本项目是反编译代码，仅供学习参考使用。使用前请评估相关法律风险。
| 章节 | 标题 | 描述 |
|---|---|---|
| 01 | 项目介绍 | 什么是 Claude Code 反编译项目，版本历史，项目目标 |
| 02 | 架构概览 | 整体目录结构、核心模块、技术栈、构建方式 |
| 章节 | 标题 | 描述 |
|---|---|---|
| 03 | 入口与启动 | cli.tsx → main.tsx → init.ts → setup.ts 完整启动流程 |
| 04 | 查询引擎 | query.ts、QueryEngine.ts、API 客户端的协作机制 |
| 05 | 工具系统 | Tool.ts、工具注册表、工具执行模型 |
| 06 | UI与REPL | REPL 屏幕、消息渲染、输入处理、权限系统 |
| 07 | 状态管理与MCP | 状态管理架构、MCP 协议支持、权限系统 |
| 章节 | 标题 | 描述 |
|---|---|---|
| 08 | 工具实现示例 | BashTool、FileEditTool、GrepTool 深度解析 |
| 09 | 使用指南 | 安装配置、交互方式、命令详解 |
| 10 | 开发指南 | 本地开发、调试技巧、扩展开发 |
| 章节 | 标题 | 描述 |
|---|---|---|
| 11 | 常见问题 | FAQ 常见问题解答 |
| 12 | 参考资源 | 相关文档、链接资源 |
| 13 | 限流机制与封号避免 | API 重试、配额管理、避免限流策略 |
| 14 | 隐藏功能与宠物系统 | Buddy 宠物系统、Auto Dream、Bridge、Ultrareview 等 |
- 运行时: Bun >= 1.2.0
- 语言: TypeScript / TSX
- UI 框架: React / Ink (终端 UI)
- API: Anthropic Claude API
- 构建: esbuild
- Claude Code 概述
- 版本历史 (1.0 → 2.1.31)
- 反编译项目说明
- 整体目录结构
- 核心模块说明
- 技术栈介绍
- 构建方式
- cli.tsx 入口点
- main.tsx CLI 定义
- init.ts 初始化流程
- setup.ts 环境配置
- query.ts 核心查询逻辑
- QueryEngine.ts 查询引擎
- API 客户端协作
- Tool.ts 工具接口
- 工具注册机制
- 工具执行模型
- REPL 屏幕实现
- 消息渲染
- 输入处理
- 权限系统
- Zustand 状态管理
- MCP 协议支持
- 权限管理
- BashTool 深度解析
- FileEditTool 深度解析
- GrepTool 深度解析
- 安装配置
- 交互方式
- 命令详解
- 开发环境设置
- 调试技巧
- 创建新工具
- 安装和运行问题
- 使用问题
- 开发问题
- 官方文档
- 技术参考
- 学习资源
- API 重试机制
- 配额状态管理
- 避免限流策略
- Buddy 宠物��统（18种物种、稀有度系统）
- Auto Dream 记忆整合
- Bridge 远程控制
- Teleport 会话迁移
- Ultrareview 代码审查
- Ultraplan 规划代理
- Kairos 主动式助手
# 克隆文档仓库
git clone https://github.com/fysh1010/claude-code-whitepaper.git
# 查看目录结构
ls -la
# 阅读 README 开始学习
cat README.md- 先阅读 架构概览 - 了解项目整体结构
- 再阅读 入口与启动 - 理解程序如何运行
- 然后阅读 使用指南 - 学会使用 Claude Code
- 最后阅读 工具系统 - 理解工具如何工作
- 架构概览 - 快速了解结构
- 入口与启动 - 理解启动机制
- 查询引擎 - 深入核心逻辑
- 工具系统 - 理解扩展机制
- 开发指南 - 开始开发
- 隐藏功能与宠物系统 - 探索隐藏功能
- claude-code-cli - Claude Code 反编译源码
- ai-agent-deep-dive - AI Agent 源码深度研究
本白皮书和项目代码仅供学习参考，不提供任何保证。使用者应自行承担使用风险。
此项目是反编译的代码，用于学习和研究目的。使用前请评估相关法律风险。
💡 提示：建议在学习过程中配合阅读实际源代码，文档中的代码示例都标注了具体文件路径。
如果这个项目对您有帮助，请 Star 支持一下！
本白皮书基于 Claude Code 2.1.31 版本编写