对 https://github.com/kejun/claude-code 项目的完整深度分析
分析日期：2026-04-01
代码规模：1,996 文件，514,038 行代码
分析团队：OpenClaw 多代理协作（5 个子代理并行）
5 个子代理并行分析 3 小时，输出 33 份详细文档，309KB 分析内容
| 分析方向 | 文档数 | 大小 | 核心内容 |
|---|---|---|---|
| 核心架构 | 6 份 | 55KB | 实时 Steering、消息队列、分层 Agent、6 大状态机 |
| 上下文与安全 | 6 份 | 70KB | 92% 触发压缩、6 层���限、CLAUDE.md 记忆 |
| 工具系统 | 5 份 | 104KB | 6 阶段管道、并发上限 10、MCP 扩展 |
| 设计哲学 | 5 份 | 35KB | Edit 先读后写、17 Hooks、Skills 元工具 |
| 实战路线 | 11 份 | 45KB | 开源重建、Prompt 分层、极简 Harness |
- 实时 Steering 与消息队列 - h2A 双缓冲异步队列 + Promise 迭代器
- 分层多 Agent 架构 - Leader→SubAgent→Task Agent 三层设计
- 智能上下文压缩 - 92% Token 使用率触发 wU2 压缩器
- 6 层权限验证 + 沙箱 - UI 输入到输出过滤的全链路安全
- 工具执行框架 - 6 阶段管道，并发上限 10，独立错误域
- Edit 强制先读后写 - 行级 SHA256 hash 验证
- 17 个 Hooks 生命周期 - 可编程治理层
- Skills 作为 Meta-Tool - 降低 90% prompt 消耗
- 6 大状态机 - 可监控、可导出
- CLAUDE.md 持久化记忆 - 越用越聪明
- System Prompt 分层注入 - 每轮加载最新环境
- 极简 Harness 哲学 - 1 个 Agent Loop + 工具集
- MCP 深度集成 - 3,348 行客户端代码
- React UI 组件系统 - 146+ 组件，87+ Hooks
- 开源重建实战路线 - 51 万行源码可直接抄作业
claude-code-deep-analysis/
├── README.md # 本文件
├── SUMMARY.md # 执行摘要
├── architecture/ # 核心架构分析
│ ├── README.md
│ ├── 01-realtime-steering.md
│ ├── 02-multi-agent-architecture.md
│ ├── 03-state-machines.md
│ ├── 04-architecture-summary.md
│ └── 05-flow-diagrams.md
├── context-security/ # 上下文与安全
│ ├── README.md
│ ├── 00-summary.md
│ ├── 01-context-compression.md
│ ├── 02-security-layers.md
│ ├── 03-claude-md-memory.md
│ └── diagrams.md
├── tool-system/ # 工具系统
│ ├── README.md
│ ├── tool-execution-framework.md
│ ├── tool-ecosystem-concurrency.md
│ ├── state-machine-monitoring.md
│ └── architecture-diagram.md
├── design-philosophy/ # 设计哲学
│ ├── README.md
│ ├── 00-executive-summary.md
│ ├── 01-hidden-features.md
│ ├── 02-hooks-governance.md
│ ├── 03-skills-meta-tool.md
│ └── 04-code-reference-index.md
└── rebuild-guide/ # 实战指南
├── README.md
├── 01-overview.md
├── 02-project-setup.md
├── 03-agent-loop.md
├── 04-permissions.md
├── 05-tools.md
├── 06-codebase-understanding.md
├── 07-ui-implementation.md
├── 08-plugins.md
├── 09-rebuild-case-study.md
└── 10-summary.md
- 新手入门：先读 rebuild-guide/01-overview.md
- 架构理解：阅读 architecture/04-architecture-summary.md
- 安全机制：阅读 context-security/02-security-layers.md
- 工具系统：阅读 tool-system/tool-execution-framework.md
- 实战重建：跟随 rebuild-guide/ 完整指南
| 文档 | 说明 |
|---|---|
| SUMMARY.md | 15 大机制完整详解 |
| architecture/03-state-machines.md | 6 大状态机详解 |
| context-security/03-claude-md-memory.md | CLAUDE.md 记忆系统 |
| tool-system/state-machine-monitoring.md | 监控面板集成 |
| rebuild-guide/03-agent-loop.md | Agent Loop 完整实现 |
| 维度 | 数量 |
|---|---|
| 总文件数 | 1,996 |
| TypeScript 文件 | 1,987 |
| 代码行数 | ~514,000+ |
| CLI 命令 | 103+ |
| 工具（Tools） | 44+ |
| React 组件 | 146+ |
| React Hooks | 87+ |
| 服务（Services） | 38+ |
| 工具函数模块 | 298+ |
| 技术 | 版本 | 作用 |
|---|---|---|
| Bun | ≥1.3.5 | 运行时，启动快 3-4 倍 |
| TypeScript | ESNext | 类型安全 |
| React + Ink | Latest | 终端组件化 UI |
| Zustand | Latest | 状态管理 |
| Zod | Latest | Schema 验证 |
| MCP SDK | Latest | Model Context Protocol |
- 分析基于 Claude Code v2.1.63 / 999.0.0-restored 源码
- 部分实现细节基于二进制文件分析和行为观察推断
- 具体算法和阈值可能随版本更新而变化
- 所有分析文档仅供学习研究使用
- 原始项目：https://github.com/kejun/claude-code
- Anthropic 官方：https://anthropic.com
- 飞书主报告：https://www.feishu.cn/docx/IW69dsr1No8tXox42hscyl4hn2g
分析报告由 OpenClaw 多代理协作生成 · 遵循 MIT 协议