Claude Swift와 Apple Foundation Models를 결합한 하이브리드 추론 설계
Claude Swift와 Apple Foundation Models를 함께 사용해 온디바이스·클라우드 추론을 라우팅하고 개인정보와 비용을 관리하는 모바일 AI 아키텍처를 다룬다.
2026-08-14 · 최초 발행 2026-08-02
하나의 Swift 코드에서 로컬 모델과 Claude를 연결한다
Anthropic이 공개한 공식 Claude Swift 패키지는 iOS·macOS 앱에서 Apple Foundation Models와 Claude 클라우드 API를 함께 쓰는 선택지를 제공한다. 앱이 모든 요청을 외부 API로 보내거나 온디바이스 모델에만 의존하는 대신, 요청의 성격에 따라 두 실행 환경을 오갈 수 있는 구조다.
Apple Foundation Models 프레임워크는 iOS 18/macOS 15부터 시스템 수준에서 제공되는 온디바이스 LLM 인프라다. Core ML 기반 추론과 달리 Apple Intelligence 백엔드에 직접 연결되며, 별도 모델 다운로드 없이 텍스트 요약·분류·생성 작업을 실행할 수 있다.
Claude Swift 패키지는 이 로컬 추론 환경에 클라우드 호출 계층을 결합한다. 개발자는 FoundationModelSession 대신 ClaudeHybridSession을 선언하고, 같은 인터페이스를 통해 Apple Foundation Models 또는 Claude API로 요청을 보낼 수 있다. 실제 대상을 고르는 역할은 패키지 내부의 ModelRouter 프로토콜이 맡는다.
import AnthropicFoundation
import FoundationModels
let session = ClaudeHybridSession(
localModel: .systemDefault,
cloudModel: .claudeSonnet4,
router: AdaptiveRouter()
)
let response = try await session.respond(
to: "사용자 리뷰 감성 분석: \(reviewText)"
)라우팅은 세션을 만들 때 고정되지 않고 호출 시점에 결정된다. AdaptiveRouter는 입력 토큰 수와 네트워크 상태, 사용자의 개인정보 설정을 함께 평가해 온디바이스와 클라우드 중 하나를 선택한다.
요청의 성격이 추론 위치를 결정한다
하이브리드 추론을 단순한 장애 폴백으로만 설계하면 두 모델 계층의 차이를 제대로 활용하기 어렵다. 온디바이스 모델과 Claude API에 어떤 작업을 맡길지 먼저 구분해야 한다.
개인 식별 정보(PII)가 들어 있는 사용자 일기, 헬스 데이터, 금융 메모는 기기 안에서 처리하는 편이 적합하다. 타이핑 어시스트와 자동완성처럼 50ms 이내 응답이 필요한 실시간 UI 피드백도 로컬 추론에 어울린다. 인터넷에 연결할 수 없는 상황에서는 Apple Foundation Models가 그대로 실행 경로가 된다.
반면 복잡한 멀티스텝 추론과 코드 생성, 장문 문서 분석은 7B 수준 온디바이스 모델의 능력 범위를 넘어설 수 있다. Claude의 Tool Use와 Structured Output, 시스템 프롬프트 기반 페르소나가 필요한 작업 역시 클라우드로 보내는 편이 맞다.
라우터를 직접 구현한다면 처음부터 복잡한 정책 엔진을 만들 필요는 없다. 입력 토큰이 512 이하이면서 작업 유형이 분류나 요약이면 온디바이스로 보내고, 나머지는 클라우드에 맡기는 규칙도 실용적이다. 작업별 신뢰도 임계값이 필요하다면 로컬 결과의 confidence score를 검사한 뒤, 기준보다 낮을 때 Claude API에 다시 요청하는 이중 검증 패턴으로 확장할 수 있다.
개인정보 경계는 라우터보다 먼저 설계한다
Claude API 호출에는 사용자 데이터가 Anthropic 서버로 전송된다는 의미가 따른다. Apple App Store 심사 가이드라인 5.1.2는 개인 데이터를 제3자 서버로 보낼 때 명시적인 사용자 동의를 요구하므로, 클라우드 경로를 열기 전에 동의 상태부터 확인해야 한다.
여기서 기준이 되는 원칙은 데이터 최소화(Data Minimization)다. Claude에 보내기 전 PII를 제거하거나 익명화하고, 작업에 필요한 컨텍스트만 남긴다. 이를테면 "홍길동의 2026년 3월 건강 기록"을 이름과 날짜가 드러나지 않는 "사용자 A의 기록 T1"로 바꿔 전송한 뒤, 응답을 앱에서 역매핑할 수 있다.
iOS 앱에서는 App Privacy Report(iOS 15.2+)에 Claude API 도메인인 api.anthropic.com을 네트워크 액세스 도메인으로 등록해야 한다. PrivacyInfo.xcprivacy 파일에도 데이터 사용 목적을 명시해야 App Store 심사 요건을 충족할 수 있다.
// 개인정보 보호 레이어 예시
struct PrivacyAwareRouter: ModelRouter {
func route(for input: String, context: RequestContext) -> ModelTarget {
let sensitivityScore = PrivacyAnalyzer.analyze(input)
if sensitivityScore > 0.7 {
return .localOnly // 온디바이스 전용
}
if context.userConsentGranted {
return .cloud(.claudeSonnet4)
}
return .localOnly // 동의 없으면 기본 온디바이스
}
}Swift SDK를 고를 때 달라지는 경계
2026년 현재 주요 AI 공급자는 모두 Swift SDK를 제공한다. 다만 온디바이스 모델을 연결하는 방식과 클라우드 기능의 범위가 서로 다르다.
Claude Swift의 두드러진 특징은 Apple Foundation Models와의 네이티브 통합이다. SDK 수준에서 하이브리드 라우팅을 지원하고, Claude의 200K 토큰 컨텍스트와 Tool Use를 Swift에서 타입 안전하게 사용할 수 있다. Anthropic 자체 온디바이스 모델은 없으므로 로컬 추론은 Apple Foundation Models에 의존한다.
Google Gemini Swift SDK는 Gemini Nano와 클라우드의 Gemini Pro/Flash를 함께 지원한다. Android와 iOS 사이의 크로스플랫폼 일관성, Google AI Studio 연동이 강점이다. Apple Foundation Models와의 결합 수준은 Anthropic보다 깊지 않다.
OpenAI Swift SDK는 ChatGPT 모델 계열과 폭넓은 생태계를 제공한다. GPT-4o의 멀티모달 기능은 이미지와 오디오를 처리하는 앱에 유리하지만, 온디바이스 추론 없이 클라우드에 의존한다.
| 항목 | Claude Swift | Gemini Swift | OpenAI Swift |
|---|---|---|---|
| 온디바이스 모델 | Apple 위임 | Gemini Nano | 없음 |
| Apple 네이티브 통합 | 최우수 | 보통 | 미흡 |
| 컨텍스트 길이 | 200K | 1M | 128K |
| Tool Use | 완전 지원 | 완전 지원 | 완전 지원 |
| 오프라인 폴백 | 지원 | 부분 지원 | 불가 |
| App Store 심사 실적 | 신규 | 풍부 | 풍부 |
비용은 모델 호출 전에 통제해야 한다
모바일 앱의 Claude API 사용량은 사용자 행동에 따라 계속 늘어날 수 있다. 호출 후 비용을 집계하는 것만으로는 부족하며, 어떤 요청을 어느 모델에 보낼지와 사용량을 넘겼을 때 어떻게 전환할지를 아키텍처에 포함해야 한다.
프롬프트 캐싱(Prompt Caching)은 고정 시스템 프롬프트와 반복 컨텍스트를 재사용하는 방법이다. 앱의 시스템 프롬프트를 cache_control 블록으로 지정하면 같은 세션의 반복 호출에서 인풋 토큰 비용을 최대 90%까지 줄일 수 있다.
모델 계층화도 함께 적용할 수 있다. 기본 요청은 claude-haiku-4로 처리하고, 복잡도 평가 결과에 따라 claude-sonnet-4로 에스컬레이션한다. Haiku는 Sonnet보다 비용이 약 20배 저렴하므로 단순 작업을 분리하면 전체 비용을 낮출 수 있다.
앱에서는 일일 API 호출 수를 추적하고, 정한 임계값을 넘으면 온디바이스 전용 모드로 바꾸는 쿼터 관리가 필요하다. 무료 티어와 유료 구독자의 API 할당량을 다르게 운영하려면 인앱 결제 상태도 라우팅 정책에 연결할 수 있다.
Apple Foundation Models의 실패나 품질 미달로 Claude 폴백이 자주 발생하는지도 관찰해야 한다. 폴백 비율이 높다면 온디바이스를 항상 먼저 시도하기보다 Claude를 기본 경로로 지정하는 편이 사용자 경험에 나을 수 있다.
엣지와 클라우드 사이에 백엔드 경계를 둔다
Claude Swift의 혼합 추론 구조는 엣지-클라우드 하이브리드 컴퓨팅의 계층 분리를 모바일 앱에 적용한 사례다. 지연에 민감하거나 개인정보를 다루는 작업은 엣지인 기기에서 실행하고, 복잡한 연산은 클라우드로 넘긴다. 이 구조는 포그 컴퓨팅(Fog Computing) 아키텍처와 개념적으로 같다.
데이터 주권(Data Sovereignty)도 처리 위치를 나누는 기준이 된다. 개인정보보호법과 GDPR 관점에서 온디바이스 처리는 데이터가 기기를 벗어나지 않으므로 별도 정보 제공 의무가 발생하지 않는다. Claude API 호출은 국외 이전에 해당할 수 있어 개인정보보호법 제28조의8에 따른 공개 또는 동의가 필요하다. 앱은 이 경계를 라우팅 정책과 사용자 동의 흐름에 함께 반영해야 한다.
모바일 앱에서 Claude API를 직접 호출하면 앱 바이너리에 API 키가 노출될 위험이 생기고, 비용 통제 지점도 각 클라이언트로 흩어진다. 앱과 Claude 사이에 자체 백엔드 프록시를 두면 키를 서버에 보관하면서 사용자별 쿼터와 어뷰징 탐지를 한곳에서 처리할 수 있다.
2026년에는 Apple Foundation Models 기반 모델의 성능 개선과 Claude API의 모바일 최적화 모델 출시가 예상된다. Claude Haiku 계열을 온디바이스에 적재할 가능성, Apple Private Cloud Compute와 Claude API의 프라이버시 보장 수준 차이는 이후 기술 선택에서 주요 기준이 될 전망이다.
Claude Swift를 도입할 때 검토해야 할 대상은 SDK 호출 코드만이 아니다. 온디바이스와 클라우드의 책임 경계, 개인정보 동의, 모델별 비용, 폴백 빈도와 API 키 보관 위치가 하나의 설계로 맞물려야 한다.
Sources
- Anthropic GitHub — claude-swift-package 공식 저장소 (2026)
- Apple Developer Documentation — Foundation Models Framework (WWDC 2025)
- Apple App Store Review Guidelines 5.1.2 — Data Collection and Storage
- Anthropic API Reference — Prompt Caching, Model Pricing (2026)
- 개인정보보호법 제28조의8 — 개인정보의 국외 이전 (2024 개정)
- Apple PrivacyInfo.xcprivacy — Required Reason APIs Documentation
- Google AI — Gemini Swift SDK Reference (2026)
- OpenAI — Swift Client Library Documentation (2026)
- 정보관리기술사 기출문제 — 엣지 컴퓨팅·클라우드 하이브리드 아키텍처 (2024-2025)