开发与工程 ✓ Anthropic · 官方 typescript-sdknpm-packagecode-editingnodejs

Claude Agent SDK(TypeScript)

以编程方式构建能理解代码库、编辑文件并执行复杂工作流的 Claude 自主智能体。

Star 数
★ 1.9k
最近更新
1 天前
主语言
Shell

30 秒速览

运行形态
代码库 / SDK开发框架
可在哪里用
平台专用Claude API
上手难度
低 · 几分钟可跑通
开始前需要
Node.js 18+@anthropic-ai/claude-agent-sdkShell / 命令行网络访问本地文件系统
典型场景
希望在自己的 TypeScript 应用中嵌入可自主理解和修改代码库的智能体的开发者
不适合
  • 需要模型供应商无关方案、不能绑定 Anthropic 生态的团队
  • 不接受 Anthropic 商业服务条款与数据采集政策的用户
维护状态
近 30 天有提交最近提交 2026-11-20

这个 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 迁移时,需按官方迁移指南处理破坏性变更。

  1. 希望在自己的 TypeScript 应用中嵌入可自主理解和修改代码库的智能体的开发者
  2. 需要程序化执行文件编辑与命令运行等复杂自动化工作流的工程团队
  3. 正在使用旧的 Claude Code SDK、需要迁移到新接口的现有项目
  4. 想基于 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-sdk

README 未提供安装 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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
63/ 100 五分制 3.2 / 5
信任安全 19/29
可靠稳定 9/14
适用触发 10/18
规范维护 10/18
有效结果 10/13
证据核验 5/8
查看各维度的扣分理由
信任安全19 / 29 · 3.3/5

工作流展示了出色的最小权限实践:egress-firewall runner、网络白名单 enforce 模式、OIDC 联合身份而非静态 API key、显式 disallowedTools、最小 permissions 块、allowed_non_write_users 风险提示检查,以及 CLAUDE.md 中的加固自查脚本。扣分点:SDK 核心源码不在样本中,其运行时权限模型(user_confirmation、数据流)只能通过文档链接间接了解;rollback 机制未见任何证据。

可靠稳定9 / 14 · 3.2/5

示例测试结构严谨(conformance 套件、mock 与 live 分离、skipIf 环境守卫),Workflow 有 timeout。扣分点:SDK 本体的错误处理与失败消息无法从样本验证,conformance 套件仅在 examples 层面可见。

适用触发10 / 18 · 2.8/5

README 明确目标(Node 18+、npm 安装、编程式构建 agent),有从 Claude Code SDK 的迁移指南,环境要求清楚。扣分点:能力边界描述停留在营销层面('autonomous agents'),样本未展示 API 面或限制说明。

规范维护10 / 18 · 2.8/5

信息架构清晰(README/CLAUDE.md/LICENSE/examples 分层),CLAUDE.md 被正确用作贡献者指导而非产品指令,命名稳定(@anthropic-ai/claude-agent-sdk),有安装说明、issue 渠道、社区渠道、许可条款说明、维护主体明确。扣分点:无 CHANGELOG/版本历史证据,未见已知限制章节,LICENSE.md 为保留所有权利的商业条款而非开源许可。

有效结果10 / 13 · 3.8/5

SDK 提供 Claude Code 能力的编程化复用,边际价值明确且示例(session stores,含 Postgres/Redis 适配器与一致性测试)展示了工程深度。扣分点:成本(token 用量、费用)与收益权衡在样本中未讨论。

证据核验5 / 8 · 3.1/5

README 声明(安装、数据收集、许可)均可追溯到具体链接与仓库文件;CLAUDE.md 与工作流文件相互印证(workflow-hardening.yml、egress-firewall 被实际引用);数据收集声明与政策链接区分清楚。扣分点:'privacy safeguards' 为断言,无源码级证据可核对。

风险与缓解建议
  • SDK 核心源码与技能/插件文件未在样本中,运行时权限与数据流只能依赖官方文档链接,建议审阅 npm 包内实际源码。
  • 许可为 Anthropic 商业条款(保留所有权利),非开源许可,商用集成前需法务确认。
  • SDK 默认会收集使用数据与对话数据(含 /bug 反馈),对隐私敏感场景需评估。
  • issue-triage 工作流对无写权限用户开放(allowed_non_write_users: "*"),虽已有检查提示,仍应持续关注提示注入风险。
证据充分度:低 评估于 2026年11月22日 审查版本 1e667424b6d3
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/claude-agent-sdk-typescript.svg?lang=zh)](https://followagents.com/zh/agents/claude-agent-sdk-typescript)
<a href="https://followagents.com/zh/agents/claude-agent-sdk-typescript"><img src="https://followagents.com/badge/claude-agent-sdk-typescript.svg?lang=zh" alt="FARS 评测"></a>

常见问题

它和 Claude Code SDK 是什么关系?
Claude Code SDK 已更名为 Claude Agent SDK。旧项目迁移时存在破坏性变更,官方提供了专门的迁移指南。
如何安装和开始使用?
需要 Node.js 18+,执行 npm install @anthropic-ai/claude-agent-sdk 即可安装;详细的 API 用法见 docs.claude.com 上的官方文档。
使用它会产生哪些数据采集?
会采集反馈数据,包括使用数据(如代码接受或拒绝情况)、关联的对话数据以及通过 /bug 命令提交的用户反馈;官方声明不会将反馈用于模型训练。
许可证是什么?
README 未标注开源许可证;使用受 Anthropic 商业服务条款约束,除非特定组件在其 LICENSE 文件中标注了不同许可证。
出了问题或想要新功能怎么办?
可以在 GitHub 仓库的 Issues 页面报告 bug 或请求功能,也可加入 Claude Developers Discord 寻求帮助。
Claude Agent SDK(TypeScript) 安全吗?
FollowAgents 的 FARS 评审(2026年11月22日)给 Claude Agent SDK(TypeScript) 的“信任与安全”打了 19/29 分。评审检查的 8 项安全措施没有完全缺失的。
Claude Agent SDK(TypeScript) 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-20,在最近 30 天内。
Claude Agent SDK(TypeScript) 是谁开发的?
Claude Agent SDK(TypeScript) 由 Anthropic 发布。FollowAgents 已核实 GitHub 账号 anthropics 属于 Anthropic。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

相关核心概念