1. Claude Code QueryEngine 架构解析
在当今AI辅助编程领域,Claude Code的QueryEngine作为其核心引擎,承担着会话管理、LLM调用编排和工具执行等关键职责。这个由46K行代码构建的复杂系统,其设计哲学却出奇地简单——"愚钝的脚手架,聪明的模型"。
1.1 核心架构分层
QueryEngine采用清晰的两层架构设计:
会话层(QueryEngine)
- 生命周期:每个会话(Conversation)
- 核心职责:
- 维护会话状态和消息历史
- 累计用量统计和成本追踪
- 文件缓存管理
- 会话持久化与恢复
回合层(query())
- 生命周期:每个用户消息(Turn)
- 核心职责:
- API调用循环管理
- 工具执行与结果处理
- 自动消息压缩
- 预算强制执行
这种分层设计使得系统能够优雅地处理不同时间跨度的状态管理,同时保持核心逻辑的清晰性。
1.2 消息处理流程
每次submitMessage()调用都遵循严格的三个阶段:
输入处理阶段
- 处理斜杠命令(/compact, /clear等)
- 解析文件附件(图片、文档)
- 输入规范化(内容块与纯文本转换)
- 工具白名单检查
上下文组装阶段
- 动态构建系统提示词
- 集成CLAUDE.md配置
- 收集当前目录信息
- 加载已安装技能和插件上下文
query()循环阶段
- 执行核心while(true)循环
- 处理与LLM的多轮交互
- 管理工具执行流程
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心循环机制剖析
2.1 query()循环设计
query.ts中的query()函数虽然长达1,730行,但其核心结构却异常简洁:
javascript复制while (true) {
// 1. 预处理
executePreprocessingPipeline();
// 2. API调用
const response = await callLLMAPI();
// 3. 后处理
const shouldContinue = processResponse(response
