Gemini CLI 종료 이후 선택지, Antigravity CLI 설치 가이드

제미나이 CLI 보다 가볍다!

Gemini CLI를 잘 쓰고 있던 입장에서는 Antigravity CLI 전환 소식이 꽤 당황스럽습니다. 터미널에서 바로 AI에게 코드를 물어보고, 프로젝트 구조를 읽게 하고, 간단한 수정까지 맡기는 흐름이 편했기 때문입니다.

이번 글은 Antigravity CLI를 Windows, WSL, Ubuntu 환경에서 설치하고 실제 개발 프로젝트에 적용해보는 기준으로 정리했습니다. 공식 문서만 옮긴 글이 아니라, 개발자가 처음 설치하면서 헷갈릴 만한 부분을 중심으로 적었습니다.

목차

1. Gemini CLI가 종료된 이유
2. Antigravity CLI란?
3. Antigravity CLI 무료 정책
4. Windows / WSL / Ubuntu 설치하기
5. Google 로그인
6. 첫 실행
7. VSCode 연동
8. Spring Boot 프로젝트 테스트
9. MCP 사용하기
10. 장점 / 단점
11. FAQ

1. Gemini CLI가 종료된 이유

설명

Gemini CLI는 터미널 기반 AI 개발 도구로 꽤 쓸 만했습니다. 그런데 Google은 Gemini CLI와 Gemini Code Assist 일부 개인 사용자용 기능을 Antigravity CLI 중심으로 전환한다고 안내했습니다.

핵심은 개발자용 AI 도구를 하나의 흐름으로 묶겠다는 방향입니다. 기존 Gemini CLI, IDE 확장, Agent 기능이 흩어져 있었다면, Antigravity CLI는 그 후속 흐름에 있는 CLI AI 도구로 보면 됩니다.

실제 사용 예시

기존에 아래처럼 쓰던 사람이라면 전환 대상입니다.

gemini
gemini "이 Spring Boot 프로젝트 구조 분석해줘"
gemini "이 오류 로그 보고 원인 찾아줘"

앞으로는 Antigravity CLI 명령어를 기준으로 프로젝트를 열고, 자연어로 작업을 요청하는 방식으로 바뀝니다.

코드 예제

agy
agy "현재 프로젝트 구조를 보고 실행 방법을 정리해줘"

주의사항
Gemini CLI에서 쓰던 명령어, 설정 파일, MCP 설정이 Antigravity CLI에서 100% 동일하게 동작한다고 보면 안 됩니다. 전환 초기에 제일 많이 막히는 부분이 이 지점입니다.

팁
기존 Gemini CLI용 스크립트가 있다면 바로 삭제하지 말고, 별도 브랜치나 백업 폴더에 남겨두는 것을 추천합니다. CLI 도구 전환은 생각보다 자잘한 경로 문제가 많이 납니다.

2. Antigravity CLI란?

설명

Antigravity CLI는 Google Antigravity 플랫폼의 터미널용 AI 개발 도구입니다. 쉽게 말하면 터미널에서 사용하는 AI 개발 도구, 즉 CLI AI입니다.

코드 질문만 하는 챗봇이라기보다는 프로젝트 폴더를 기준으로 코드 분석, 수정 방향 제안, 명령 실행 보조, 개발 작업 정리를 도와주는 도구에 가깝습니다.

구분	설명
도구 유형	CLI 기반 AI 개발 도구
주요 용도	코드 분석, 리팩토링 보조, 오류 원인 파악, 개발 작업 자동화 보조
비교 대상	Gemini CLI, Claude Code, Codex CLI, Aider 등
사용 환경	Windows, macOS, Linux, WSL, Ubuntu

실제 사용 예시

저는 Spring Boot 프로젝트 폴더에서 먼저 이런 식으로 테스트합니다.

agy "이 프로젝트가 어떤 구조인지 설명해줘"
agy "실행에 필요한 Java 버전과 빌드 도구를 확인해줘"
agy "README 기준으로 로컬 실행 순서를 정리해줘"

