Google이 개발자들을 위한 폭탄을 투하했습니다! 🎉 Gemini CLI는 터미널에서 바로 사용할 수 있는 완전 무료 오픈소스 AI 코딩 어시스턴트예요.
Gemini 2.5 Pro 모델에 직접 접근할 수 있고, 일일 1,000회 요청까지 무료! 신용카드도 구독료도 필요 없이 Google 계정만 있으면 됩니다. Claude Code나 Cursor에 돈을 내고 있었다면 주목하세요! 💡
📋 Gemini CLI란?
Gemini CLI는 Google이 2025년 6월에 발표한 오픈소스 AI 에이전트예요. 터미널에서 직접 Gemini AI 모델을 사용할 수 있어 개발자들에게 매우 유용합니다.
핵심 특징
| 항목 | 내용 |
|---|---|
| 모델 | Gemini 2.5 Pro (Thinking Mode 탑재) |
| 컨텍스트 | 100만 토큰 (책 한 권 분량!) |
| 무료 사용량 | 일일 1,000회 / 분당 60회 요청 |
| 라이선스 | Apache 2.0 (완전 오픈소스) |
| 비용 | 무료 (Google 계정만 필요) |
🛠️ 설치 전 준비사항
필수 요구사항
- Node.js 20 이상: 필수! (LTS 버전 권장)
- Google 계정: 인증을 위해 필요
- 터미널: 명령줄 인터페이스 사용 가능 환경
Node.js 버전 확인
node -v
# v20.x.x 이상이면 OK!버전이 낮다면 nodejs.org에서 LTS 버전을 다운로드하세요.
📦 Gemini CLI 설치 방법
방법 1: NPM 글로벌 설치 (권장)
# 글로벌 설치
npm install -g @google/gemini-cli
# 설치 확인
gemini --version방법 2: NPX로 바로 실행 (설치 없이)
# 설치 없이 바로 실행
npx https://github.com/google-gemini/gemini-cli방법 3: Homebrew 설치 (macOS)
brew install gemini-cli🔐 Google 계정 연동하기
설치 후 처음 실행하면 Google 계정 로그인을 요청해요. 정말 간단합니다!
연동 순서
- 터미널에서
gemini입력 - “Login with Google” 선택
- 브라우저에서 Google 계정 로그인
- 브라우저 창 닫고 터미널로 돌아오면 완료!
# 원하는 프로젝트 폴더에서 실행
cd your-project
gemini💡 Claude Code는 유료 구독이나 API 키가 필수지만, Gemini CLI는 Google 로그인만으로 바로 사용 가능해요!
🔑 (선택) API 키 설정
더 높은 사용량이나 데이터 보호가 필요하다면 API 키를 발급받아 사용할 수 있어요.
API 키 발급 방법
- Google AI Studio 접속
- “API 키 만들기” 클릭
- 새 프로젝트 또는 기존 프로젝트 선택
- 발급된 키 안전하게 보관
환경 변수 설정
# macOS/Linux (.zshrc 또는 .bashrc에 추가)
export GEMINI_API_KEY="your-api-key"
source ~/.zshrc
# Windows (PowerShell)
$env:GEMINI_API_KEY="your-api-key"
# 또는 ~/.gemini/.env 파일 생성
GEMINI_API_KEY="your-api-key"⌨️ 주요 명령어 정리
| 명령어 | 설명 |
|---|---|
/help | 도움말 표시 |
/model | 모델 선택 (2.5 Pro, Flash 등) |
/clear | 화면 지우기 |
/stats | 토큰 사용량 확인 |
/memory add | 컨텍스트 추가 |
/tools | 사용 가능 도구 목록 |
/mcp list | MCP 서버 목록 |
/init | GEMINI.md 파일 생성 |
/quit | 종료 |
📊 무료 vs 유료 비교
| 항목 | 무료 (Google 로그인) | API 키 사용 |
|---|---|---|
| 일일 요청 | 1,000회 | 100회 (무료) / 유료 확장 |
| 분당 요청 | 60회 | API 플랜에 따라 다름 |
| 데이터 보호 | 모델 개선에 사용될 수 있음 | 데이터 보호 보장 |
| 비용 | 무료 | 입력 $0.10/1M, 출력 $0.40/1M |
🆚 Claude Code vs Gemini CLI
| 항목 | Claude Code | Gemini CLI |
|---|---|---|
| 무료 사용 | 제한적 (Pro 구독 권장) | 일일 1,000회 완전 무료 |
| 컨텍스트 | 20만 토큰 | 100만 토큰 |
| 인증 | API 키 또는 구독 필수 | Google 로그인만으로 OK |
| 오픈소스 | X | O (Apache 2.0) |
| MCP 지원 | O | O |
💡 실전 활용 팁
1. GEMINI.md 파일 활용
프로젝트 루트에 GEMINI.md 파일을 만들어 프로젝트 컨텍스트를 제공하세요. Gemini가 더 정확한 답변을 제공합니다.
gemini
> /init2. MCP 서버로 기능 확장
MCP(Model Context Protocol) 서버를 연결하면 API, 데이터베이스, 파일 시스템 등에 접근할 수 있어요.
3. VS Code 통합
VS Code의 Gemini Code Assist와 연동하면 IDE 내에서도 Gemini CLI 기능을 사용할 수 있어요.
❓ 자주 묻는 질문 (FAQ)
Q1. 정말 무료인가요?
네! Google 계정만 있으면 일일 1,000회 요청까지 완전 무료예요. 신용카드 등록 필요 없습니다.
Q2. Windows에서도 사용 가능한가요?
네! Windows, macOS, Linux 모두 지원해요. Node.js 20 이상만 설치하면 됩니다.
Q3. 내 코드가 학습에 사용되나요?
무료 계정 사용 시 데이터가 모델 개선에 사용될 수 있어요. 민감한 프로젝트는 API 키 사용을 권장합니다.
Q4. Claude Code보다 나은가요?
용도에 따라 달라요! Gemini CLI는 무료 사용량과 100만 토큰 컨텍스트가 장점이고, Claude Code는 코딩 벤치마크 성능이 우수해요.
✅ 마무리
Gemini CLI는 개발자에게 혁신적인 무료 AI 도구예요! 🎉
설치도 간단하고 (npm install 한 줄!), Google 로그인만으로 바로 사용 가능해요. 100만 토큰 컨텍스트로 대규모 코드베이스도 한 번에 이해할 수 있고, MCP 서버로 기능 확장도 가능합니다.
AI 코딩 어시스턴트를 고민 중이라면, 일단 무료인 Gemini CLI부터 시작해 보세요! 💪
📎 공식 GitHub: github.com/google-gemini/gemini-cli