Gemini CLI 최신 버전 기준
Gemini CLI Plan 모드, 무료 계정엔 절반만 됩니다
2026년 3월 11일, 구글이 Gemini CLI에 Plan 모드를 공식 추가했습니다. “AI가 먼저 계획 세우고 움직인다”는 게 핵심 메시지인데, 실제로 써보기 전에 반드시 알아야 할 게 하나 있습니다. 무료 계정에서는 Plan 모드의 핵심인 Pro 모델 자동 전환이 작동하지 않습니다.
Plan 모드가 뭔지 30초 안에 이해하기
구글 공식 발표(2026.03.11)에 따르면, Plan 모드에서 허용되는 도구는 read_file, grep_search, glob, ask_user 같은 읽기 계열로만 제한됩니다. 파일을 쓸 수 있는 건 오직 ~/.gemini/tmp/ 아래의 계획서 마크다운 파일뿐입니다. (출처: Gemini CLI 공식 문서)
진입 방법은 세 가지입니다. /plan 명령어 입력, Shift+Tab으로 모드 순환, 또는 그냥 “이 기능 계획 세워줘”처럼 자연어로 요청하면 AI가 알아서 Plan 모드로 진입합니다.
💡 공식 발표문과 실제 사용 흐름을 같이 놓고 보니, Plan 모드는 기능 추가가 아니라 “실행 전 검토” 문화를 CLI에 강제하는 설계 철학에 가깝습니다. 명령 하나로 AI가 바로 파일을 건드리던 기존 방식과 정반대입니다.
핵심 기능인 모델 자동 라우팅의 실체
Plan 모드에서 가장 눈에 띄는 기능이 자동 모델 라우팅(Automatic Model Routing)입니다. 공식 문서에 정확히 이렇게 적혀 있습니다.
“Planning Phase: While in Plan Mode, the CLI routes requests to a high-reasoning Pro model to ensure robust architectural decisions and high-quality plans. Implementation Phase: Once a plan is approved and you exit Plan Mode, the CLI automatically switches to a high-speed Flash model.”
계획할 땐 Gemini 3.1 Pro(고추론 모델), 구현할 땐 Flash(고속 모델)로 자동 전환됩니다. 전략엔 머리 좋은 모델, 실행엔 빠른 모델을 쓰는 구조입니다.
| 단계 | 사용 모델 | 무료 계정 여부 |
|---|---|---|
| 계획 단계 (Plan 모드) | Gemini 3.1 Pro | ❌ 2026.03.25부터 차단 |
| 구현 단계 (일반 모드) | Gemini Flash | ✅ 사용 가능 |
| API 키 미설정 무료 계정 | Flash 전용 (250회/일) | ⚠️ Pro 라우팅 무효 |
Plan 모드를 켜도 무료 계정은 결국 Flash 모델로만 돌아갑니다. 모드는 켜지지만, 그 모드가 가진 핵심 이점은 유료 계정에서만 온전히 발휘됩니다.
무료 계정에서 실제로 되는 것과 안 되는 것
2026년 3월 25일, 구글은 GitHub 공식 논의(github.com/google-gemini/gemini-cli/discussions/22970)를 통해 정책 변경을 공지했습니다. 핵심 문장은 다음과 같습니다.
“Model restrictions for free tier users: Starting March 25, 2026, Gemini Pro models will only be accessible via paid subscriptions. Free tier users will be limited to Flash models.”
무료 계정 기준으로 정리하면 이렇습니다.
/plan명령어 진입 자체- 읽기 전용 코드베이스 탐색
- 마크다운 계획서 생성
- ask_user 도구로 질문 받기
- read-only MCP 도구 연동
- Shift+Tab 모드 전환
- 계획 단계 Pro 모델 자동 라우팅
- Gemini 3.1 Pro 추론 품질
- 트래픽 과부하 시 우선 처리
- API 키 미설정 시 1일 250회 초과
솔직히 말하면, Plan 모드는 “복잡한 아키텍처 결정을 Pro 모델로 신중하게”가 설계 의도인데, 무료 계정에서는 Flash 모델이 그 자리를 채웁니다. Flash가 나쁜 모델은 아니지만, 라우팅 설계의 전제가 Pro의 높은 추론 능력이라는 점에서 처음부터 다른 조건에서 쓰고 있는 셈입니다.
ask_user 도구가 중요한 진짜 이유
Plan 모드와 함께 추가된 ask_user 도구는 처음엔 그냥 “AI가 질문을 한다”처럼 보입니다. 그런데 DevOps.com의 분석(2026.03.16)이 이 도구의 의미를 정확히 짚었습니다.
“It’s a direct response to one of the most common failure modes in AI-assisted development: an agent confidently implementing the wrong thing because it was never asked.”
(출처: DevOps.com, 2026.03.16)
AI 코딩 에이전트가 망하는 가장 흔한 이유가 “한 번도 확인 안 하고 자신감 있게 엉뚱한 걸 구현하는 것”이라는 뜻입니다. ask_user는 이 실패 패턴을 설계 단계에서 차단합니다.
💡 기존 블로그들이 주목하지 않은 부분인데, Plan 모드 설계의 출발점이 “AI가 계획을 세운다”가 아니라 “AI가 틀린 가정으로 진행하는 것을 막는다”는 방어적 설계라는 점입니다. ask_user는 기능이 아니라 실패 예방 장치입니다.
예를 들어 “데이터베이스 마이그레이션 계획 세워줘”라고 입력하면, AI는 읽기 전용으로 스키마를 파악한 후 “롤백 전략도 포함할까요?”, “현재 운영 중인 환경인가요?” 같은 질문을 먼저 던집니다. 가정을 전제한 채 30분짜리 계획서를 뽑아내지 않는다는 게 실제 차이입니다.
Plan 모드와 Claude Code Plan 모드 비교
Claude Code에도 Plan 모드가 있습니다. Shift+Tab으로 전환하거나 /plan을 입력하면 됩니다. DataCamp 비교 자료(2026.03 기준)를 바탕으로 두 도구의 Plan 모드 차이를 정리했습니다.
| 항목 | Gemini CLI Plan 모드 | Claude Code Plan 모드 |
|---|---|---|
| 진입 방법 | /plan, Shift+Tab, 자연어 | /plan, Shift+Tab |
| 기본 활성화 | 기본값 ON | 수동 전환 필요 |
| 계획 단계 모델 | Gemini 3.1 Pro (무료 계정: Flash로 대체) |
Haiku Explore Subagent |
| 계획서 편집 | Ctrl+X로 외부 에디터 열기 | Ctrl+G로 외부 에디터 열기 |
| MCP 연동 | 읽기 전용 MCP 허용 | MCP 연동 지원 |
| 토큰 효율 | 432K (동일 작업 기준) | 261K (동일 작업 기준) |
| 무료 사용 | 무료 있음, Plan 핵심 기능 제한 | 무료 없음 (월 $20~) |
토큰 효율 수치를 보면, 같은 작업에서 Gemini CLI가 432K 입력 토큰을 쓴 데 비해 Claude Code는 261K였습니다 (출처: DataCamp, 2026.03 기준). Gemini CLI의 무료 일일 한도가 1,000회 요청이지만, 요청당 토큰 소모가 많으면 체감 가용량은 그보다 빠르게 줄어듭니다. 무료라는 숫자만 보면 여유롭지만, 실제론 빠르게 소진됩니다.
무료로 최대한 활용하는 현실적인 방법
무료 계정에서도 Plan 모드 자체가 막히는 건 아닙니다. 읽기 전용 탐색, 계획서 작성, ask_user 대화는 그대로 됩니다. 단, Pro 모델 라우팅이 빠진 상태에서 최대한 활용하려면 몇 가지를 챙겨야 합니다.
구글 계정 로그인 대신 AI Studio에서 발급받은 API 키로 인증하면, Flash 모델 일일 250회 한도가 적용됩니다. 단, 이 경우 Pro 모델을 직접 API 키에 연결하면 Gemini 3.1 Pro에 접근 가능합니다 — 단, 이 방법은 API 키 유료 요금제(Pay-as-you-go)에서만 Pro 모델이 풀립니다.
전체 리팩토링 계획보다 함수 하나, 모듈 하나 단위로 Plan 모드를 돌리면 토큰 소모가 훨씬 줄어듭니다. 코드베이스 전체를 읽게 하면 요청 횟수가 빠르게 소진됩니다.
Ctrl+X로 마크다운 계획서를 VS Code나 Vim에서 직접 열어 수정할 수 있습니다. AI가 짠 계획의 순서를 바꾸거나 불필요한 단계를 지우는 건 모델 등급과 무관하게 됩니다.
settings.json에서 "modelRouting": false로 설정하면 Plan 모드에서도 Auto 전환이 꺼집니다. 어차피 무료 계정은 Flash밖에 안 되니, 라우팅을 끄고 처음부터 Flash 기준으로 프롬프트를 설계하는 게 오히려 더 예측 가능합니다.
💡 자동 라우팅은 꺼지더라도, Plan 모드의 읽기 전용 안전장치와 계획서 기반 워크플로우는 무료 계정에서도 그대로 작동합니다. 모델 품질보다 “먼저 계획 세우고 승인하는 습관”이 목적이라면 무료에서도 충분합니다.
자주 묻는 것들 — Q&A 5가지
마치며 — Plan 모드, 어디까지 기대해도 될까요
다만 “무료로 쓸 수 있다”는 점에 기대가 컸다면, 2026년 3월 25일부터 핵심인 Pro 모델 라우팅이 무료 계정에서 빠진다는 걸 먼저 알고 시작하는 게 맞습니다. Plan 모드가 없어지는 게 아니라, Plan 모드가 가장 잘 작동하는 조건이 유료 계정임을 확인해두는 것입니다.
무료 계정이라면 읽기 전용 탐색, ask_user 대화, 계획서 직접 편집이라는 구조적 이점은 그대로 챙길 수 있습니다. Flash 모델의 한계는 있지만, “수정 전에 계획서 한 번 보고 승인한다”는 습관을 만들기엔 충분합니다. 복잡한 아키텍처 결정을 AI에 맡겨야 한다면, 그때 Pro 요금제를 고려하면 됩니다.
본 포스팅 참고 자료
- Google Developers Blog — Plan mode is now available in Gemini CLI (2026.03.11) 링크
- Gemini CLI 공식 문서 — Plan Mode 링크
- Gemini CLI 공식 문서 — Quotas and Pricing 링크
- GitHub Discussions — Service update: mitigating abuse and prioritizing traffic (2026.03.25) 링크
- DevOps.com — Gemini CLI Plan Mode Separates Thinking From Doing (2026.03.16) 링크
- DataCamp — Gemini CLI vs. Claude Code: Differences and Use Cases (2026) 링크
본 포스팅은 2026년 3월 28일 기준으로 작성됐습니다. Gemini CLI의 서비스 정책·UI·기능·요금제는 구글의 업데이트에 따라 언제든 변경될 수 있습니다. 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있으므로, 최신 정보는 geminicli.com 공식 문서에서 확인하세요.
댓글 남기기