Claude Agent SDK(TypeScript)
以编程方式构建能理解代码库、编辑文件并执行复杂工作流的 Claude 自主智能体。
- Star 数
- ★ 1.9k
- 最近更新
- 1 天前
- 主语言
- Shell
- FA 评分
- 63/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Claude API
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 希望在自己的 TypeScript 应用中嵌入可自主理解和修改代码库的智能体的开发者
- 不适合
- 需要模型供应商无关方案、不能绑定 Anthropic 生态的团队
- 不接受 Anthropic 商业服务条款与数据采集政策的用户
- 维护状态
- 近 30 天有提交最近提交 2026-11-20
- 源码审查
- 63/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Claude Agent SDK 是 Anthropic 官方的 TypeScript 软件包(npm 包名 @anthropic-ai/claude-agent-sdk),让开发者通过代码调用 Claude Code 的能力来构建 AI 智能体。它可以创建能理解代码库、编辑文件、运行命令并执行复杂工作流的自主智能体。它由 Claude Code SDK 演化而来,官方提供迁移指南说明破坏性变更。SDK 通过 npm 分发,要求 Node.js 18 及以上版本,完整的官方文档在 docs.claude.com。使用该 SDK 受 Anthropic 商业服务条款约束,并附带明确的数据采集、使用与保留政策。
安装后,开发者在 Node.js 18+ 项目中通过 npm 引入 @anthropic-ai/claude-agent-sdk,以编程方式创建智能体。这些智能体能够理解代码库、编辑文件、运行命令并执行复杂的多步骤工作流——即复用 Claude Code 的能力供自己的程序调用。SDK 是库/框架形态,由你的应用代码驱动,而非独立 CLI 或聊天界面。当从旧的 Claude Code SDK 迁移时,需按官方迁移指南处理破坏性变更。
- 希望在自己的 TypeScript 应用中嵌入可自主理解和修改代码库的智能体的开发者
- 需要程序化执行文件编辑与命令运行等复杂自动化工作流的工程团队
- 正在使用旧的 Claude Code SDK、需要迁移到新接口的现有项目
- 想基于 Claude Code 能力构建自有产品或服务并交付给最终用户的团队
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install @anthropic-ai/claude-agent-sdk
- 运行环境
- Node.js 18
如何安装或部署这个 Agent?
先确保环境为 Node.js 18 或更高版本,然后通过 npm 安装 SDK:
npm install @anthropic-ai/claude-agent-sdkREADME 未提供安装 Anthropic API 密钥等凭据配置的具体说明,这部分信息请查阅官方文档(https://docs.claude.com/en/api/agent-sdk/overview)。
如何使用这个 Agent?
README 未给出第一段可运行的调用代码。已记录的用法是:安装后在自己的 Node.js 代码中引入并调用该 SDK 来创建智能体,让它们理解代码库、编辑文件、运行命令、执行工作流。完整的 API 用法见官方文档;从 Claude Code SDK 迁移的项目请按迁移指南(https://docs.claude.com/en/docs/claude-code/sdk/migration-guide)处理破坏性变更。
这个 Agent 有哪些优点和局限?
- 官方 SDK,直接复用 Claude Code 的代码库理解、文件编辑与命令执行能力
- 一条 npm install 命令即可安装,Node.js 18+ 即可运行,上手成本低
- 提供从 Claude Code SDK 的官方迁移指南,便于既有项目升级
- 有官方文档站与 Claude Developers Discord 社区支持
- 与 Anthropic 生态绑定,使用受商业服务条款约束,非模型无关方案
- 会采集使用数据、对话数据及 /bug 反馈,对数据敏感的团队需评估隐私影响
- README 未提供许可证信息,也未给出可运行的示例代码或凭据配置步骤
- 需要 Node.js 18+ 运行时,且依赖对 Anthropic 服务的网络访问
这个 Agent 与同类方案有什么区别?
README 明确指出该 SDK 是 Claude Code SDK 的继任者:Claude Code SDK 已更名为 Claude Agent SDK,并存在破坏性变更,需要按官方迁移指南迁移。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Claude Agent SDK(TypeScript) 当前 | 63 · 存在缺口 | 代码库 / SDK | ★ 1.9k | 1 天前 | Shell | Claude API |
| Superset | 66 · 存在缺口 | 桌面应用免费版 + 付费版 | ★ 16k | 今天 | TypeScript | Codex · Claude Code |
| Context7 文档服务 | 59 · 缺口较多 | 命令行工具免费版 + 付费版 | ★ 65k | 2 天前 | TypeScript | — |
| OpenCode 目标模式插件 | 86 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 533 | 5 天前 | TypeScript | — |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
工作流展示了出色的最小权限实践:egress-firewall runner、网络白名单 enforce 模式、OIDC 联合身份而非静态 API key、显式 disallowedTools、最小 permissions 块、allowed_non_write_users 风险提示检查,以及 CLAUDE.md 中的加固自查脚本。扣分点:SDK 核心源码不在样本中,其运行时权限模型(user_confirmation、数据流)只能通过文档链接间接了解;rollback 机制未见任何证据。
示例测试结构严谨(conformance 套件、mock 与 live 分离、skipIf 环境守卫),Workflow 有 timeout。扣分点:SDK 本体的错误处理与失败消息无法从样本验证,conformance 套件仅在 examples 层面可见。
README 明确目标(Node 18+、npm 安装、编程式构建 agent),有从 Claude Code SDK 的迁移指南,环境要求清楚。扣分点:能力边界描述停留在营销层面('autonomous agents'),样本未展示 API 面或限制说明。
信息架构清晰(README/CLAUDE.md/LICENSE/examples 分层),CLAUDE.md 被正确用作贡献者指导而非产品指令,命名稳定(@anthropic-ai/claude-agent-sdk),有安装说明、issue 渠道、社区渠道、许可条款说明、维护主体明确。扣分点:无 CHANGELOG/版本历史证据,未见已知限制章节,LICENSE.md 为保留所有权利的商业条款而非开源许可。
SDK 提供 Claude Code 能力的编程化复用,边际价值明确且示例(session stores,含 Postgres/Redis 适配器与一致性测试)展示了工程深度。扣分点:成本(token 用量、费用)与收益权衡在样本中未讨论。
README 声明(安装、数据收集、许可)均可追溯到具体链接与仓库文件;CLAUDE.md 与工作流文件相互印证(workflow-hardening.yml、egress-firewall 被实际引用);数据收集声明与政策链接区分清楚。扣分点:'privacy safeguards' 为断言,无源码级证据可核对。
- SDK 核心源码与技能/插件文件未在样本中,运行时权限与数据流只能依赖官方文档链接,建议审阅 npm 包内实际源码。
- 许可为 Anthropic 商业条款(保留所有权利),非开源许可,商用集成前需法务确认。
- SDK 默认会收集使用数据与对话数据(含 /bug 反馈),对隐私敏感场景需评估。
- issue-triage 工作流对无写权限用户开放(allowed_non_write_users: "*"),虽已有检查提示,仍应持续关注提示注入风险。
常见问题
它和 Claude Code SDK 是什么关系?
如何安装和开始使用?
使用它会产生哪些数据采集?
许可证是什么?
出了问题或想要新功能怎么办?
Claude Agent SDK(TypeScript) 安全吗?
Claude Agent SDK(TypeScript) 还在维护吗?
Claude Agent SDK(TypeScript) 是谁开发的?
谢谢反馈,我们会据此改进页面。