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) 서버와의 통합 및 도구 권한 관리.
• 세션 관리: 에이전트 세션의 생성, 재개, 포크, 삭제 기능을 제공합니다.
• 고급 제어: 실시간 세션 제어 및 USD 기준 예산 제한에 접근 가능한 쿼리 컨트롤러 제공.
• 다단계 대화: 스트리밍 및 다단계 상호작용을 완전히 지원합니다.