BBoilerplate

실습 노트

윈도우에 Google Antigravity CLI 설치하기: 완전 초보용 순서 가이드

Windows에서 Google Antigravity CLI를 설치하고 Google 계정으로 로그인하는 과정을 완전 초보 기준으로 정리했습니다.

정인효Antigravity · Antigravity CLI · Google Antigravity · Windows

윈도우에서 Google Antigravity CLI를 설치하는 방법을 초보자 기준으로 정리합니다.

Windows에 Google Antigravity CLI 설치하기

Antigravity CLI는 터미널에서 실행하는 Google의 코딩 에이전트입니다. 프로젝트 폴더를 읽고, 코드를 설명하고, 여러 파일을 수정하고, 필요한 명령어를 실행하는 방식으로 쓸 수 있습니다. 화면이 있는 Antigravity 앱보다 가볍게, 키보드 중심으로 쓰는 도구라고 보면 됩니다.

이 글은 개발자가 아닌 분도 따라 할 수 있게 구성했습니다.

공식 설치 명령은 Google Antigravity CLI GitHub README와 Antigravity 공식 문서 기준으로 확인했습니다. Windows에서는 PowerShell 설치 스크립트 또는 CMD 설치 스크립트를 사용할 수 있습니다.
참고: Google Antigravity CLI GitHub →, Antigravity CLI Installation & Auth →, Google Codelab: Hands-on with Antigravity CLI →

ChatGPT 계정을 주로 쓰는 분은 윈도우 Codex CLI 설치 가이드를, Claude 계정을 쓰는 분은 윈도우 Claude Code CLI 설치 가이드를 함께 보면 됩니다.

설치가 끝난 뒤에는 AI 코딩 CLI 설치 후 처음 세팅할 것 7가지를 먼저 확인하는 편이 안전합니다.

바로 결과물을 만들어보고 싶다면 AI 코딩 CLI로 첫 홈페이지 만들기 실습으로 이어가면 됩니다.

준비물

먼저 아래 3가지만 확인합니다.

  1. Windows PC
  2. Google 계정
  3. 인터넷 연결

개인 계정으로 시작한다면 Google OAuth 로그인을 선택하면 됩니다. 회사나 조직에서 쓰는 경우에는 온보딩 중 Google Cloud 프로젝트를 연결하는 방식이 필요할 수 있습니다.

1단계: PowerShell 열기

Windows 검색창에 PowerShell을 입력합니다.

그다음 Windows PowerShell을 엽니다.

처음 설치할 때 권한 문제가 생기면 관리자 권한으로 실행합니다.

$PSVersionTable.PSVersion

숫자가 나오면 PowerShell이 정상으로 열린 것입니다.

2단계: Antigravity CLI 설치

PowerShell에 아래 명령어를 그대로 붙여넣고 Enter를 누릅니다.

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

설치가 진행됩니다.

중간에 확인을 묻는 문구가 나오면 화면 안내에 따라 Y 또는 Enter를 누릅니다.

3단계: 설치 확인

설치가 끝났으면 PowerShell 창을 닫았다가 다시 엽니다.

그다음 아래 명령어를 입력합니다.

agy --version

버전 숫자가 나오면 설치가 된 것입니다.

agy라는 이름이 Antigravity CLI 실행 명령어입니다.

4단계: 첫 실행 전 확인

설치는 끝났지만, 아직 아무 폴더에서나 agy를 입력하지 않습니다.

Antigravity CLI는 현재 폴더를 기준으로 파일을 읽고 수정합니다. 그래서 처음 실행은 다음 단계에서 만드는 연습용 폴더 안에서 하는 편이 안전합니다.

5단계: 바탕화면에 작업 폴더 만들기

먼저 터미널 명령어로 폴더를 만들지 말고, 눈에 보이는 곳에서 직접 만듭니다.

  1. 바탕화면으로 갑니다.
  2. 빈 곳에서 마우스 오른쪽 버튼을 누릅니다.
  3. 새로 만들기 → 폴더를 누릅니다.
  4. 폴더 이름을 agy-practice로 바꿉니다.

그다음 바탕화면 위치에서 PowerShell을 엽니다.

  1. 파일 탐색기에서 바탕화면을 엽니다.
  2. 위쪽 주소창을 클릭합니다.
  3. powershell을 입력하고 Enter를 누릅니다.

PowerShell 창이 열리면 아래처럼 입력합니다.

cd agy-practice
agy

처음 실행하면 로그인 방식 선택 화면이 나옵니다.

개인 Google 계정으로 쓰려면 Google OAuth를 선택합니다.

회사나 조직에서 Google Cloud 프로젝트 기준으로 쓰는 경우에는 Use a Google Cloud project를 선택합니다.

브라우저가 열리면 Google 계정으로 로그인합니다. 인증 코드가 표시되면 다시 PowerShell 창으로 돌아와 코드를 붙여넣습니다.

로그인이 끝나면 테마 선택, 약관 동의, 작업 폴더 신뢰 여부를 묻는 화면이 나올 수 있습니다.

처음 들어간 폴더에서는 이 폴더를 신뢰할지 묻는 화면이 나올 수 있습니다.

연습용 폴더라면 신뢰한다고 선택해도 됩니다. 중요한 업무 폴더나 개인정보가 들어 있는 폴더에서는 바로 승인하지 말고 먼저 멈추는 편이 좋습니다.

이제 Antigravity CLI에게 간단히 요청해볼 수 있습니다.

이 폴더에 hello.txt 파일을 만들고, 안에 "처음 실행한 Antigravity CLI 테스트"라고 적어줘.