코드 예제

cd ~/workspace/my-spring-project
agy

주의사항
Antigravity CLI가 프로젝트 파일을 읽고 수정할 수 있는 환경에서는 작업 디렉터리를 꼭 확인해야 합니다. 엉뚱한 폴더에서 실행하면 전혀 다른 프로젝트를 기준으로 답변할 수 있습니다.

팁
처음부터 “전체 수정해줘”라고 하기보다 “분석만 해줘”, “수정 계획만 세워줘”처럼 단계적으로 요청하는 편이 안전합니다.

반응형

3. Antigravity CLI 무료 정책

설명

Antigravity CLI 무료 정책은 계정 유형과 시점에 따라 달라질 수 있습니다. 현재 기준으로 개인 계정은 무료 플랜이 제공되지만, 실제 사용 가능한 모델, 요청량, 제한 조건은 공식 가격 페이지에서 반드시 확인해야 합니다.

이런 AI 개발 도구는 무료라고 해도 완전히 무제한이라는 의미가 아닐 수 있습니다. 특히 Claude Code 대체, Codex CLI 대체 용도로 매일 장시간 사용하려면 제한 정책을 꼭 봐야 합니다.

AI를 통해서 조사한 내용!

실제 사용 예시

개인 개발자는 보통 아래 순서로 확인하면 됩니다.

1. 공식 Antigravity 가격 페이지 접속
2. 개인 계정 무료 플랜 확인
3. 사용 가능한 모델 확인
4. CLI 사용량 제한 확인
5. 업무용이면 회사 계정/GCP 조건 별도 확인

코드 예제

agy --version
agy auth status

주의사항
블로그 글을 보고 설치할 때 가장 위험한 부분이 “무료 정책”입니다. 무료 제공 여부는 바뀔 수 있으니, 설치 전 공식 가격 페이지를 한 번 더 확인하는 것이 좋습니다.

팁
Claude Code, Codex CLI, Antigravity CLI를 같이 비교할 때는 가격만 보지 말고 “내가 쓰는 개발 환경에서 얼마나 덜 막히는지”를 같이 봐야 합니다.

4. Windows / WSL / Ubuntu 설치하기

설명

Antigravity CLI 설치는 운영체제별로 나눠서 보는 것이 좋습니다. Windows 설치, WSL 설치, Ubuntu 설치가 비슷해 보여도 실제로는 경로, 인증, 브라우저 연동에서 차이가 납니다.

Windows 설치

Windows에서는 PowerShell을 관리자 권한으로 열고 공식 설치 명령을 사용하는 방식이 일반적입니다. 아래 명령은 예시이므로, 실제 설치 명령은 공식 문서의 최신 명령을 확인한 뒤 사용하세요.

# PowerShell 예시
# 실제 명령은 공식 문서에서 최신 버전 확인 후 실행
irm https://antigravity.google/install.ps1 | iex

Windows 설치 후 확인

agy --version
where agy

WSL 설치

WSL에서 Antigravity CLI를 쓰려면 Windows 쪽 설치와 WSL 내부 설치를 구분해야 합니다. 개인적으로는 개발 프로젝트가 WSL 안에 있다면 WSL 내부에 CLI를 설치하는 편이 낫습니다.

# WSL Ubuntu 내부 예시
# 실제 명령은 공식 문서에서 최신 버전 확인 후 실행
curl -fsSL https://antigravity.google/cli/install.sh | bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

WSL 설치 후 확인

which agy
agy --version

Ubuntu 설치

Ubuntu 서버나 데스크톱에서는 Linux 설치 방식으로 진행하면 됩니다. WSL과 비슷하지만 브라우저 인증 과정에서 차이가 날 수 있습니다.

sudo apt update
curl -fsSL https://antigravity.google/cli/install.sh | bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
agy --version

실제 사용 예시

저는 WSL 안에 프로젝트가 있으면 아래처럼 프로젝트 폴더로 이동한 뒤 실행합니다.

