ClaudeMap

Claude Agent SDK (Python)

Claude Agent SDK 的 Python 版本。

SDK 与工具officialsdkpythonanthropic
访问项目anthropics/claude-agent-sdk-python

Claude Agent SDK 的 Python 版本。它把 Claude Code Agent 循环（工具、上下文管理、hooks）嵌入 Python 程序，让你不用重写运行时就能构建生产级 agent。

它做什么

  • query() 异步生成器 API——迭代消息流（AssistantTextMessage / ToolUseBlock / ToolResultBlock / ResultMessage）
  • ClaudeAgentOptions 全字段：allowed_tools / permission_mode / cwd / model / hooks / mcp_servers / max_turns / max_budget_usd / fallback_model
  • MCP server 接入（stdio + HTTP/SSE），与项目级 .mcp.json 自动合并
  • hooks 系统——PreToolUse / PostToolUse / Stop / SubagentStop；配合 async 迭代做结构化 JSON 审计
  • 由内置 Claude Code CLI 驱动——继承所有内置工具、上下文管理、权限模型

什么时候用

Python 生态生产级 agent 首选——CI 流水线、分流 bot、研究助手，用 asyncio.gather(*queries, return_exceptions=True) 跑多 agent 调研。与 FastAPI 配合做服务化，配任意 Python 队列做后台分发，现有 logging 栈接审计。TypeScript SDK 的 Python 对位。

如何上手

pip install claude-agent-sdk
# 或
uv add claude-agent-sdk

依赖 Python 3.10+、PATH 上的 Claude Code CLI、以及设好的 ANTHROPIC_API_KEY。SDK 内部驱动 CLI。

注意事项

生产请 pin 到 major 版本——SDK 的 Pydantic 模型在 minor 版本之间会变。生产务必设 max_turns 和 max_budget_usd。多 agent 扇出请用 asyncio.gather(*queries, return_exceptions=True)——直接对 asyncio.as_completed 用 async generator 会抛 TypeError。

代码仓库

anthropics/claude-agent-sdk-python

收录日期

地图上的相关资源

  • Harness Bridge

    SDK / 工具

    一个本地启动器：让 Claude Code 与其他七种编码 harness 直连任意 OpenAI / Anthropic / Responses 兼容端点——不改任何一行配置文件。

    • launcher
    • local-models
    • cli
    • menu-bar
    查看

  • Claude for Siri

    SDK / 工具

    用你已登录的 Claude Code 账号回答 macOS Spotlight 与 Siri 的提问——一个实验性的 macOS 27 模型委派提供者。

    • macos
    • siri
    • spotlight
    • model-delegation
    查看

  • AI Coding Assistant Data Extractor

    SDK / 工具

    把十个 AI 编程助手的本地聊天记录提取成统一 JSONL——微调、分析，或赶在本地数据库被清空前备份多年的对话。纯标准库实现。

    • cli
    • data-export
    • jsonl
    • backup
    查看