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

解决的问题

该项目在 Vercel AI SDK 与官方 Anthropic Claude Agent SDK（以及 Claude Code CLI）之间搭建桥梁。它使开发者能够在 Vercel AI SDK 的标准化接口中使用 Claude 的代理功能（如工具调用和会话管理），从而简化在 JavaScript/TypeScript 应用中集成 Claude 代理的过程。

工作原理

该库作为 Vercel AI SDK 的提供者。通过安装该提供者并在本地机器上认证 Claude Code CLI，开发者可以调用 claudeCode() 来实例化模型。该提供者随后将 AI SDK 请求（如 streamText 或 generateText）转换为 @anthropic-ai/claude-agent-sdk 可理解的调用，处理消息、工具和结构化输出的映射。

适用人群

已在使用 Vercel AI SDK 的 TypeScript 和 JavaScript 开发者，希望在不编写自定义集成层的情况下，利用官方 Claude Agent SDK 和 Claude Code 的代理功能。

主要亮点

• Vercel AI SDK 兼容性：支持 AI SDK 的多个版本（v4 至 v7）。
• 原生结构化输出：使用 Zod 支持符合模式的 JSON 输出的约束解码。
• 代理工具支持：与 MCP（Model Context Protocol）服务器集成及工具权限管理。
• 会话管理：支持创建、恢复、分叉和删除代理会话。
• 高级控制：可访问查询控制器，实现对实时会话的控制和以美元为单位的预算限制。
• 多轮对话：完全支持流式传输和多轮交互。