Claude Agent SDK

项目概述

该项目是 Anthropic 官方提供的 Claude Agent SDK for Python。它是一个软件开发工具包，允许开发者通过 Python 代码与 Claude Code（一个专为编码和智能体任务设计的 Claude 应用程序）进行交互、集成和扩展，从而构建强大的、由 Claude 驱动的AI智能体（Agent）。

核心功能与特性

1. 两种主要交互模式：

· query() 函数：一个简单、高级的接口，用于执行单次查询并获取流式响应。适合快速、简单的交互。

· ClaudeSDKClient 类：一个功能更全面、低级别的客户端，支持双向、交互式对话。这是构建复杂应用的基础，支持自定义工具（Tools） 和钩子（Hooks）。

2. 自定义工具（In-Process MCP Servers）：

· 核心创新：允许开发者将Python函数直接定义为工具供Claude调用，无需运行独立的MCP（Model Context Protocol）服务器进程。

· 实现方式：使用 @tool 装饰器定义函数，然后使用 create_sdk_mcp_server() 将其打包成一个SDK MCP服务器，最后通过 ClaudeAgentOptions 提供给Claude。

· 优势：

· 无需子进程管理：工具运行在与应用相同的Python进程中。

· 性能更好：避免了进程间通信（IPC）的开销。

· 部署更简单：只需管理一个Python进程。

· 调试更容易：所有代码在同一进程，便于跟踪和调试。

· 类型安全：直接使用Python函数，支持类型提示。

· 兼容性：支持同时使用SDK MCP服务器（内部）和外部MCP服务器（子进程）。

3. 钩子（Hooks）：

· 功能：允许开发者在Claude智能体循环的特定时间点（如 PreToolUse）注入自定义Python逻辑。