06/02/2026 · zyss

Antigravity CLI 설치 방법: Google 계정으로 시작하는 AI 개발 도우미

Google Antigravity CLI 공식 홈페이지에 소개된 Antigravity CLI는 터미널에서 AI 개발 도우미를 실행하는 도구입니다. 마우스로 프로그램을 여는 대신 명령어 창에서 AI에게 작업을 부탁하는 방식입니다.

처음 쓰는 사람도 따라 할 수 있도록 사용 가능 조건, 설치, 계정 로그인, API 키 사용 상황, 첫 프롬프트 순서로 정리했습니다.

1. 사용 가능 조건 확인하기

Antigravity CLI도 설치 명령어만으로 모든 기능이 바로 열리는 것은 아닐 수 있습니다. Google 계정 로그인, 계정 권한, 서비스 정책에 따라 사용할 수 있는 기능과 사용량이 달라질 수 있습니다.

무료 계정으로 시도하는 경우 일부 기능이 제한될 수 있으니, 실행 화면의 로그인 안내와 공식 문서를 먼저 확인하는 것이 좋습니다.

2. 설치 전 준비하기

macOS, Linux, Windows 중 내가 사용하는 운영체제를 확인합니다. 설치 명령어가 운영체제마다 다르기 때문입니다.

uname -a

Windows 사용자는 PowerShell 또는 CMD를 사용할 수 있습니다.

3. Antigravity CLI 설치하기

Antigravity CLI 설치 매뉴얼 기준으로, macOS 또는 Linux에서는 아래 명령어를 실행합니다.

curl -fsSL https://antigravity.google/cli/install.sh | bash

Windows PowerShell에서는 아래 명령어를 실행합니다.

irm https://antigravity.google/cli/install.ps1 | iex

Windows CMD에서는 아래 명령어를 실행합니다.

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

4. Google 계정으로 로그인하기

설치가 끝나면 아래 명령어로 Antigravity CLI를 실행합니다.

agy

처음 실행하면 Google 계정 로그인이 필요할 수 있습니다. 내 컴퓨터에서는 브라우저가 자동으로 열릴 수 있고, SSH 같은 원격 서버에서는 로그인 주소와 코드가 터미널에 표시될 수 있습니다. 실행 후 사용법은 Antigravity CLI 사용 매뉴얼을 참고하면 됩니다.

5. API 키는 언제 사용할까?

일반적인 Antigravity CLI 실행은 먼저 Google 계정 로그인 방식으로 시작하면 됩니다. API 키는 Gemini API 같은 Google AI 개발 기능을 별도로 연동해야 할 때 필요할 수 있습니다.

필요한 경우 Google AI Studio API 키 발급 페이지에서 API 키를 만들 수 있습니다. API 키는 비밀번호처럼 중요한 값이므로 공개하면 안 됩니다.

6. 프로젝트 폴더에서 실행하기

고치고 싶은 코드가 있는 폴더로 이동한 뒤 Antigravity CLI를 실행합니다.

cd my-project
agy

설정 화면을 열고 싶으면 아래 명령어를 입력합니다.

/config

또는 아래 명령어를 사용할 수 있습니다.

/settings

7. 처음 써볼 프롬프트

설치가 끝났다면 아래 문장을 복사해서 입력해 볼 수 있습니다.

현재 폴더의 파일 구조를 확인하고, 이 프로젝트가 어떤 역할을 하는지 초등학생도 이해할 수 있게 설명해줘.

코드를 고치고 싶다면 이렇게 요청할 수 있습니다.

이 프로젝트에서 오류가 날 가능성이 있는 부분을 찾아주고, 수정 계획을 먼저 설명한 뒤 코드를 고쳐줘.

정리

사용 가능 조건을 먼저 확인합니다.
운영체제에 맞는 설치 명령어를 사용합니다.
agy 명령어로 실행합니다.
Google 계정으로 로그인합니다.
Google AI 개발 연동이 필요할 때만 API 키를 사용합니다.
프로젝트 폴더에서 작은 요청부터 시작합니다.