Gemini CLI 설치 & 초기 설정

1.1 Gemini CLI는 무엇인가?

Gemini CLI는 Google Gemini 2.5 Pro 모델을 터미널에서 직접 활용할 수 있는 무료, 오픈소스 AI 도구입니다. 커맨드 라인에서 코드 작성, 디버깅, 리서치, 미디어 생성까지 자연어로 할 수 있어요

1.2 설치 전 준비물

• Node.js 18 버전 이상
• Google 계정 (무료 Gemini Code Assist 라이선스 필요)
• (선택) 고급 사용을 위한 Google AI Studio API 키

1.3 설치 방법

터미널에 아래 명령어 중 하나를 실행하면 설치됩니다:

# 글로벌 설치
npm install -g @google/gemini-cli

# 또는 실행만 할 경우
npx https://github.com/google-gemini/gemini-cli

설치 후 gemini 명령어로 실행하면 테마 선택과 Google 로그인 화면이 열립니다

1.4 로그인 & 인증

1. gemini 입력 후 실행
2. 테마 선택
3. “Login with Google” 선택
4. 브라우저에서 Google 로그인 – 최대 60 req/min, 1,000 req/day 무료 제공
5. API 키 사용 시 (선택):
6. export GEMINI_API_KEY="YOUR_API_KEY"

---

💡 2. 기본 사용법 & 툴 소개

2.1 인터랙티브 모드

터미널에 gemini 입력하면 아래처럼 자연어 프롬프트로 AI와 대화 가능합니다:

> What does the file index.js do?
> Add error handling to index.js

이처럼 코드 설명, 수정, 실행(npx, !npm test 등) 명령이 모두 가능해요

2.2 주요 빌트인 툴

• ls, read-file, read-many-files, glob, grep, edit, write-file, shell (!command), web-fetch, web-search, memoryTool 등
• /tools 입력 시 사용 가능한 도구 목록 확인 가능

2.3 프로젝트 시작법

새로운 프로젝트 생성

mkdir new-project && cd new-project
gemini
> Write me a simple CLI app in Python

기존 프로젝트 분석

cd existing-repo
gemini
> Summarize all changes made yesterday

이처럼 상호작용이 깔끔하고 생산적인 워크플로우가 가능합니다