mirror of
https://github.com/ComeOnOliver/claude-code-analysis.git
synced 2026-04-25 07:00:47 +09:00
ComeOnOliver
81 lines
3.8 KiB
Markdown
81 lines
3.8 KiB
Markdown
**[English](README.md)** | **[中文](README.zh-CN.md)**
|
||
|
||
# Claude Code 源码分析
|
||
|
||
[](LICENSE)
|
||
[](DOCUMENTATION.zh-CN.md)
|
||
[](README.md)
|
||
[](README.zh-CN.md)
|
||
|
||
> Claude Code 内部架构、模块和设计模式的全面逆向工程分析。
|
||
|
||
---
|
||
|
||
## 这是什么？
|
||
|
||
本项目是对 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)（Anthropic 官方 AI 驱动的软件工程 CLI 工具）的深度技术分析。文档详细记录了其内部源码树结构、模块边界、工具/命令清单、状态管理和架构设计模式——全部通过源码逆向工程获得。
|
||
|
||
无论你是在 Claude Code 之上构建工具、参与类似项目的开发，还是对一个生产级 AI CLI 的架构设计感到好奇，本分析都能为你提供详尽的内部结构图。
|
||
|
||
## 为什么做这个？
|
||
|
||
Claude Code 是一个复杂的实际应用，它在单一 TypeScript 代码库中集成了 LLM 编排、终端 UI 渲染、插件系统、多智能体协调等功能。理解其架构可以帮助你深入了解：
|
||
|
||
- 如何设计基于工具的 LLM Agent 系统
|
||
- React 终端 UI（Ink）的实际应用模式
|
||
- AI 代码助手的权限与安全模型
|
||
- 上下文窗口管理与压缩策略
|
||
- 多智能体任务编排
|
||
|
||
## 涵盖内容
|
||
|
||
[完整分析](DOCUMENTATION.md) 包含以下章节：
|
||
|
||
| 章节 | 描述 |
|
||
|------|------|
|
||
| [项目概览](DOCUMENTATION.md#1-project-overview) | 高层能力与功能概述 |
|
||
| [技术栈](DOCUMENTATION.md#2-technology-stack) | 运行时、框架和依赖 |
|
||
| [目录结构](DOCUMENTATION.md#3-directory-structure) | 完整源码树布局（37 个子目录） |
|
||
| [入口点](DOCUMENTATION.md#4-entry-points) | 引导启动、CLI、SDK 和 MCP 入口 |
|
||
| [核心架构](DOCUMENTATION.md#5-core-architecture) | 查询引擎、上下文构建器、成本追踪 |
|
||
| [工具系统](DOCUMENTATION.md#6-tool-system) | 全部 41 个工具，按类别分类说明 |
|
||
| [命令系统](DOCUMENTATION.md#7-command-system) | 全部 101 个斜杠命令，按功能组织 |
|
||
| [状态管理](DOCUMENTATION.md#8-state-management) | Zustand 风格状态存储及关键状态字段 |
|
||
| [任务系统](DOCUMENTATION.md#9-task-system) | 任务类型、生命周期和状态管理 |
|
||
| [服务与集成](DOCUMENTATION.md#10-services--integrations) | API 客户端、MCP、分析、压缩等 |
|
||
| [UI 层](DOCUMENTATION.md#11-ui-layer) | React/Ink 组件架构（130+ 组件） |
|
||
| [工具函数](DOCUMENTATION.md#12-utilities) | 300+ 工具模块，覆盖所有类别 |
|
||
| [特殊模式](DOCUMENTATION.md#13-special-modes) | Bridge、Kairos、协调器、语音、计划、Vim 模式 |
|
||
| [插件与技能](DOCUMENTATION.md#14-plugins--skills) | 插件和技能扩展系统 |
|
||
| [钩子与可扩展性](DOCUMENTATION.md#15-hooks--extensibility) | 钩子模式和 React Hooks |
|
||
| [文件统计](DOCUMENTATION.md#16-file-statistics) | 代码库规模与模块数量 |
|
||
| [架构模式](DOCUMENTATION.md#17-architectural-patterns) | 关键设计模式与原则 |
|
||
|
||
## 快速开始
|
||
|
||
直接阅读文档即可：
|
||
|
||
```bash
|
||
# 克隆仓库
|
||
git clone https://github.com/YOUR_USERNAME/claude-code-analysis.git
|
||
|
||
# 打开分析文档
|
||
open DOCUMENTATION.md
|
||
```
|
||
|
||
## 免责声明
|
||
|
||
> **这是一份非官方的独立分析。** Claude Code 是 [Anthropic](https://www.anthropic.com/) 的产品。本项目与 Anthropic 无关，未获其认可或赞助。所有商标归其各自所有者所有。
|
||
|
||
## 许可证
|
||
|
||
本项目采用 [MIT 许可证](LICENSE) 开源。
|
||
|
||
---
|
||
|
||
📖 **[阅读完整分析（中文） →](DOCUMENTATION.zh-CN.md)**
|
||
|
||
📖 **[阅读完整分析（English） →](DOCUMENTATION.md)**
|
||
|
||
🇺🇸 **[English Version →](README.md)**
|