Claude Agent SDK Python

活跃
GitHub Python MIT

简介

Claude Agent SDK 是 Anthropic 官方提供的 Python SDK，用于构建基于 Claude 的 AI Agent 应用。支持工具调用、多轮对话、Agent 编排等核心能力，是开发 Claude 原生 Agent 的首选工具包。

核心特性

  • 捆绑 Claude Code CLI — 无需单独安装，SDK 默认使用捆绑的 CLI
  • 进程内 MCP 工具 — 将自定义工具定义为作为进程内 MCP 服务器运行的 Python 函数，消除子进程开销
  • 钩子系统 — 在特定循环点拦截和控制智能体行为，提供确定性处理和自动化反馈
  • 权限控制 — allowed_tools、disallowed_tools 和 permission_mode 实现细粒度工具访问管理
  • 双向对话 — ClaudeSDKClient 支持带工具使用和流式传输的交互式多轮对话
  • 错误层级 — 为 CLI 缺失、连接问题、进程失败和 JSON 解码错误提供结构化错误类型

适用场景

💡 在 Python 中构建带自定义工具使用的 Claude 驱动 AI 智能体
💡 创建进程内 MCP 工具服务器以实现高性能工具执行
💡 通过钩子实现智能体行为守卫和自动化反馈
💡 开发带流式响应的多轮对话智能体
💡 通过 Claude Code 自动化文件编辑、bash 命令和项目任务

标签

anthropic python agent-sdk claude tools

分类

⚡ Agent 工具

快速开始

通过 pip install claude-agent-sdk 安装（Python 3.10+）。快速开始：从 claude_agent_sdk 导入 anyio 和 query，然后运行 async for message in query(prompt='What is 2 + 2?'): print(message)。CLI 已捆绑，无需单独安装。
访问 GitHub

相关项目