← 소프트웨어 자료실
개발 · 개발 도구

Google Antigravity CLI

Google Antigravity CLI는 터미널에서 자연어로 코드 수정·명령 실행을 요청하고, 여러 AI 에이전트의 작업과 결과를 관리하는 개발 도구입니다.

공식 사이트로 이동 ↗

어떤 개발자에게 맞는가

Git과 빌드·테스트 명령을 터미널에서 주로 사용하는 개발자를 위한 AI 작업 인터페이스입니다. 질문에 답하는 데서 끝나지 않고 프로젝트를 읽고, 코드를 수정하고, 도구를 실행하는 흐름을 제공합니다. 여러 파일에 걸친 수정이나 반복적인 유지보수 작업에 활용할 수 있습니다.

Antigravity 2.0과 같은 에이전트 기반을 사용하며 설정을 공유하고 CLI 대화를 시각적 인터페이스로 옮길 수 있습니다. 설치·사용 경험이 아닌 공식 자료를 바탕으로 작성한 설명입니다.

지원 운영체제와 버전 검토

2026년 10월 7일 직접 연 공식 설치 문서는 macOS·Linux·Windows·Googlebook 지원을 명시합니다. Googlebook은 배포 페이지에서 Linux Terminal 설치 경로를 안내합니다. 제공된 macOS 전용 표기는 보강이 필요합니다.

공식 배포 페이지의 CLI 표시는 v1.2.14였습니다. 제공된 1.3.0,6233328509124608과 일치하지 않으므로 입력 버전을 최신 공식판으로 단정할 수 없습니다. CLI의 최소 OS 버전과 CPU별 지원 범위는 별도 확인이 필요하며, 같은 페이지의 데스크톱 제품 요구사항을 그대로 적용해서는 안 됩니다. 확인한 자료에서 CLI 지원 종료 안내는 발견하지 못했습니다.

주요 기능과 작업 관리

자연어로 수정 목적과 범위를 전달하면 에이전트가 프로젝트를 파악하고 필요한 작업을 진행합니다. 코드 편집, 명령 실행, 대화 이력과 산출물 검토가 하나의 터미널 화면에 연결됩니다.

큰 작업은 하위 에이전트에 나누고 /agents에서 상태를 확인할 수 있습니다. /permissions는 프로젝트·공유·전역 범위의 규칙을 관리합니다. 플러그인·MCP·스킬·훅은 확장 수단이지만, 실제 사용할 도구와 권한 범위는 사용자의 환경에 맞춰 검토해야 합니다.

설치와 첫 작업 순서

macOS에서는 공식 배포 페이지가 안내하는 curl -fsSL https://antigravity.google/cli/install.sh | bash 명령으로 설치하며 기본 실행 파일 위치는 ~/.local/bin/agy입니다. Windows에는 별도의 PowerShell·CMD 설치 안내가 있습니다.

설치 후 새 터미널에서 프로젝트 폴더로 이동해 agy를 실행합니다. 저장된 인증이 없으면 브라우저에서 로그인하고, 첫 설정에서 색상·렌더링 방식·작업 폴더 신뢰 여부를 선택합니다. 작은 요청부터 입력한 뒤 제안된 코드와 실행 명령을 검토하고 테스트 결과를 확인하는 순서가 적절합니다.

실무에서 요청하는 방법

예를 들어 CSV 정산 파일을 처리하는 Python 프로젝트에서 “날짜가 비어 있는 행은 오류 목록으로 분리하고, 정상 행의 월별 합계를 계산하도록 수정해 줘. 기존 출력 형식은 유지하고 테스트도 실행해 줘”처럼 요청할 수 있습니다. 이는 활용 예시이며 실제 실행 결과를 주장하는 것은 아닙니다.

입력 형식, 유지할 동작, 완료 기준을 함께 적으면 검토할 결과가 분명해집니다. 변경 파일과 오류 처리 방식을 살펴보고, 테스트가 어떤 조건을 확인했는지 확인한 뒤 작업을 마무리하는 방식이 좋습니다.

무료·유료와 사용량 제약

공식 가격 페이지는 개인 무료 플랜을 월 0달러로 안내하며, 플랜 문서는 CLI를 모든 플랜의 기본 기능에 포함합니다. 무료 이용에도 주간 사용량 제한이 있어 무제한 에이전트 실행으로 이해하면 안 됩니다.

Google AI Pro는 더 높은 주간 한도와 주간 한도 도달 전 5시간 단위 갱신을, Ultra는 가장 높은 사용량 할당과 주간 한도를 안내합니다. 복잡한 작업은 더 많은 할당량을 소비할 수 있습니다. Pro·Ultra는 기본 할당량 소진 후 AI 크레딧을 사용할 수 있으며 자동 사용 여부를 설정합니다. 한국 구독료와 고정 요청 횟수는 확인하지 못했습니다.