mkdir demo-api
cd ./demo-api
agy "이 프로젝트 실행 방법을 확인해줘"

주의사항
인터넷에 돌아다니는 설치 스크립트를 그대로 복사해서 실행하지 마세요. Antigravity CLI 설치는 반드시 공식 문서의 명령을 기준으로 진행하는 것이 안전합니다.

팁
Windows에서 개발 파일을 열고, WSL에서 빌드하는 구조라면 경로가 꼬일 수 있습니다. 가능하면 프로젝트 위치와 CLI 실행 위치를 통일하세요.

반응형

5. Google 로그인

설명

Antigravity CLI는 Google 계정 로그인이 필요합니다. 이 부분은 Gemini CLI 후속 도구라는 느낌이 가장 강하게 나는 부분입니다.

대부분은 CLI에서 로그인 명령을 실행하면 브라우저가 열리고, Google 계정으로 인증하는 방식입니다.

실제 사용 예시

agy auth login

로그인이 끝나면 인증 상태를 확인합니다.

agy auth status

구글인증화면을 요구한다!

 

제공되는 코드를 입력(계정결재에 따름)

 

 

인증후 로딩된 화면

 

 

코드 예제

# 로그아웃이 필요한 경우
agy auth logout

# 다시 로그인
agy auth login

주의사항
WSL 환경에서는 브라우저 인증이 매끄럽지 않을 수 있습니다. 인증 URL이 출력되면 Windows 브라우저에 직접 붙여 넣어 로그인하는 방식도 생각해볼 수 있습니다.

팁
회사 계정과 개인 계정을 모두 쓰는 개발자라면, 어떤 계정으로 로그인했는지 먼저 확인하세요. 나중에 사용량이나 권한 문제를 헷갈릴 수 있습니다.

반응형

6. 첫 실행

설명

설치와 로그인이 끝났다면 바로 프로젝트에서 실행해볼 수 있습니다. 처음에는 복잡한 요청보다 읽기 전용에 가까운 질문부터 시작하는 것이 좋습니다.

실제 사용 예시

cd ./demo-api
agy "현재 프로젝트 구조를 설명해줘"

그 다음에는 빌드 파일을 기준으로 개발 환경을 확인하게 합니다.

agy "pom.xml과 README를 보고 로컬 실행 방법을 정리해줘"

코드 예제

agy "최근 수정된 파일 기준으로 변경 내용을 요약해줘"
agy "이 프로젝트에서 테스트 코드를 실행하는 방법을 알려줘"
agy "빌드 실패 가능성이 있는 설정을 먼저 찾아줘"

주의사항
처음 실행할 때 파일 수정 권한을 바로 허용하기보다, 어떤 파일을 수정하려는지 먼저 확인하는 습관이 좋습니다.

팁
AI 개발 도구는 질문을 짧게 던지는 것보다 “내 목표, 현재 상태, 원하는 결과”를 같이 적어주는 편이 결과가 좋습니다.

반응형

7. VSCode 연동

설명

Antigravity CLI를 VSCode와 같이 쓰면 터미널 작업과 코드 확인을 동시에 할 수 있습니다. 다만 VSCode 연동은 Antigravity IDE와 VSCode 확장을 혼동하지 않는 것이 중요합니다.

저는 보통 VSCode로 코드를 열어두고, 하단 터미널에서 Antigravity CLI를 실행하는 방식으로 사용합니다.

실제 사용 예시

cd ./demo-api
code .
agy "Controller, Service, Mapper 구조를 보고 개선할 부분을 알려줘"

 

VSCode WSL 모드에서 바로 열고 사용!

코드 예제

agy "현재 열려 있는 Spring Boot 프로젝트에서 API 목록을 추정해서 정리해줘"
agy "수정 전에 변경 대상 파일 목록만 알려줘"

주의사항
VSCode Remote WSL을 쓰는 경우 Windows 경로와 WSL 경로가 섞이면 문제가 생길 수 있습니다. 프로젝트는 WSL 내부 경로에서 열고, CLI도 같은 WSL에서 실행하는 편이 깔끔합니다.

