평범한 50대의 AI life insight

안티그래비티(Antigravity) 설정 메뉴 사용자 안내서

Jul 5, 2026

안티그래비티(Antigravity) 설정 메뉴 사용자 안내서

구글 안티그래비티(Antigravity)는 AI 에이전트 기반의 개발 플랫폼(Agentic Development Platform)입니다. 에이전트의 안전한 동작과 효율적인 개발 환경 구성을 위해 제공되는 설정 메뉴의 주요 기능과 세부 옵션을 안내합니다.

1. 설정 구조 및 진입 방법

안티그래비티의 설정은 보안과 유연성을 위해 전역(Global) 설정과 프로젝트(Project-level) 설정 두 가지 계층으로 관리됩니다.

  • 글로벌 설정 (Global Settings):
    • 진입 방법: 앱 메인 화면의 설정 아이콘 혹은 단축키 Ctrl + , (macOS는 Cmd + ,)
    • 설명: 애플리케이션 전반에 적용되는 기본 환경설정입니다. 기본 모델 사양, 브라우저 도구 권한, 공통 MCP(Model Context Protocol) 서버 연동을 다룹니다.
  • 프로젝트별 설정 (Project-Level Settings):
    • 진입 방법: 특정 워크스페이스 또는 프로젝트 관리 메뉴 내의 설정 탭
    • 설명: 개별 프로젝트 단위로 고유하게 적용되는 보안 정책, 허용 도구, 로컬 에이전트 스크립트 권한을 설정합니다.

2. 핵심 설정 항목 안내

① AI 모델 선택 (Model Selection)

에이전트가 질문을 이해하고 코드를 생성할 때 사용할 AI 모델을 지정합니다.

  • Gemini 3.5 Flash (High): 가벼우면서도 빠른 반응 속도와 높은 작업 효율성을 보여주는 모델로, 일반적인 코딩 업무와 에이전트 자동화 실행에 최적화되어 있습니다.
  • Gemini 1.5 Pro: 복잡하고 깊이 있는 소스코드 구조 분석, 거대한 아키텍처 설계, 혹은 복잡한 버그 디버깅에 강력한 성능을 발휘합니다.

② 개발 모드 및 명령어 실행 정책 (Development Modes)

에이전트가 로컬 시스템에서 명령어(Terminal Command)를 실행하거나 파일을 수정할 때의 자율성 수준을 설정합니다.

  • 검토 기반 개발 (Review-driven development): 에이전트가 어떠한 시스템 명령어 실행이나 파일 변경 작업을 시도하든 간에 사용자에게 미리 확인 창을 띄워 승인을 요구합니다. 안전을 최우선으로 할 때 적합합니다.
  • 에이전트 기반 개발 (Agent-driven development): 신뢰할 수 있는 디렉토리 및 일부 기본 명령어에 한하여 에이전트가 사용자의 개입 없이 자율적으로 명령을 실행하며 태스크를 이어나갈 수 있도록 허용합니다.
주의 (Caution)
데이터 삭제(rm, DROP TABLE 등)나 외부 네트워크 요청 등의 고위험 명령어는 기본적으로 '검토 기반(Review)' 동작을 권장하며, 위험도가 높은 작업은 시스템 수준에서 자동으로 승인을 재차 묻게 설계되어 있습니다.

③ 브라우저 도구 설정 (Browser Settings)

AI 에이전트가 인터넷 브라우징(/browser 기능 등)을 통해 정보 검색 및 웹사이트 조작을 대행할 때 적용되는 보안 정책입니다.

  • Browser Javascript Execution Policy (자바스크립트 실행 권한):
    • Disabled (비활성화): 웹사이트의 단순 텍스트 수집만 가능하게 차단합니다.
    • Request Review (검토 요청): 페이지 내에서 특수 스크립트나 클릭 자동화가 필요할 때 팝업으로 먼저 사용자 동의를 얻습니다. (권장)
    • Always Proceed (항상 허용): AI의 판단에 따라 웹페이지 자동화 코드를 즉시 무조건 실행합니다.
  • Browser Actuation Rules (동작 허용 규칙):
    • AI가 접근하거나 조작해도 안전한 웹 주소(URL) 목록(Allowlist) 및 접근을 금지할 사이트 목록(Denylist)을 편집합니다.

④ MCP (Model Context Protocol) 및 플러그인 설정

외부 CLI 도구, 사내 API, 로컬 개발 환경 등을 안티그래비티 에이전트와 연동합니다.

  • MCP Config: mcp_config.json 구조를 편집하거나 UI를 활용하여 에이전트가 사용할 수 있는 외부 에이전트 툴들을 매핑합니다.
  • Plugins 관리: 안드로이드 CLI, 크롬 데브툴 등 프로젝트 성격에 맞춰 필요한 플러그인을 온/오프할 수 있습니다.

⑤ 자격 증명 및 API 키 (Credentials)

  • 에이전트가 Google Cloud 등 클라우드 환경에 안전하게 접속할 수 있도록 자격 증명(Application Default Credentials)의 유효성을 검사하고 API 키 설정을 도와줍니다.
팁 (Tip)
설정 변경 후에는 현재 에이전트와의 세션을 초기화하거나 새로고침(Reload)해야 최신 정책이 즉시 반영될 수 있습니다.

추천 글