Windows + Antigravity 설정 가이드

Windows 환경에서 Antigravity 에이전트를 설치하고, GIIP 플랫폼을 통해 원격으로 AI 운영을 수행하는 방법을 안내합니다.

📋 개요

Antigravity는 GIIP 플랫폼과 연동되어 Windows 서버 내에서 직접 코드를 수정하거나 시스템 설정을 변경할 수 있는 자율형 에이전트입니다. 이 가이드를 통해 에이전트를 활성화하고 보안 연결을 구성할 수 있습니다.

🛠️ 설치 및 설정 단계

1. 에이전트 다운로드

GIIP 플랫폼의 [에이전트 관리] 페이지 또는 공식 저장소에서 giipAgentWin.zip 파일을 다운로드합니다.

2. API 키 발급 및 설정

1. [계정 설정] > [API Keys] 메뉴에서 새로운 에이전트용 키를 발급받습니다.
2. 다운로드한 폴더 내의 config.json 파일을 열어 발급받은 키와 서버 주소를 입력합니다.

   {
     "apiKey": "your-api-key-here",
     "serverUrl": "https://api.giip.io"
   }

3. 에이전트 실행 및 서비스 등록

PowerShell(관리자 권한)을 열고 에이전트 폴더로 이동하여 다음 명령을 실행합니다.

• 가동: .\giipAgentWin.exe start
• 서비스 등록 (백그라운드 실행): .\install_service.ps1

4. 플랫폼 연동 확인

GIIP [서버 상세 정보] 페이지에서 해당 서버의 Agent Status 아이콘이 초록색으로 변경되었는지 확인합니다.

🚀 활용 시나리오

• 이슈 자동 해결: 등록된 이슈에 대해 Antigravity를 호출하여 소스 코드의 버그를 분석하고 즉시 패치를 적용합니다.
• 모니터링 강화: 에이전트가 로컬 시스템 메트릭을 수집하여 플랫폼에 실시간으로 전송합니다.

🚨 보안 주의사항

• 키 관리: API 키는 외부에 노출되지 않도록 주의하십시오.
• 권한 제한: 에이전트가 실행되는 윈도우 계정의 권한을 필요한 최소 수준으로 유지하는 것을 권장합니다.

문제 해결

증상	원인	해결
[서버 상세 정보] 페이지의 Agent Status 아이콘이 초록색으로 바뀌지 않음	config.json의 apiKey 또는 serverUrl 값이 잘못 입력됨	config.json을 다시 열어 값을 확인하고, 필요 시 [API Keys]에서 키를 재발급합니다
.\install_service.ps1 실행 시 "스크립트를 로드할 수 없음" 오류 발생	PowerShell 실행 정책(ExecutionPolicy)이 제한되어 있음	관리자 권한 PowerShell에서 Set-ExecutionPolicy -Scope Process Bypass 실행 후 다시 시도합니다
.\giipAgentWin.exe start 실행 시 인증 실패	API 키가 만료되었거나 유효하지 않음	[계정 설정] > [API Keys]에서 키를 재발급하고 config.json을 갱신합니다
에이전트 기동 시 설정 파일 파싱 오류 발생	config.json의 JSON 형식이 깨짐(따옴표·쉼표 누락 등)	config.json의 JSON 문법을 검증하여 올바르게 수정합니다

---

버전: 1.0 최종 업데이트: 2026-03-19 소스 파일: giipv3/public/help/agent-setup-win-antigravity.ko.md