팁
VSCode 연동이라고 해서 꼭 전용 확장부터 찾을 필요는 없습니다. 처음에는 VSCode 터미널에서 CLI를 실행하는 방식만으로도 충분히 테스트할 수 있습니다.

8. Spring Boot 프로젝트 테스트

설명

Antigravity CLI 사용법을 제대로 확인하려면 단순 샘플보다 실제 Spring Boot 프로젝트에서 테스트해보는 것이 좋습니다. Java 버전, Maven/Gradle, profile, DB 접속 설정이 같이 얽혀 있기 때문입니다.

실제 사용 예시

먼저 프로젝트 구조를 확인합니다.

cd ./demo-api
ls
agy "이 Spring Boot 프로젝트의 실행 조건을 분석해줘"

Maven 프로젝트라면 다음처럼 물어볼 수 있습니다.

agy "pom.xml 기준으로 Java 버전, Spring Boot 버전, 주요 의존성을 정리해줘"

Gradle 프로젝트라면 이렇게 요청합니다.

agy "build.gradle 기준으로 실행 방법과 테스트 방법을 알려줘"

코드 예제

# Maven 실행
./mvnw spring-boot:run

# Gradle 실행
./gradlew bootRun

오류 로그 분석 요청

agy "아래 오류 로그를 보고 원인과 확인 순서를 알려줘"

# 예시
# Failed to configure a DataSource
# url attribute is not specified
# no embedded datasource could be configured

주의사항
application.yml, application.properties에는 DB 계정, API Key, 토큰이 들어 있을 수 있습니다. 외부 저장소나 공유 화면에 노출되지 않도록 주의하세요.

팁
Spring Boot 개발에서는 “코드 수정”보다 “설정 파일과 실행 프로파일 분석”에서 CLI AI의 도움을 먼저 받아보는 것이 좋습니다. 이 부분이 실제로 시간을 많이 줄여줍니다.

반응형

9. MCP 사용하기(필요시)

설명

MCP는 Model Context Protocol의 약자입니다. 쉽게 말하면 AI 개발 도구가 외부 도구나 데이터 소스와 연결될 수 있게 해주는 표준 방식입니다.

Antigravity CLI에서도 MCP 사용법을 익혀두면 단순 코드 분석을 넘어 문서, API, 내부 도구, 클라우드 리소스와 연결하는 흐름으로 확장할 수 있습니다.

실제 사용 예시

일반적으로 MCP 설정 파일에 서버 정보를 추가한 뒤 CLI에서 해당 도구를 사용할 수 있게 구성합니다.

# MCP 설정 파일 위치 확인 예시
ls ~/.gemini/antigravity/

코드 예제

{
  "mcpServers": {
    "example-mcp": {
      "command": "node",
      "args": [
        "/path/to/mcp-server/index.js"
      ]
    }
  }
}

원격 MCP 서버를 쓰는 경우에는 서버 URL과 인증 헤더가 필요할 수 있습니다.

