Antigravity 3501 오류 해결: 재설정으로 풀리는 경우와 안 되는 경우

Antigravity App·IDE·CLI(agy)나 VS Code의 Gemini Code Assist에서 "You do not have a valid license of this product… (#3501)"이 떴다면, 여기서 license는 소프트웨어 라이선스 키가 아니라 Google의 기업용 좌석(Gemini Code Assist Standard·Enterprise)을 뜻합니다. 서버가 계정에서 그 좌석을 찾지 못했다는 거절인데, Google 직원의 포럼 답변에 따르면 지역 제한으로 거절할 때도 같은 메시지가 나옵니다. 기업 로그인으로 잘못 잡힌 세션, 2026년 6월 18일에 끝난 Code Assist 개인 사용, 계정 국가·VPN, 연령 확인, 요금제 혜택이 모두 같은 #3501로 끝나기 때문에 메시지만 보고는 원인을 알 수 없습니다.

개인 Gmail 계정으로 Antigravity를 쓴다면 최신 버전으로 올리고(2026년 10월 23일 기준 App v2.25.0, CLI v1.4.0), AGY_ADC_AUTH 환경 변수가 있으면 지운 뒤, IDE·App에서는 명령 팔레트의 Antigravity: Reset Onboarding, CLI에서는 /logout 후 /login을 실행하고 개인 @gmail.com 계정을 고르세요. VS Code·JetBrains의 Gemini Code Assist 확장이나 Gemini CLI를 개인 계정·Google AI Pro로 쓰고 있다면 재설정으로는 풀리지 않으므로 Antigravity로 옮겨야 합니다. 어느 경우든 ~/.gemini 폴더는 지우지 마세요. 에이전트 대화 기록과 Gemini CLI 로그인까지 함께 사라집니다.

같은 PC에서 개인 계정 여러 개가 모두 #3501이고 VPN도 AGY_ADC_AUTH도 없다면 원인은 계정이나 지역 판정 쪽이어서 재설치를 반복해도 소용없습니다. 직접 실행해 본 것은 2026년 10월 23일 macOS 26.1 Mac 한 대에서 Antigravity 데이터 폴더 크기와 환경 변수를 점검한 두 가지뿐입니다. #3501 자체는 재현하지 못했고 Windows 명령은 실행하지 않았으므로, 나머지는 Google 공식 문서와 Google AI 개발자 포럼의 직원·운영자 답변에 근거합니다.

3501 오류 원인별 판별표: 클라이언트·계정·접속 위치로 나누기

