[Antigravity #2] 세상에서 제일 쉬운 설치 & Hello World
Editor’s Note
“코딩 툴 설치하다가 포기했어요…” 라는 말이 나오지 않도록!
초보자도 5분 만에 따라 할 수 있는 가장 친절한 설치 가이드를 준비했습니다.
복잡한 설정은 다 빼고, 딱 필요한 것만 떠먹여 드립니다.
1. 준비물 챙기기
시작하기 전에 딱 2가지만 확인해주세요.
- Google 계정: 프리뷰 제공 조건은 계정 유형과 지역에 따라 달라질 수 있으니 공식 안내를 먼저 확인하세요.
- 컴퓨터: 공식 안내 기준으로 macOS, Windows, Linux를 지원합니다.
여기에 하나를 더 추가하면 훨씬 덜 막힙니다.
- 기본 개발 런타임: Python, Node.js, Git 중 자주 쓰는 도구가 이미 설치되어 있는지 확인하세요.
Antigravity는 에이전트가 파일을 만들고 터미널 명령을 실행하도록 돕는 도구입니다. 하지만 여러분 컴퓨터에 없는 런타임을 마법처럼 대신 갖고 있는 것은 아닙니다. 첫 실습 전에 아래 명령으로 현재 상태를 확인해두면 좋습니다.
1
2
3
git --version
node --version
python --version
셋 중 하나가 없어도 시작은 할 수 있습니다. 다만 에이전트에게 “설치 방법을 안내하고, 실행 전 확인 명령까지 알려줘”라고 요청하는 편이 안전합니다.
2. 3분 컷! 설치하기
터미널이나 까만 화면(CLI) 무서워하시는 분들을 위해, 가장 쉬운 방법으로 알려드립니다.
Step 1: 다운로드
antigravity.google 공식 사이트에 접속해 운영체제에 맞는 설치 파일을 받으세요.
Step 2: 로그인 & 인증
앱을 켜면 구글 로그인 창이 뜹니다. 로그인 후 화면에 표시되는 약관, 모델 사용 조건, 프리뷰 안내를 확인합니다.
확인 포인트: Google Developers Blog 기준 Antigravity는 개인 사용자에게 public preview로 제공되며, Gemini 3 Pro는 generous rate limits가 언급되어 있습니다. 다만 무료 범위와 제한은 바뀔 수 있으므로 설치 시점의 공식 안내를 다시 확인하세요.
설치 직후에는 권한 설정도 함께 확인하세요. 에이전트가 어느 범위까지 파일을 수정할 수 있는지, 터미널 명령을 자동 실행할 수 있는지, 브라우저 조작에 승인이 필요한지에 따라 안전성이 크게 달라집니다.
처음 추천 설정:
- 낯선 저장소에서는 자동 실행 범위를 낮게 시작
- 파일 삭제, 패키지 설치, 배포 명령은 승인 후 실행
- 작업 전
git status로 변경 상태 확인 - 에이전트가 만든 계획과 아티팩트 먼저 검토
3. 대망의 첫 코딩: “안녕, 에이전트!”
이제 Antigravity를 켜볼까요? 화면이 낯설어 보여도 겁먹지 마세요. 우리에겐 든든한 AI 비서가 있으니까요.
미션: “화면에 Hello World 띄우기”
우리는 키보드로 print("Hello World")를 치지 않을 겁니다. 그건 ‘옛날 방식’이니까요. 매니저 뷰(Manager View)라고 적힌 채팅창에 이렇게 말해보세요.
1
"파이썬으로 Hello World를 출력하는 프로그램을 만들고 실행해줘."
그러면 보통 이런 흐름으로 진행됩니다:
- 에이전트가 작업 계획을 세웁니다.
hello.py파일을 만들고 코드를 작성합니다. (print("Hello World"))- 터미널에서
python hello.py를 실행합니다. - 실행 결과와 변경 사항을 Artifact 또는 작업 로그로 확인합니다.
여러분은 단 한 글자의 코드도 타이핑하지 않았습니다. 이것이 바로 Agent-First 코딩입니다.
첫 실습에서 꼭 봐야 할 것은 “파일이 생겼다”가 아니라 “실행 결과가 남았다”입니다.
체크 포인트:
| 항목 | 확인 방법 |
|---|---|
| 파일 생성 | hello.py가 예상 위치에 있는지 |
| 실행 명령 | python hello.py를 실제로 실행했는지 |
| 출력 결과 | 터미널에 Hello World가 찍혔는지 |
| 변경 범위 | 불필요한 파일이 같이 생기지 않았는지 |
이 네 가지를 보는 습관이 앞으로 더 큰 작업에서도 그대로 이어집니다.
4. 문제 해결: 혹시 이런 에러가 뜨나요?
Q. “Python을 찾을 수 없대요!” Antigravity는 여러분 컴퓨터에 설치된 프로그램을 씁니다. 파이썬이 없다면 에이전트가 “파이썬 설치해줘”라고 할 거예요. 그럴 땐 에이전트에게 이렇게 말하세요.
“네가 설치 방법 알려줘.”
Q. “영어만 알아듣나요?” 한국어로 요청해도 사용할 수 있습니다. 다만 파일명, 명령어, 오류 메시지처럼 원문이 중요한 부분은 영어 표현을 함께 남기면 에이전트가 더 정확히 맥락을 잡는 데 도움이 됩니다.
Q. “에이전트가 바로 명령어를 실행해도 괜찮나요?” 처음에는 자동 실행 범위를 낮게 두고, 터미널 명령이나 파일 삭제처럼 위험한 작업은 직접 승인하는 편이 안전합니다. 공식 소개에서도 Antigravity의 핵심은 자율성뿐 아니라 Artifacts를 통한 검증과 피드백입니다.
Q. “첫 작업이 실패하면 어떻게 하나요?” 실패 자체는 문제 아닙니다. 중요한 것은 에이전트가 실패 원인을 설명하고 다시 시도할 수 있게 정보를 주는 것입니다.
1
2
방금 실패한 명령, 에러 메시지, 필요한 설치 항목을 정리해줘.
바로 수정하지 말고 다음 단계 제안부터 해줘.
처음에는 이렇게 “분석 먼저, 수정은 승인 후” 흐름으로 가면 도구를 더 차분하게 익힐 수 있습니다.
5. 오늘의 성공 확인 ✔️
- Antigravity 설치 완료
- 구글 로그인 성공
- 말 한마디로 “Hello World” 출력 성공
- 실행 로그와 변경 파일 확인
축하합니다! 여러분은 이제 AI 매니저로서의 첫발을 뗐습니다. 다음 편 [Antigravity #3] 에서는, 이 도구를 내 손발처럼 쓰기 위한 화면 조작법(인터페이스 가이드)을 아주 쉽게 알려드릴게요.