2026년 6월 18일부터 개인 무료 계정과 Google AI Pro, Ultra 계정의 관련 서비스가 Antigravity CLI로 이전되었습니다. 따라서 로그인 실패가 반복될 때 먼저 삭제와 재설치를 하는 것은 효율적인 첫 조치가 아닙니다.

다만 모든 오류가 같은 원인은 아닙니다. 먼저 계정 유형을 나누어 확인하십시오.

• 개인 무료 계정이라면 Antigravity CLI 이전을 우선 검토합니다.
• Google AI Pro 또는 Ultra라면 개인 계정 이전 대상인지 공식 안내에서 확인합니다.
• 기업 권한이라면 조직 관리자가 허용한 인증 방식과 사용 권한을 확인합니다.
• API 키 인증이라면 키의 사용 조건과 현재 지원 경로를 별도로 검토합니다.
• 로그인 화면 자체가 열리지 않는다면 계정 이전 문제와 일반 연결 문제를 분리합니다.

커뮤니티에서 보이는 오류 사례는 개별 환경의 단서일 뿐, 모든 사용자의 공통 원인으로 단정하면 안 됩니다. 구체적인 버전, 로그인 자격, 설치 명령은 변경될 수 있으므로 실행 직전에 공식 문서를 다시 확인해야 합니다.

결정 조건 목록: 이전할지 보류할지 판단하기

다음 항목을 위에서부터 확인하면 불필요한 재설치를 줄일 수 있습니다.

• [ ] 개인 무료 계정, Google AI Pro 또는 Ultra 계정으로 로그인했습니까?
  그렇다면 Antigravity CLI 이전을 선택합니다.
• [ ] 기업 계정 또는 조직이 관리하는 인증을 사용합니까?
  그렇다면 관리자 권한과 공식 자격을 먼저 확인합니다.
• [ ] 조건을 충족하는 API 키를 사용합니까?
  그렇다면 API 인증 경로를 검토한 뒤 기존 Gemini CLI 유지 여부를 결정합니다.
• [ ] 프로젝트 폴더 위치와 저장되지 않은 변경 내용을 확인했습니까?
  확인하지 못했다면 도구 종료와 이전을 멈추고 파일부터 보존합니다.
• [ ] 새 도구를 삭제 가능한 연습 폴더에서 시험했습니까?
  시험하지 않았다면 실제 과제 폴더를 열지 말고 테스트 환경을 먼저 만듭니다.
• [ ] Xcode 빌드, Python 실행 또는 프런트엔드 화면을 직접 검증했습니까?
  검증하지 않았다면 AI 도구의 완료 표시만으로 과제를 제출하지 않습니다.

개인 계정 사용자라면 첫 번째 항목에서 이전을 선택하면 됩니다. 기업 또는 API 사용자라면 두 번째와 세 번째 항목을 통과한 뒤 기존 도구를 잠시 유지할 수 있습니다. 제출 기한이 가까우면 연습 프로젝트에서 두 경로를 함께 확인한 뒤 전환하십시오.

Gemini CLI와 Antigravity CLI는 작업을 돕는 도구입니다. 프로젝트 폴더 그 자체가 아닙니다. 프로젝트를 공책에 비유하면 CLI는 옆에서 설명하는 조교에 가깝습니다. 조교를 바꾼다고 공책이 자동으로 없어지지는 않습니다. 대신 조교의 메모와 대화 기록은 그대로 따라오지 않을 수 있습니다.

첫 단계: 실제 프로젝트 위치 찾기

파일 탐색기나 터미널에서 프로젝트 폴더를 찾습니다. 로컬 맥에 있는지, 원격 맥에 있는지, 외장 저장 공간에 있는지 구분해야 합니다. 폴더 위치를 모른 채 새 도구를 실행하면 다른 빈 폴더를 열 수 있습니다.

다음 단계: 변경 상태 기록하기

버전 관리 도구를 사용한다면 현재 변경 목록을 확인합니다. 저장되지 않은 편집 내용, 새로 만든 파일, 무시 규칙 때문에 추적되지 않는 파일을 각각 살펴봅니다. 버전 관리가 없다면 프로젝트 폴더를 별도 위치에 복사해 두십시오.

설정과 비밀 정보 분리하기

