안티그래비티에서 아르곤이 보이지 않는다면 재설치부터 하기보다 이용 중인 제품과 로그인 경로를 먼저 확인해야 합니다. Google AI Pro의 제미나이 앱 이용 조건이 안티그래비티에 그대로 적용되지는 않습니다. API 키를 연결한 CLI라면 구독 계정과 다른 경로로 요청을 보냅니다.
모델 목록이 없는 문제, 프로그램이 시작되지 않는 문제, 대화를 보낸 뒤 오류가 나는 문제는 확인할 곳이 다릅니다. 2026년 10월 15일 공식 문서 기준으로 처음 연결할 때와 연결이 어긋났을 때의 순서를 나누어 보겠습니다.
앱에서는 모델 선택 전에 제품과 계정을 맞춥니다
먼저 실행한 프로그램이 Antigravity 앱인지 확인합니다. 별도 Antigravity IDE에서는 아르곤을 지원하지 않습니다. 개인 계정의 안티그래비티 아르곤 이용 조건은 Google AI Ultra이며, 기업 계정은 해당 Enterprise 조건을 따릅니다. Pro 계정으로 로그인한 뒤 아르곤이 없는 상황은 설치 실패와 구분해야 합니다.
앱의 공식 시작 경로는 New Project → Add Folder → Create입니다. 작업 폴더를 연결한 뒤 대화 입력창의 모델 선택 메뉴를 확인합니다. 프로젝트를 만들었다는 사실만으로 선택할 수 있는 모델이 늘어나지는 않습니다. 구독한 계정과 지금 로그인한 계정이 같은지도 함께 확인합니다.
CLI는 실행 파일과 로그인부터 확인합니다
CLI는 터미널에서 사용하는 프로그램이며 실행 이름은 agy입니다. 공식 설치 안내에서 운영체제에 맞는 설치 경로를 확인한 뒤, agy --version으로 버전이 표시되는지 봅니다. 이 결과는 실행 파일을 찾았다는 뜻이며 아르곤 사용 권한까지 확인한 것은 아닙니다.
agy: command not found가 나오면 터미널이 실행 파일 위치를 찾지 못한 상태입니다. macOS·Linux의 기본 설치 폴더는 $HOME/.local/bin입니다. 먼저 그 위치에 파일이 있는지, 터미널이 명령을 찾는 PATH에 그 폴더가 포함되는지 확인합니다. 여기서 막혔다면 모델 요금제나 API 키를 바꿔도 해당 문제는 해결되지 않습니다.
계정 방식에서는 저장된 보안 키링의 로그인 정보를 사용할 수 있습니다. 저장된 세션이 없으면 브라우저 로그인이 열립니다. 따라서 브라우저가 매번 뜨지 않는다는 이유만으로 로그인이 생략됐다고 판단하지 않습니다. 반대로 키링 잠금 오류가 표시되면 모델 목록보다 운영체제의 인증 저장소 접근 상태를 먼저 살펴봅니다.
API 키 방식은 두 설정이 함께 있어야 합니다
CLI를 API 방식으로 쓰려면 ~/.gemini/antigravity-cli/settings.json의 modelProvider 값을 gemini로 지정하고, 실행 환경에 GEMINI_API_KEY를 설정해야 합니다. 키만 넣으면 전환되지 않습니다. 기존 설정 파일에서는 다른 항목을 지우지 말고 필요한 항목만 수정합니다.
API 방식이면 상단에 이메일 대신 Gemini API key가 표시됩니다. 요청은 Gemini API로 직접 가며 구독 계정 세션을 만들지 않습니다.
| 증상 | 확인할 항목 | 조치 |
|---|---|---|
| 키 누락으로 시작 종료 | API 모드인데 키 없음 | 키 설정 또는 계정 복원 |
| 계정 로그인으로 시작 | 제공자 설정 철자 | gemini 확인 후 재시작 |
| 키 설정 반영 안 됨 | 변수 이름·설정 위치 | 아래 변수 조건 확인 |
| 첫 요청 모델 오류 | 키 유효성·모델 권한 | AI Studio에서 키 확인 |
.env 파일이나 GOOGLE_API_KEY만 설정한 경우 이 인증에 적용되지 않습니다. 실행 환경의 GEMINI_API_KEY를 사용해야 합니다. 키 값이 비어 있지 않은지 확인하는 단계와 실제 모델 요청은 다릅니다. CLI가 열려도 첫 요청에서 오류가 날 수 있으므로, 키가 있다는 사실만으로 아르곤 사용이 보장되지는 않습니다.
구독 한도와 API 연결을 같은 뜻으로 읽지 않습니다
안티그래비티 요금제 안내의 “추가 한도를 위한 BYOK 미지원”에서 BYOK는 자신의 API 키를 가져와 쓰는 방식입니다. 자기 키를 구독 한도에 덧붙이는 방식을 지원하지 않는다는 뜻입니다. CLI의 별도 API 인증 경로까지 없다는 뜻으로 읽으면 두 문서가 모순처럼 보입니다. 계정 구독 한도와 API 요청 경로를 따로 보면 구분됩니다.
계정 방식에서 기본 한도를 다 썼을 때는 AI Credit Overages 설정도 확인합니다. Never는 한도가 갱신될 때까지 추가 크레딧을 자동 사용하지 않고, Always는 기본 한도가 끝나면 크레딧을 사용합니다. 이 설정을 API 단가표와 혼합해 예상 지출을 계산하지 않아야 합니다. CLI에서는 /usage로 모델 한도, /credits로 크레딧을 확인할 수 있습니다.
계정 로그인으로 돌아갈 때는 provider부터 복원합니다
API 방식을 그만 쓰려면 settings.json의 modelProvider 항목을 제거한 뒤 CLI를 다시 시작해 계정으로 로그인합니다. provider=gemini를 남겨 둔 채 환경 변수만 없애면 시작할 수 없습니다. API 모드의 /logout은 지울 계정 세션이 없어 효과가 없습니다. 키 연결을 끊는 것과 계정 로그아웃은 다른 작업입니다.
연결 확인은 모델 선택과 결과 검토까지 이어집니다
CLI의 /model에서 사용할 모델을 선택합니다. 그런 다음 빈 시험 폴더에서 “숫자 두 개를 더하는 간단한 Python 파일을 만들고 실행 방법을 설명해 주세요”처럼 결과를 확인하기 쉬운 요청을 보냅니다. 이는 첫 연결을 점검하기 위한 예시이며, 실제로 실행해 얻은 성공 기록은 아닙니다.
파일이 생성되면 Ctrl+R로 검토 화면을 열어 전체 내용과 변경점을 읽습니다. Python을 실행할 수 있는 환경이라면 실행을 별도로 요청하고, 제안된 명령을 확인한 뒤 결과를 봅니다. 생성된 코드가 있다는 것과 프로그램이 올바른 값을 출력했다는 것을 나누어 확인하는 단계입니다.
작업을 마친 뒤 /diff로 파일 변경을 살펴보고 /usage로 한도를 확인합니다. 문제가 있다면 “안 된다” 대신 버전 표시 여부, 현재 인증 표시, 선택한 모델, 실패한 단계, 오류 문구를 남깁니다. 키나 인증 코드는 제외합니다. 이렇게 기록하면 설치·계정·모델 접근·파일 작업 중 어디에서 막혔는지 구분할 수 있습니다.
출처
- Google Antigravity 모델별 접근 조건 2026-10-15
- Google Antigravity 앱 시작 안내 2026-10-15
- Antigravity CLI 설치와 인증 2026-10-15
- Google Antigravity 한도와 크레딧 2026-10-15
- Antigravity CLI 명령 참조 2026-10-15
0 댓글