ClaudeCode 代码解读：从请求到工具执行

本篇作为快速上手章节，聚焦 ClaudeCode 在一次请求中的关键执行链路，帮助你先建立“读源码的主地图”。

1. 主流程总览

你可以把一次请求理解为四步：

1. 解析输入与上下文
2. 构建系统提示词（System Prompt）
3. 触发模型推理并决定是否调用工具
4. 写回会话状态并产出响应

2. 建议优先阅读的模块

• query.ts：主循环入口，串联一次请求执行
• QueryEngine：会话状态与消息编排核心
• tool 相关模块：工具定义、权限判断、执行与结果回填
• hooks 相关模块：用户侧扩展能力，介入请求生命周期

3. 阅读顺序建议

• 第一遍：只看函数调用关系，画出流程图
• 第二遍：关注状态结构（消息、上下文、工具结果）
• 第三遍：关注异常处理与边界（超时、权限、失败回滚）

4. 你可以重点回答的三个问题

• ClaudeCode 在哪里决定“继续对话”还是“调用工具”？
• 工具执行失败后，错误如何反馈给模型继续推理？
• 会话上下文如何压缩，避免 token 爆炸？

继续阅读建议：先看 query.ts 主循环，再看工具系统与上下文压缩章节，会更容易建立完整认知。