Repolode
anthropics

anthropics/claude-agent-sdk-python

基于 Claude Code 构建智能体的 Python SDK,提供 query()、交互式客户端、进程内自定义工具和 hooks。

Star
8,304
Fork
1,363
未关闭 Issue
571
最近提交
18小时前

这是什么?

Claude Agent SDK for Python 让 Python 应用能够以编程方式调用 Claude Code。通过 pip 安装后,可以使用 query() 发送提示并逐条遍历流式返回的消息,也可以使用 ClaudeSDKClient 进行双向的多轮对话。

该包已内置 Claude Code CLI,默认无需额外安装,也可以指定系统级安装或自定义 CLI 路径。默认情况下 Claude 可使用完整的 Claude Code 工具集(如 Read、Write、Edit、Bash),并可通过 allowed_tools、disallowed_tools 和 permission_mode 控制工具审批。

借助 ClaudeSDKClient,可以把 Python 函数定义为以进程内 MCP 服务器运行的自定义工具,也可以注册在智能体循环特定节点执行的 hooks,例如在 Bash 命令执行前将其拦截。SDK 还提供了类型化的配置项、消息类和错误类,便于处理运行结果。

核心功能

  • 01通过异步 query() 函数获取 Claude Code 的流式响应。
  • 02使用 ClaudeSDKClient 进行多轮交互式会话。
  • 03用 Python 装饰器将函数定义为进程内 MCP 服务器形式的自定义工具。
  • 04注册在智能体循环各节点执行的 Python hooks。
  • 05通过允许与禁止工具列表及权限模式控制工具调用审批。

适用场景

  • 在 Python 应用或内部工具中嵌入 Claude 编码智能体。
  • 将领域相关的 Python 函数作为工具供 Claude 调用。
  • 借助 hooks 实施策略,例如拦截特定的 Shell 命令。
  • 构建在指定项目目录中运行 Claude Code 的自动化流程。

快速上手

  1. 1

    从 PyPI 安装 SDK

    pip install claude-agent-sdk
  2. 2

    将 README 快速开始代码保存为 Python 文件并运行

使用前须知

  • 使用须遵守 Anthropic 的商业服务条款,而不仅是 MIT 许可证。
  • 需要 Python 3.10 或更高版本。
  • 调用 Claude 需要访问 Anthropic 服务及相应凭证。

标签

常见问题

claude-agent-sdk-python 是什么?
基于 Claude Code 构建智能体的 Python SDK,提供 query()、交互式客户端、进程内自定义工具和 hooks。 Claude Agent SDK for Python 让 Python 应用能够以编程方式调用 Claude Code。通过 pip 安装后,可以使用 query() 发送提示并逐条遍历流式返回的消息,也可以使用 ClaudeSDKClient 进行双向的多轮对话。
claude-agent-sdk-python 可以免费使用吗?用的什么许可证?
claude-agent-sdk-python 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
claude-agent-sdk-python 还在维护吗?
活跃维护中。claude-agent-sdk-python 最近一次提交是在 2026年10月19日。
claude-agent-sdk-python 适合用来做什么?
在 Python 应用或内部工具中嵌入 Claude 编码智能体。 将领域相关的 Python 函数作为工具供 Claude 调用。 借助 hooks 实施策略,例如拦截特定的 Shell 命令。 构建在指定项目目录中运行 Claude Code 的自动化流程。
claude-agent-sdk-python 怎么安装和运行?
从 PyPI 安装 SDK: pip install claude-agent-sdk 将 README 快速开始代码保存为 Python 文件并运行
在哪里获取 claude-agent-sdk-python?
源代码和安装说明在 GitHub 上:https://github.com/anthropics/claude-agent-sdk-python

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目