환경 설정 파일, 인증서, 비밀번호, API 키는 코드와 같은 방식으로 다루면 안 됩니다. 새 도구가 파일을 읽거나 수정하도록 허용하기 전에 비밀 파일을 별도 위치로 옮기거나 접근 대상에서 제외합니다.

주의: 새 도구가 프로젝트를 읽을 수 있다는 것과 프로젝트를 안전하게 수정할 수 있다는 것은 다른 상태입니다. 처음에는 읽기와 설명만 허용하고, 변경은 차이를 확인한 뒤 승인하십시오.

프로젝트 폴더가 존재하고, 변경 내용을 확인했으며, 필요한 설정을 별도로 보관했다면 이전 도구를 종료해도 파일 손실 위험을 줄일 수 있습니다. 반대로 이 세 가지를 확인하지 못했다면 새 도구 설치보다 백업이 먼저입니다.

Antigravity CLI는 실제 코드가 저장되고 실행되는 컴퓨터에 설치하는 것이 원칙입니다. Xcode 프로젝트가 원격 맥에 있다면 윈도우 컴퓨터에만 도구를 설치해서는 충분하지 않습니다. 원격 맥에서 설치, 로그인, 프로젝트 열기를 진행해야 합니다.

반대로 Python 연습 파일이 로컬 맥에만 있다면 로컬 환경에 설치하는 편이 단순합니다. 같은 프로젝트를 두 장비에서 번갈아 수정한다면 어느 폴더가 최신인지 먼저 정해야 합니다. 자동 동기화가 된다고 가정하고 동시에 수정하면 충돌이 생길 수 있습니다.

설치 결과를 확인하는 다섯 단계

설치 방법은 Antigravity CLI 공식 문서와 공식 실습 자료를 기준으로 진행하십시오.

1. 실제 프로젝트가 있는 컴퓨터에서 공식 설치 방법을 확인합니다.
2. 설치가 끝난 뒤 명령어가 인식되는지 확인합니다.
3. 버전 출력이 정상인지 기록합니다.
4. 안내 화면을 통해 계정 인증을 진행합니다.
5. 빈 연습 폴더를 열고 파일 목록과 실제 폴더 내용을 비교합니다.

공식 문서의 명령어는 바뀔 수 있습니다. 다른 글에서 복사한 오래된 명령을 그대로 사용하지 마십시오. 공식 학습 예제도 현재 문서와 맞는지 확인한 뒤 실행해야 합니다.

학교 컴퓨터에 설치 권한이 없다면 관리 제한을 우회하지 마십시오. 개인 맥, 권한이 있는 원격 맥, 또는 브라우저에서 허용된 학습 환경으로 경로를 바꾸는 것이 안전합니다. 학교 계정과 장비 규정도 함께 지켜야 합니다.

KVMNODE의 원격 맥 환경 안내를 살펴볼 때도 먼저 프로젝트가 어느 장비에 있어야 하는지 정하십시오. 도구를 설치한 위치와 코드가 저장된 위치가 다르면 로그인에 성공해도 프로젝트를 찾지 못할 수 있습니다.

로그인, 작업 공간 신뢰, 명령 실행 권한은 서로 다른 기능입니다. 로그인은 계정 확인입니다. 작업 공간 신뢰는 해당 폴더를 도구가 다루어도 되는지 정하는 절차입니다. 명령 실행 권한은 파일 변경이나 프로그램 실행을 허용하는 문과 같습니다.

초보자는 확인 창이 나오면 모두 허용하기 쉽습니다. 그러나 첫 실행부터 공식 과제 폴더나 인증서가 있는 폴더를 열 필요는 없습니다. 삭제해도 되는 연습 프로젝트를 만들어 다음 순서로 검증하십시오.

• 연습 폴더에 간단한 코드 파일만 넣습니다.
• 도구가 읽은 파일 목록을 확인합니다.
• 작은 수정 작업을 요청합니다.
• 실행 전에 바뀔 파일의 차이를 살펴봅니다.
• 예상하지 않은 파일이나 명령이 나오면 거부하고 중단합니다.
• 결과를 직접 실행해 요청한 내용과 같은지 확인합니다.

AI 프로그래밍 도구가 작업을 완료했다고 표시해도 프로그램이 정상이라는 뜻은 아닙니다. Python은 직접 실행해 오류를 확인해야 합니다. 프런트엔드는 개발 서버와 화면을 확인해야 합니다. iOS 학습자는 Xcode에서 빌드하거나 시뮬레이터로 실행해야 합니다.

