SuperAPI AI 工具集

claude-agent-sdk

智能体与模型

查看项目

更新于 10-16 00:20

技能介绍

用途:该技能面向使用 Anthropic Claude Agent SDK 构建自主智能体与多步工作流的开发者,核心是通过 query() 函数以编程方式驱动 Claude Code CLI,返回异步生成器并流式输出消息。

主要能力:支持内置工具(Read、Write、Edit、Bash、Grep、Glob、WebSearch、WebFetch、Task)的允许/禁止控制;通过 createSdkMcpServer() 或外部 stdio/HTTP/SSE 服务器接入 MCP 自定义工具;用 agents 选项定义子智能体实现多智能体编排;用 session_id 恢复会话、forkSession 分叉;权限模式含 default、acceptEdits、bypassPermissions,并可用 canUseTool 回调自定义授权;settingSources 控制加载 user/project/local 设置文件。

使用方式:先安装 Claude Code CLI 与 SDK,命令为 bun add -g @anthropic-ai/claude-code 和 bun add @anthropic-ai/claude-agent-sdk zod,再设置 export ANTHROPIC_API_KEY="sk-ant-...",随后调用 query({ prompt, options }) 并在 for await 循环中按 message.type 处理消息。依赖要求 Node.js 18+、zod 3.23+,可选 @modelcontextprotocol/sdk。

适用场景:编码智能体、SRE 系统、安全审计、CI/CD 自动化等。

限制与注意:必须安装 CLI 并配置 API 密钥,否则出现 CLI_NOT_FOUND 或认证失败;不要提交密钥、生产环境慎用 bypassPermissions、CI/CD 中避免加载 user 设置;工具输入建议用 Zod 校验,并处理流中的错误消息。资料未提供具体收费与价格信息。