anthropics/ClaudeForFoundationModels

해결하는 문제

이 패키지는 Apple의 Foundation Models 프레임워크 내에서 Claude를 서버 측 언어 모델로 사용할 수 있게 해줍니다. Anthropic의 API와 Apple의 표준화된 LanguageModel 프로토콜 사이의 격차를 메우며, 개발자가 동일한 LanguageModelSession API를 사용해 온디바이스 모델과 Claude를 쉽게 전환할 수 있도록 합니다.

작동 방식

라이브러리는 LanguageModel 프로토콜을 준수하는 ClaudeLanguageModel를 제공합니다. 이 모델을 LanguageModelSession에 전달하면 Apple의 네이티브 API를 사용해 스트리밍, 가이드 생성, 도구 호출 등의 작업을 수행할 수 있습니다. 앱 인증(App Attest)을 통한 보안 키리스 프로덕션 배포, 개발용 API 키, 사용자 정의 백엔드를 통한 프록시 요청 등 다양한 인증 방식을 지원합니다.

대상 사용자

iOS 27, macOS 27, visionOS 27, watchOS 27(베타)용 Swift 개발자 중 Apple의 공식 기초 모델 프레임워크를 사용해 Claude 기능을 앱에 통합하고자 하는 분들.

주요 특징

• 네이티브 통합: Apple의 온디바이스 모델과 동일한 API(respond(to:) 및 스트리밍) 사용 가능.
• 보안 인증: API 키를 번들링하지 않고도 앱의 정당성을 입증할 수 있는 Apple의 App Attest 지원.
• 서버 측 도구: 단일 요청 내에서 웹 검색, 웹 가져오기, 코드 실행 등 Anthropic 인프라를 내장 가능.
• 구조화된 출력: 특정 데이터 구조의 가이드 생성을 위한 @Generable 타입 지원.
• 모델 포알백: 정책 거부 시 원활하게 대체할 수 있도록 연쇄적인 포알백 모델 지정 가능.
• 노력 수준 제어: Apple의 추론 수준을 Claude의 특정 노력 수준(low, medium, high, xhigh, max)으로 매핑.