{
  "mcpServers": {
    "remote-example": {
      "serverUrl": "https://example.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

주의사항
MCP 설정에는 API Key 같은 민감 정보가 들어갈 수 있습니다. Git에 올리지 않도록 .gitignore 확인이 필요합니다.

팁
MCP 사용법은 처음부터 많이 붙이지 말고 하나씩 추가하는 것이 좋습니다. 문제가 생겼을 때 어떤 MCP 서버가 원인인지 바로 찾을 수 있어야 합니다.

10. 장점 / 단점

설명

Antigravity CLI는 Gemini CLI 후속 AI 개발 도구로 볼 수 있지만, 모든 개발자에게 바로 맞는 도구라고 보기는 어렵습니다. 특히 기존 Claude Code 대체, Codex CLI 대체를 고민한다면 장점과 단점을 같이 봐야 합니다.

장점

• Google 계정 기반으로 시작하기 쉽다.
• CLI에서 바로 AI 개발 도구를 사용할 수 있다.
• Windows, WSL, Ubuntu 환경을 지원한다.
• Spring Boot 개발처럼 기존 프로젝트 분석에 활용하기 좋다.
• MCP 사용법을 익히면 확장성이 있다.

단점

• Gemini CLI와 1:1 호환된다고 보기 어렵다.
• 전환 초기에는 문서와 실제 동작 차이가 있을 수 있다.
• WSL 인증이나 경로 문제로 삽질할 수 있다.
• 무료 정책은 언제든 바뀔 수 있다.
• 기존 Claude Code, Codex CLI 사용자가 바로 만족하지 않을 수 있다.

반응형

실제 사용 예시

agy "이 기능을 수정하기 전에 영향받는 파일을 먼저 알려줘"
agy "Controller부터 DB Mapper까지 호출 흐름을 추적해줘"
agy "테스트 코드 없이 수정하면 위험한 부분을 알려줘"

주의사항
AI 개발 도구가 제안한 코드를 그대로 운영 프로젝트에 반영하면 안 됩니다. 특히 DB, 인증, 파일 삭제, 배포 스크립트는 반드시 직접 검토해야 합니다.

팁
실무에서는 “AI가 코드를 짜게 하는 것”보다 “내가 놓친 영향 범위를 찾게 하는 것”이 더 안전하고 효과적입니다.

11. FAQ

Q1. Antigravity CLI는 Gemini CLI 후속인가요?

개인 개발자 입장에서는 Gemini CLI 후속 AI 개발 도구로 이해해도 됩니다. 다만 명령어와 설정이 완전히 동일한 것은 아니므로 마이그레이션 확인이 필요합니다.

Q2. Antigravity CLI는 무료인가요?

개인용 무료 플랜이 제공되지만, 사용 가능한 모델과 제한은 공식 가격 정책을 확인해야 합니다. 무료 정책은 변경될 수 있습니다.

Q3. Windows와 WSL 중 어디에 설치하는 게 좋나요?

프로젝트가 WSL 안에 있다면 WSL 설치를 추천합니다. Windows 폴더에서 개발한다면 Windows 설치가 편합니다. 핵심은 프로젝트 위치와 CLI 실행 위치를 맞추는 것입니다.

Q4. Ubuntu 서버에서도 사용할 수 있나요?

Linux 설치 방식으로 사용할 수 있습니다. 다만 브라우저 로그인 과정이 서버 환경에서는 불편할 수 있으므로 인증 방식을 확인해야 합니다.

Q5. VSCode 연동은 꼭 필요한가요?

필수는 아닙니다. 처음에는 VSCode 터미널에서 Antigravity CLI를 실행하는 것만으로도 충분합니다.

Q6. Spring Boot 개발에 쓸 만한가요?

프로젝트 구조 분석, 실행 방법 정리, 오류 로그 분석에는 꽤 쓸 만합니다. 다만 실제 코드 수정은 반드시 개발자가 검토해야 합니다.

Q7. MCP는 꼭 써야 하나요?

처음 설치 단계에서는 필요 없습니다. 기본 CLI 사용에 익숙해진 뒤 외부 도구나 문서, API와 연결할 때 MCP 사용법을 보면 됩니다.

Q8. Claude Code 대체가 가능한가요?

일부 용도는 대체 가능하지만 사용감은 다릅니다. Claude Code를 터미널 중심으로 깊게 쓰고 있었다면 직접 비교 테스트가 필요합니다.

Q9. Codex CLI 대체로 볼 수 있나요?

코드 분석과 수정 보조라는 점에서는 비교 대상이 될 수 있습니다. 다만 모델, 권한 처리, 프로젝트 이해 방식이 다르므로 완전 대체라고 단정하기는 어렵습니다.

Q10. 설치할 때 가장 조심할 점은 무엇인가요?

공식 문서의 설치 명령만 사용하는 것입니다. AI CLI 도구를 사칭한 설치 스크립트나 npm 패키지는 보안 위험이 있을 수 있습니다.