문제가 생겼을 때 확인 순서

agy를 찾지 못하면 실행 파일이 설치됐는지, 설치 폴더가 PATH에 포함됐는지 확인하고 터미널을 다시 엽니다. 로그인 중 멈추거나 keyring 오류가 나오면 macOS Keychain 등 운영체제 자격 증명 저장소의 잠금과 접근 권한을 확인합니다.

SSH에서는 터미널이 제공한 인증 URL을 로컬 브라우저에서 열고 발급된 코드를 돌려주는 절차를 따릅니다. 업데이트 잠금 오류는 다른 업데이트 프로세스의 실행 여부와 설치 폴더 쓰기 권한부터 확인합니다. 명령 실행이 막히면 요청 범위와 권한 규칙을 검토하는 것이 우선입니다.

다른 도구와 선택 기준

SSH·tmux와 키보드 중심 작업을 이어 가려면 CLI가 적합합니다. 여러 패널에서 프로젝트와 대화를 시각적으로 관리하려면 Antigravity 2.0을, 기존 편집기 안에서 코드 변경을 검토하려면 공식 IDE 확장을 고려할 수 있습니다.

Gemini CLI에서 이동하는 사용자를 위해 확장·스킬·설정을 한 번 가져오는 기능도 안내됩니다. 기존 설정의 이전 가능성, 명령 승인 방식, 사용량 한도를 비교해 선택해야 하며 다른 도구보다 정확하거나 빠르다고 단정할 공식 비교 근거는 확인하지 못했습니다.

공식 안내

주요 기능

  • 프로젝트 파일을 읽고 여러 파일에 걸친 코드 수정과 단계별 개발 작업 수행
  • 터미널 명령과 테스트 실행을 에이전트 작업에 연결
  • 백그라운드 하위 에이전트에 작업을 나누고 /agents에서 진행 상태 확인
  • 생성된 코드와 작업 산출물을 검토하는 Artifact Review 화면 제공
  • /permissions에서 프로젝트·공유·전역 범위의 허용·거부·확인 규칙 관리
  • /config와 /keybindings로 설정과 단축키 조정
  • 플러그인·MCP·스킬·훅을 통한 작업 환경 확장
  • SSH 환경의 인증 절차와 Antigravity 2.0으로의 대화 이동 지원
광고

관련 프로그램

Tuist

tuist.io

Tuist는 Swift로 Xcode 프로젝트 구조를 정의하고 생성하며, 빌드 캐시와 테스트 분석을 연계해 개발팀의 반복 작업을 줄이는 개발 도구다.

개발macOS

Lens

lenshq.io

Lens는 Kubernetes 클러스터의 리소스, 로그, 메트릭을 데스크톱 화면에서 확인하고 관리하는 IDE다. 여러 개발·운영 환경을 오가는 개발자와 DevOps·SRE 담당자에게 적합하며, macOS 외에 Windows와 Linux도 지원한다.

개발macOS

Git Credential Manager

aka.ms

Git Credential Manager(GCM)는 Git의 HTTPS 인증을 처리하고 자격 증명을 보관하는 무료 오픈소스 도구다. macOS에서는 기본적으로 키체인을 사용하며, GitHub·Azure Repos·Bitbucket·GitLab 등 여러 호스팅 서비스의 인증을 지원한다. Git 명령을 실행할 때 필요한 로그인과 다중 인증을 연결해 준다.

개발macOS

.NET SDK

microsoft.com

.NET SDK는 C#, F#, Visual Basic으로 앱과 라이브러리를 만들고 빌드·테스트·배포 파일을 생성하는 Microsoft의 무료 오픈소스 개발 도구입니다. macOS에서는 Apple Silicon용 Arm64와 Intel용 x64를 제공하며, 터미널과 원하는 편집기를 함께 사용해 콘솔 도구와 웹 서비스를 개발할 수 있습니다.

개발macOS

Docker Desktop

docker.com

Docker Desktop은 컨테이너 이미지 빌드와 실행, 여러 서비스의 개발 환경 관리를 GUI와 명령줄로 제공하는 개발 도구입니다.

개발macOS

GitHub Copilot CLI

docs.github.com

GitHub Copilot CLI는 터미널에서 자연어로 코드 분석·수정·디버깅과 GitHub 작업을 요청하는 AI 코딩 에이전트입니다. macOS, Linux, Windows를 지원합니다.

개발macOS