Interact with Antigravity CLI

내 진행 상황 확인하기

/ 25

Use Antigravity CLI non-interactive mode

내 진행 상황 확인하기

/ 25

Verify local repository using Git MCP tools

내 진행 상황 확인하기

/ 25

Commit project changes using Git MCP server

내 진행 상황 확인하기

/ 25

이 실습에는 학습을 지원하는 AI 도구가 통합되어 있을 수 있습니다.
이 콘텐츠는 아직 휴대기기에 최적화되지 않음
최상의 경험을 위해 데스크톱 컴퓨터에서 이메일로 전송된 링크를 사용하여 방문하세요.

GSP1348

Google Cloud 사용자 주도형 실습

개요

바이브 코딩은 인공지능(AI)을 사용하여 자연어 프롬프트에서 기능 코드를 생성하여 개발을 가속하고 앱 빌드의 접근성을 향상할 수 있도록 하는 새로운 소프트웨어 개발 방식입니다. 특히 프로그래밍 경험이 적은 개발자에게 유용합니다.

2025년 초에 AI 연구원 안드레이 카르파티가 처음 사용한 이 용어는 코드를 한 줄씩 작성하는 것에서 Antigravity CLI 같은 AI 어시스턴트가 대화식 프로세스를 통해 애플리케이션을 생성, 수정, 디버그하도록 안내하는 것으로 개발자의 기본 역할이 바뀐 워크플로를 설명합니다. 실제 코드 작성은 AI가 처리하도록 하고 개발자는 앱의 큰 그림이나 주요 목표에 대해 생각하는 데 집중할 수 있습니다.

Antigravity CLI는 터미널에서 바로 Gemini의 기능을 사용할 수 있도록 지원하는 오픈소스 AI 에이전트입니다. Antigravity CLI 프로젝트는 오픈소스이므로 개발자는 공개 로드맵에서 기능 개선사항, 예정된 기능, 버그 수정에 대해 자세히 알아볼 수 있습니다.

학습할 내용

이 실습에서는 다음 작업을 수행하는 방법을 알아봅니다.

  • Antigravity CLI를 사용할 수 있도록 구성합니다.
  • Antigravity CLI와 상호작용합니다.
  • Antigravity CLI 기본 제공 도구를 살펴봅니다.
  • 셸 모드에서 Antigravity CLI를 사용합니다.
  • Antigravity CLI에서 MCP 서버를 구성하는 방법을 알아봅니다.
  • Antigravity CLI로 바이브 코딩을 진행합니다.

필요한 사항

이 실습은 Google Cloud Shell에서 처음부터 끝까지 진행할 수 있습니다. Google Cloud Shell에는 Antigravity CLI가 사전 설치되어 있습니다.

이 실습은 초보자 포함 모든 수준의 사용자와 개발자를 대상으로 합니다.

설정 및 요건

실습 시작 버튼을 클릭하기 전에

다음 안내를 확인하세요. 실습에는 시간 제한이 있으며 일시중지할 수 없습니다. 실습 시작을 클릭하면 타이머가 시작됩니다. 이 타이머는 Google Cloud 리소스를 사용할 수 있는 시간이 얼마나 남았는지를 표시합니다.

실무형 실습을 통해 시뮬레이션이나 데모 환경이 아닌 실제 클라우드 환경에서 실습 활동을 진행할 수 있습니다. 실습 시간 동안 Google Cloud에 로그인하고 액세스하는 데 사용할 수 있는 새로운 임시 사용자 인증 정보가 제공됩니다.

이 실습을 완료하려면 다음을 준비해야 합니다.

  • 표준 인터넷 브라우저 액세스 권한(Chrome 브라우저 권장)
참고: 이 실습을 실행하려면 시크릿 모드(권장) 또는 시크릿 브라우저 창을 사용하세요. 개인 계정과 학습자 계정 간의 충돌로 개인 계정에 추가 요금이 발생하는 일을 방지해 줍니다.
  • 실습을 완료하기에 충분한 시간(실습을 시작하고 나면 일시중지할 수 없음)
참고: 이 실습에는 학습자 계정만 사용하세요. 다른 Google Cloud 계정을 사용하는 경우 해당 계정에 비용이 청구될 수 있습니다.

Cloud Shell 활성화

Cloud Shell은 다양한 개발 도구가 탑재된 가상 머신으로, 5GB의 영구 홈 디렉터리를 제공하며 Google Cloud에서 실행됩니다. Cloud Shell을 사용하면 명령줄을 통해 Google Cloud 리소스에 액세스할 수 있습니다.

  1. Google Cloud 콘솔 상단에서 Cloud Shell 활성화 Cloud Shell 활성화 아이콘를 클릭합니다.

  2. 다음 창을 클릭합니다.

    • Cloud Shell 정보 창을 통해 계속 진행합니다.
    • 사용자 인증 정보를 사용하여 Google Cloud API를 호출할 수 있도록 Cloud Shell을 승인합니다.

