Google Gemini CLI 설치 및 사용 가이드

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

개발 툴

대상자

• *개발자, DevOps 엔지니어, 데이터 분석가**
• 난이도: 초보자 ~ 중급자 (Node.js 설치 및 CLI 사용 기초 지식 필요)

핵심 요약

• Gemini CLI는 100만 토큰 이상의 대규모 코드베이스 분석 및 다중 모달(이미지/텍스트) 기능을 지원하는 AI 기반 CLI 도구
• 설치 필수 조건: Node.js 18 이상
• 주요 명령어: sudo npm install -g @google/gemini-cli, gemini, @ (로컬 파일 업로드)

섹션별 세부 요약

1. 소개 및 기능

• Gemini CLI는 Google Gemini 팀에서 개발한 오픈소스 CLI 도구
• 주요 기능:
• 대규모 코드베이스 분석 (100만 토큰 이상 지원)
• PDF/스케치 기반 앱 프로토타입 생성
• Git 연동, PR 추출, 마이그레이션 계획 생성 등의 DevOps 자동화 기능
• Imagen, Veo, Lyria 등 미디어 생성 모델과의 MCP 서버 통합
• Google 검색 내장 (최신, 신뢰성 있는 답변 제공)

2. 설치 및 초기 설정

• 설치 조건:
• Node.js 18 이상 설치 (node -v로 확인)
• macOS/Windows 지원 (터미널 기반 설치)
• 설치 명령어:

```bash

sudo npm install -g @google/gemini-cli

```

• 인증 방법 선택:
• Google 로그인 (60/min, 1,000/day 무료 요청)
• API 키 사용 (Google AI Studio에서 발급 후 export GEMINI_API_KEY="YOUR_API_KEY" 설정)

3. 사용 예제 및 기능

• CLI 실행: gemini 명령어로 실행 후 테마 선택, 로그인 진행
• 파일 업로드: @ 명령어로 로컬 파일 선택 후 대화 진행
• 예시:
• Help me write a simple calculator 입력 시 계산기 코드 생성
• 연결 불안정 시 자동 모델 전환: gemini-2.5-pro → gemini-2.5-flash

4. 추가 도구 및 추천

• Apidog 소개:
• API 문서화, 디버깅, 테스트, 자동화 통합 플랫폼
• 개발 효율성 향상을 위한 최적의 도구
• 등록 링크: https://apidog.com

결론

• Gemini CLI는 자연어 기반의 코드 분석 및 자동화에 유리하며, VSCode 터미널과 연동하여 사용하는 것이 효과적
• API 키 사용 시는 Gemini API 가이드를 별도로 참조
• Apidog과 같은 API 관리 도구와의 병행 사용을 추천