Gemini CLI 설치 및 설정 - 바이브코딩

📚 개발 환경 세팅 완벽 가이드 시리즈

1편부터 순서대로 따라하세요!

🚀 Gemini CLI란?

Google의 공식 오픈소스 AI 에이전트로, 터미널에서 직접 Gemini AI를 사용할 수 있게 해주는 도구입니다.

주요 특징

🎯 무료 사용: 개인 Google 계정으로 60 요청/분, 1,000 요청/일 무료
🧠 강력한 AI: Gemini 2.5 Pro 모델 (1M 토큰 컨텍스트)
🔧 내장 도구: Google 검색, 파일 작업, 셸 명령어, 웹 크롤링
🔌 확장 가능: MCP(Model Context Protocol) 지원
💻 개발자 친화적: 터미널 기반 인터페이스

📋 설치 전 준비사항

항목	요구사항
Node.js	18.0 이상
npm	최신 버전
운영체제	Windows, Mac, Linux

Gemini CLI 설치 방법

1단계: 터미널 열기

Windows: Windows키 + R → 터미널 또는 cmd 입력
Mac: Command + Space → "터미널" 검색

2단계: Gemini CLI 설치

터미널에서 다음 명령어 입력:

npm install -g @google/gemini-cli

💡 참고:

-g 옵션은 전역(global) 설치를 의미합니다

전역 설치하면 어디서든 gemini 명령어 사용 가능

3단계: 설치 확인

gemini --version

성공적으로 설치되면 버전 정보가 표시됩니다.

로그인 설정

1단계: Gemini CLI 실행

터미널에서 gemini 입력

2단계: 인증 방법 선택

처음 실행 시 인증 방법을 선택해야 합니다:

인증 방법	장점	제한
Google 로그인 (추천)	• 설정 간편 • 무료 사용	• 60 요청/분 • 1,000 요청/일
API Key	• 더 많은 요청 가능	• Google AI Studio에서 발급 필요

3단계: Google 로그인 (권장)

Gemini CLI에서 /auth 입력
"● 1. Login with Google" 선택
브라우저가 열리면 Google 계정으로 로그인
권한 승인

4단계: 로그인 완료

Google 계정으로 로그인 완료하면 사용 가능!

🎯 기본 사용법

대화 시작

gemini

주요 명령어

명령어	설명
`/help`	도움말 표시
`/auth`	인증 설정
`/clear`	대화 내용 초기화
`/exit` 또는 `Ctrl+C`	종료

사용 예시

# 코드 작성 요청
gemini "Python으로 피보나치 수열 함수 작성해줘"

# 파일 분석
gemini "package.json 파일 분석해줘"

# 버그 수정
gemini "이 에러 메시지 해결 방법 알려줘: [에러 내용]"

❗ 문제 해결

문제 1: "command not found: gemini"

해결방법:

# npm 전역 경로 확인
npm config get prefix

# PATH에 추가 (Windows PowerShell)
$env:PATH += ";$(npm config get prefix)"

# PATH에 추가 (Mac/Linux)
export PATH=$PATH:$(npm config get prefix)/bin

문제 2: 권한 오류 (Mac/Linux)