Gemini CLI 설치 방법 완벽 가이드: 무료 AI 코딩 도구 시작하기

작성일자 글쓴이

🚀 Gemini CLI란? 구글의 무료 AI 코딩 도구

Gemini CLI는 Google이 2025년 6월에 공개한 오픈소스 CLI 기반 AI 에이전트예요. 터미널에서 바로 실행할 수 있는 AI 코딩 어시스턴트로, 가장 강력한 Gemini 2.5 Pro 모델을 무료로 사용할 수 있답니다!

개발자라면 꼭 알아야 할 이 도구, 오늘은 설치부터 기본 사용법까지 완벽하게 정리해 드릴게요.

✨ Gemini CLI의 주요 특징

Gemini CLI가 왜 이렇게 인기일까요? 핵심 특징을 살펴볼게요.

  • 완전 무료: 개인 Google 계정으로 하루 1,000회 요청 가능
  • 분당 60회 요청: 넉넉한 Rate Limit 제공
  • Gemini 2.5 Pro: 업계 최고 수준의 AI 모델 사용
  • 오픈소스: GitHub에서 소스 코드 확인 가능
  • 터미널 기반: IDE를 벗어나지 않고 AI 활용

Gemini CLI로 할 수 있는 것들

  • 코드 작성 및 리팩토링
  • 버그 디버깅 및 해결
  • 문서 생성 및 정리
  • 자연어 명령으로 파일 조작
  • 프로젝트 구조 분석
  • 코드 리뷰 및 최적화 제안

📋 설치 전 필수 준비사항

Gemini CLI를 설치하기 전에 몇 가지 준비가 필요해요.

1. Node.js 설치 (필수)

Gemini CLI는 npm으로 설치하기 때문에 Node.js 20 버전 이상이 필요해요.

Node.js 설치 확인

node --version
npm --version

버전이 표시되지 않거나 20 미만이라면 Node.js를 설치해야 해요.

Node.js 설치 방법

Windows/macOS: nodejs.org에서 LTS 버전 다운로드 후 설치

macOS (Homebrew):

brew install node

Ubuntu/Debian:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

2. Google 계정 준비

Gemini CLI 인증을 위해 Google 계정이 필요해요. 기존에 사용하던 Gmail 계정이면 충분합니다.

🔧 Gemini CLI 설치하기

이제 본격적으로 Gemini CLI를 설치해 볼게요. 아주 간단해요!

방법 1: npm으로 전역 설치 (추천)

터미널을 열고 다음 명령어를 입력하세요.

npm install -g @google/gemini-cli

macOS/Linux에서 권한 에러가 발생하면:

sudo npm install -g @google/gemini-cli

방법 2: npx로 바로 실행 (설치 없이)

설치 없이 바로 실행해보고 싶다면 npx를 사용할 수 있어요.

npx @google/gemini-cli

이 방법은 매번 다운로드하기 때문에 자주 사용한다면 전역 설치를 추천해요.

설치 확인

설치가 완료되면 버전을 확인해 보세요.

gemini --version

버전 번호가 표시되면 설치 성공이에요! 🎉

🔐 Gemini CLI 인증하기

처음 실행할 때 Google 계정 인증이 필요해요.

인증 과정

  1. 터미널에서 gemini 명령어 실행
  2. 브라우저가 자동으로 열리며 Google 로그인 화면 표시
  3. 사용할 Google 계정으로 로그인
  4. 권한 요청에 “허용” 클릭
  5. 인증 완료! 터미널로 돌아가면 사용 준비 완료

인증 정보 저장 위치

인증 정보와 설정은 다음 경로에 저장돼요.

~/.gemini/settings.json

이 파일을 삭제하면 다시 인증해야 해요.

💻 Gemini CLI 기본 사용법

설치와 인증이 끝났다면 이제 사용해 볼 차례예요!

Gemini CLI 실행

gemini

명령어를 입력하면 대화형 모드로 진입해요. 자연어로 질문하거나 명령을 내릴 수 있어요.

기본 명령어

  • /help – 도움말 보기
  • /quit – Gemini CLI 종료
  • /clear – 대화 내역 지우기
  • /model – 사용 중인 모델 확인
  • Ctrl + C 두 번 – 강제 종료

사용 예시

$ gemini