Antigravity CLI가 파일을 만들겠다고 하면 내용을 확인한 뒤 진행하면 됩니다.

6단계: CMD 방식 대안

PowerShell 대신 Windows CMD를 쓰는 경우에는 아래 명령어를 사용할 수 있습니다.

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

처음 설치하는 분이라면 PowerShell 방식이 더 단순합니다.

설치 후 다시 버전만 확인합니다.

agy --version

실제 실행은 위 5단계처럼 바탕화면의 agy-practice 폴더로 들어간 뒤 agy를 입력합니다.

7단계: 기본 명령어 확인

Antigravity CLI 안에서는 /help를 입력해 사용할 수 있는 명령어와 단축키를 볼 수 있습니다.

/help

설정 화면은 /config 또는 /settings에서 확인할 수 있습니다.

/config

처음 쓰는 단계에서는 도구 실행 권한을 너무 넓게 열지 않는 것이 좋습니다.

Antigravity CLI는 파일 수정과 터미널 명령어 실행을 할 수 있으므로, 어떤 작업을 승인하는지 직접 확인하면서 진행합니다.

자주 막히는 지점

증상 해결
agy 명령어를 찾을 수 없음 PowerShell을 닫았다가 다시 열기
설치 스크립트 실행이 막힘 PowerShell을 관리자 권한으로 실행
로그인 창이 안 뜸 기본 브라우저를 열어둔 상태에서 agy 다시 실행
인증 코드 입력 위치가 헷갈림 브라우저 인증 후 PowerShell의 Antigravity CLI 화면으로 돌아가기
아무 폴더에서 실행해서 불안함 바탕화면에 만든 agy-practice 폴더 안에서 먼저 테스트
회사 계정으로 로그인해야 함 Google Cloud 프로젝트 연결 방식이 필요한지 조직 관리자에게 확인

초보자가 조심할 점

Antigravity CLI는 파일을 읽고 수정할 수 있습니다.

처음부터 중요한 업무 폴더, 계약서 폴더, 개인정보가 들어 있는 폴더에서 실행하지 않는 편이 좋습니다.

처음에는 반드시 연습용 폴더에서 테스트합니다.

그리고 Antigravity CLI가 제안하는 변경사항을 바로 승인하지 말고, 어떤 파일을 바꾸는지 먼저 확인합니다.

공식 GitHub README에도 AI 코딩 에이전트는 자동 코드 실행, 데이터 유출, 프롬프트 인젝션, 공급망 위험 같은 보안 리스크가 있을 수 있다고 안내되어 있습니다. 편하게 쓰되, 중요한 폴더에서는 승인 단계를 유지하는 편이 안전합니다.

처음 시켜볼 만한 요청

아래처럼 작게 시작하면 됩니다.

이 폴더 구조를 설명해줘.

README.md 파일을 만들고, 이 프로젝트의 목적을 초보자도 이해하게 정리해줘.

index.html 파일을 하나 만들고, 간단한 자기소개 페이지를 만들어줘.

방금 만든 파일을 더 깔끔하게 정리해줘. 단, 내 허락 없이 파일을 삭제하지 마.

처음에는 코딩보다 파일 정리, 설명, 작은 HTML 만들기부터 해보는 편이 좋습니다.

index.html로 첫 홈페이지를 만들어보는 전체 과정은 AI 코딩 CLI로 첫 홈페이지 만들기에서 이어서 볼 수 있습니다.

Codex CLI, Claude Code CLI와 헷갈리는 점

Codex CLI, Claude Code CLI, Antigravity CLI는 모두 터미널에서 쓰는 코딩 에이전트입니다.

하지만 로그인 계정과 실행 명령어가 다릅니다.

구분 설치 확인 명령어 실행 명령어 계정
Codex CLI codex --version codex ChatGPT 계정
Claude Code CLI claude --version claude Claude 계정
Antigravity CLI agy --version agy Google 계정 또는 Google Cloud 프로젝트

셋을 모두 설치할 필요는 없습니다. 이미 ChatGPT를 주로 쓴다면 Codex CLI부터, Claude 구독을 쓰고 있다면 Claude Code부터, Google 계정과 Antigravity 흐름을 써보고 싶다면 Antigravity CLI부터 시작하면 됩니다.

설치보다 중요한 것

Antigravity CLI 설치 자체는 어렵지 않습니다.

진짜 중요한 것은 어디에 적용할지 정하는 일입니다.

예를 들면 이런 식입니다.

  • 반복되는 문서 정리
  • 엑셀 데이터를 웹 화면으로 보기
  • 간단한 내부 업무 도구 만들기
  • 홈페이지 문구와 FAQ 정리
  • 기존 코드 설명 받기
  • 자동화 아이디어를 실제 파일로 만들기

도구를 먼저 설치하고 끝내기보다, 작은 업무 하나를 골라 실제로 줄여보는 것이 좋습니다.

Boilerplate AI 컨설팅

Boilerplate는 AI 도구 설치만 설명하는 곳이 아니라, 실제 업무에 맞게 AI를 적용하는 AI 업무자동화 컨설팅을 진행합니다.

Antigravity CLI, Codex CLI, Claude Code, ChatGPT, Gemini 같은 도구를 어디에 써야 하는지부터 정리하고, 필요한 경우 업무자동화 흐름이나 작은 웹앱 제작까지 연결합니다.

윈도우 PC에 Antigravity CLI를 설치하고 싶거나, 조직 안에서 AI 코딩 도구를 어떻게 써야 할지 정리하고 싶다면 아래 페이지로 연락주세요.

AI 컨설팅 문의하기