# 欢迎
欢迎阅读 Claude Code 源码分析文档！
## 🎯 推荐阅读路径
### 新手路径
如果你是第一次了解 Claude Code：
1. [项目概览](/halls-organization-zh/gai-lan.md) - 了解 Claude Code 是什么
2. [架构设计](/halls-organization-zh/gai-nian/jia-gou.md) - 理解整体架构
3. [Query Loop](/halls-organization-zh/shi-xian/cha-xun-xun-huan.md) - 核心执行流程
4. [工具系统](/halls-organization-zh/readme-4.md) - 工具的使用和实现
### 开发者路径
如果你想扩展 Claude Code：
1. [工具接口设计](/halls-organization-zh/gong-ju-jie-kou.md) - 如何创建工具
2. [Skills 系统](/halls-organization-zh/kuo-zhan/ji-neng.md) - 添加上下文
3. [Plugins 系统](/halls-organization-zh/kuo-zhan/cha-jian.md) - 开发插件
4. [MCP 集成](/halls-organization-zh/kuo-zhan/mcp.md) - 集成外部工具
### 架构师路径
如果你想深入理解设计：
1. [设计哲学](/halls-organization-zh/gai-nian/li-nian.md) - 核心设计原则
2. [上下文管理](/halls-organization-zh/readme-1.md) - 压缩策略
3. [权限与安全](/halls-organization-zh/an-quan/readme.md) - 安全机制
4. [多 Agent 系统](/halls-organization-zh/dai-li/readme.md) - 协作模式
### 性能优化路径
如果你关注性能：
1. [启动优化](/halls-organization-zh/xing-neng/qi-dong.md) - 快速启动技术
2. [流式工具执行](/halls-organization-zh/xing-neng/liu-shi-gong-ju.md) - 并发执行
3. [缓存策略](/halls-organization-zh/xing-neng/huan-cun.md) - 多层缓存
4. [并发控制](/halls-organization-zh/xing-neng/bing-fa.md) - 资源管理
## 🔍 按主题查找
### 想了解核心机制？
* [Query Loop](/halls-organization-zh/shi-xian/cha-xun-xun-huan.md) - 执行引擎
* [状态管理](/halls-organization-zh/zhuang-tai-guan-li.md) - 状态系统
* [消息流转](/halls-organization-zh/shi-xian/xiao-xi-liu.md) - 消息处理
### 想了解工具实现？
* [FileEditTool](/halls-organization-zh/wen-jian-bian-ji.md) - 文件编辑
* [BashTool](/halls-organization-zh/gong-ju/bash-gong-ju.md) - Shell 执行
* [AgentTool](/halls-organization-zh/gong-ju/dai-li-gong-ju.md) - 子 Agent
### 想了解安全机制？
* [权限模式](/halls-organization-zh/an-quan/quan-xian-mo-shi.md) - Auto/Manual/Supervised
* [Bash 权限检查](/halls-organization-zh/an-quan/bash-quan-xian.md) - 2600+ 行规则
* [沙箱执行](/halls-organization-zh/an-quan/sha-xiang.md) - 隔离环境
### 想了解扩展方式？
* [Skills](/halls-organization-zh/kuo-zhan/ji-neng.md) - Markdown 上下文
* [Plugins](/halls-organization-zh/kuo-zhan/cha-jian.md) - TypeScript 插件
* [MCP](/halls-organization-zh/kuo-zhan/mcp.md) - 外部工具集成
* [Hooks](/halls-organization-zh/kuo-zhan/gou-zi.md) - 事件自动化
## 📈 文档统计
* **总页面**: 57 个
* **主要章节**: 9 个
* **代码示例**: 200+
* **架构图**: 20+
## 🎓 学习建议
### 第一天：基础理解
* 阅读项目概览
* 理解核心架构
* 了解 Query Loop
### 第二天：深入实现
* 学习工具系统
* 理解状态管理
* 探索消息流转
### 第三天：高级特性
* 多 Agent 协作
* 上下文压缩
* Permission system
### 第四天：扩展开发
* 创建 Skills
* 开发 Plugins
* 配置 MCP
## 💡 常见问题
Q: 如何快速理解 Claude Code 的核心？
A: 阅读这三个文档：
1. [架构设计](/halls-organization-zh/gai-nian/jia-gou.md)
2. [Query Loop](/halls-organization-zh/shi-xian/cha-xun-xun-huan.md)
3. [工具系统](/halls-organization-zh/readme-4.md)
Q: 如何开始扩展 Claude Code？
A: 从最简单的开始：
1. 创建一个 [Skill](/halls-organization-zh/kuo-zhan/ji-neng.md)
2. 尝试创建一个 [Hook](/halls-organization-zh/kuo-zhan/gou-zi.md)
3. 开发一个简单的 [Plugin](/halls-organization-zh/kuo-zhan/cha-jian.md)
Q: 文档太长，如何快速查找？
A: 使用以下资源：
* [术语表](/halls-organization-zh/shu-yu-biao.md) - 查找概念定义
* [关键文件索引](/halls-organization-zh/guan-jian-wen-jian.md) - 定位源码文件
* [目录结构](/halls-organization-zh/fu-lu/mu-lu-jie-gou.md) - 了解代码组织
## 🔗 相关链接
* [Claude Code 官网](https://claude.ai/code)
* [Anthropic 文档](https://docs.anthropic.com/)
* [MCP 协议](https://modelcontextprotocol.io/)
## 📞 反馈
如有问题或建议，欢迎：
* 提交 GitHub Issue
* 发起 Pull Request
* 参与讨论
***
**开始阅读**: [docs/README.md](broken://pages/bd3ef33ee4e1f7f088b9e8635e6ec2b0626a2765)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://halls-organization-2.gitbook.io/halls-organization-zh/huan-ying.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.