피드로 돌아가기
Dev.toBackend
원문 읽기
Local Proxy를 통한 Claude Code와 Google Antigravity OAuth 연동 및 API Protocol 변환
"I Pointed Claude Code at Google's Antigravity — Here's the 5-Minute OAuth Setup"
AI 요약
Context
Claude Code CLI의 Anthropic API Key 기반 인증 체계로 인한 잦은 Key Rotation 및 관리 오버헤드 발생. Google Antigravity 플랫폼이 Claude 모델을 제공함에도 불구하고, Anthropic Messages API와 Google cloudcode-pa API 간의 Protocol 불일치로 인해 직접 연동이 불가능한 아키텍처적 제약 존재.
Technical Solution
- Local Proxy 서버인 CliGate를 구축하여 Claude Code의 요청을 중간에서 가로채는 Interceptor 구조 설계
- Google OAuth 2.0 Refresh Token 기반의 Account Pool을 구현하여 5분 미만 만료 시 자동 갱신하는 인증 자동화 로직 적용
- Anthropic Messages Payload를 Google generateContent 요청 규격으로 변환하는 Payload Translation Layer 구현
- Google Antigravity의 SSE 응답을 Anthropic SSE 포맷으로 다시 변환하여 Claude Code에 전달하는 Response Streaming Bridge 구축
- 서로 다른 모델 ID 체계를 매핑하는 Normalization 함수를 통해 API 간 Model Identifier 불일치 문제 해결
- 요청 로그 기반의 Upstream Provider 추적 기능을 통해 라우팅 상태를 가시화한 Monitoring 구조 설계
실천 포인트
1. 서로 다른 API Protocol을 사용하는 LLM 백엔드 통합 시, Payload Translation Layer를 갖춘 Local Proxy 도입 검토
2. API Key 방식보다 보안성과 관리 효율이 높은 OAuth
2.0 Refresh Token 기반 인증 체계 전환 고려
3. 모델 ID Alias 매핑 테이블을 구축하여 Upstream 제공자 변경 시의 하위 호환성 확보
4. SSE 스트리밍 응답 변환 시 타임아웃 및 데이터 손실 방지를 위한 버퍼링 전략 수립