2025. 6. 26. 21:42ㆍ코딩/AI
https://github.com/google-gemini/gemini-cli
GitHub - google-gemini/gemini-cli: An open-source AI agent that brings the power of Gemini directly into your terminal.
An open-source AI agent that brings the power of Gemini directly into your terminal. - google-gemini/gemini-cli
github.com
Gemini CLI 설치 및 사용 방법, 장단 vs Claude Code와 비교
TL;DR – Gemini CLI는 무료(1 일 1 000 요청·60 RPM)로 Gemini 2.5 Pro 모델까지 터미널에서 바로 쓰게 해 주는 오픈소스 AI 에이전트다. 반면 Claude Code는 고급 IDE 통합·에이전트 자동화가 강점이지만 Pro 17 달러/월, Max 200 달러/월의 구독료가 필요하다. 개인·학습용은 Gemini CLI, 엔터프라이즈 리팩터링·대규모 협업은 Claude Code가 적합하다. 꾸리꾸리~
1. Gemini CLI 사용법 : “프롬프트 한 줄로 모든 워크플로”
Gemini CLI를 실행하면 REPL 모드가 열리고, 자연어/코드 프롬프트를 바로 입력할 수 있다. 예를 들어 새 디렉터리에서 gemini를 입력하고 “FAQ.md를 기반으로 디스코드 봇 만들어줘”라고 치면, 봇 코드·설정·README까지 완성된다. 모델 컨텍스트가 100만 토큰이어서 거대한 코드베이스도 한 번에 요약·검색·수정 가능하다.
2. 단축키 : 속도를 끌어올리는 핵심 키맵
| 메시지 전송 | Enter |
| 줄바꿈 | Shift + Enter |
| 프롬프트 히스토리 | ↑ / ↓ |
| 단어 단위 이동 | Alt + ← / → |
| 화면 정리 | Ctrl + L 또는 /clear |
이외에도 /help로 전체 키맵·명령어를 실시간으로 확인할 수 있다. 작은 습관이 토큰·시간을 동시에 절약해 준다.
3. 설치 방법 : Node 18+만 있으면 5 분 완성
# 설치 없이 즉시 실행(권장)
npx https://github.com/google-gemini/gemini-cli
# 전역 설치
npm install -g @google/gemini-cli
gemini -v # 버전 확인
Windows·macOS·리눅스 모두 동일하며, 첫 실행 때 테마(Dracula/GitHub 등)를 고르면 ~/.gemini/settings.json에 저장된다.
4. 모델 변경 : gemini-2.5-pro ↔ gemini-2.0-flash 1초 스위치
- 실행 시
gemini -m gemini-2.0-flash - 대화 중
!m → 숫자 선택 - 자동 전환 : 응답이 지연되면 Flash로 바꾸는 기능이 기본 활성화다. 비활성화하려면 settings.json에 "autoModelSwitch": false.
5. 띄워쓰기 : 긴 답변 깔끔하게 정리하는 팁
AI 응답이 불필요한 줄바꿈·공백을 넣을 때는 파이프 | sed '/^$/d' 같은 후처리 스크립트를 연결해 보자. 특히 로그·코드 블록을 복사-붙여넣기 할 때 편리하다. 또 @경로 자동 완성 뒤 Space를 한 번 눌러야 “붙어버리는 문장” 버그(#1638)도 예방할 수 있다.
6. 인증 방법 : OAuth 1-Click 또는 API Key BYOK
| 개인 Gmail 로그인 | Login with Google(OAuth) – 클릭 한 번 |
| Google Workspace | GOOGLE_CLOUD_PROJECT 환경변수 설정 + Google 로그인 |
| API Key 사용 | export GEMINI_API_KEY="…", AI Studio 또는 Vertex AI에서 발급 |
언제든 /auth로 인증 방식을 교체할 수 있으니, 무료 쿼터(60 RPM·1 000 RPD)가 모자랄 때 BYOK로 확장하자.
7. 가격 : “Gemini CLI는 0원 vs Claude Code 최소 17 달러”
| 도구 | 무료 한도 | 유료 플랜 |
| Gemini CLI | 60 요청/분, 1,000 요청/일, 1M 토큰 컨텍스트 | 없음(추가 쿼터는 API Key 종량제) |
| Claude Code | 없음 | Pro $17/월(연간), Max $200/월 – 사용량 20 배 |
Gemini CLI는 신용카드 없이도 즉시 전체 기능을 체험할 수 있다는 점이 압도적이다.
8. 꿀팁 : 생산성을 2배 올리는 현실 사용 노하우
- GEMINI.md 활용 – 디렉터리마다 규칙·컨텍스트를 적어 두면 자동 메모리에 로드돼 프롬프트 길이를 아낀다.
- YOLO Mode(-y) + Sandbox – 반복 빌드 스크립트를 자동 승인하면서도 실제 파일 시스템은 컨테이너로 보호.
- 멀티 인스턴스 – 터미널 탭별로 다른 모델·키를 지정해 병렬 작업. 예: 메인 탭은 Pro, 서브 탭은 Flash.
- MCP 서버 연결 – settings.json에 GitHub MCP를 미리 등록하면 PR 리뷰·이슈 생성 자동화 가능.
- Debug(-d) – 요청·응답 JSON을 그대로 확인하며 프롬프트 엔지니어링 연습.
9. Claude Code와 비교 : 언제 어떤 도구를 써야 할까?
| 항목 | Gemini CLI | Claude Code |
| 비용 | 완전 무료, 종량제 API 옵션 | Pro $17/월, Max $200/월 |
| 모델 컨텍스트 | 1 M 토큰(멀티모달) | 200 K ~ 300 K(텍스트 중심) |
| IDE 통합 | 터미널 중심, VS Code 플러그인은 실험 중 | VS Code·JetBrains 깊게 통합 |
| 파일 편집 도구 | 제한적(외부 MCP 필요) | 내장 edit-file, Git 워크플로 자동 |
| 기업 지원 | 오픈소스 커뮤니티 | Anthropic SLAs·엔터프라이즈 계약 |
| 확장성 | MCP 서버로 넓히는 구조 | MCP + GitHub Actions 이미 완성 (docs.anthropic.com, docs.anthropic.com) |
의사결정 가이드
- 개인·학습·해커톤 → 비용 부담 없는 Gemini CLI
- 대기업·미션 크리티컬 리팩터링 → 팀 기반 협업·자동 수정을 지원하는 Claude Code
- 스타트업·오픈소스 → 초기엔 Gemini CLI로 빠르게 프로토타입, 성장 후 Claude Code 도입 검토
마무리 : 터미널 속 AI 비서, 어떤 쪽이든 지금 써 보라!
AI 코딩 도구의 진짜 가치는 **“얼마나 자주, 부담 없이 써 보느냐”**에 달려 있다. 무료로 시작해 보고 싶다면 Gemini CLI만큼 좋은 선택이 없다. 이미 팀 차원의 코드 리팩터링·CI 자동화가 절실하다면 Claude Code가 시간을 저축해 줄 것이다. 두 도구 모두 **Model Context Protocol(MCP)**로 생태계를 확장하고 있으니, 오늘 바로 설치해 차이를 체감해 보자. 꾸리꾸리~
VIM 에서도 사용 가능하네요.
bashrc에다가 API KEY 저장해두면 매번 쉽게 로그인 가능!
검색도 해줌
'코딩 > AI' 카테고리의 다른 글
| 윈도우 claude code 클로드 코드 설치 및 사용방법, 기능 설명 (1) | 2025.06.21 |
|---|---|
| LlamaIndex 라마인덱스 설명·사용법·설치·파이썬 예제코드 완전 가이드 (3) | 2025.05.29 |
| langchain-naver-community 사용법, 네이버 기사 검색 API 블로그 자동화 파이썬 예제 코드 (3) | 2025.05.28 |
| Mircrosoft BitNet 성능, 사용법, 설치 방법, 모델 (1) | 2025.04.30 |
| 알리바바 AI LLM Qwen3 설명 사용법 설치 방법, 한국어 설정 (1) | 2025.04.30 |