AntiGravity란 무엇인가
바이브 코딩 도구 중에서 최근 가장 빠르게 주목받고 있는 것이 바로 AntiGravity입니다. 이름에서 알 수 있듯 “중력을 거스른다”는 컨셉, 즉 코딩의 장벽을 없앤다는 철학을 담고 있습니다. 비전공자가 자연어로 원하는 기능을 설명하면 AI가 실제로 작동하는 코드를 만들어주는 방식입니다.
AntiGravity가 기존 코딩 보조 도구와 다른 점은 프로젝트 전체 맥락을 이해한다는 것입니다. 단순히 코드 한 줄을 완성해주는 것이 아니라, 파일 구조, 의존성, 배포 환경까지 파악하고 그에 맞는 코드를 제안합니다. 2025년 이후 비전공자 개발 생태계에서 Claude Code와 함께 양대 축을 이루는 도구로 자리잡았습니다.
특히 다음과 같은 상황에서 AntiGravity가 빛을 발합니다.
- 처음 코딩을 배우는 사람이 “어디서부터 시작해야 할지 모를 때”
- 이미 존재하는 프로젝트를 수정하거나 기능을 추가할 때
- 에러 메시지를 보고 무슨 뜻인지 해석이 안 될 때
- 특정 기능 구현 방법이 여러 가지일 때 최적을 선택해야 할 때
설치 및 환경 설정
Node.js 설치 확인
AntiGravity를 사용하려면 먼저 Node.js가 설치되어 있어야 합니다. 터미널을 열고 아래 명령어를 입력하세요.
node --version
npm --version버전 번호가 출력되면 이미 설치된 것입니다. command not found가 뜬다면 nodejs.org에서 LTS 버전을 받아 설치하세요. 설치 후 터미널을 완전히 닫고 다시 열어야 명령어가 인식됩니다.
AntiGravity CLI 설치
npm install -g @antigravity/cli설치가 완료되면 아래 명령어로 확인합니다.
ag --versionAntiGravity CLI v2.x.x 형태의 출력이 나오면 정상입니다. Mac에서 permission denied 오류가 나온다면 앞에 sudo를 붙여보세요.
API 키 연결
AntiGravity는 내부적으로 대형 언어 모델(LLM)을 사용합니다. 사용하려면 API 키가 필요합니다.
ag auth login위 명령어를 실행하면 브라우저가 열리며 로그인 화면이 나타납니다. GitHub 계정으로 간편하게 연동할 수 있으며, 무료 플랜에서도 하루 일정 요청량은 무료로 제공됩니다.
첫 번째 프로젝트 만들기
프로젝트 폴더 생성
바탕화면이나 원하는 위치에 폴더를 만들고 터미널로 해당 폴더로 이동합니다.
mkdir my-first-vibe-project
cd my-first-vibe-project
ag initag init을 실행하면 AntiGravity가 현재 폴더를 프로젝트로 인식하고 .ag 설정 폴더를 생성합니다. 이 폴더 안에는 AI가 프로젝트 맥락을 기억하기 위한 파일들이 저장됩니다.
자연어로 기능 요청하기
이제 진짜 바이브 코딩을 시작합니다. 아래처럼 원하는 것을 한국어로 그냥 말하면 됩니다.
ag "사용자가 이름을 입력하면 인사말을 보여주는 HTML 페이지 만들어줘"AntiGravity가 분석을 마치면 index.html 파일을 자동으로 생성합니다. 내용은 대략 다음과 같습니다.
<!DOCTYPE html>
<html lang="ko">
<head>
<meta charset="UTF-8">
<title>인사말 생성기</title>
</head>
<body>
<input type="text" id="nameInput" placeholder="이름을 입력하세요">
<button onclick="greet()">인사하기</button>
<p id="result"></p>
<script>
function greet() {
const name = document.getElementById('nameInput').value;
document.getElementById('result').textContent = '안녕하세요, ' + name + '님!';
}
</script>
</body>
</html>코드를 전혀 몰라도 됩니다. 원하는 것을 설명하면 AI가 작동하는 코드를 만들어 줍니다.
수정 요청하기
결과가 마음에 들지 않거나 수정이 필요하면 그냥 또 말하면 됩니다.
ag "버튼 색깔을 보라색으로 바꾸고, 입력창이 비어있으면 경고 메시지 보여줘"AntiGravity는 방금 만든 index.html을 기억하고 있으므로, 이전 맥락을 유지한 채로 수정해줍니다. 처음부터 다시 만드는 것이 아니라 기존 파일을 영리하게 편집합니다.
실전 활용 패턴
기존 코드 디버깅
에러가 났을 때 AntiGravity가 특히 강력합니다. 에러 메시지를 복사해서 그대로 붙여넣으면 됩니다.
ag "TypeError: Cannot read properties of undefined (reading 'map') 이게 무슨 에러야? 어떻게 고쳐?"AntiGravity는 에러 메시지를 분석하고, 현재 프로젝트 파일을 확인한 뒤, 문제가 되는 코드 위치와 수정 방법을 함께 알려줍니다.
Claude Code와 함께 사용하기
AntiGravity와 Claude Code를 함께 사용하면 시너지가 극대화됩니다. 일반적인 워크플로우는 다음과 같습니다.
- AntiGravity로 초기 프로젝트 구조 생성 및 빠른 프로토타이핑
- Claude Code로 복잡한 로직 구현 및 코드 리뷰
- AntiGravity로 UI/스타일 수정 및 간단한 기능 추가
두 도구의 성격이 다릅니다. AntiGravity는 빠른 실행에 특화, Claude Code는 깊은 이해와 정교한 구현에 강점이 있습니다. 상황에 따라 번갈아 쓰는 것이 가장 효율적입니다.
버전 관리와 연동
AntiGravity는 Git과 자연스럽게 연동됩니다. 프로젝트 폴더에서 Git을 초기화하면 AI가 변경 이력을 파악하고 더 정확한 수정을 제안합니다.
git init
git add .
git commit -m "초기 프로젝트 생성"
ag "로그인 기능 추가해줘"이렇게 하면 AntiGravity가 “로그인 기능이 없던 상태”에서 “로그인 기능이 추가된 상태”로의 변경 사항만 깔끔하게 처리합니다.
자주 묻는 질문 Q&A
Q. 코딩을 전혀 모르는 사람도 쓸 수 있나요?
A. 네, 가능합니다. 바이브 코딩의 핵심이 바로 그것입니다. 다만 완전히 코드를 무시할 수는 없습니다. AI가 만들어준 코드가 원하는 대로 작동하는지 확인하려면, 최소한 파일을 열어보고 브라우저에서 결과를 확인할 줄 알아야 합니다. “절대 코드 안 봐도 됨”이 아니라 “코드를 쓸 줄 몰라도 됨”이 정확한 표현입니다.
Q. 만들어진 코드가 보안상 안전한가요?
A. AI가 생성한 코드는 기본적인 보안 패턴을 따르지만, 실제 서비스에 배포할 때는 반드시 보안 전문가의 검토가 필요합니다. 특히 사용자 데이터를 다루는 서비스, 결제가 포함된 서비스, 개인정보를 처리하는 경우에는 AI 코드를 그대로 배포하면 안 됩니다. 바이브 코딩은 프로토타이핑과 학습 목적으로는 완벽하지만, 프로덕션 배포 전 반드시 검증 단계를 거쳐야 합니다.
Q. Claude Code와 AntiGravity 중 하나만 써야 한다면?
A. 처음 배우는 단계라면 AntiGravity를 추천합니다. 빠른 피드백과 직관적인 인터페이스가 학습 초기에 동기부여를 유지하는 데 효과적입니다. 어느 정도 개념이 잡히고 좀 더 복잡한 프로젝트를 다루게 되면 Claude Code로 넘어가는 것이 자연스러운 흐름입니다. 두 도구를 모두 배우는 것이 이상적이지만, 순서가 있다면 AntiGravity 먼저입니다.
Q. 유료인가요?
A. AntiGravity는 무료 플랜과 유료 플랜이 있습니다. 무료 플랜은 하루 일정 요청 수 제한이 있어 학습 목적으로는 충분합니다. 실무에서 매일 대량으로 사용한다면 유료 플랜이 필요합니다. Claude Code(Anthropic) 역시 API 사용 요금이 발생하지만, 개인 학습 수준에서는 월 몇 달러 수준입니다.
Q. 특정 프레임워크(React, Vue 등)도 지원하나요?
A. 지원합니다. 프로젝트 폴더에 해당 프레임워크가 이미 설치되어 있으면 AntiGravity가 자동으로 인식합니다. 예를 들어 package.json에 React가 명시되어 있으면 JSX 문법으로 코드를 생성해줍니다. 별도 설정 없이 프로젝트 환경을 파악하고 거기에 맞게 작동하는 것이 AntiGravity의 강점 중 하나입니다.
오늘 5분 실습
아래 단계를 따라 직접 해보세요. 5분이면 충분합니다.
- 터미널을 열고 바탕화면으로 이동합니다.
cd ~/Desktop - 새 폴더를 만들고 진입합니다.
mkdir vibe-test && cd vibe-test - AntiGravity를 초기화합니다.
ag init - 아래 명령어를 실행해보세요.
ag "할 일 목록을 관리하는 간단한 웹 페이지 만들어줘. 추가, 삭제 기능 포함" - 생성된
index.html을 브라우저로 열어 실제로 작동하는지 확인하세요.
잘 됐다면 이제 추가 요청을 해보세요. “완료한 항목은 취소선으로 표시해줘”, “항목 개수를 상단에 보여줘” 같은 식으로 계속 발전시켜 나갈 수 있습니다.
미래이음연구소 바이브 코딩 교육
이신우 소장이 이끄는 미래이음연구소에서 Claude Code, AntiGravity 등 최신 바이브 코딩 도구 실전 강의를 진행합니다.
강의 문의: 010-3343-4000 | lab.duonedu.net
마무리
AntiGravity는 코딩의 진입 장벽을 낮추는 강력한 도구입니다. 하지만 도구는 어디까지나 도구입니다. 바이브 코딩이 편리하다고 해서 기본 개념을 완전히 무시하면 나중에 복잡한 문제를 만났을 때 막히게 됩니다. AI가 만들어준 코드를 읽어보고, 이게 왜 이렇게 작동하는지 조금씩 이해해나가는 습관이 결국 실력으로 이어집니다.
AntiGravity와 Claude Code로 바이브 코딩을 배우고 싶다면, 미래이음연구소(lab.duonedu.net)의 실전 강의를 통해 체계적으로 시작하세요. 두온교육(main.duonedu.net)에서도 AI 시대 교육 관련 다양한 자료를 확인할 수 있습니다.
