Antigravity Auth 플러그인의 핵심 가치 파악하기
Antigravity Auth는 OpenCode 플러그인으로, Google OAuth 인증을 통해 Antigravity API에 액세스합니다. 익숙한 Google 계정만으로 Claude Opus 4.5, Sonnet 4.5, Gemini 3 Pro/Flash 등 고급 모델을 호출할 수 있으며, API 키 관리가 필요 없습니다. 또한 다중 계정 로드 밸런싱, 이중 쿼터 풀, 자동 세션 복구 등의 기능을 제공하여 고급 모델과 자동 관리가 필요한 사용자에게 적합합니다.
학습 완료 후 할 수 있는 것
- 이 플러그인이 자신의 사용 시나리오에 적합한지 판단하기
- 플러그인이 지원하는 AI 모델과 핵심 기능 파악하기
- 이 플러그인 사용 시의 리스크와 주의사항 명확히 이해하기
- 설치 및 구성 계속 진행 여부 결정하기
현재 당신이 처한 상황
최첨단 AI 모델(Claude Opus 4.5, Gemini 3 Pro 등)을 사용하고 싶지만, 공식 액세스가 제한되어 있습니다. 이러한 모델을 안정적으로 사용할 수 있는 방법을 찾고 있으며, 다음을 원합니다:
- 여러 API 키를 수동으로 관리할 필요 없음
- 속도 제한 발생 시 자동으로 계정 전환
- 대화 중단 후 자동 복구 및 컨텍스트 유지
핵심 개념
Antigravity Auth는 OpenCode 플러그인으로, Google OAuth 인증을 통해 Google Antigravity API에 액세스하여, 익숙한 Google 계정만으로 고급 AI 모델을 호출할 수 있게 합니다.
모든 요청을 프록시하는 것이 아니라, 모델 호출 요청을 가로채고 변환하여 Antigravity API로 전달한 후, 응답을 OpenCode가 인식할 수 있는 형식으로 다시 변환합니다.
주요 기능
지원하는 모델
| 모델 시리즈 | 사용 가능한 모델 | 특징 |
|---|---|---|
| Claude | Opus 4.5, Sonnet 4.5 | 확장 사고 모드 지원 |
| Gemini 3 | Pro, Flash | Google Search 통합, 확장 사고 |
사고 모드 (Thinking)
Thinking 모델은 답변을 생성하기 전에 "심층 사고"를 하여 추론 과정을 보여줍니다. 사고 예산을 구성하여 품질과 응답 속도의 균형을 맞출 수 있습니다.
다중 계정 로드 밸런싱
- 최대 10개의 Google 계정 지원
- 속도 제한(429 오류) 발생 시 다음 계정으로 자동 전환
- 세 가지 계정 선택 전략: sticky(고정), round-robin(순환), hybrid(지능형 하이브리드)
이중 쿼터 시스템
플러그인은 두 개의 독립적인 쿼터 풀에 동시에 액세스합니다:
- Antigravity 쿼터: Google Antigravity API에서 제공
- Gemini CLI 쿼터: Google Gemini CLI에서 제공
하나의 풀이 속도 제한되면, 플러그인은 자동으로 다른 풀을 시도하여 쿼터 활용을 극대화합니다.
자동 세션 복구
- 도구 호출 실패(예: ESC 키로 인한 중단) 감지
- synthetic tool_result를 자동으로 주입하여 대화가 중단되지 않도록 방지
- 자동으로 "continue"를 보내 대화를 계속하는 것을 지원
Google Search 통합
Gemini 모델에 대해 웹 검색을 활성화하여 사실적 정확성을 높입니다:
- Auto 모드: 모델이 필요에 따라 검색 여부를 결정
- Always-on 모드: 매번 검색 수행
이 플러그인을 사용해야 하는 경우
다음 시나리오에 적합
- 여러 Google 계정이 있어 전체 쿼터를 높이고 싶은 경우
- Claude 또는 Gemini 3의 Thinking 모델이 필요한 경우
- Gemini 모델에 대해 Google Search를 활성화하고 싶은 경우
- API 키를 수동으로 관리하는 대신 OAuth 인증을 선호하는 경우
- 속도 제한을 자주 겪어 계정 자동 전환이 필요한 경우
다음 시나리오에는 적합하지 않음
- Google에서 공식적으로 공개하지 않은 모델이 필요한 경우
- Google ToS 리스크에 매우 민감한 경우(아래 리스크 알림 참조)
- 기본 Gemini 1.5 또는 Claude 3 모델만 필요한 경우(공식 인터페이스가 더 안정적)
- WSL, Docker 등에서 브라우저를 열기 어려운 환경에 있는 경우
⚠️ 중요 리스크 알림
이 플러그인을 사용하는 것은 Google의 서비스 약관을 위반할 수 있습니다. 일부 사용자는 Google 계정이 정지되거나 그림자 정지(명시적 통보 없이 액세스 제한)되었다고 보고했습니다.
고위험 시나리오
- 🚨 완전히 새로운 Google 계정: 정지 확률이 매우 높음
- 🚨 Pro/Ultra 구독을 막 시작한 계정: 플래그 지정 및 정지되기 쉬움
사용 전 확인 사항
- 이것은 비공식 도구이며 Google이 승인하지 않았습니다
- 계정이 일시 중단되거나 영구적으로 금지될 수 있습니다
- 이 플러그인을 사용하는 모든 리스크는 사용자가 부담합니다
권장 사항
- 이 플러그인을 위해 새 계정을 생성하는 대신 성숙한 Google 계정을 사용하세요
- 중요한 서비스에 바인딩된 계정은 사용하지 마세요
- 계정이 정지되면 이 플러그인을 통해 항소할 수 없습니다
계정 보안
모든 OAuth 토큰은 로컬 ~/.config/opencode/antigravity-accounts.json에 저장되며, 어떤 서버에도 업로드되지 않습니다. 하지만 컴퓨터 보안을 유지하여 토큰 유출을 방지하세요.
본 강의 요약
Antigravity Auth는 강력한 OpenCode 플러그인으로, Google OAuth를 통해 Claude와 Gemini 3 고급 모델에 액세스할 수 있게 해줍니다. 다중 계정 로드 밸런싱, 이중 쿼터 풀, 자동 세션 복구 등의 기능을 제공하여 고급 모델과 자동 관리가 필요한 사용자에게 적합합니다.
하지만 반드시 주의하세요: 이 플러그인을 사용하면 계정 정지 리스크가 있습니다. 중요하지 않은 Google 계정을 사용하고, 계속 설치하기 전에 관련 리스크를 이해하세요.
다음 강의 예고
다음 강의에서는 **빠른 설치**를 학습합니다.
학습 내용:
- 5분 만에 플러그인 설치 완료
- 첫 번째 Google 계정 추가
- 설치 성공 여부 확인