연결되면 사용자 인증이 이미 처리된 것이며 프로젝트가 학습자의 PROJECT_ID, (으)로 설정됩니다. 출력에 이 세션의 PROJECT_ID를 선언하는 줄이 포함됩니다.

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud는 Google Cloud의 명령줄 도구입니다. Cloud Shell에 사전 설치되어 있으며 명령줄 자동 완성을 지원합니다.

  1. (선택사항) 다음 명령어를 사용하여 활성 계정 이름 목록을 표시할 수 있습니다.
gcloud auth list
  1. 승인을 클릭합니다.

출력:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`
  1. (선택사항) 다음 명령어를 사용하여 프로젝트 ID 목록을 표시할 수 있습니다.
gcloud config list project

출력:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} 참고: gcloud 전체 문서는 Google Cloud에서 gcloud CLI 개요 가이드를 참고하세요.

작업 1. 필요에 맞게 Antigravity CLI 구성하기

Antigravity CLI에서 Cloud Logging 사용 설정하기

이 실습의 일부 작업에서 채점 기능이 작동하도록 하려면 Antigravity CLI에서 Cloud Logging을 사용 설정해야 합니다.

  • Cloud Shell에서 다음 명령어를 실행하여 Antigravity CLI에 대해 Cloud Logging을 구성합니다.
mkdir -p ~/.antigravity cat < ~/.antigravity/settings.json { "project": "{{{ project_0.project_id }}}", "telemetry": { "enabled": true, "target": "gcp", "otlpEndpoint": "http://{{{ project_0.startup_script.external_ip }}}:4318", "otlpProtocol": "http", "logPrompts": true, "useCollector": true } } EOF

샘플 AGENTS.md (or GEMINI.md) 파일에는 일반적인 지침 외에도 코딩 스타일, 종속 항목 관리 등에 관한 매우 구체적인 지침이 있는 것을 볼 수 있습니다. 사용자는 이 샘플과 비슷하게 사용 중인 프로그래밍 언어, 프레임워크, 코딩 스타일, 기타 프로젝트별 선호사항에 따라 자신만의 가이드라인을 작성할 수 있습니다.

AGENTS.md (or GEMINI.md) 파일은 Antigravity CLI가 사용자의 선호사항을 따르도록 하기 위한 핵심입니다. 자세한 내용은 프로젝트에 대해 자동으로 이러한 파일을 생성하고 시스템 프롬프트를 맞춤설정하는 방법 등을 자세히 다루는 Practical Antigravity CLI 시리즈를 참고하세요.

프로젝트별 구성 설정하기

Antigravity CLI를 시작하기 전, 추후 모든 프로젝트의 홈 폴더로 사용할 폴더를 만들어야 합니다. 홈 폴더는 Antigravity CLI가 작동할 때 가장 먼저 참고하는 곳입니다. 물론 이 외에도 필요한 경우에는 사용자의 시스템에 있는 다른 폴더도 참고합니다.

  1. Cloud Shell에서 다음 명령어를 실행하여 샘플 폴더 antigravity-projects를 만들고 이 폴더로 이동합니다.
export GOOGLE_CLOUD_PROJECT="{{{ project_0.project_id }}}" mkdir antigravity-projects cd antigravity-projects
  1. 이제 다음 명령어를 실행하여 settings.json 구성 파일을 포함하는 .gemini 하위 디렉터리를 만듭니다.
mkdir -p ~/.antigravity echo '{ "project": "{{{ project_0.project_id }}}", "telemetry": { "enabled": true, "target": "gcp", "otlpEndpoint": "http://{{{ project_0.startup_script.external_ip }}}:4318/v1/logs", "otlpProtocol": "http", "logPrompts": true, "useCollector": true } }' > ~/.antigravity/settings.json

Cloud Shell에는 Antigravity CLI가 사전 설치되어 있습니다.

  1. Antigravity CLI와 상호작용을 시작하려면 Cloud Shell 터미널에서 ✦ Antigravity CLI 탭으로 전환합니다.

Antigravity CLI를 처음 사용하는 경우 인증 방법을 선택하라는 메시지가 표시될 수 있습니다.

  1. 인증 모드를 선택하라는 메시지가 표시되면 2를 눌러 2. Use Cloud Shell user credentials를 선택합니다. 인증을 요청하는 메시지가 표시되지 않는다면 이 단계를 무시하고 실습을 진행하면 됩니다.

인증이 완료되면 Antigravity CLI가 준비되어 명령어가 입력되기를 기다립니다. 다음은 샘플 스크린샷입니다.

여기서는 일단 Antigravity CLI를 종료해도 됩니다. 다음 작업에서 모델을 사용하는 방법을 더 자세히 알아볼 것입니다.

  1. Ctrl+D 또는 Ctrl+C를 두 번 누르거나 /quit 명령어를 실행하여 Antigravity CLI를 종료합니다.

작업 2. Antigravity CLI와 상호작용하기

이 작업에서는 Antigravity CLI를 시작합니다. 이 실습에서 채점 기능이 작동하도록 하기 위해 먼저 특정 버전의 Antigravity CLI를 설치합니다. 그런 다음 앞에서 만든 프로젝트 폴더 내에서 작업하기 위해 새 Gemini 세션을 시작합니다.

  1. Cloud Shell에서 다음 명령어를 실행하여 해당 버전의 Antigravity CLI를 전역으로 설치합니다. npm install -g @google/antigravity-cli@0.6.1
참고: Antigravity CLI에서 /model 명령어를 사용하여 다른 모델을 시도해 볼 수 있습니다.

Antigravity CLI가 실행되는 중에는 다음 스크린샷처럼 Antigravity CLI 터미널의 오른쪽 하단에서 현재 실행 중인 모델을 확인할 수 있습니다.

비대화형 모드 사용하기

Antigravity CLI를 비대화형 모드로 실행하는 옵션도 있습니다. 비대화형 모드로 실행하면 Antigravity CLI 대화형 터미널을 열지 않아도 사용자가 프롬프트를 입력하면 Gemini가 프롬프트에 대답합니다. 이 옵션은 스크립트나 그 밖의 자동화 프로세스의 일환으로 Antigravity CLI를 자동화된 방식으로 사용하려는 경우에 유용합니다.

  1. Ctrl+D 또는 Ctrl+C를 두 번 누르거나 /quit 프롬프트를 실행하여 세션을 종료합니다.

  2. Cloud Shell에서 -p 파라미터 뒤에 프롬프트가 오는 다음 명령어를 실행합니다.

gemini -p "Cloud Run을 배포하는 gloud 명령어는?"

비대화형 모드에서는 후속 질문으로 대화를 이어갈 수 없다는 점에 유의하세요. 이 모드에서는 WriteFile을 비롯한 도구를 승인하거나 셸 명령어를 실행할 수도 없습니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. Gemini 비대화형 모드 사용하기

수고하셨습니다

Antigravity CLI와 그 기능을 살펴보았고, 사용 사례에 적용하는 방법을 알아보았습니다.

다음 단계/더 학습하기

설명서 최종 업데이트: 2025년 10월 16일

실습 최종 테스트: 2025년 10월 16일

Copyright 2026 Google LLC. All rights reserved. Google 및 Google 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표일 수 있습니다.

시작하기 전에

  1. 실습에서는 정해진 기간 동안 Google Cloud 프로젝트와 리소스를 만듭니다.
  2. 실습에는 시간 제한이 있으며 일시중지 기능이 없습니다. 실습을 종료하면 처음부터 다시 시작해야 합니다.
  3. 화면 왼쪽 상단에서 실습 시작을 클릭하여 시작합니다.

시크릿 브라우징 사용

  1. 실습에 입력한 사용자 이름과 비밀번호를 복사합니다.
  2. 비공개 모드에서 콘솔 열기를 클릭합니다.

콘솔에 로그인

    실습 사용자 인증 정보를 사용하여
  1. 로그인합니다. 다른 사용자 인증 정보를 사용하면 오류가 발생하거나 요금이 부과될 수 있습니다.
  2. 약관에 동의하고 리소스 복구 페이지를 건너뜁니다.
  3. 실습을 완료했거나 다시 시작하려고 하는 경우가 아니면 실습 종료를 클릭하지 마세요. 이 버튼을 클릭하면 작업 내용이 지워지고 프로젝트가 삭제됩니다.

현재 이 콘텐츠를 이용할 수 없습니다

이용할 수 있게 되면 이메일로 알려드리겠습니다.

감사합니다

이용할 수 있게 되면 이메일로 연락드리겠습니다.

한 번에 실습 1개만 가능

모든 기존 실습을 종료하고 이 실습을 시작할지 확인하세요.

시크릿 브라우징을 사용하여 실습 실행하기

이 실습을 실행하는 가장 좋은 방법은 시크릿 모드 또는 시크릿 브라우저 창을 사용하는 것입니다. 개인 계정과 학생 계정 간의 충돌로 개인 계정에 추가 요금이 발생하는 일을 방지해 줍니다.