API 로그나 CLI 출력을 보면 이 메시지와 함께 HTTP 403, PERMISSION_DENIED, 이유 SUBSCRIPTION_REQUIRED, 도메인 cloudaicompanion.googleapis.com이 찍힙니다(gemini-cli GitHub 이슈 #28912에 올라온 로그). Antigravity, Code Assist 확장, Gemini CLI 어디서 나와도 문구와 번호가 같기 때문에, 무엇을 쓰고 있는지와 어떤 계정으로 어디서 접속했는지로 나눠 보는 것이 가장 빠릅니다.

표에서 지역 행의 근거는 Google 직원(포럼에서 staff로 표시된 chunduriv)이 2026년 9월 9일 Google AI 개발자 포럼의 지역 제한 스레드에서 한 답변입니다. 지역 제한으로 연결을 거부할 때 "지역 미지원" 대신 이 라이선스 오류를 내는, 오해를 부르는 메시지라고 설명하고 혼란에 사과했습니다. VPN, 연령, 국가 변경 대기 시간, Windows 관련 내용은 포럼 운영자(Rebbanpalli_Naveen, Ambati_Rajendra)가 여러 스레드에서 일관되게 한 답변이며 staff 표시는 없으므로 Google 공식 문서와 같은 무게로 보지는 않는 편이 맞습니다. 회사 계정 행은 Antigravity FAQ의 "Google Workspace 계정에서 문제가 생기면 @gmail.com 주소를 써 보라"는 안내에 따른 것입니다.

기업 로그인으로 잘못 잡혔을 때: Reset Onboarding 순서

Google 직원은 2026년 9월 24일 Fady_Azmy가 올린 #3501 포럼 스레드에서 이 오류가 "로그인이 기업·비즈니스 라이선스가 필요한 것으로 처리됐는데 계정에 활성 라이선스가 없을 때" 생긴다고 설명했습니다. 예전에 회사 계정이나 Google Cloud 프로젝트로 로그인한 상태가 남아 개인 계정까지 기업 검사로 보내는 경우이고, 아래 순서는 이 경우에만 효과가 있습니다. Antigravity 변경 내역을 보면 App v2.16.0(9월 22일)에서 만료되거나 거부된 기업 로그인 정보가 캐시에 남던 문제를, v2.18.1(9월 28일)에서 기업 로그인 도중 앱을 닫으면 미완료 로그인이 저장되던 문제를, CLI v1.2.9(9월 23일)에서 중간에 멈춘 기업 로그인 정보가 남던 문제를 고쳤기 때문에 업데이트가 첫 단계입니다.

1. 최신 버전으로 올립니다. 2026년 10월 23일 기준 최신은 App v2.25.0(10월 20일)과 CLI v1.4.0(10월 16일)이고, CLI는 agy update로 올릴 수 있습니다. 새 버전은 며칠에 걸쳐 단계적으로 배포되므로 아직 이전 버전이 보일 수 있습니다.
2. AGY_ADC_AUTH 환경 변수가 있으면 지우고 Antigravity와 터미널을 완전히 다시 시작합니다. OS별 확인 방법은 아래 환경 변수 절에 있습니다.
3. 로그인 상태를 초기화합니다. Antigravity IDE·App에서는 명령 팔레트(macOS Cmd+Shift+P, Windows·Linux Ctrl+Shift+P)를 열고 Antigravity: Reset Onboarding을 실행합니다. 일반 로그아웃과 달리 캐시된 온보딩 상태까지 지우고 로그인을 처음부터 다시 시작합니다. Antigravity CLI에서는 /logout을 입력한 뒤 /login을 입력합니다.
4. 브라우저 로그인 화면에서 개인 @gmail.com 계정을 고릅니다. Enterprise, Workspace SSO, Google Cloud 옵션은 고르지 않습니다.
5. Windows라면 자격 증명 관리자 → Windows 자격 증명에서 LegacyGeneric:target=gemini:antigravity 항목을 지운 뒤 다시 로그인합니다. 포럼 운영자에 따르면 이 토큰은 앱 재설치나 .gemini, %APPDATA%\Antigravity 삭제로는 지워지지 않으며, agy 안에서 /logout을 실행해도 지워집니다.

IDE와 App 2.x를 함께 설치했다면 Google 직원이 9월 28일 같은 스레드에서 제안한 방법도 있습니다. IDE가 아닌 독립 실행형 Antigravity App을 열어 로그인하고, 계정 확인이나 QR 코드 스캔을 요청하면 끝까지 마친 다음 IDE로 돌아와 다시 로그인하는 순서입니다. 그 스레드에는 이 방법의 결과 보고가 올라오지 않았습니다.

~/.gemini 폴더를 지워야 하나: Mac에서 잰 689 MB의 정체

지우기 전에 위의 Reset Onboarding과 로그아웃을 먼저 하세요. 2026년 10월 23일 macOS 26.1 Mac 한 대(2025년 12월~2026년 1월에 Antigravity IDE를 쓰고 지금은 앱을 지운 상태)에서 확인해 보니 ~/.gemini/antigravity 하나가 689 MB였고, 그 안은 로그인 정보가 아니라 에이전트 대화, brain 산출물(83개), 브라우저 녹화 파일(4,302개)이었습니다. 같은 ~/.gemini에는 Gemini CLI 로그인 정보(google_accounts.json)와 MCP OAuth 토큰(mcp-oauth-tokens-v2.json)도 들어 있어서, 포럼에서 흔히 보이는 "~/.gemini를 지우라"는 조언을 따르면 에이전트 기록과 CLI 로그인이 함께 사라집니다.

du -sh ~/.gemini/antigravity ~/.antigravity "$HOME/Library/Application Support/Antigravity"
# 689M  ~/.gemini/antigravity
#  71M  ~/.antigravity
# 142M  ~/Library/Application Support/Antigravity

ls ~/.gemini/antigravity
# brain  browser_recordings  code_tracker  conversations  implicit
# mcp_config.json  playground  scratch  user_settings.pb  ...

로그인과 관련된 브라우저 상태(Cookies, Local Storage, Session Storage)는 ~/Library/Application Support/Antigravity 쪽에 있었고, 포럼 운영자에 따르면 토큰은 OS 키체인이나 Windows 자격 증명 관리자에도 저장됩니다. 그래서 ~/.gemini를 지워도 키체인 토큰이 남아 있으면 같은 세션으로 다시 들어가게 되고, 기록만 잃는 결과가 될 수 있습니다.

재설정을 한 뒤에도 폴더를 정리해야겠다면 앱을 완전히 종료하고 지우는 대신 이름을 바꿔 두세요. 오류가 그대로면 이름을 되돌려 기록을 살릴 수 있습니다.

mv "$HOME/Library/Application Support/Antigravity" "$HOME/Library/Application Support/Antigravity-backup"
# 꼭 필요할 때만: Gemini CLI도 다시 로그인해야 합니다
mv ~/.gemini ~/.gemini-backup

Windows에서는 탐색기에서 %APPDATA%\Antigravity 폴더 이름을 Antigravity-backup으로 바꾸면 같은 효과입니다. 이 확인은 Mac 한 대, 계정 하나, 예전 버전 앱의 폴더 구성 기준이며 v2.25.0에서는 구성이 다를 수 있습니다. 이름을 바꾸는 것만으로 #3501이 풀리는지는 시험하지 않았습니다.

AGY_ADC_AUTH 환경 변수 확인: macOS·Linux·Windows

AGY_ADC_AUTH는 Google Cloud 기본 사용자 인증 정보(Application Default Credentials)로 Antigravity에 로그인하게 하는 변수입니다. Google 직원과 포럼 운영자 답변에 따르면 이 값이 설정돼 있으면 개인 계정도 기업 라이선스 검사로 보내지고, 환경 변수는 앱 재설치나 폴더 삭제로 지워지지 않습니다. 재설치를 몇 번 해도 오류가 똑같다면 가장 먼저 볼 곳입니다.

macOS·Linux: 셸 변수와 launchctl 모두 확인

2026년 10월 23일 같은 Mac에서 아래 두 명령을 실행했고, 둘 다 아무것도 출력하지 않았습니다(Google Cloud 기본 인증 파일 ~/.config/gcloud/application_default_credentials.json도 없었습니다).

env | grep -E '^(AGY_|GOOGLE_CLOUD_PROJECT|GOOGLE_APPLICATION_CREDENTIALS|GOOGLE_GENAI_USE_VERTEXAI|CLOUDSDK_)'
launchctl getenv AGY_ADC_AUTH

macOS에서 두 곳을 모두 보는 이유는 Dock이나 Finder에서 실행한 앱이 ~/.zshrc를 읽지 않기 때문입니다. 터미널에서 env가 비어 있어도 launchctl setenv로 넣은 값은 GUI 앱에 전달됩니다. 값이 나오면 ~/.zshrc나 ~/.bash_profile에서 해당 export 줄을 지우고 unset AGY_ADC_AUTH를 실행하며, launchctl에 있던 값은 launchctl unsetenv AGY_ADC_AUTH로 지운 뒤 Antigravity를 완전히 종료했다가 다시 엽니다. Linux에서는 env 확인과 unset만 하면 됩니다.

GOOGLE_CLOUD_PROJECT도 함께 확인해 두면 좋습니다. Antigravity에서 원인으로 확인된 변수는 AGY_ADC_AUTH뿐이지만, Gemini CLI에서는 Google Cloud 프로젝트 ID로 로그인한 상태에서 #3501이 보고된 적이 있습니다(앞의 gemini-cli 이슈 #28912).

Windows: 사용자 변수와 시스템 변수 확인

아래 PowerShell 명령은 실행해 보지 않았습니다. 포럼 운영자가 안내한 위치를 확인하는 명령으로, 두 줄 중 하나라도 값이 나오면 설정된 것입니다.

[Environment]::GetEnvironmentVariable('AGY_ADC_AUTH','User')
[Environment]::GetEnvironmentVariable('AGY_ADC_AUTH','Machine')

지우려면 설정 → 시스템 → 정보 → 고급 시스템 설정 → 환경 변수에서 사용자 변수와 시스템 변수 양쪽의 AGY_ADC_AUTH를 삭제합니다. 운영자 답변에 나오는 Remove-Item Env:\AGY_ADC_AUTH는 지금 열린 PowerShell 창에서만 값을 없애므로, 영구 설정은 위 화면에서 지워야 합니다. 삭제한 뒤에는 Antigravity와 터미널을 모두 다시 시작합니다.

Gemini Code Assist·Gemini CLI의 3501: 6월 18일 이후 예정된 동작

Gemini Code Assist 지원 중단 안내 페이지에 따르면 2026년 6월 18일 이후 Gemini Code Assist IDE 확장과 Gemini CLI는 Google AI Pro·Ultra와 개인용 Gemini Code Assist 요청을 처리하지 않습니다. 그래서 VS Code나 JetBrains에서 개인 계정이나 AI Pro로 Code Assist 확장을 쓰다 #3501을 봤다면 고장이 아니라 예정된 결과이고, 포럼 운영자(Ambati_Rajendra)도 10월 1일 VS Code Code Assist 3501 스레드에서 같은 답을 했습니다. 로그아웃, 재설치, 자격 증명 삭제를 반복해도 결과는 바뀌지 않습니다.

메시지가 "관리자에게 라이선스를 요청하라"고 해도 개인 사용자가 라이선스를 사서 해결할 길은 사실상 없습니다. 확장을 계속 쓰려면 유료 Standard·Enterprise 라이선스가 필요한데, 같은 안내 페이지 기준으로 이 두 등급의 신규 구독은 2026년 10월 9일 이후 구매할 수 없고 연간 갱신은 2027년 1월 31일, 월간 갱신은 2027년 12월 31일에 끝납니다. AI Pro 요금제로 코딩 에이전트를 쓰려면 Antigravity App·IDE·CLI나, 포럼 운영자가 10월 16일 안내한 공식 "Antigravity for Visual Studio Code" 확장으로 옮기세요.

지역·VPN 문제인가: 약관 국가, 접속 경로, 만 18세 확인

한국은 Antigravity FAQ의 제공 국가 목록에 들어 있습니다(2026년 10월 23일 기준 아시아 43개 국가·지역 중 하나). 그래도 지역 검사에 걸릴 수 있는 이유는 확인 대상이 IP만이 아니라 Google 계정에 연결된 국가와 실제 접속 경로이기 때문입니다. 계정 국가는 Google 서비스 약관 페이지에 표시된 국가이고, 틀렸다면 Google 국가 연결 변경 신청 양식으로 바꿔 달라고 요청할 수 있습니다. 포럼 운영자에 따르면 변경이 반영되기까지 24~48시간 이상 걸릴 수 있고, Google 결제 프로필 중 미지원 지역에 묶인 프로필이 남아 있어도 같은 오류가 날 수 있습니다.

VPN은 원인 중 하나이지 해결책이 아닙니다. 포럼 운영자 답변에 따르면 VPN, 프록시, TUN 모드, 분할 터널(IPv6 트래픽이 따로 나가는 경우 포함)을 거치면 위치 확인이 실패하고, 그 세션에는 무료 개인 등급이 배정되지 않아 #3501로 끝납니다. 한국에서 접속한다면 VPN을 완전히 끄고 직접 연결로 다시 로그인하세요. 포럼의 한 사용자는 10월 3일 특별한 조치 없이 복구됐다가 10월 13일 실수로 VPN을 켠 채 계정을 열고 다시 기업 라우팅으로 돌아갔다고 보고했습니다. 개별 사례이지만 순서는 참고할 만합니다.

실제 위치나 계정 국가가 목록 밖이라면 클라이언트에서 고칠 방법은 없습니다. 이 경우 앱이나 CLI에 "Your current account is not eligible for Antigravity, because it is not currently available in your location"이라는 더 직접적인 메시지가 함께 나오기도 합니다. 연령도 같은 성격의 검사입니다. Antigravity FAQ는 만 18세 미만에게 제공하지 않는다고 밝히고, 요건을 충족하면 Google 계정 연령 인증 페이지에서 인증하도록 안내합니다. 연령 미인증이 #3501로 나타난다는 설명은 공식 문서가 아니라 포럼 운영자 답변에서 나온 것입니다.

Google AI Pro를 결제했는데 3501: 체험판·제휴사 요금제일 때

Pro를 결제했다는 사실만으로는 #3501이 풀리지 않습니다. Antigravity FAQ 기준으로 Gemini 4 Argon, Claude Opus 5.5, Claude Sonnet 5.5는 유료 Google AI Pro나 Ultra가 필요하고 무료 체험에는 포함되지 않습니다. 체험판 사용자는 체험 취소를 요청한 뒤 유료 Pro로 전환하거나 Ultra로 올려야 하고, 제휴사·Pixel Pass·Google Fi로 받은 멤버십은 Google One 서드파티 구독 관리 도움말을 따라야 합니다. 어느 입구와 요금제에서 Argon을 쓸 수 있는지는 Gemini 4 Argon·Opus 5.5·GPT-6.1 Sol 비교: 작업당 비용 6배 차이에 정리돼 있습니다.

제휴사 요금제의 사례로는 포럼 운영자(Ambati_Rajendra)가 10월 1일과 8일 Jio 제공 AI Pro 3501 스레드에서 한 답변이 있습니다. 계정 국가는 독일, Pro는 인도 Jio에서 받은 경우였는데, 운영자는 Antigravity가 혜택을 직접 주는 것이 아니라 Google 구독에서 읽어 오므로 요금제 발급 국가와 계정 국가가 다르면 혜택이 적용되지 않을 수 있고, Antigravity 쪽에서 수동으로 다시 맞춰 줄 수 없다고 했습니다. Google One 지원이나 제휴사에 문의하거나 자기 나라에서 Pro를 직접 구독하는 것이 지원되는 방법이며, 그동안에도 Antigravity는 Starter Quota로 쓸 수 있습니다. 그 사례의 #3501은 앱이 아니라 내부 엔드포인트를 직접 호출해서 나온 것이었고, 운영자는 공식 앱과 CLI만 쓰라고 답했습니다.

X에서는 2026년 10월 17일 @StatsWire가 Pixel·Jio·학생 혜택처럼 번들로 받은 AI Pro 계정이 Google 백엔드에서 '체험·프로모션'으로 분류돼 HTTP 403 #3501과 함께 Gemini 4 Argon·Claude 5.5가 막힌다고 주장했고(@StatsWire의 X 게시물, 조회 약 4만 6천 회), 다음 날까지 다른 계정 두 곳이 이를 옮겼습니다. Google이 확인한 내용은 아닙니다. 체험판에 해당 모델이 포함되지 않는다는 부분만 공식 FAQ와 맞고, 그것이 #3501로 나타난다는 부분은 보고 수준입니다.

재설치를 멈출 시점과 Google에 보낼 정보

Reset Onboarding, 로그아웃·로그인, AGY_ADC_AUTH 삭제, 키체인 토큰 삭제, 업데이트가 고칠 수 있는 것은 클라이언트에 남은 기업 로그인 상태뿐입니다. 같은 PC에서 개인 계정 두 개 이상이 모두 #3501이고 VPN도 AGY_ADC_AUTH도 없다면 원인은 서버 쪽 계정·지역 판정이고 재설치를 반복해도 바뀌지 않는다고 보는 것이 위의 직원·운영자 답변을 종합한 추론입니다. 포럼 운영자도 10월 8일 Antigravity 2.19.1 개인 무료 계정 3501 버그 스레드에서 같은 상황을 "서버 측 지역 또는 계정 자격 거부"를 가리키는 경우라고 답했습니다.

서버 쪽 판정은 저절로 풀리기도 하지만 기한은 알 수 없습니다. Google AI 개발자 포럼에는 2026년 10월 23일 기준 "3501"로 검색되는 주제가 약 45개 있고, 6월 22일 전후, 8월 19~28일, 9월 24~29일(엿새 동안 약 25건, 대부분 "개인 계정이 기업용으로 잘못 잡혔다"는 글)에 몰렸으며 10월 15일에도 새 글이 올라왔습니다. 9월 말에 막힌 한 사용자는 10월 3일 특별한 조치 없이 복구됐고, 다른 사용자는 9월 26일 지인들의 오래된 개인 계정은 막히고 새로 만든 계정은 된다고 보고했습니다. 둘 다 개별 사례라 일반화할 수는 없습니다.

더 시도하지 말고 신고할 차례라면, Antigravity 지원 페이지에 연결된 커뮤니티(Google AI 개발자 포럼 포함)에 아래 항목을 함께 올리세요. 요금제 혜택 문제라면 Google One 지원이 창구입니다. Google 직원과 포럼 운영자가 추가 조사를 위해 요청한 항목입니다.

• 오류와 함께 표시된 Error ID, 보이면 Trajectory ID
• 사용한 화면(IDE, App 2.x, CLI)과 버전, OS
• 실제 접속 국가와 Google 서비스 약관 페이지에 표시된 계정 국가
• 요금제(무료, Pro, Ultra)와 직접 결제·체험판·제휴사 중 어느 경로인지
• VPN·프록시 사용 여부, AGY_ADC_AUTH 설정 여부, 이미 해 본 단계
• 진단 로그 .txt 파일(Help > Toggle Developer Tools > Console, 또는 View > Output > Antigravity Language Server) 또는 오류 화면 스크린샷

포럼은 공개 게시판이므로 로그를 올리기 전에 이메일 주소를 가리세요.

Antigravity 3501 오류에 관한 다른 질문

회사 Google Workspace 계정이라면 관리자에게 라이선스를 받으면 되나요?

2026년 10월 23일 기준 Antigravity FAQ는 Antigravity가 승인된 지역의 개인 Google 계정에 제공된다고 밝히고, Workspace 계정에서 문제가 생기면 @gmail.com 주소를 써 보라고 안내합니다. 회사 업무로 Antigravity를 쓰려는 것이라면 FAQ가 가리키는 Antigravity Enterprise 문서의 Google Cloud 로그인 절차를 따라야 하고, 개인 용도라면 회사 계정 대신 @gmail.com 계정으로 로그인하는 것이 맞습니다.

Antigravity 로그인을 Claude Code·OpenCode에서 써도 되나요?

안 됩니다. Antigravity FAQ는 Claude Code, OpenClaw, OpenCode 같은 서드파티 소프트웨어에 Antigravity 로그인을 쓰는 것을 서비스 약관 위반으로 보고 계정 정지나 해지까지 이어질 수 있다고 밝히며, 서드파티 코딩 에이전트에는 Gemini Enterprise나 Google AI Studio API 키를 쓰라고 안내합니다. API 키 방식이라면 laozhang.ai도 키 하나로 gemini-4-argon(입력·출력 100만 토큰당 $2·$10)과 gemini-3.8-flash를 제공하지만(2026년 10월 23일 기준 플랫폼 표시 가격), 이는 Antigravity 요금제를 쓰는 방법도 #3501을 푸는 방법도 아닙니다.

안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.

로그인은 되는데 Antigravity가 느리면 같은 문제인가요?

아닙니다. 로그인이 끝나고 응답만 늦다면 #3501과 관계없는 속도 문제이며, 원인별 대처는 Antigravity의 Gemini 3.8 Flash 느림, 원인별 대처에서 다룹니다.