Windows + Gemini CLI 설정 가이드

Google Gemini의 강력한 분석 능력을 Windows 터미널에서 직접 활용하고 GIIP 플랫폼과 연동하는 방법을 안내합니다.

📋 개요

Gemini CLI는 터미널 기반의 AI 대화 도구로, GIIP 플랫폼의 데이터를 조회하거나 로컬 스크립트를 생성 및 실행할 때 유용합니다. 특히 대규모 언어 모델(LLM)을 통해 복잡한 시스템 로그를 분석하는 데 최적화되어 있습니다.

🛠️ 설치 및 설정 단계

1. 사전 요구 사항

• Node.js: 최신 LTS 버전이 설치되어 있어야 합니다.
• Google Cloud 계정: 프로젝트 ID 및 API 접근 권한이 필요합니다.

2. CLI 설치

Windows 명령 프롬프트(CMD) 또는 PowerShell에서 다음 명령을 실행합니다.

npm install -g @google/generative-ai-cli

3. 인증 및 API 키 설정

1. Google AI Studio에서 API 키를 발급받습니다.
2. 시스템 환경 변수에

   GOOGLE_API_KEY

   를 추가하거나, 실행 시 파라미터로 전달합니다.

   $env:GOOGLE_API_KEY="your-api-key"

4. GIIP 연동 설정

GIIP 에이전트 폴더 내의

cli-config.json

을 수정하여 Gemini CLI가 GIIP의 인프라 메타데이터를 참조할 수 있도록 설정합니다.

🚀 활용 예시

• 로그 분석:

  gemini-cli "error.log 파일의 치명적 오류 분석해줘"

• 스크립트 생성:

  gemini-cli "서버 상태를 점검하는 파워쉘 스크립트 작성해줘"

• 인프라 조회: GIIP API와 연동하여 특정 서버의 제원을 터미널에서 즉시 확인합니다.

💡 팁

• gemini-cli --help

  를 통해 더 많은 옵션을 확인할 수 있습니다.
• GIIP의

  Antigravity

  와 함께 사용하면 분석은 Gemini가, 실행은 Antigravity가 담당하는 협업 모델을 구축할 수 있습니다.

---

버전: 1.0 최종 업데이트: 2026-03-19 소스 파일:

giipv3/public/help/agent-setup-win-gemini.ko.md