mirror of
https://github.com/ComeOnOliver/claude-code-analysis.git
synced 2026-04-25 07:00:47 +09:00
ComeOnOliver
79 lines
4.1 KiB
Markdown
79 lines
4.1 KiB
Markdown
**[English](README.md)** | **[中文](README.zh-CN.md)**
|
|
|
|
# Claude Code Source Analysis
|
|
|
|
[](LICENSE)
|
|
[](DOCUMENTATION.md)
|
|
[](README.md)
|
|
[](README.zh-CN.md)
|
|
|
|
> A comprehensive reverse-engineering analysis of Claude Code's internal architecture, modules, and design patterns.
|
|
|
|
---
|
|
|
|
## What Is This?
|
|
|
|
This project is a deep-dive technical analysis of [Claude Code](https://docs.anthropic.com/en/docs/claude-code), Anthropic's official AI-powered CLI for software engineering. It documents the internal source tree structure, module boundaries, tool/command inventories, state management, and architectural patterns — all reverse-engineered from the source code.
|
|
|
|
Whether you're building tools on top of Claude Code, contributing to similar projects, or simply curious about how a production-grade AI CLI is architected, this analysis gives you a detailed map of the internals.
|
|
|
|
## Why Does This Exist?
|
|
|
|
Claude Code is a sophisticated, real-world application that combines LLM orchestration, terminal UI rendering, plugin systems, multi-agent coordination, and more — all in a single TypeScript codebase. Understanding its architecture provides valuable insight into:
|
|
|
|
- How to design tool-based LLM agent systems
|
|
- Real-world patterns for React-in-terminal UIs (Ink)
|
|
- Permission and security models for AI code assistants
|
|
- Context window management and compaction strategies
|
|
- Multi-agent task orchestration
|
|
|
|
## What's Covered
|
|
|
|
The [full analysis](DOCUMENTATION.md) covers:
|
|
|
|
| Section | Description |
|
|
|---------|-------------|
|
|
| [Project Overview](DOCUMENTATION.md#1-project-overview) | High-level capabilities and feature summary |
|
|
| [Technology Stack](DOCUMENTATION.md#2-technology-stack) | Runtime, frameworks, and dependencies |
|
|
| [Directory Structure](DOCUMENTATION.md#3-directory-structure) | Complete source tree layout (37 subdirectories) |
|
|
| [Entry Points](DOCUMENTATION.md#4-entry-points) | Bootstrap, CLI, SDK, and MCP entry points |
|
|
| [Core Architecture](DOCUMENTATION.md#5-core-architecture) | Query engine, context builder, cost tracking |
|
|
| [Tool System](DOCUMENTATION.md#6-tool-system) | All 41 tools with categories and descriptions |
|
|
| [Command System](DOCUMENTATION.md#7-command-system) | All 101 slash commands organized by function |
|
|
| [State Management](DOCUMENTATION.md#8-state-management) | Zustand-style store and key state fields |
|
|
| [Task System](DOCUMENTATION.md#9-task-system) | Task types, lifecycle, and state management |
|
|
| [Services & Integrations](DOCUMENTATION.md#10-services--integrations) | API client, MCP, analytics, compaction, and more |
|
|
| [UI Layer](DOCUMENTATION.md#11-ui-layer) | React/Ink component architecture (130+ components) |
|
|
| [Utilities](DOCUMENTATION.md#12-utilities) | 300+ utility modules across all categories |
|
|
| [Special Modes](DOCUMENTATION.md#13-special-modes) | Bridge, Kairos, Coordinator, Voice, Plan, Vim modes |
|
|
| [Plugins & Skills](DOCUMENTATION.md#14-plugins--skills) | Plugin and skill extension systems |
|
|
| [Hooks & Extensibility](DOCUMENTATION.md#15-hooks--extensibility) | Hook schemas and React hooks |
|
|
| [File Statistics](DOCUMENTATION.md#16-file-statistics) | Codebase size and module counts |
|
|
| [Architectural Patterns](DOCUMENTATION.md#17-architectural-patterns) | Key design patterns and principles |
|
|
|
|
## Quick Start
|
|
|
|
Just read the documentation:
|
|
|
|
```bash
|
|
# Clone the repo
|
|
git clone https://github.com/YOUR_USERNAME/claude-code-analysis.git
|
|
|
|
# Open the analysis
|
|
open DOCUMENTATION.md
|
|
```
|
|
|
|
## Disclaimer
|
|
|
|
> **This is an unofficial, independent analysis.** Claude Code is a product of [Anthropic](https://www.anthropic.com/). This project is not affiliated with, endorsed by, or sponsored by Anthropic. All trademarks belong to their respective owners.
|
|
|
|
## License
|
|
|
|
This project is licensed under the [MIT License](LICENSE).
|
|
|
|
---
|
|
|
|
📖 **[Read the Full Analysis →](DOCUMENTATION.md)**
|
|
|
|
🇨🇳 **[中文版 →](README.zh-CN.md)**
|