Welcome

欢迎阅读 Claude Code 源码分析文档！

🎯 推荐阅读路径

新手路径

如果你是第一次了解 Claude Code：

1. 项目概览 - 了解 Claude Code 是什么

2. 架构设计 - 理解整体架构

3. Query Loop - 核心执行流程

4. 工具系统 - 工具的使用和实现

开发者路径

如果你想扩展 Claude Code：

1. 工具接口设计 - 如何创建工具

2. Skills 系统 - 添加上下文

3. Plugins 系统 - 开发插件

4. MCP 集成 - 集成外部工具

架构师路径

如果你想深入理解设计：

1. 设计哲学 - 核心设计原则

2. 上下文管理 - 压缩策略

3. 权限与安全 - 安全机制

4. 多 Agent 系统 - 协作模式

性能优化路径

如果你关注性能：

1. 启动优化 - 快速启动技术

2. 流式工具执行 - 并发执行

3. 缓存策略 - 多层缓存

4. 并发控制 - 资源管理

🔍 按主题查找

想了解核心机制？

• Query Loop - 执行引擎

• 状态管理 - 状态系统

• 消息流转 - 消息处理

想了解工具实现？

• FileEditTool - 文件编辑

• BashTool - Shell 执行

• AgentTool - 子 Agent

想了解安全机制？

• 权限模式 - Auto/Manual/Supervised

• Bash 权限检查 - 2600+ 行规则

• 沙箱执行 - 隔离环境

想了解扩展方式？

• Skills - Markdown 上下文

• Plugins - TypeScript 插件

• MCP - 外部工具集成

• Hooks - 事件自动化

📈 文档统计

• 总页面: 57 个

• 主要章节: 9 个

• 代码示例: 200+

• 架构图: 20+

🎓 学习建议

第一天：基础理解

• 阅读项目概览

• 理解核心架构

• 了解 Query Loop

第二天：深入实现

• 学习工具系统

• 理解状态管理

• 探索消息流转

第三天：高级特性

• 多 Agent 协作

• 上下文压缩

• 权限系统

第四天：扩展开发

• 创建 Skills

• 开发 Plugins

• 配置 MCP

💡 常见问题

Q: 如何快速理解 Claude Code 的核心？

A: 阅读这三个文档：

1. 架构设计

2. Query Loop

3. 工具系统

Q: 如何开始扩展 Claude Code？

A: 从最简单的开始：

1. 创建一个 Skill

2. 尝试创建一个 Hook

3. 开发一个简单的 Plugin

Q: 文档太长，如何快速查找？

A: 使用以下资源：

• 术语表 - 查找概念定义

• 关键文件索引 - 定位源码文件

• 目录结构 - 了解代码组织

🔗 相关链接

• Claude Code 官网

• Anthropic 文档

• MCP 协议

📞 反馈

如有问题或建议，欢迎：

• 提交 GitHub Issue

• 发起 Pull Request

• 参与讨论

---

开始阅读: docs/README.md