2025 年下半年,Anthropic 把内部自用的 agent harness 抽出来,起了个名字 Claude Agent SDK (formerly Claude Code SDK),免费开源。这不是又一个 LangChain —— 这是一条让你站在 Claude Code 同一套基础设施之上做 agent 的路。
一 · 为什么叫 "Managed" What Anthropic Manages
所谓 "managed",指的是:agent 运行时所需要的所有麻烦事,SDK 都替你接好。你只写最少量的配置和业务逻辑。
- 上下文管理 —— 自动滑窗、压缩、关键事实抽取,不用你手工剪。
- 工具调用编排 —— tool_use / tool_result 的 round-trip 全部自动,中间失败自动重试。
- 权限与沙盒 —— 文件读写、网络请求、命令执行,每一步 per-tool 可以配置 allow/deny/ask。
- 观测层 —— 每一次 LLM 调用 · 每一次工具调用 · 每一次状态变更,都有日志事件流出来。
二 · 核心模块 Building Blocks
1. Harness · 主循环
Agent 的最内核是一个while not done: 循环:让模型产生思考 + 可选工具调用 → 执行工具 → 把结果回给模型 → 下一轮。SDK 把这个 loop 参数化,你可以定义最大轮次、token 预算、中止条件。
2. Tool Use + MCP
工具有两种来源:内建工具 (Read, Write, Bash, Grep, WebFetch ...) 和通过 MCP (Model Context Protocol) 接进来的外部服务。MCP 是 2024 年底 Anthropic 开源的标准,现在是行业事实标准 —— 一个 MCP server 写一遍,所有 agent 都能接。
3. Subagents · 分形
主 agent 可以 spawn 子 agent,每个 sub 拥有独立的 context 窗口和工具权限。这样长任务 (读 200 个文件 · 跑 10 个测试) 可以被拆到子 agent,父 agent 只看摘要,避免主 context 被冲爆。
4. Hooks · 生命周期钩子
在每一次 tool 调用前后、每次用户输入进来时,你可以挂钩子执行自定义逻辑 —— 审计、脱敏、拦截、自动化、通知。
5. Memory · 持久记忆
Agent 可以读写一个专属的笔记本 (~/.claude/memory),跨会话保留 —— 不是 RAG,也不是 fine-tune,是一种轻量的"工作手册",把学到的东西、用户的偏好写进去,下次自动加载。
三 · 和竞品对比 SDK Comparison
| 维度 | Anthropic Agent SDK | OpenAI Assistants API | LangGraph |
|---|---|---|---|
| 编程模型 | 函数式 · event-driven | 对象式 · polling | 状态机 · graph |
| 工具标准 | MCP · 开放 | OpenAI 专属 schema | Python 函数 |
| 本地 / 远端 | 本地优先 · 可 remote | 云端托管 | 全自己部署 |
| 开箱 subagent | ✓ | 有限 | 需手写 |
| Hooks / 审计 | ✓ 原生 | 需 webhook | 需自定义节点 |
| 生产成熟度 | Claude Code 自用,很高 | 中 | 高,但学习曲线陡 |
四 · 典型落地姿势 Deployment Patterns
→ CLI · 终端型 agent
最直接的用法,Claude Code 本身就是这样。适合开发、运维、科研一类的交互式任务。
→ IDE 集成
VS Code / JetBrains 系已经出了第一波 agent 插件 —— SDK 提供事件流、文件操作、会话持久化的全部接口。
→ 后台服务型
跑定时任务、处理邮件、审计日志。SDK 的 non-interactive 模式可以配合 cron 或 queue 跑。辉火云管家的夜间巡检就跑在这上面。
→ 多 agent 编排
主 agent 做 orchestrator,把任务拆给领域专家 subagent (代码 agent / 数据 agent / 客服 agent),这是 2026 年多 agent 系统的主流形态。
Agent SDK 把脚手架收进了 runtime,留给你的只剩业务逻辑和工具。
The scaffolding is now the runtime — you only bring the business.
— 青岛火一五信息科技 · 2026 年 4 月 —