ben-vargas/ai-sdk-provider-claude-code

解决的问题

该项目在 Vercel AI SDK 与官方 Anthropic Claude Agent SDK（以及 Claude Code CLI）之间搭建桥梁。它使开发者能够通过 Vercel AI SDK 的标准化接口使用 Claude 的代理功能（如工具调用和结构化输出），而无需为这些高级功能编写特定于提供方的代码。

工作原理

该库作为 Vercel AI SDK 的提供方。它封装了 @anthropic-ai/claude-agent-sdk 和 Claude Code CLI，将 AI SDK 调用（如 streamText 或 generateText）转换为 Claude Agent SDK 可执行的指令。它支持多个版本的 AI SDK（v4 至 v7），并处理 Claude CLI 所需的底层认证和会话管理。

适用人群

使用 Vercel AI SDK 构建 AI 应用的开发者，希望利用 Claude Agent SDK 的特定代理工具、MCP（模型上下文协议）服务器以及原生结构化输出功能。

主要亮点

• 与 Vercel AI SDK 完全集成：在多个 SDK 版本中完全兼容 streamText 和 generateText。
• 原生结构化输出：通过 Zod 模式支持约束解码，确保输出为有效且符合模式的 JSON。
• 代理工具支持：可访问 MCP 服务器、工具权限和自定义插件。
• 高级会话控制：支持会话恢复、分叉以及预算限制和沙箱配置等会话管理功能。
• 细粒度回调：提供 onSdkMessage、canUseTool 及其他任务/MCP 状态事件的钩子。