안티그래비티(Antigravity) 설치 및 셋팅 메뉴얼

안티그래비티(Antigravity)란?

안티그래비티(Antigravity) 는
개발자가 IDE(편집기) 환경에서 AI 에이전트를 활용해 코드 작성, 분석, 테스트, 검증까지 한 흐름으로 수행할 수 있도록 도와주는 개발 보조 도구이다.

단순히 “코드를 대신 짜주는 AI”가 아니라,
👉 개발·퍼블리싱·리뷰·검증 과정 전반을 가속화하는 실무형 도구라고 이해하면 된다.

---

안티그래비티를 사용하는 목적

1. 개발 생산성 향상

• 반복적인 코드 작성 감소
• 기본 구조(Boilerplate) 자동 생성
• 빠른 프로토타입 제작

➡️ 개발자는 구조와 로직 판단에 집중

---

2. 커뮤니케이션 비용 절감

• “이 코드 왜 이렇게 짰어요?”를 묻기 전에
• AI에게 의도 설명, 개선 포인트를 먼저 확인 가능

➡️ 사람 간 설명 비용 감소

---

3. 품질 표준화

• 코드 스타일
• 주석 규칙
• 네이밍 컨벤션

➡️ 팀 내 코드 품질 편차 감소

---

안티그래비티 주요 활용 사례

1️⃣ 퍼블리싱(Publishing)

활용 예

• HTML / CSS 기본 구조 생성
• 반응형 레이아웃 초안 작성
• 접근성(Accessibility) 체크

기대 효과

• 퍼블리셔가 마크업 구조에 집중 가능
• 개발자와 협업 시 구조 충돌 감소

예:

• “이 디자인을 기준으로 시맨틱 마크업으로 만들어줘”
• “모바일/태블릿/PC 기준으로 반응형 잡아줘”

---

2️⃣ 프론트엔드 개발

활용 예

• React / Vue 컴포넌트 생성
• 상태 관리 로직 초안
• 이벤트 핸들링 코드 생성

기대 효과

• 단순 CRUD 화면 개발 속도 향상
• 테스트 가능한 코드 빠른 확보

---

3️⃣ 백엔드 개발 보조

활용 예

• API 명세 기반 Controller / Service 코드 생성
• DTO / VO 구조 설계
• 간단한 쿼리 작성

기대 효과

• 반복 구조 최소화
• 로직 설계에 집중 가능

---

4️⃣ 코드 리뷰(Code Review)

활용 예

• 가독성 문제 지적
• 네이밍 개선 제안
• 중복 로직 탐지

기대 효과

• 리뷰어 부담 감소
• 리뷰 누락 방지
• 주니어 개발자 학습 가속

예:

• “이 코드에서 개선할 수 있는 부분 알려줘”
• “시니어 기준으로 리뷰해줘”

---

5️⃣ 코드 인스펙션(Code Inspection)

활용 예

• 잠재적 버그 탐지
• 성능 이슈 가능성 확인
• 보안 취약 패턴 점검

기대 효과

• 배포 전 리스크 사전 제거
• 장애 가능성 감소

예:

• “이 로직에서 NullPointerException 가능성 있어?”
• “트래픽 늘었을 때 문제될 부분 알려줘”

---

6️⃣ 테스트 & 검증

활용 예

• 테스트 코드(Jest, JUnit 등) 생성
• 브라우저 실행 후 동작 확인
• 에러 메시지 원인 분석

기대 효과

• 테스트 작성 진입장벽 감소
• QA 이전 단계에서 문제 발견

---

7️⃣ 문서화 & 지식 공유

활용 예

• 코드 설명 자동 생성
• README 초안 작성
• 신규 인원 온보딩 문서 보조

기대 효과

• 문서 작성 부담 감소
• 기술 부채 감소

---

안티그래비티를 쓰면 안 되는 경우 (중요)

❌ 무조건 정답을 기대할 때
❌ 설계 판단 없이 그대로 복붙할 때
❌ 보안·비즈니스 로직 검증 없이 신뢰할 때

➡️ 안티그래비티는 개발자를 대체하는 도구가 아니라 보조하는 도구임

 

