深度解析 Claude Code 的 Agent 主循环、工具控制体系、系统提示词架构与多 Agent 协作机制，提炼可借鉴的工程实践。
Claude Code 是一个多层次的 Agent 系统，核心是无限循环的 query 引擎，围绕其建立了工具系统、权限体系和多 Agent 协调层。
每个子系统都有清晰的职责边界，点击卡片查看详细解析。
query.ts 中的 while(true) 主循环，驱动 API 流式调用、工具执行、上下文更新。QueryEngine 作为 SDK 外壳管理会话状态和消息持久化。
系统提示词由 10+ 个独立函数段组成，静态段走全局 Prompt Cache，动态段（环境、MCP指令、技能等）按需构建，通过 BOUNDARY 标记分隔。
从 Deny Rules 到 Bypass Mode，每次工具调用经过 12个决策节点。5 种权限模式 + 沙箱集成 + AI 分类器辅助决策。
Coordinator 模式下，主 Agent 扮演编排者，通过 AgentTool 异步派生 Worker，结果经 task-notification XML 回传。Mailbox 文件系统支持 Teammate 间通信。
从并发工具执行、错误恢复路径、Token 预算管理到 Prompt Cache 优化，提炼 10+ 个可直接应用到自建 Agent 系统的工程模式。
MCP 服务器通过 ListTools RPC 动态暴露工具，名称规范化为 mcp__server__tool，每个 Agent 可继承父 Agent 的 MCP 客户端或拥有独立 MCP 配置。