这是什么？

Anthropic 正式发布了 Claude Agent SDK，让开发者可以像调用库一样使用 Claude Code 的能力。此前叫 Claude Code SDK，现在更名为 Agent SDK，支持 Python 和 TypeScript。

简单说：你不用自己实现 Agent 循环、工具执行、沙箱管理这些复杂的东西，SDK 已经内置好了。你的代码只需要告诉它"做什么"，Claude 会自主完成。

同时发布的还有 Claude Managed Agents——一个托管式代理基础设施，适合长时间运行、需要云端环境的任务。

---

核心能力

1. 内置工具

SDK 自带一套完整的工具，开箱即用：

| 工具 | 功能 |

|------|------|

| Read | 读取工作目录中的文件 |

| Write | 创建新文件 |

| Edit | 精确编辑现有文件 |

| Bash | 运行终端命令、脚本、git 操作 |

| Glob | 按模式查找文件（**/*.ts） |

| Grep | 正则搜索文件内容 |

| WebSearch | 搜索网络获取最新信息 |

| WebFetch | 抓取并解析网页内容 |

| AskUserQuestion | 向用户提问（多选） |

这意味着你的 Agent 可以直接读文件、改代码、跑命令、搜代码库，不需要你额外实现工具层。

2. Hooks（生命周期钩子）

在 Agent 执行的关键节点插入自定义代码：

• PreToolUse / PostToolUse：工具调用前后
• SessionStart / SessionEnd：会话开始/结束
• UserPromptSubmit：用户提交输入时

典型场景：审计日志、安全校验、行为拦截。

3. Subagents（子代理）

主 Agent 可以委托专门的子 Agent 处理特定任务。你可以定义：

• description：子 Agent 的职责描述
• prompt：系统提示词
• tools：可用工具子集

比如定义一个 "code-reviewer" 子 Agent，专门负责代码审查。

4. MCP 集成

支持 Model Context Protocol，可以连接外部工具和数据库：

```python

mcp_servers={

"playwright": {"command": "npx", "args": ["@playwright/mcp@latest"]}

}

```

这给你的 Agent 加上了浏览器自动化能力。

5. Sessions（会话管理）

Agent 有记忆。它记得之前读过什么文件、做过什么分析。你可以：

• 保存会话 ID
• 稍后恢复，继续对话
• Fork 会话，探索不同方向

---

Managed Agents 是什么？

如果你不想自己管理基础设施，可以用 Claude Managed Agents——Anthropic 托管的代理运行环境。

特点：

• 云端容器：预装 Python、Node.js、Go 等，可配置网络规则
• 长时间运行：任务可以跑几分钟甚至几小时
• 状态持久化：文件系统和对话历史都保存着
• 最小运维：不需要自己搭沙箱、工具执行层

适合场景：CI/CD 集成、批量处理、后台自动化任务。

---

和 Client SDK 有什么区别？

| | Client SDK | Agent SDK |

|---|---|---|

| 工具执行 | 你自己实现 | Claude 自动处理 |

| Agent 循环 | 你自己写 | SDK 内置 |

| 适用场景 | 精细控制每个 API 调用 | 让 Claude 自主完成任务 |

Client SDK 是"直接调用 API"，Agent SDK 是"把任务交给 Claude 让它自己搞定"。

---

谁会用？

• 自动化脚本开发者：CI/CD 中自动修复 bug、生成报告
• 应用开发者：在自己的产品里嵌入 Claude Agent 能力
• 企业用户：需要云端托管环境，不想自建基础设施
• 研究者和爱好者：快速搭建原型，探索 Agent 能力边界

---

怎么开始？

安装：

```bash

npm install @anthropic-ai/claude-agent-sdk

pip install claude-agent-sdk

```

设置 API Key：

```bash

export ANTHROPIC_API_KEY=your-api-key

```

第一个 Agent：

```python

import asyncio

from claude_agent_sdk import query, ClaudeAgentOptions

async def main():

async for message in query(

prompt="Find and fix the bug in auth.py",

options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"]),

):

if hasattr(message, "result"):

print(message.result)

asyncio.run(main())

```

---

限制和注意点

• Managed Agents 仍在 Beta：需要 managed-agents-2026-04-01 beta header
• API Key 认证：不允许用 claude.ai 登录或 rate limit 做第三方产品
• 品牌规范：可以叫 "Claude Agent"，但不能用 "Claude Code" 品牌元素

---

总结

Claude Agent SDK 的发布，意味着 Claude Code 的能力从一个"终端工具"扩展成了"可编程的 Agent 库"。你可以把它嵌入自己的产品、自动化流程、CI/CD 管道。

对于想构建生产级 AI Agent 的开发者，这是一个值得关注的官方方案——不需要自己从零搭工具链，SDK 已经把工具执行、权限控制、会话管理这些都做好了。

---

来源

• Agent SDK 官方文档：https://code.claude.com/docs/en/agent-sdk/overview
• Managed Agents 文档：https://platform.claude.com/docs/en/managed-agents/overview
• 发布时间：2026 年 4 月（beta header: managed-agents-2026-04-01）

参考来源

• https://code.claude.com/docs/en/agent-sdk/overview
• https://platform.claude.com/docs/en/managed-agents/overview

说明：该页面由基础模板稳定生成，后续可继续局部润色样式或补充模块，再进入发布检查。