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

해결하는 문제

이 프로젝트는 Vercel AI SDK와 공식 Anthropic Claude Agent SDK(및 Claude Code CLI) 사이의 다리를 제공합니다. 개발자들이 Claude의 에이전트 기능(도구 사용 및 구조화된 출력 등)을 Vercel AI SDK의 표준화된 인터페이스 내에서 사용할 수 있게 하여, 이러한 고급 기능에 특화된 프로바이더 전용 코드를 작성할 필요를 없앱니다.

작동 방식

이 라이브러리는 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(Model Context Protocol) 서버, 그리고 네이티브 구조화된 출력 기능을 활용하고자 하는 개발자들.

주요 특징

• Vercel AI SDK 통합: 여러 SDK 버전에서 streamText 및 generateText와 완전 호환.
• 네이티브 구조화된 출력: Zod 스키마를 통한 제약된 디코딩을 지원하여 유효하고 스키마 준수된 JSON 출력을 보장.
• 에이전트 도구: MCP 서버, 도구 권한, 사용자 정의 플러그인에 접근 가능.
• 고도화된 세션 제어: 세션 재개, 포크, 예산 제한 및 사전 설정 등 세션 관리 기능 제공.
• 세밀한 콜백: onSdkMessage, canUseTool, 기타 작업/MCP 상태 이벤트용 훅 제공.