Google Cloud 할당량 조회: G3 Pro/Image/Flash 및 Claude

학습 완료 후 할 수 있는 것

Google Cloud Antigravity 계정의 4개 모델 할당량 보기
각 모델의 재설정 시간 및 남은 비율 이해
여러 Google Cloud 계정의 할당량 사용 관리

현재 문제 상황

Google Cloud Antigravity는 여러 모델(G3 Pro, G3 Image, G3 Flash, Claude)을 제공하며, 각 모델은 독립적인 할당량과 재설정 시간이 있습니다. 귀하는 다음이 필요합니다:

각 모델의 상태를 보기 위해 Google Cloud 콘솔에 각각 로그인
남은 할당량 및 재설정 시간 수동 계산
여러 계정 관리 시 더욱 혼란스러움

이 방법을 사용해야 할 때

다음과 같은 상황일 때:

모든 Google Cloud 모델의 남은 할당량을 빠르게 이해하고 싶을 때
다양한 모델 간의 사용 배분을 계획하고 싶을 때
여러 Google Cloud 계정을 통합 관리해야 할 때

🎒 시작 전 준비

사전 확인

mystatus 플러그인 설치: 빠른 시작 참조
Google Cloud 인증 완료: 먼저 opencode-antigravity-auth 플러그인 설치하여 OAuth 인증 완료 필요
인증 파일 존재: ~/.config/opencode/antigravity-accounts.json에 최소한 하나의 계정 포함

핵심 개념

Google Cloud Antigravity는 OAuth 메커니즘을 통해 인증하며, 각 계정은 독립적인 새로 고침 토큰이 있습니다. mystatus 플러그인은 다음을 수행합니다:

antigravity-accounts.json을 읽어 모든 구성된 계정 가져오기
새로 고침 토큰을 사용하여 액세스 토큰 새로 고침
Google Cloud API를 호출하여 모든 모델의 할당량 가져오기
계정별로 4개 모델의 할당량 및 재설정 시간 표시

Google Cloud 지원 모델

mystatus는 다음 4개 모델의 할당량을 표시합니다:

표시 이름	모델 키(주/대체)	설명
G3 Pro	`gemini-3-pro-high` / `gemini-3-pro-low`	Gemini 3 Pro 고성능 버전
G3 Image	`gemini-3-pro-image`	Gemini 3 Pro 이미지 생성
G3 Flash	`gemini-3-flash`	Gemini 3 Flash 빠른 버전
Claude	`claude-opus-4-5-thinking` / `claude-opus-4-5`	Claude Opus 4.5 모델

주 키 및 대체 키 메커니즘:

API 응답은 주 키 또는 대체 키 중 하나의 데이터만 반환할 수 있음
mystatus는 자동으로 모든 키의 할당량을 가져오려고 시도함
예: gemini-3-pro-high에 데이터가 없으면 gemini-3-pro-low를 시도함

단계별 따라하기

1단계: 조회 명령 실행

왜 필요한가 모든 Google Cloud 계정의 할당량 정보를 빠르게 가져옵니다.

/mystatus

다음을 확인해야 합니다

모든 구성된 플랫폼의 할당량 정보를 포함하며, Google Cloud 섹션은 다음과 같은 내용을 표시합니다:

## Google Cloud Account Quota

### user@gmail.com

G3 Pro     4h 59m     ████████████████████ 100%
G3 Image   4h 59m     ████████████████████ 100%
G3 Flash   4h 59m     ████████████████████ 100%
Claude     2d 9h      ░░░░░░░░░░░░░░░░░░░░ 0%

2단계: 출력 형식 이해

왜 필요한가 핵심 정보를 빠르게 파악: 남은 할당량 및 재설정 시간

각 줄 형식:

[모델 이름] [재설정 시간] [진행률 막대] [남은 비율]

필드 설명:

