yuting0624/antigravity-for-claude-code

해결하는 문제

이 프로젝트는 Claude Code가 판단과 검증을 위한 고수준 '지휘자' 역할을 하며, Antigravity CLI(Gemini 기반)가 토큰이 많은 반복적 또는 대량 작업을 위한 '실행자' 역할을 하는 하이브리드 AI 워크플로우를 가능하게 합니다. 이는 최첨단 모델을 사용할 때 발생하는 높은 비용과 컨텍스트 창 포화 문제를 해결하면서도, 최종 검토에는 최상위 수준의 모델 품질을 유지합니다.

작동 방식

Claude Code의 플러그인으로 작동하며, 특정 작업을 Antigravity CLI(agy)로 라우팅합니다. Claude가 작업을 지시하고, Gemini가 이를 실행합니다. 시스템은 위임할 시점을 결정하기 위해 '비용 인식' 라우팅 정책을 사용합니다. 주요 메커니즘은 다음과 같습니다:

• 다이제스트만 반환: 전체 원시 출력을 반환하는 대신, Gemini는 타임스탬프가 포함된 다이제스트를 제공하여 Claude의 컨텍스트를 가볍게 유지합니다.
• 다중 모델 검증: Claude가 Gemini가 생성한 출력을 검토하여 정확성을 보장합니다.
• 서브 에이전트 팬아웃: Gemini는 복잡한 작업을 처리하기 위해 더 저렴한 서브 에이전트를 자동으로 생성할 수 있으며, agy-trace를 통해 트래잭션을 감사할 수 있습니다.
• 세션 훅: SessionStart 훅은 세션에 자동으로 라우팅 정책을 삽입합니다.

대상 사용자

• API 비용을 줄이면서 품질을 희생하지 않고 Claude Code를 사용하는 개발자.
• Google/웹 검색 또는 Vertex AI Search를 코드 워크플로우에 통합해야 하는 팀.
• 로컬 음성/비디오 변환 스택을 설정하지 않고도 대용량 멀티모달 파일(오디오/비디오)을 처리해야 하는 사용자.

주요 특징

• 비용 효율성: 대량 작업을 더 저렴한 모델로 위임함으로써 최첨단 모델 비용을 절감(일부 테스트에서 최대 64% 절감).
• 멀티모달 기능: Gemini를 통해 네이티브 오디오 및 비디오 인식을 제공하며, Claude의 컨텍스트를 채우지 않고도 다이제스트를 제공합니다.
• 통합 도구: Claude Code에 실시간 웹 검색, Vertex AI Search, Cloud Run 디버깅 기능을 추가합니다.
• 마이그레이션 도구: 기존 Claude Code 설정(스킬, MCP 서버, 메모리)을 Antigravity로 이전할 수 있는 /antigravity:migrate 포함.
• 백그라운드 실행: 장시간 실행 위임 작업을 백그라운드 작업으로 실행하여 나중에 수집할 수 있습니다.

"이 플러그인은 Claude Code의 지휘 역할을 유지하면서도, Gemini를 통해 비용을 절감하고 대규모 작업을 처리할 수 있게 해줍니다." — @antigravity-ai