안티그래비티(Antigravity) 설치 및 셋팅 메뉴얼

1. 확장 프로그램 설치

1-1. 마켓플레이스 진입

• 좌측 메뉴에서 [확장(Extensions) → 마켓플레이스(Marketplace)] 로 이동

1-2. 한국어 언어팩 설치

• 검색창에서 Korean 또는 한국어 검색
• 한국어(Language Pack) 설치
• 설치 후 필요 시 IDE 재시작

✅ 목적

• UI 및 메시지를 한글로 확인하여 설정/에러 파악을 쉽게 하기 위함

2. Antigravity Quota (AGQ) 설치

2-1. AGQ 설치

• 마켓플레이스에서 Antigravity Quota (AGQ) 검색 후 설치

2-2. AGQ 기능 설명

AGQ를 통해 아래 항목을 확인할 수 있음

• 실제 사용량 (Usage)
• 잔여 쿼터 (Remaining Quota)
• 쿼터 리셋 시간 (Reset Time)

✅ 목적

• 모델 사용량 초과로 인한 작업 중단 방지
• 테스트/개발 시 사용 패턴 관리

3. 룰(Rule) 설정

3-1. 설정 경로

 

Additional options → Customizations → GEMINI.md

3-2. 기본 룰 정의

아래 내용을 GEMINI.md 파일에 작성

 

1. Language: Always respond in Korean (한국어). 2. Code Comments: 주석도 반드시 한국어로 작성할 것. 3. Explanation: 기술적인 용어는 영어를 병기하되 (예: 변수(Variable), 함수(Function)), 설명은 쉽게 한국어로 풀어서 할 것.

 

✅ 목적

• 팀 내 산출물의 언어 통일
• 코드 리뷰 및 지식 공유 시 이해도 향상

4. 모델 설정

4-1. 사용 모델

• Gemini 3 Flash

✅ 선택 이유

• 응답 속도가 빠르고
• 프론트엔드/간단한 로직 테스트에 적합

⚠️ 참고

• 복잡한 아키텍처 설계나 대용량 코드 생성 시 다른 모델 검토 필요

5. 폴더 설정

5-1. 작업 폴더 열기

1. 폴더 열기(Open Folder) 선택
2. test 폴더 생성 (이름은 아무거나 가능)
3. 생성한 폴더 열기

✅ 목적

• 실제 파일 생성/수정 테스트를 위한 워크스페이스 확보

---

6. 테스트 진행

6-1. 에이전트 실행

• 우측 Agent 패널 열기
• 아래 내용 입력

 

리액트(React)로 간단한 투두 리스트 만들어줘. 추가 / 삭제 기능 넣어줘. 다 만들면 브라우저에서 테스트해줘.

6-2. 진행 중 확인 사항

• 최초 실행 시 중간중간 권한 허용(Allow) 요청이 뜰 수 있음
  • 파일 생성
  • 브라우저 실행
  • 코드 수정
• 모두 허용해야 정상 테스트 가능

⚠️ 주의

• 권한을 거부하면 브라우저 테스트나 파일 생성이 실패할 수 있음

---

7. 브라우저 확인

7-1. 기능 테스트

• 브라우저 자동 실행 여부 확인
• 아래 기능 정상 동작 확인
  • 할 일 추가
  • 할 일 삭제
  • 화면 리렌더링 정상 여부

7-2. 문제 발생 시 체크 포인트

• 포트 충돌 여부
• 브라우저 콘솔(Console) 에러 확인
• AGQ 사용량 초과 여부 확인

---

8. (추가 권장) 운영 시 팁

8-1. 초기 세팅 후 확인 체크리스트

• 한국어 UI 적용 확인
• AGQ 사용량 정상 표시 확인
• GEMINI.md 룰 반영 여부 확인
• 파일 생성/수정 권한 정상 여부

8-2. 팀 공용 사용 시 권장 사항

• GEMINI.md는 공통 템플릿으로 관리
• 모델 변경 시 사유 기록
• 쿼터 리셋 시간 기준으로 테스트 일정 조율

 

오늘도 보람찬 생존 ^.^