> Python으로 피보나치 수열 함수 만들어줘

> 이 코드의 시간 복잡도를 분석해줘

> package.json 파일 분석해줘

> 현재 디렉토리의 README.md 작성해줘

⚙️ 고급 설정

Gemini CLI를 더 효율적으로 사용하기 위한 설정들을 알아볼게요.

설정 파일 편집

설정 파일 위치: ~/.gemini/settings.json

{
  "theme": "dark",
  "model": "gemini-2.5-pro",
  "maxTokens": 8192
}

프로젝트별 설정

프로젝트 루트에 .gemini 폴더를 만들고 설정 파일을 넣으면 프로젝트별로 다른 설정을 사용할 수 있어요.

API 키 사용 (선택)

Google AI Studio에서 API 키를 발급받아 사용할 수도 있어요. 더 많은 요청이 필요할 때 유용해요.

export GEMINI_API_KEY=your_api_key_here
gemini

🖥️ 운영체제별 설치 가이드

Windows 설치

  1. Node.js 공식 사이트에서 Windows Installer 다운로드
  2. 설치 마법사 실행 (기본 옵션 유지)
  3. PowerShell 또는 명령 프롬프트 열기
  4. npm install -g @google/gemini-cli 실행
  5. gemini로 실행 및 인증

macOS 설치

  1. Homebrew로 Node.js 설치: brew install node
  2. 터미널에서 npm install -g @google/gemini-cli 실행
  3. 권한 에러 시 sudo 추가
  4. gemini로 실행

Linux 설치

  1. Node.js 설치 (패키지 매니저 또는 nvm 사용)
  2. sudo npm install -g @google/gemini-cli 실행
  3. gemini로 실행 및 인증

❓ 자주 발생하는 문제 해결

“command not found: gemini” 에러

npm 글로벌 경로가 PATH에 등록되지 않은 경우예요.

# npm 글로벌 경로 확인
npm config get prefix

# 해당 경로를 PATH에 추가 (~/.bashrc 또는 ~/.zshrc)
export PATH="$PATH:$(npm config get prefix)/bin"

권한 에러 (EACCES)

macOS/Linux에서 자주 발생해요.

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

# 또는 npm 권한 수정
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

Node.js 버전 문제

Node.js 20 이상이 필요해요. nvm으로 버전을 관리하면 편리해요.

# nvm 설치 후
nvm install 20
nvm use 20

인증 실패

브라우저 팝업이 차단되거나 인증이 실패하면:

  1. ~/.gemini 폴더 삭제
  2. 다시 gemini 실행
  3. 브라우저에서 수동으로 인증

📊 사용량 제한 안내

Gemini CLI는 무료지만 사용량 제한이 있어요.

항목 무료 제한
일일 요청 수 1,000회
분당 요청 수 60회
사용 모델 Gemini 2.5 Pro

더 많은 요청이 필요하면 Google AI Studio에서 유료 API 키를 발급받아 사용할 수 있어요.

🎯 실전 활용 팁

코드 리뷰 요청

gemini
> 현재 디렉토리의 main.py 파일을 리뷰해줘. 개선점을 알려줘.

프로젝트 문서화

> 이 프로젝트의 README.md를 작성해줘. 설치 방법과 사용법을 포함해줘.

버그 수정

> 에러 메시지: "TypeError: Cannot read property of undefined"
이 에러를 해결하는 방법을 알려줘.

코드 변환

> 이 JavaScript 코드를 TypeScript로 변환해줘.

🔗 유용한 리소스

  • GitHub 저장소: github.com/google-gemini/gemini-cli
  • Google Codelabs: Gemini CLI 실습 튜토리얼
  • Google AI Studio: API 키 발급 및 관리
  • 공식 문서: cloud.google.com/gemini/docs

🎉 마무리

Gemini CLI는 개발자에게 정말 유용한 무료 AI 도구예요. 터미널을 벗어나지 않고도 강력한 AI 모델을 활용할 수 있다니, 생산성이 확 올라가겠죠?

설치는 npm install -g @google/gemini-cli 한 줄이면 끝! 오늘 바로 설치해서 사용해 보세요. 코딩이 훨씬 재미있어질 거예요! 💪

궁금한 점이 있으시다면 댓글로 남겨주세요. 즐거운 코딩 되세요! 🚀