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가 담당하는 협업 모델을 구축할 수 있습니다.

문제 해결

증상	원인	해결
npm install -g @google/generative-ai-cli 실행 시 명령을 찾을 수 없음	Node.js가 설치되지 않았거나 PATH에 등록되지 않음	최신 Node.js LTS를 설치한 뒤 터미널을 다시 실행합니다
gemini-cli 실행 시 인증(401) 오류 발생	GOOGLE_API_KEY가 설정되지 않았거나 유효하지 않음	$env:GOOGLE_API_KEY를 설정하고 Google AI Studio에서 키를 재발급합니다
재부팅 후 GOOGLE_API_KEY가 사라짐	현재 세션에만 환경 변수를 설정함	시스템 환경 변수에 GOOGLE_API_KEY를 영구적으로 등록합니다
Gemini CLI가 GIIP 인프라 메타데이터를 참조하지 못함	cli-config.json 설정이 누락되거나 잘못됨	에이전트 폴더의 cli-config.json 값을 확인하고 수정합니다

---

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