Claude Agent SDK

Claude Agent SDK 的核心是 Agent 循环（Agent Loop）——一个经过数十万开发者生产验证的自主执行引擎。循环流程：

• 接收用户查询
• LLM 决定下一步行动（调用工具或返回结果）
• 执行工具调用（文件读写、Shell 命令、MCP Server 等）
• 将工具结果注入上下文
• 重复步骤 2-4 直到任务完成。这个循环看似简单，但包含大量工程细节：工具调用的错误重试（网络超时、API 限流）、上下文截断（超过模型窗口时自动摘要）、子 Agent 管理（创建、通信、生命周期）、权限检查（每次工具调用前验证是否允许）。Claude Agent SDK 将这些复杂性封装为 query() 函数调用，开发者只需指定允许的工具列表和权限模式，Agent 就能自主执行任务

Claude Agent SDK 提供两类工具：内置工具和 MCP 工具。

内置工具包括：Read（读取文件）、Write（写入文件）、Edit（精确编辑文件）、Bash（执行 Shell 命令）、WebSearch（网络搜索）等，这些工具经过 Claude Code 的长期打磨，具备精确的文件编辑能力（基于 diff 算法）、安全的 Shell 执行（沙箱隔离）、流式输出（实时返回工具结果）。

MCP（Model Context Protocol）是 Anthropic 提出的开放协议，标准化 LLM 与外部工具/数据源的连接。

Claude Agent SDK 原生支持 MCP，开发者可以通过 mcpServers 配置连接任何 MCP Server（如 GitHub、Slack、数据库、自定义 API），Agent 就能自动发现和调用这些外部能力。

例如，连接 GitHub MCP Server 后，Agent 可以自动创建 Issue、提交 PR、审查代码；连接 Slack MCP Server 后，Agent 可以发送消息、读取频道历史。

Claude Agent SDK 的权限系统是经过生产验证的安全模型，控制 Agent 能做什么、不能做什么。

权限模式（Permission Mode）分为三种：default（默认模式，每次工具调用前询问用户确认）、allowedTools（白名单模式，只允许指定工具，无需确认）、full（完全自主模式，所有工具无需确认，适合无人值守场景）。

开发者可以为不同工具配置不同的权限级别：例如，允许 Read 工具无需确认（只读操作安全），但 Bash 工具需要确认（可能执行危险命令）。

Hook 系统允许在 Agent 循环的关键节点插入自定义逻辑：preToolUse（工具调用前检查参数）、postToolUse（工具调用后处理结果）、onError（错误时触发告警）。

这种细粒度的控制使 Claude Agent SDK 既能用于交互式场景（用户实时监督），也能用于无人值守场景（CI/CD、定时任务）。