Claude Code에 Gemini 연결하기 - 프록시 백엔드로 저렴하게 사용
목차
개요
Claude Code는 뛰어난 에이전트 설계로 AI 코딩 도구 중 높은 평가를 받고 있다. 하지만 Claude API 비용이 부담스러운 개발자들 사이에서 상대적으로 저렴한 Gemini 토큰을 활용하려는 시도가 나타나고 있다. 프록시 백엔드를 구축해 Claude Code의 인터페이스를 유지하면서 실제 추론은 Gemini 모델로 처리하는 방식이다.
왜 Gemini를 Claude Code에 연결하는가
Gemini CLI도 존재하지만 “너무 전투적”이라는 평가를 받는다. 반면 Claude Code의 에이전트 설계는 더 효과적이고 사용하기 편리하다고 알려져 있다. Claude Code의 UX와 에이전트 프레임워크를 유지하면서 백엔드 모델만 교체하는 것이 이 접근의 핵심이다. Gemini 토큰이 상대적으로 저렴하기 때문에 비용 절감 효과도 기대할 수 있다.
기술적 구현 방식
추상화 레이어 설계
추상화 레이어를 통해 여러 AI 제공자를 동일한 방식으로 연결하는 구조를 설계한다. OpenAI, XAI, Claude, Gemini 등 다양한 모델을 단일 인터페이스로 처리할 수 있다. Claude Code는 자신이 Claude API와 통신한다고 인식하지만, 실제 요청은 프록시를 통해 Gemini로 전달된다.
해결해야 할 기술적 문제들
프록시 백엔드 구현 시 해결해야 할 주요 기술적 도전들이 있다.
| 문제 | 설명 |
|---|---|
| 스트리밍 처리 | API별 스트리밍 포맷 차이 처리 |
| JSON 파싱 | 응답 포맷 변환 및 오류 처리 |
| Tool use 스키마 정제 | 모델별 tool use 스키마 차이 통일 |
각 AI 제공자마다 API 응답 형식이 다르기 때문에 이를 통일된 형식으로 변환하는 로직이 핵심이다. 스트리밍 응답의 경우 특히 세심한 처리가 필요하다.
기존 솔루션과의 비교
이미 유사한 목적의 오픈소스 프로젝트들이 존재한다. anthropic-proxy와 claude-code-proxy 같은 GitHub 프로젝트들이 비슷한 기능을 제공한다. 새로운 구현과의 차이점으로는 서버리스/AWS Lambda 기반 배포의 장점을 활용할 수 있다는 점이 논의되었다. 기존 도구를 활용하거나 직접 구현하는 방식 중 자신의 인프라 환경에 맞는 것을 선택할 수 있다.
약관 검토 사항
이 방식을 사용하기 전에 약관을 반드시 확인해야 한다. Anthropic 약관 위반 가능성에 대한 우려가 제기되었다. 핵심은 API 키 사용 방식이다. 종량제(pay-per-use) API 키를 직접 사용하는 방식은 약관 위반이 아닌 것으로 확인되었다. 단, 구독 기반 서비스의 자격 증명을 제3자 도구와 연동하는 것은 별도 검토가 필요하다. Google AI Ultra 계정 정지 사례처럼 서드파티 도구와의 OAuth 연동이 문제가 될 수 있다.
결론
Claude Code의 뛰어난 에이전트 프레임워크를 유지하면서 더 저렴한 모델을 백엔드로 활용하려는 시도는 비용 최적화 측면에서 합리적인 접근이다. 스트리밍, JSON 파싱, tool use 스키마 등의 기술적 과제가 있지만 이미 검증된 오픈소스 프로젝트들이 참고 자료로 활용될 수 있다. 다만 사용하는 서비스의 약관을 철저히 검토하고, 종량제 API 키 방식을 사용하는 것이 안전하다.