一款 VS Code 扩展,把纯文本 .chat.md 文件变成可编辑的 AI 对话,并支持多种大模型调用 MCP 工具。
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
从 PyPI 安装 SDK
pip install claude-agent-sdk - 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 数据每日更新。
相关项目
FastGPT 是一个开源的 AI Agent 构建平台,提供知识库数据处理、RAG 检索与可视化工作流编排。
面向智能体的记忆基础设施,将对话与执行过程转化为可持久化的结构化记忆,支持 Python 与 TypeScript。
一款面向 AI 智能体的开源 Chromium 浏览器,在本机运行,智能体可借助你已登录的账号并行处理网页任务。
一个把数字人与大语言模型接入业务系统的 agent 框架,支持多终端接入。