모델 이름: G3 Pro, G3 Image, G3 Flash, Claude
재설정 시간: 다음 할당량까지 남은 시간(예: 4h 59m, 2d 9h)
진행률 막대: 남은 비율 직관적 표시
남은 비율: 0-100 숫자

다음을 확인해야 합니다 각 모델 한 줄씩, 할당량 및 재설정 시간 명확히 표시

3단계: 다중 계정 상황 보기

왜 필요한가 여러 Google Cloud 계정이 있는 경우, 각각 따로 표시됩니다.

### user@gmail.com

G3 Pro     4h 59m     ████████████████████ 100%
G3 Image   4h 59m     ████████████████████ 100%

### another@gmail.com

G3 Pro     2h 30m     ████████████░░░░░░░░ 75%
G3 Image   2h 30m     ████████████░░░░░░░░ 75%

다음을 확인해야 합니다 각 계정은 별도 섹션이며, 해당 계정의 4개 모델 할당량을 포함

4단계: 할당량 경고 확인

왜 필요한가 초과 사용으로 인한 서비스 중단 방지

어느 모델의 사용률이 80%를 초과하면 경고 메시지가 표시됩니다:

### user@gmail.com

G3 Pro     1h 30m     ████░░░░░░░░░░░░░░░ 20%
G3 Image   1h 30m     ████░░░░░░░░░░░░░░░ 20%

⚠️ 사용률이 80% 이상에 도달했습니다

다음을 확인해야 합니다 경고 메시지는 해당 계정의 모델 목록 아래에 표시됩니다

검사점 ✅

다음 확인을 완료하여 올바르게 수행했는지 확인하세요:

[ ] /mystatus 실행 후 Google Cloud 할당량 정보를 볼 수 있음
[ ] 4개 모델의 이름 및 재설정 시간 이해
[ ] 진행률 막대 및 남은 비율 식별
[ ] 다중 계정이 있는 경우, 모든 계정의 할당량 볼 수 있음

주의 사항

문제 1: Google Cloud 할당량 보이지 않음

가능한 원인:

opencode-antigravity-auth 플러그인 설치 안 함
Google OAuth 인증 완료 안 함
antigravity-accounts.json 파일이 존재하지 않거나 비어 있음

해결 방법:

opencode-antigravity-auth 플러그인 설치
GitHub 저장소의 지침에 따라 인증 완료
/mystatus 다시 실행

문제 2: 특정 계정 오류 표시

가능한 원인:

새로 고침 토큰 만료
projectId 누락

오류 예시:

user@gmail.com: No project ID found

해결 방법:

opencode-antigravity-auth 플러그인을 사용하여 해당 계정 다시 인증
인증 과정에서 프로젝트 ID를 올바르게 설정했는지 확인

문제 3: 모델 데이터 "-" 또는 재설정 시간 비정상

가능한 원인:

API가 반환한 resetTime 필드가 누락되었거나 형식이 비정상
해당 모델에 할당량 정보가 없음

해결 방법:

이것은 정상적인 상황이며, mystatus는 "-"를 표시하여 데이터를 사용할 수 없음을 나타냄
모든 모델이 "-"로 표시되면 네트워크 연결 또는 Google Cloud API 상태 확인

이 수업 요약

Google Cloud Antigravity는 4개 모델 지원: G3 Pro, G3 Image, G3 Flash, Claude
각 모델은 독립적인 할당량 및 재설정 시간을 가짐
다중 계정 관리 지원, 각 계정은 별도로 표시
사용률이 80%를 초과하면 경고 메시지 표시

다음 수업 예고

다음 수업에서 **Google Cloud 고급 구성: 다중 계정 및 모델 관리**를 배웁니다.
학습할 내용:
여러 Google Cloud 계정을 추가하고 관리하는 방법
4개 모델의 매핑 관계 이해
projectId와 managedProjectId의 차이

부록: 소스 코드 참조

소스 코드 위치 확인하려면 클릭

업데이트 시간: 2026-01-23

