anthropic-agent-sdk

anthropic-agent-sdk

Claude Agent SDK（code.claude.com/docs/en/agent-sdk）——用于使用 TypeScript / Python 构建 Agent 的官方 SDK 参考资料。涵盖通过 query() 运行 Agent 循环、自定义工具（进程内 MCP）、连接外部 MCP、hooks、 subagents、权限（canUseTool）、会话持久化/恢复/分支、streaming、structured outputs、 生产环境托管。

Claude Code CLI 本体请参阅 anthropic-claude-code / anthropic-claude-code-extend，直接调用 Messages API 请参阅 anthropic-api-core，Claude API 侧的 tool use / Agent Skills / MCP 请参阅 anthropic-api-tools-mcp （本技能负责通过 SDK 构建和运维 Agent）。

来源：https://code.claude.com/docs/en/agent-sdk ，获取于 2026-10-16（当时的 npm @anthropic-ai/claude-agent-sdk 0.3.301 / PyPI claude-agent-sdk 0.2.168）。

目录结构

skills/anthropic-agent-sdk/
  SKILL.md
  references/
    getting-started/
      README.md
      agent-loop.md
      claude-code-features.md
      configuration.md
      examples.md
      migration-guide.md
      overview.md
      quickstart.md
    api-reference/
      README.md
      python.md
      typescript.md
    extending/
      README.md
      custom-tools.md
      hooks.md
      mcp.md
      plugins.md
      skills.md
      slash-commands.md
      subagents.md
      tool-search.md
    sessions-io/
      README.md
      file-checkpointing.md
      session-storage.md
      sessions.md
      streaming-output.md
      streaming-vs-single-mode.md
      structured-outputs.md
      todo-tracking.md
    control/
      README.md
      modifying-system-prompts.md
      permissions.md
      user-input.md
    operations/
      README.md
      cost-tracking.md
      hosting.md
      observability.md
      secure-deployment.md
      troubleshooting.md
  samples/
    README.md
    minimal-agent.md
    configure-agent.md
    custom-tools.md
    mcp-servers.md
    hooks.md
    permissions.md
    subagents.md
    sessions.md
    streaming.md
    structured-outputs.md
    system-prompts.md
  scripts/
    README.md
    setup.md
    runtime.md

探索步骤

根据任务查找类别，再通过类别的 README.md 确定目标页面：

1. 在下方映射表中查找与任务对应的类别
2. 参阅该类别的 references/{category}/README.md（samples/ scripts/ 则参阅其根目录下的 README.md），确定目标页面
3. Read 对应的 .md 文件以查看详细信息

任务 → 类别映射

任务	类别	参考 README
想了解 Agent SDK 概览和 Agent 循环的运行机制・安装并创建第一个 Agent・从 Claude Code SDK 迁移・在 SDK 中使用 Claude Code 的功能（CLAUDE.md、Agent Skills、hooks）・组装 options 对象（model / fallbackModel, env / cwd / maxTurns / maxBudgetUsd）・在会话期间更改 model 或 permission mode（setModel / setPermissionMode / applyFlagSettings / updateSettings）・查找可运行的示例项目（claude-agent-sdk-demos / Claude Cookbook）	getting-started	references/getting-started/README.md
想确认 query() 或 ClaudeAgentOptions / Options 等 TypeScript / Python 的完整类型和函数签名	api-reference	references/api-reference/README.md
想定义自定义工具（进程内 MCP、createSdkMcpServer）・连接外部 MCP 服务・通过 hooks 控制工具调用・使用 plugins・处理 Agent Skills（SKILL.md）的 skills 选项・按命令名称调用（/compact、/clear、自定义命令。slash-commands 已整合到 skills 中）・处理 subagents・tool search	extending	references/extending/README.md
想处理会话持久化/恢复/分支（resume / fork）・保存到外部存储・file checkpointing・todo 管理・streaming 输出・structured outputs	sessions-io	references/sessions-io/README.md
想自定义 system prompt・通过 permission mode 或 canUseTool 控制权限・处理用户输入/审批流程	control	references/control/README.md
想了解生产环境托管・安全部署・通过 OpenTelemetry 实现 observability・成本/令牌跟踪・错误故障排查	operations	references/operations/README.md
想了解典型用法（最小 Agent、options 配置（configure-agent）、自定义工具、连接 MCP 服务、hooks、权限、subagents、会话延续、streaming、structured outputs、自定义 system prompt）	samples	samples/README.md
想了解 SDK 安装・API 密钥设置・用于托管的 telemetry 环境变量	scripts	scripts/README.md