Gemini CLI 완전정복: 무료 1,000회로 Claude Code 뛰어넘는 법
2026년 3월 9일 오늘, Gemini 3.0 Pro가 공식 종료됩니다. 그리고 그 자리를 Gemini 3.1 Pro가 채웠습니다.
더 놀라운 건 이 최신 모델이 Gemini CLI를 통해 하루 1,000회 무료로 쓸 수 있다는 사실입니다.
Claude Code에 월정액을 쓰기 전, 이 글을 먼저 읽어보세요.
Gemini 3.1 Pro 탑재
MCP 연동 지원
2026년 3월 최신
오픈소스 Apache 2.0
🔥 Gemini CLI가 다시 주목받는 이유: 오늘부터 달라진 것
2026년 3월 9일, 구글은 Gemini 3.0 Pro Preview의 공식 서비스를 종료했습니다. 이는 단순한 버전 업그레이드가 아닙니다. 구글이 Gemini 3.1 Pro로 전체 생태계를 이전시키면서, Gemini CLI도 자동으로 Gemini 3.1 Pro 기반으로 전환됩니다.
gemini-3.1-pro-preview로 마이그레이션해야 하며, Gemini CLI 사용자는 최신 버전으로 업데이트만 하면 자동 적용됩니다.
바이브코딩(Vibe Coding) 열풍으로 Claude Code에 관심이 쏠린 2026년이지만, 솔직히 말씀드리겠습니다. 코딩이 처음이거나 비용이 부담스럽다면 Gemini CLI가 훨씬 합리적인 선택입니다. 1M 토큰 컨텍스트 윈도우, MCP 지원, GitHub Action 연동까지—이 글에서 모두 다루겠습니다.
⚙️ Gemini CLI 설치부터 인증까지 5분 완성
① 설치 방법 (3가지 중 선택)
npm install -g @google/gemini-cli@latest
# 방법 2: 설치 없이 바로 실행 (npx)
npx @google/gemini-cli
# 방법 3: Homebrew (macOS/Linux)
brew install gemini-cli
② 인증 방법 선택 (3가지)
Gemini CLI는 세 가지 인증 방식을 지원합니다. 무료로 시작하고 싶다면 Option 1을 강력히 권장합니다.
| 인증 방식 | 무료 한도 | 모델 | 적합한 대상 |
|---|---|---|---|
| Option 1 Google 계정 로그인 |
60회/분, 1,000회/일 | Gemini 3.1 Pro (자동) | 개인 개발자 · 입문자 |
| Option 2 Gemini API 키 |
1,000회/일 (Gemini 3 혼합) | 모델 수동 선택 가능 | API 제어 필요 개발자 |
| Option 3 Vertex AI |
유료 청구 기반 | 기업 전용 확장 모델 | 엔터프라이즈 팀 |
gemini
③ Gemini 3.1 Pro 활성화 (Preview 기능 켜기)
/settings
# → Preview features: true 로 토글
설정 후 Gemini CLI는 자동으로 Gemini 3.1 Pro를 기본 모델로 사용합니다. 특정 모델을 직접 지정하고 싶다면 gemini -m gemini-3.1-pro-preview 플래그를 사용하세요.
🧠 Gemini 3.1 Pro 활성화 방법과 무료 한도 완전 이해
많은 분들이 “무료인데 진짜 Gemini 3.1 Pro를 쓸 수 있나?”라고 의심하십니다. 정답은 예, 맞습니다. 구글 공식 문서에 따르면, 개인 Google 계정으로 OAuth 로그인한 Gemini CLI 사용자는 분당 60회, 하루 1,000회의 요청 한도 내에서 Gemini 3 시리즈 모델(3.1 Pro 포함)을 무료로 사용할 수 있습니다.
하루 1,000회 요청은 일반적인 개인 개발자에게 충분합니다. 코드 리뷰 1회당 약 3~5회 요청을 소비한다고 가정하면, 하루 200~300개의 코드 블록을 처리할 수 있습니다. 단, Google AI Ultra($249.99/월) 구독자는 한도 제한 없이 사용 가능합니다.
중요한 것은 1M 토큰 컨텍스트 윈도우입니다. 대규모 코드베이스 전체를 한 번에 읽히고, 수십 개의 파일을 동시에 분석하는 것이 가능합니다. Claude Code의 200K 토큰과 비교하면 약 5배에 해당하는 규모입니다. 레거시 코드 마이그레이션이나 대형 프로젝트 리팩토링에서 이 차이가 실제로 느껴집니다.
현재 사용량 확인 방법
# 현재 세션의 토큰 사용량 및 남은 한도 확인
🔌 MCP 연동으로 터미널을 AI 에이전트로 만드는 법
MCP 설정 방법
~/.gemini/settings.json 파일에 MCP 서버 정보를 추가합니다. 아래는 GitHub MCP 서버를 연동하는 예시입니다.
{
“mcpServers”: {
“github”: {
“command”: “npx”,
“args”: [“-y”, “@modelcontextprotocol/server-github”],
“env”: { “GITHUB_TOKEN”: “YOUR_TOKEN” }
}
}
}
설정 후 Gemini CLI에서 @github 접두사로 GitHub 관련 작업을 자연어로 지시할 수 있습니다.
> @github 오늘 내 오픈 PR 목록을 정리하고 각각 리뷰 포인트를 요약해줘
> @slack #개발팀 채널에 오늘 커밋 요약을 한국어로 보내줘
> @database 지난 30일간 비활성 사용자를 쿼리해서 CSV로 내보내줘
/tools 명령어로 사용 가능한 도구 확인
# 현재 활성화된 내장 도구 및 MCP 서버 목록 확인
/mcp
# 연결된 MCP 서버 상태 확인
📄 GEMINI.md 컨텍스트 파일: 나만의 AI 페르소나 설정법
GEMINI.md 작성 예시
## 기술 스택
– Next.js 15, TypeScript, Supabase
– Tailwind CSS, shadcn/ui
## 코딩 규칙
– 모든 함수에 JSDoc 주석 필수
– 변수명은 camelCase, 컴포넌트는 PascalCase
– 에러 처리는 반드시 try-catch 사용
## 주의사항
– /api 폴더는 절대 직접 수정 금지
– .env 파일 내용은 절대 출력 금지
이렇게 설정해두면 매번 컨텍스트를 다시 설명할 필요가 없습니다. 특히 여러 프로젝트를 오가며 작업할 때 체크포인팅(Checkpointing) 기능과 함께 사용하면 대화 세션을 저장하고 이어서 작업하는 것도 가능합니다.
/chat save my-feature-work
# 나중에 이어서 작업
/chat resume my-feature-work
⚖️ Claude Code vs Gemini CLI: 솔직한 비교 분석
요즘 개발자 커뮤니티에서 Claude Code와 Gemini CLI를 비교하는 논의가 뜨겁습니다. 직접 두 도구를 써본 관점에서 솔직하게 정리합니다.
| 항목 | Gemini CLI | Claude Code |
|---|---|---|
| 무료 한도 | 1,000회/일 (Google 계정) | 제한적 (API 토큰 소비) |
| 컨텍스트 윈도우 | 1M 토큰 | 200K 토큰 |
| 멀티모달 | 텍스트+이미지+영상+오디오 | 텍스트+이미지 |
| MCP 지원 | ✅ 지원 | ✅ 지원 |
| Google 서비스 연동 | ✅ 네이티브 지원 | MCP로 간접 연동 |
| 코딩 추론 능력 | Gemini 3.1 Pro (77.1% ARC-AGI-2) | Claude Sonnet 4.6 (업계 최상위) |
| 라이선스 | 오픈소스 (Apache 2.0) | 독점 (Anthropic) |
| 월 비용 | $0 (기본) | API 토큰 기반 |
Reddit에서는 “Claude CLI를 통해 Gemini CLI를 호출해서 토큰을 절약하는” 하이브리드 방식을 쓰는 개발자도 있습니다. 두 도구를 상호보완적으로 활용하는 것이 2026년 현재 가장 현실적인 접근법입니다.
🛠️ 실전 활용 5가지: 바이브코딩부터 자동화 스크립트까지
UI 스케치 이미지를 터미널에 드래그&드롭하면, Gemini 3.1 Pro가 이미지를 분석해 HTML/CSS/JS 코드를 즉시 생성합니다. 코딩 지식 없이도 아이디어를 실제 앱으로 만드는 가장 빠른 방법입니다.
버그가 언제 유입됐는지 추적하는
git bisect 명령어는 복잡하지만, Gemini CLI에 자연어로 요청하면 전 과정을 자동으로 처리해줍니다.
문서가 없는 레거시 코드베이스를 통째로 분석해서 사용자 문서를 자동 생성합니다. 1M 토큰 컨텍스트 덕분에 대규모 프로젝트도 한 번에 처리됩니다.
MCP 확장을 통해 Cloud Run + Snyk + GitHub을 연결하여, 성능 이슈의 근본 원인을 찾고 자동으로 수정·배포하는 워크플로우를 구성할 수 있습니다.
@gemini-cli를 PR에 멘션하면 Gemini CLI가 코드를 리뷰하고 개선 제안을 자동으로 달아줍니다. 소규모 팀에서 코드 리뷰 병목을 해소하는 데 효과적입니다.
❓ 자주 묻는 질문 (Q&A)
Gemini CLI는 Windows에서도 쓸 수 있나요?
npm install -g @google/gemini-cli를 실행하면 됩니다. WSL2(Windows Subsystem for Linux)를 사용하면 더욱 안정적인 환경에서 사용할 수 있습니다. 공식적으로 Windows, macOS, Linux 모두 지원합니다.
무료 1,000회 한도가 초과되면 어떻게 되나요?
Claude Code와 Gemini CLI를 동시에 써도 되나요?
GEMINI.md 파일은 어디에 만들어야 하나요?
Gemini 3.0 Pro가 종료됐는데, 기존 API 코드는 어떻게 수정하나요?
✍️ 마치며: 무료가 이 정도면 유료가 필요한가요?
솔직한 총평을 드리겠습니다. Gemini CLI는 2026년 현재 가장 과소평가된 AI 코딩 도구입니다. 무료 1,000회/일, Gemini 3.1 Pro의 추론 능력, 1M 토큰 컨텍스트, MCP 연동, 오픈소스—어느 하나 흠잡을 곳이 없습니다.
물론 Claude Code가 여전히 세밀한 코드 이해와 자연스러운 한국어 처리에서 앞선다는 평가는 유효합니다. 하지만 비용이 0원인 도구가 유료 서비스와 경쟁하는 수준에 이르렀다는 사실 자체가 놀랍습니다. 특히 오늘 Gemini 3.0 Pro가 종료되면서 3.1 Pro로 자동 전환된 지금, Gemini CLI의 성능은 불과 2주 전보다 눈에 띄게 향상됐습니다.
아직 Gemini CLI를 한 번도 써보지 않으셨다면, 지금 바로 설치해서 5분만 사용해보세요. 처음에는 낯설 수 있지만, GEMINI.md 하나 설정하고 MCP 연동을 시작하는 순간 “이걸 왜 이제 알았지?”라는 생각이 드실 겁니다.
※ 본 포스팅은 2026년 3월 9일 기준 공식 문서와 실제 사용 경험을 바탕으로 작성되었습니다. 구글의 정책 변경에 따라 무료 한도, 모델 가용성, 기능 등이 예고 없이 변경될 수 있습니다. 최신 정보는 Gemini CLI 공식 사이트 및 Gemini API 출시 노트를 참고하시기 바랍니다.
댓글 남기기