기능	파일 경로	행번호
모델 구성	`plugin/lib/google.ts`	69-78
계정 조회 로직	`plugin/lib/google.ts`	304-370
토큰 새로 고침	`plugin/lib/google.ts`	162-184
할당량 추출	`plugin/lib/google.ts`	132-157
출력 포맷팅	`plugin/lib/google.ts`	265-294
유형 정의	`plugin/lib/types.ts`	78-94

핵심 상수:

GOOGLE_QUOTA_API_URL = "https://cloudcode-pa.googleapis.com/v1internal:fetchAvailableModels": Google Cloud 할당량 조회 API
GOOGLE_TOKEN_REFRESH_URL = "https://oauth2.googleapis.com/token": OAuth 토큰 새로 고침 API
USER_AGENT = "antigravity/1.11.9 windows/amd64": API 요청 User-Agent

핵심 함수:

queryGoogleUsage(): 모든 Antigravity 계정의 할당량 조회
fetchAccountQuota(): 단일 계정의 할당량 조회
extractModelQuotas(): API 응답에서 4개 모델의 할당량 추출
formatAccountQuota(): 단일 계정의 할당량 표시 포맷팅

모델 매핑 규칙:

G3 Pro는 gemini-3-pro-high 및 gemini-3-pro-low 지원, 주 키 우선 사용
Claude는 claude-opus-4-5-thinking 및 claude-opus-4-5 지원, 주 키 우선 사용
G3 Image 및 G3 Flash는 하나의 키만 존재

빠른 시작

플랫폼 기능

고급 기능

常见问题

부록

버전 기록

Google Cloud 할당량 조회: G3 Pro/Image/Flash 및 Claude

학습 완료 후 할 수 있는 것

현재 문제 상황

이 방법을 사용해야 할 때

🎒 시작 전 준비

핵심 개념

Google Cloud 지원 모델

단계별 따라하기

1단계: 조회 명령 실행

2단계: 출력 형식 이해

3단계: 다중 계정 상황 보기

4단계: 할당량 경고 확인

검사점 ✅

주의 사항

문제 1: Google Cloud 할당량 보이지 않음

문제 2: 특정 계정 오류 표시

문제 3: 모델 데이터 "-" 또는 재설정 시간 비정상

이 수업 요약

다음 수업 예고

부록: 소스 코드 참조

Google Cloud 할당량 조회: G3 Pro/Image/Flash 및 Claude ​

학습 완료 후 할 수 있는 것 ​

현재 문제 상황 ​

이 방법을 사용해야 할 때 ​

🎒 시작 전 준비 ​

핵심 개념 ​

Google Cloud 지원 모델 ​

단계별 따라하기 ​

1단계: 조회 명령 실행 ​

2단계: 출력 형식 이해 ​

3단계: 다중 계정 상황 보기 ​

4단계: 할당량 경고 확인 ​

검사점 ✅ ​

주의 사항 ​

문제 1: Google Cloud 할당량 보이지 않음 ​

문제 2: 특정 계정 오류 표시 ​

문제 3: 모델 데이터 "-" 또는 재설정 시간 비정상 ​

이 수업 요약 ​

다음 수업 예고 ​

부록: 소스 코드 참조 ​

Google Cloud 할당량 조회: G3 Pro/Image/Flash 및 Claude

학습 완료 후 할 수 있는 것

현재 문제 상황

이 방법을 사용해야 할 때

🎒 시작 전 준비

핵심 개념

Google Cloud 지원 모델

단계별 따라하기

1단계: 조회 명령 실행

2단계: 출력 형식 이해

3단계: 다중 계정 상황 보기

4단계: 할당량 경고 확인

검사점 ✅

주의 사항

문제 1: Google Cloud 할당량 보이지 않음

문제 2: 특정 계정 오류 표시

문제 3: 모델 데이터 "-" 또는 재설정 시간 비정상

이 수업 요약

다음 수업 예고

부록: 소스 코드 참조