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 狀態事件的鈎子。