경험상 첫 요청은 “이 폴더의 파일을 읽고 변경하지 말고 구조만 설명해 달라”가 안전합니다. 읽기 결과가 틀리면 권한을 더 주기 전에 폴더 위치부터 다시 확인하십시오.

공유 계정, 타인의 API 키, 인증서 업로드는 피해야 합니다. 수업용 프로젝트에 개인 토큰이 들어 있다면 도구에 제공하기 전에 삭제하거나 별도 환경 변수로 분리하십시오.

이전이 끝났다는 판단은 로그인 성공만으로 내리면 안 됩니다. 다음 다섯 가지 결과가 모두 확인되어야 합니다.

• 계정이 새 도구에서 정상 인증됩니다.
• 프로젝트 파일과 저장되지 않은 변경 내용이 보존되었습니다.
• Antigravity CLI가 실제 프로젝트 폴더를 읽습니다.
• 작업 공간과 명령 실행 권한을 통제할 수 있습니다.
• 수업 과제를 직접 실행하고 검증할 수 있습니다.

하나라도 실패하면 해당 단계로 돌아가십시오. 예를 들어 계정 인증은 성공했지만 프로젝트가 보이지 않는다면 설치를 반복하지 말고 폴더 위치를 확인해야 합니다. 파일은 읽히지만 Xcode 빌드가 실패한다면 도구의 대화 기록보다 프로젝트 의존성과 빌드 설정을 점검해야 합니다.

개인 학생의 기본 선택은 이전입니다. 계정이 정상이고 기존 수업 환경이 안정적이며 제출 기간이 임박했다면 짧은 기간 두 경로를 유지할 수 있습니다. 단, 실제 과제 폴더에서 동시에 수정하지 말고 복사한 연습 폴더에서 비교하십시오.

윈도우 컴퓨터에서 코드 편집을 하고 맥에서 Xcode 검증을 진행하는 방식도 가능합니다. 그러나 프로젝트가 원격 맥에 저장되어 있다면 Antigravity CLI, 프로젝트 파일, Xcode를 같은 원격 맥에서 연결하는 편이 경로 혼동이 적습니다.

Gemini CLI를 쓸 수 없게 되면 개인 계정 사용자는 재설치보다 계정 이전 여부를 먼저 확인해야 합니다. 이전 후에는 파일 보존, 권한 확인, 실제 실행 검증까지 끝내야 합니다. 로그인 화면이 열렸다는 이유만으로 수업 제출이 준비된 것은 아닙니다.

FAQ는 다음 네 가지를 중심으로 확인하십시오. 개인 계정의 서비스 이전 여부, Antigravity CLI로 바꿀 때 프로젝트가 남는지, 원래 코드 폴더를 열 수 있는지, 원격 맥에 어디에 설치해야 하는지가 핵심입니다. 각각의 답은 계정, 파일 위치, 권한이라는 서로 다른 기준으로 판단해야 합니다.

현재 윈도우 방식은 익숙하고 설치 가능한 도구가 많다는 장점이 있습니다. 그러나 macOS 전용 도구를 실행할 수 없고, Xcode 확인을 위해 별도 맥 환경을 추가해야 하며, 학교 컴퓨터에서는 설치 권한에 막힐 수 있습니다. 반면 맥을 직접 구매하면 비용과 관리 부담이 생기고, 과제 기간이 짧을 때 사용하지 않는 기간에도 장비가 남습니다.

수업 기간에만 Xcode, 사파리, Antigravity CLI를 함께 확인하려는 학생이라면 KVMNODE의 원격 맥을 임시 학습 환경으로 검토할 수 있습니다. 다만 장기간 안정적인 고부하 작업, 물리 아이폰 연결, 개인 장비에만 저장해야 하는 자료가 핵심이면 대여보다 직접 구매가 맞습니다. 먼저 삭제 가능한 예제 프로젝트로 로그인, 파일 읽기, 수정 차이, Xcode 빌드까지 확인한 뒤 정식 과제에 적용하십시오. Xcode 프로젝트가 필요한 학습자는 원격 맥에서 맥 전용 프로젝트를 확인하는 경로도 함께 살펴보면 좋습니다.