Gemini CLI 완전정복 2026: 하루 1,000회 무료, AI 에이전트 지금 시작하는 법
ChatGPT·Claude에 가려졌지만, 터미널에서 하루 1,000회 무료로 Gemini 3.1 Pro를 쓸 수 있는 도구가 있습니다.
구글이 오픈소스로 공개한 Gemini CLI는 2026년 3월 현재 v0.32.0까지 업데이트되며 에이전트·플랜 모드까지 갖췄습니다.
코딩 몰라도, 터미널이 낯설어도 괜찮습니다. 지금 바로 세팅해보세요.
무료 1,000회/일
Gemini 3.1 Pro 지원
오픈소스
Plan Mode · Agent Skills
Gemini CLI란? — 터미널에 AI 에이전트를 심다
Gemini CLI는 구글이 2025년 6월 오픈소스로 공개한 터미널 기반 AI 에이전트입니다.
ChatGPT처럼 브라우저에서 대화하는 방식이 아니라, 여러분의 터미널(명령줄) 창에서 직접 파일을 읽고, 코드를 수정하고, 인터넷을 검색하고, 시스템 명령까지 실행합니다.
쉽게 말해 “나 대신 컴퓨터를 조종하는 AI”가 여러분의 터미널 안에 들어온 것입니다.
가장 중요한 차별점은 무료 사용량이 업계 최고 수준이라는 점입니다.
구글 계정으로 로그인하면 하루 1,000회 요청, 분당 60회까지 완전 무료로 Gemini 모델 패밀리(Gemini 3 Pro 포함)를 사용할 수 있습니다.
Claude Code나 GitHub Copilot이 유료 구독 없이는 심각하게 제한되는 것과 대조적입니다.
개인적으로 Gemini CLI의 핵심 매력은 “AI가 내 로컬 코드베이스를 직접 본다”는 점이라고 생각합니다.
웹 기반 AI에게 코드를 붙여넣는 번거로움 없이, 프로젝트 폴더 안에서 바로 자연어로 명령을 내릴 수 있습니다.
2026년 3월 기준 최신 버전 v0.32.0에는 Generalist Agent, Plan Mode 강화, Gemini 3.1 Pro Preview 지원까지 추가됐습니다.
설치 5분 완성 — Windows·Mac·Linux 통합 가이드
Node.js가 없다면 nodejs.org에서 LTS 버전을 먼저 설치하세요.
그 다음 단계는 OS에 상관없이 동일한 명령어 한 줄로 끝납니다.
① 설치 명령어 (OS 공통)
npm install -g @google/gemini-cli
# 또는 npx로 설치 없이 바로 실행
npx @google/gemini-cli
② 첫 실행 & 구글 로그인
# 테마 선택 화면 → 인증 방법 선택
# “Log in with Google” 선택 → 브라우저 자동 열림 → 구글 계정 연동
로그인 후 터미널에 프롬프트 입력 창이 생기면 세팅 완료입니다.
처음 실행 시 테마(다크/라이트)를 선택하는 화면이 나오는데, 나중에 /settings 명령으로 언제든 바꿀 수 있습니다.
구글 계정으로 로그인하는 방식이 무료 1,000회 한도를 받는 유일한 방법이므로, API 키 방식(일일 250회)보다 구글 계정 방식을 강력 권장합니다.
③ 설치 확인
# 오늘 남은 요청 수 확인
무료 한도 완전 해부 — 돈 한 푼 안 써도 되는 이유
로그인 방식에 따라 한도가 다르게 적용되므로 아래 표를 주의 깊게 확인하시기 바랍니다.
| 로그인 방식 | 일일 한도 | 분당 한도 | 사용 가능 모델 | 비용 |
|---|---|---|---|---|
| 구글 계정 로그인 (권장) | 1,000회 | 60회 | Gemini 전 모델군 (3.1 Pro 포함) | 무료 |
| Gemini API 키 (무료) | 250회 | 10회 | Flash 모델만 | 무료 |
| Google AI Pro (₩29,000/월) | 상향 제공 | 120회 | 전 모델군 | 월정액 |
| Gemini Code Assist Standard | 1,500회 | 120회 | 전 모델군 | 기업 구독 |
| Gemini Code Assist Enterprise | 2,000회 | 120회 | 전 모델군 | 기업 구독 |
개인 개발자 입장에서 구글 계정 무료 로그인이 얼마나 관대한지 체감이 안 될 수 있는데,
터미널 세션 하나에서 간단한 질문은 1회, 파일 수정 작업은 3~5회 정도 소모됩니다.
하루 1,000회라면 개인 프로젝트 작업 전체를 무리 없이 커버할 수 있는 양입니다.
실시간 사용량은 /stats model 명령으로 언제든 확인 가능합니다.
한도를 초과했을 때는 Gemini API 키를 추가로 연결해 종량제로 전환하거나,
하루 리셋을 기다리는 것이 가장 현실적인 선택입니다.
필자 개인적으로는 하루 1,000회를 소진한 날이 아직 없었습니다. 웬만한 작업에선 넘치지 않습니다.
2026년 3월 핵심 신기능 — v0.32 무엇이 달라졌나
2026년 3월 3일 출시된 v0.32.0은 이전 버전과 체감이 크게 달라진 업데이트입니다.
주요 변경 사항을 아래에 정리합니다.
🆕 Generalist Agent 정식 활성화
v0.32.0부터 Generalist Agent가 기본 활성화됐습니다. 이는 복잡한 요청을 받았을 때 AI가 자동으로 작업을 하위 에이전트에 위임하고 라우팅하는 기능입니다.
예를 들어 “이 프로젝트의 버그를 찾아 고치고 테스트까지 돌려줘”라고 하면, 코드 분석·수정·테스트 실행을 각각 최적의 서브 에이전트에 나눠 처리합니다.
단순 명령 실행을 넘어 진짜 에이전트로 진화한 순간입니다.
🆕 워크스페이스 내 Model Steering
워크스페이스 안에서 특정 작업마다 다른 모델을 지정할 수 있게 됐습니다.
빠른 응답이 필요한 작업은 Flash, 복잡한 추론이 필요한 작업은 3.1 Pro로 자동 분기됩니다.
이로 인해 하루 1,000회 한도를 더 효율적으로 사용할 수 있습니다.
🆕 Plan Mode 강화 (외부 편집기 연동)
v0.29.0에서 처음 도입된 Plan Mode가 v0.32.0에서 대폭 개선됐습니다.
이제 계획(Plan)을 VS Code 같은 외부 편집기에서 직접 열어 수정할 수 있고,
복잡한 멀티스텝 작업에서 여러 옵션 중 선택하는 다중 선택 기능도 추가됐습니다.
🆕 v0.31.0 — Gemini 3.1 Pro Preview 지원 & 브라우저 에이전트
2026년 2월 27일 출시된 v0.31.0에서는 Gemini 3.1 Pro Preview 모델이 Gemini CLI에 공식 통합됐습니다.
또한 실험적 기능으로 브라우저 에이전트가 추가돼 웹 페이지와 직접 상호작용할 수 있게 됐습니다.
뉴스 검색, 페이지 내용 추출, 폼 입력 자동화 등이 가능해진 것입니다.
Plan Mode 실전 사용법 — AI가 계획을 짜고 실행한다
Plan Mode는 Gemini CLI에서 가장 강력한 신기능 중 하나입니다.
복잡한 작업을 AI가 단계별 계획으로 먼저 정리하고, 사용자가 확인한 뒤 실행하는 방식이라
엉뚱한 파일을 덮어쓰거나 예상치 못한 결과가 나오는 사고를 예방할 수 있습니다.
Plan Mode 진입 방법
/plan
# 또는 자연어 요청 앞에 플랜 요청
> 이 React 프로젝트의 성능을 최적화하는 계획을 먼저 세워줘
실전 예시 — 레거시 코드 리팩토링
터미널에서 프로젝트 폴더로 이동 후
gemini 실행
“@src/utils.js 파일의 중복 함수를 정리하는 계획을 세워줘” 입력
AI가 파일을 분석하고 “1. 중복 함수 식별 → 2. 유틸리티 모듈 분리 → 3. import 경로 수정 → 4. 테스트 실행” 형태의 계획을 출력
계획 검토 후 수정이 필요하면 외부 편집기에서 직접 편집, 동의하면 실행 승인
단계마다 승인/거부 선택 가능.
/rewind로 언제든 이전 상태로 되돌리기 가능
Plan Mode의 진정한 가치는 “AI가 내 파일을 마음대로 수정하는 것에 대한 불안감”을 해소한다는 점입니다.
투명한 단계별 계획과 매 단계 승인 프로세스 덕분에 초보자도 안심하고 AI 에이전트를 활용할 수 있습니다.
개인적으로 이 기능이 생기면서 Gemini CLI를 실무에 적극 도입하게 됐습니다.
익스텐션 생태계 — Gemini CLI를 200% 확장하는 법
MCP 서버와 연동되는 익스텐션을 설치하면 Gemini CLI가 외부 서비스까지 직접 조작할 수 있습니다.
설치 명령어는 딱 한 줄입니다.
# GitHub 이슈·PR 자동 관리
# Conductor — 계획 기반 개발 워크플로우
# 설치된 익스텐션 목록 확인
/extensions list
주목할 만한 익스텐션 3가지
Google Workspace 익스텐션은 자연어로 구글 문서·스프레드시트·슬라이드를 조작합니다. “이 데이터로 월간 보고서 슬라이드 만들어줘”라고 하면 Gemini CLI가 실제로 슬라이드를 생성합니다.
Browserbase 익스텐션은 웹 페이지 스크린샷 캡처, 정보 추출, 자동화 액션을 처리합니다. “경쟁사 가격 페이지를 스크랩해서 표로 정리해줘”가 터미널 한 줄로 가능해집니다.
Endor Labs 익스텐션은 코드 취약점 스캔과 의존성 검사를 자연어 명령으로 처리합니다. 보안이 중요한 프로젝트에서 특히 유용합니다.
실전 워크플로우 3가지 — 바이브코딩·문서 자동화·웹 스크래핑
코딩을 전혀 모르는 분도 따라 할 수 있는 수준으로 설명합니다.
워크플로우 ① 바이브코딩 — 말로 앱 만들기
mkdir my-app && cd my-app && gemini
# 자연어로 앱 설명
> 할 일 목록 웹앱을 만들어줘. React + Tailwind CSS 사용. 완료한 항목은 취소선 처리되고,
> 로컬스토리지에 저장되어야 해. 모바일 반응형으로 만들어줘.
이것이 바이브코딩의 핵심입니다. 논리나 문법이 아닌 의도(Vibe)로 개발하는 것입니다.
워크플로우 ② 문서 자동화 — PDF를 보고서로
@ 기호를 파일 앞에 붙이면 해당 파일을 AI가 직접 읽습니다. PDF, 이미지, 코드 파일 모두 지원합니다. 회의록 정리, 계약서 요약, 기술 문서 번역에도 활용할 수 있습니다.
워크플로우 ③ 웹 스크래핑 — 경쟁사 모니터링
/settings → Experimental Features → Browser Agent: true
> 네이버 쇼핑에서 “무선 청소기” 상위 10개 제품의 가격과 리뷰 수를 크롤링해서
> comparison.csv 파일로 저장해줘
브라우저 에이전트 기능을 사용하면 외부 웹 페이지 접근이 가능합니다.
단, 현재는 실험적 기능이며 사이트 이용약관을 반드시 확인해야 합니다.
Browserbase 익스텐션과 조합하면 더 안정적으로 활용할 수 있습니다.
❓ 자주 묻는 질문 (Q&A)
Gemini CLI와 일반 Gemini 웹앱의 차이는 무엇인가요?
무료로 Gemini 3.1 Pro를 정말 쓸 수 있나요? 뭔가 제한이 있지 않나요?
Claude Code, GitHub Copilot과 비교하면 어떤가요?
Gemini CLI를 쓰다가 내 파일이 잘못 수정되면 어떻게 하나요?
Node.js나 터미널을 전혀 모르는 초보자도 쓸 수 있나요?
gemini를 입력하면 자연어로 AI와 대화할 수 있습니다. 터미널 명령어를 몰라도 AI에게 원하는 것을 말하면 CLI가 대신 실행합니다. 오히려 Gemini CLI를 사용하다 보면 자연스럽게 터미널에 익숙해지는 효과도 있습니다.
마치며 — Gemini CLI, 지금 시작해야 할 이유
솔직히 말해서, 2026년 현재 AI 코딩 도구 시장은 혼잡합니다. Claude Code, GitHub Copilot, Cursor, Windsurf…
매달 새 도구가 등장하고 요금제가 바뀝니다. 그 속에서 Gemini CLI가 돋보이는 이유는 단 하나,
무료로 쓸 수 있는 AI 에이전트 중 현재 가장 강력하다는 점입니다.
v0.32.0에서 정식화된 Generalist Agent와 Plan Mode는 더 이상 “AI가 코드 조각을 제안하는” 수준을 벗어났습니다.
이제 Gemini CLI는 계획을 세우고, 파일을 읽고, 코드를 작성하고, 테스트를 돌리고, 결과를 보고하는 진짜 에이전트입니다.
여기에 하루 1,000회 무료 사용량이 보장된다는 사실은 개인 개발자에게 말 그대로 게임 체인저입니다.
물론 아직 실험적 기능이 많고, 브라우저 에이전트나 커스텀 Skills는 완성도가 더 필요합니다.
하지만 구글이 매주 업데이트를 쏟아붓는 속도를 보면, 6개월 후의 Gemini CLI는 지금과 또 완전히 다를 것입니다.
지금 세팅해두고 익숙해지는 것이 가장 현명한 선택이라고 생각합니다.
본 포스팅은 2026년 3월 11일 기준으로 작성됐으며, Gemini CLI의 요금·기능·한도는 구글 정책에 따라 사전 고지 없이 변경될 수 있습니다.
최신 정보는 geminicli.com 공식 사이트에서 반드시 확인하시기 바랍니다.
댓글 남기기