Gemini CLI 완전정복:
무료로 3.1 Pro 쓰는 진짜 방법
월정액 결제 없이 하루 1,000건, 구글 최강 AI를 터미널에서 바로 호출하는 법
🤖 Gemini 3.1 Pro 지원
🔗 MCP 서버 연결 가능
📁 파일·DB·웹 자동화
🗓️ 2026년 3월 최신 기준
Gemini CLI란? 왜 지금 써야 하나
Gemini CLI는 구글이 2025년 6월에 오픈소스로 공개한 터미널 기반 AI 에이전트입니다. 웹 브라우저나 별도 앱 없이 컴퓨터의 명령창(터미널) 하나로 구글 최신 AI 모델과 대화하고, 파일을 읽고 쓰고, 코드를 직접 생성하며, 웹 검색까지 수행할 수 있는 강력한 도구입니다. GitHub에서 소스 코드가 공개되어 있어 누구나 무료로 설치해 사용할 수 있다는 점이 가장 큰 장점입니다.
개인적으로 이 도구가 특별하다고 생각하는 이유는 단순히 ‘무료라서’가 아닙니다. Cursor 에디터나 Claude Desktop처럼 별도 IDE 환경 없이, 개발자가 이미 매일 사용하는 터미널에서 AI를 호출할 수 있다는 워크플로우의 자연스러운 통합이 핵심입니다. 코드를 작성하다 막히면 그 자리에서 바로 물어보고, 파일을 생성하고, 심지어 DB에 데이터를 넣을 때까지 창을 전환할 필요가 없습니다.
오픈소스 AI
터미널 에이전트
무료 AI 도구
설치 3분 완성: Node.js부터 첫 실행까지
① 터미널 열기
Windows라면 검색창에 PowerShell 또는 Windows Terminal을 입력해 실행하고, macOS라면 Spotlight(⌘+Space)에서 터미널을 검색해 여세요. Linux는 Ctrl+Alt+T로 바로 열 수 있습니다.
② Gemini CLI 설치 명령어
npm install -g @google/gemini-cli
# 설치 없이 바로 실행하려면 (npx 방식)
npx https://github.com/google-gemini/gemini-cli
③ 첫 실행 및 구글 계정 로그인
gemini
처음 실행하면 테마 선택 등 초기 설정 화면이 나타납니다. 이후 인증 방식을 선택해야 하는데, Login with Google을 선택하면 브라우저가 열리면서 구글 계정으로 로그인할 수 있습니다. 개인 구글 계정으로 로그인하면 즉시 Gemini 2.5 Pro를 하루 최대 1,000건, 무료로 이용할 수 있습니다. 별도의 신용카드 등록이나 API 키 발급 없이도 됩니다.
Set-ExecutionPolicy RemoteSigned를 입력하고 Y를 선택한 후 다시 시도하세요. macOS/Linux에서 권한 오류가 나면 명령어 앞에 sudo를 붙여 실행하세요.
-
1
Login with Google — 개인 계정으로 하루 1,000건 무료 (가장 추천) -
2
Use Gemini API Key — AI Studio에서 키 발급, CI/CD 파이프라인·자동화 스크립트 용도에 적합 -
3
Vertex AI — Google Cloud 프로젝트 연동, 기업용 대용량 처리에 최적
2026년 3월 핵심 업데이트: Gemini 3.1 Pro 무료 연동
2026년 2월 하순, 구글은 Gemini 모델의 증분 업데이트 버전인 Gemini 3.1 Pro를 출시했습니다. 구글 역사상 처음으로 정수 버전이 아닌 ‘.1’ 단위의 업데이트가 적용된 모델로, 기존 Gemini 3 Pro 대비 추론 정확도·코드 생성 품질이 눈에 띄게 향상되었다는 평가를 받고 있습니다. 특히 100만 토큰의 컨텍스트 윈도우와 64K 출력 한도는 대형 코드베이스 분석이나 장문 문서 처리에서 큰 위력을 발휘합니다.
이 모델을 Gemini CLI에서 사용하는 방법은 매우 간단합니다. 아래 명령어 하나로 즉시 전환할 수 있으며, 세션 중에 /model 명령으로도 실시간 전환이 가능합니다.
Gemini 3.1 Pro로 모델 고정하기
gemini –model gemini-3.1-pro-preview
# 또는 Flash 계열 (더 빠른 응답이 필요할 때)
gemini -m “gemini-3.1-flash”
# 세션 중 모델 전환 슬래시 명령
/model → Manual → gemini-3.1-pro-preview
~/.gemini/settings.json 파일에 모델명을 기본값으로 저장해 두면, 매번 옵션을 입력하지 않아도 Gemini 3.1 Pro가 자동으로 적용됩니다. 한 번 설정해 두면 영구적으로 유지됩니다.
모델별 특성 비교 (2026년 3월 기준)
| 모델 | 특성 | 추천 용도 | 무료 여부 |
|---|---|---|---|
| Gemini 3.1 Pro | 최고 정확도, 100만 토큰 컨텍스트 | 복잡한 코딩, 대형 파일 분석 | 무료 (한도 내) |
| Gemini 3.1 Flash | 빠른 응답, 경량 | 빠른 질답, 간단한 자동화 | 무료 (한도 내) |
| Gemini 2.5 Pro | 안정적 (구버전) | 범용 작업 | 무료 (한도 내) |
실전 활용 4가지: 코딩·파일·웹·DB 자동화
① AI 코딩 에이전트로 바이브코딩
원하는 기능을 자연어로 설명하면 Gemini CLI가 코드를 작성하고 파일까지 직접 생성합니다. 예를 들어 “Node.js로 기술 강연 일정 웹사이트를 만들어줘. 카테고리별 검색 기능 포함”이라고 입력하면, 계획을 세우고 → 추가 질문을 하고 → 코드를 작성하고 → 로컬 실행 방법까지 안내해 줍니다. Cursor 에디터와 동일한 방식으로 동작하되, 설치 없이 터미널 하나로 완결됩니다.
② 파일·이미지 일괄 자동화
폴더 안의 파일을 종류별로 자동 분류하거나, webp 이미지를 png로 일괄 변환하거나, CSV 데이터를 분석해 통계를 내는 작업을 자연어 명령 한 줄로 처리할 수 있습니다. 복잡한 스크립트를 미리 만들어 둘 필요 없이, AI가 상황에 맞는 쉘 스크립트를 즉석에서 작성하고 실행합니다.
이 폴더의 파일을 .jpg/.png는 Images 폴더로, .txt는 Documents로, .mp4는 Videos로 분류해줘
③ 웹 검색·URL 스크래핑 자동화
특정 URL의 내용을 분석하거나, 구글에서 최신 뉴스를 검색해 파일로 저장하는 작업도 가능합니다. @파일명 문법으로 로컬 파일을 대화 컨텍스트에 직접 참조할 수 있어, 긴 문서를 요약하거나 비교 분석하는 RAG 형태의 활용도 손쉽게 구현됩니다.
오늘 금융 최신 헤드라인을 검색해서 finance-news.txt에 저장해줘
# @파일 참조 예시
@회의록.txt를 읽고 액션 아이템만 추출해줘
④ 데이터베이스 자연어 조회
SQLite3, Supabase 등 로컬 DB와 연결하면 SQL을 몰라도 자연어로 데이터를 조회하고 분석할 수 있습니다. “이 DB에서 가장 많이 구매한 상위 3명은 누구야?”라고 물으면 AI가 sqlite3 명령어를 직접 실행해 결과를 표 형태로 보여줍니다. 인보이스 이미지 파일을 폴더에 넣고 “전부 읽어서 청구번호·날짜·금액을 표로 정리해줘”라고 하면 OCR+데이터 추출까지 한 번에 해결됩니다.
MCP 서버 연결로 능력치 무한 확장하기
MCP 서버 추가 방법 (settings.json 방식)
{
“theme”: “Default”,
“selectedAuthType”: “oauth-personal”,
“mcpServers”: {
“supabase”: {
“command”: “npx”,
“args”: [“@supabase/mcp-server-supabase@latest”,
“–access-token”, “$SUPABASE_ACCESS_TOKEN”]
}
}
}
Extension 명령으로 GitHub MCP 설치하기
gemini extensions install https://github.com/github/github-mcp-server
# 설치된 확장 목록 확인
gemini extensions list
# MCP 서버 상태 확인
/mcp list
예를 들어 GitHub MCP를 연결하면 “내 GitHub 계정에 새 리포지토리 만들고, 방금 작성한 코드를 커밋해줘”라는 한 줄 명령으로 전체 과정이 자동화됩니다. 코드 작성에서 버전 관리까지, Gemini CLI가 AI 코딩 에이전트와 개발 도구의 경계를 지워가고 있는 것입니다.
필수 명령어 10선 & settings.json 최적화 설정
| 명령어 | 기능 | 활용 팁 |
|---|---|---|
/help |
전체 명령어 도움말 | 처음 실행 시 반드시 확인 |
/init |
GEMINI.md 프로젝트 지침 생성 | 프로젝트 루트에서 1회 실행 |
/memory show |
현재 메모리(GEMINI.md) 확인 | AI가 알고 있는 맥락 점검용 |
/model |
사용 모델 실시간 전환 | 3.1 Pro ↔ Flash 빠른 전환 |
/tools |
사용 가능한 내장 도구 목록 | MCP 연결 후 확인 필수 |
@파일명 |
파일을 대화 컨텍스트에 참조 | 문서 분석, 코드 리뷰에 활용 |
! |
쉘 명령어 직접 실행 모드 | ESC로 빠져나옴 |
/compress |
대화 컨텍스트 압축 | 긴 세션에서 토큰 절약 |
/stats |
현재 세션 사용량 통계 | 무료 한도 관리에 유용 |
/quit |
CLI 종료 | Ctrl+C도 동일 동작 |
settings.json 최적화 예시
{
“theme”: “Default”,
“selectedAuthType”: “oauth-personal”,
// 불필요한 도구 비활성화 (선택사항)
“excludeTools”: [“google_web_search”],
// 기본 모델 고정 (3.1 Pro 권장)
“model”: “gemini-3.1-pro-preview”
}
무료 한도·개인정보·보안: 알아야 할 현실 주의사항
-
1
무료 한도: 개인 구글 계정(Login with Google)으로 로그인하면 하루 최대 1,000건의 요청이 무료입니다. 일반적인 개발·자동화 작업에서는 이 한도에 도달하기 어렵습니다. -
2
데이터 수집 정책: 무료 사용자의 대화 데이터는 구글 AI 모델 개선에 활용될 수 있습니다. 민감한 회사 코드·개인정보는 CLI에 입력하지 않는 것을 강력히 권장합니다. -
3
유료 API Key 사용 시: Google AI Studio에서 API 키를 발급받아 사용하면 ‘제품 개선에 데이터를 사용하지 않는다’는 정책이 적용됩니다. 회사 프로젝트나 민감한 코드베이스는 이 방식을 사용하세요. -
4
파일 조작 권한: Gemini CLI는 실제 파일을 읽고 쓸 수 있으므로, 중요한 데이터가 있는 폴더에서--yolo모드(자동 승인) 없이 사용하는 것이 안전합니다. 모든 파일 변경 전 AI가 확인을 요청합니다. -
5
모델 지원 중단 공지: Gemini 2.0 Flash 및 Flash-Lite는 2026년 6월 1일 지원 종료 예정입니다. 현재 Gemini CLI에서는 3.x 계열 모델을 기본값으로 사용하는 것을 권장합니다.
❓ Q&A — 자주 묻는 질문 5가지
Gemini CLI와 Cursor 에디터의 가장 큰 차이는 무엇인가요?
코딩을 전혀 모르는 사람도 Gemini CLI를 사용할 수 있나요?
하루 1,000건 한도를 초과하면 어떻게 되나요?
VS Code 에디터와 Gemini CLI를 동시에 사용할 수 있나요?
Gemini 3.1 Pro는 유료인데 CLI에서 무료로 쓸 수 있는 이유가 있나요?
✍️ 마치며 — 총평
이 도구의 진짜 가치는 단순한 ‘무료 AI 챗봇’이 아니라, 터미널·파일시스템·외부 서비스를 자율적으로 조작하는 에이전트라는 점에 있습니다. MCP 프로토콜을 통해 GitHub, Supabase, Cloud Run 등 어떤 서비스와도 연결할 수 있기 때문에, 앞으로 더 많은 자동화 시나리오가 가능해질 것입니다. 2026년 현재 시점에서 Gemini CLI를 모른다면, AI 자동화 흐름에서 한 발 늦어질 가능성이 있습니다. 지금 바로 터미널을 열고 시작해 보세요.
본 콘텐츠는 2026년 3월 7일 기준으로 작성된 정보입니다. 구글의 정책 및 모델 지원 일정은 사전 공지 없이 변경될 수 있으므로, 최신 정보는 공식 문서(Google AI Developers)에서 반드시 확인하시기 바랍니다. 본 포스팅은 특정 제품의 광고나 제휴 마케팅 목적으로 작성된 것이 아닙니다.
댓글 남기기