Gemini CLI v0.33.0 기준
Gemini CLI Plan 모드, 쓸수록 한도 빨리 닳는 이유 있습니다
2026년 3월 11일, 구글이 Gemini CLI에 Plan 모드를 추가하고 모든 사용자에게 기본값으로 설정했습니다. “코드 변경 없이 안전하게 분석부터”라는 설명만 보면 좋은 기능이지만, 실제 구조를 보면 무료 한도가 생각보다 빠르게 줄어들 수 있습니다. 공식 문서에 명시된 내용을 직접 확인했습니다.
Plan 모드가 뭔지부터 확인했습니다
Gemini CLI Plan 모드는 코드를 실제로 수정하기 전에 분석과 설계만 먼저 수행하는 읽기 전용 실행 환경입니다. 3월 11일 구글 공식 블로그에 발표됐고, v0.33.0부터 모든 사용자에게 기본값으로 켜졌습니다. (출처: Google Developers Blog, 2026.03.11)
Plan 모드가 활성화되면 Gemini CLI는 read_file, grep_search, glob 같은 읽기 전용 도구만 사용할 수 있습니다. 파일을 직접 수정하거나 명령어를 실행하는 건 불가능하고, 내부 계획 파일(.md)에만 쓰기가 허용됩니다. (출처: geminicli.com/docs/cli/plan-mode)
💡 공식 발표문과 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다
Plan 모드는 “안전하게 계획부터”라는 설명과 달리, 계획 단계에서도 모델 요청이 발생합니다. 읽기만 해도 토큰을 씁니다.
터미널에서 /plan을 입력하거나 Shift+Tab을 눌러 모드를 전환할 수 있습니다. 기본값 → Auto-Edit → Plan 순서로 순환됩니다. Plan 모드를 끄고 싶다면 /settings에서 “Plan”을 검색해 토글하면 됩니다.
기본값으로 켜져 있는 게 문제인 이유
“기본으로 켜졌다”는 게 왜 문제냐고 할 수 있습니다. 읽기만 하는데 뭐가 문제냐는 거죠. 막상 써보면 다릅니다. Plan 모드가 기본값이면, Gemini CLI를 실행하고 아무 요청을 입력했을 때 자동으로 분석 단계를 먼저 거칩니다. 그 분석 단계에서 이미 모델 요청이 발생합니다.
결론부터 말씀드리면, Plan 모드에서 Plan을 승인하고 구현 단계로 넘어가면 총 최소 2번의 주요 모델 호출 사이클이 발생합니다. 계획 단계 1회 이상 + 실제 코드 구현 단계 1회 이상. 기존에 바로 구현 모드(Default)만 쓰던 방식보다 요청 수가 늘어날 수밖에 없습니다.
💡 무료로 쓰는데 Plan 모드가 기본값인 건 양날의 검입니다
안전하게 계획을 세워준다는 장점은 실재합니다. 다만 같은 작업에 소모되는 요청 수가 늘어난다는 것도 사실입니다.
실제로 Reddit의 r/GeminiCLI에서 다수의 사용자가 지적한 부분도 이것입니다. “구조화된 워크플로 없이는 코딩 결과가 들쭉날쭉하다”는 피드백이 반복되는데, 그 배경에는 Plan 모드를 제대로 활용하지 않고 그냥 넘어갈 때 발생하는 컨텍스트 단절 문제가 있습니다. (출처: r/GeminiCLI, 2026.03.06)
무료 한도가 더 빨리 닳는 구조 — 공식 문서 확인
여기서 핵심은 모델 자동 라우팅(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 detects the existence of the approved plan and automatically switches to a high-speed Flash model.”
(출처: geminicli.com/docs/cli/plan-mode/#automatic-model-routing)
Plan 모드에서는 Gemini 3.1 Pro 같은 고추론 모델이 자동으로 배정됩니다. 빠른 구현 단계에는 Flash 모델로 내려갑니다. 즉, 설계 단계에서 Pro 모델이 소비하는 토큰이 무료 한도에 카운트됩니다.
| 인증 방식 | 일일 요청 한도 | Plan 모드 적용 모델 | 주의 |
|---|---|---|---|
| Google 계정 로그인 | 1,000회/일 | Gemini 3 Pro → 2.5 Pro → Flash 순 하강 | Plan 단계에서 Pro 소비 |
| Gemini API 키(무료) | 250회/일 | Flash 모델만 지원 | Plan 모드 효과 반감 |
| Vertex AI Express | 90일 무료 후 과금 | 가변(계정별 상이) | 과금 전 확인 필요 |
API 키 무료 사용자라면 상황이 더 아쉽습니다. API 키 무료 티어에서는 Flash 모델만 지원됩니다. Plan 모드가 Pro 모델을 자동 배정하도록 설계됐는데, Flash밖에 쓸 수 없으면 Plan 모드의 핵심 이점인 고추론 아키텍처 분석이 제대로 작동하지 않습니다. (출처: geminicli.com/docs/resources/quota-and-pricing) Plan 모드를 굳이 켤 이유가 줄어드는 상황입니다.
Google AI Plus 구독해도 여기선 안 됩니다
월 11,000원짜리 Google AI Plus를 구독하면 Gemini CLI 한도도 늘어날 것 같지만, 공식 문서에 이렇게 적혀 있습니다:
“Supported tiers: Tiers not listed above, including Google AI Plus, are not supported.”
(출처: geminicli.com/docs/resources/quota-and-pricing — 2026.03.21 기준)
Google AI Plus는 Gemini 웹앱이나 Flow 영상 편집기 같은 웹 기반 제품에는 적용되지만, Gemini CLI의 API 사용량에는 적용되지 않습니다. Gemini CLI의 유료 한도를 늘리려면 Google AI Pro($19.99/월, 국내 약 29,000원) 또는 AI Ultra를 구독해야 합니다. AI Plus만 쓰다가 한도 초과 시 Flash로 강제 전환되는 경험을 하게 됩니다.
💡 AI Plus와 CLI 한도가 분리된 이유는 아직 공개되지 않았습니다
공식 문서에 “Supporting these plans is under active consideration for future support”라고만 나와 있습니다. 언제 통합될지는 구글이 공식 답변을 내놓지 않은 상태입니다.
Claude Code랑 실제로 뭐가 다른가
Claude Code에도 계획 먼저 세우는 방식이 있습니다. 하지만 구조가 다릅니다. Claude Code에서는 프롬프트에 think 파라미터나 “먼저 계획을 세운 후 구현해줘”라는 지시를 직접 넣는 방식입니다. 별도의 모드 전환이 없고, 계획이 내부 추론 흐름 안에 포함됩니다.
| 항목 | Gemini CLI Plan 모드 | Claude Code |
|---|---|---|
| 계획 단계 분리 | ✅ 명시적 모드 전환 | ❌ 프롬프트 지시로 처리 |
| 계획 파일 외부 편집 | ✅ Ctrl+X로 에디터 열기 | ❌ 미지원 |
| 무료 사용 가능 여부 | ✅ 1,000회/일 (Google 로그인) | ❌ 유료 구독 필수 |
| 컨텍스트 창 | 100만 토큰 | 100만 토큰 |
| 오픈소스 여부 | ✅ Apache 2.0 | ❌ 비공개 |
| 실제 코딩 정확도 | 중간 (복잡한 작업은 낮음) | 높음 (비복잡·복잡 모두) |
shipyard.build의 비교 분석에서 Gemini CLI는 “정확한 지시 없이 스스로 방향을 잡는 데 약하다”고 평가됐습니다. (출처: shipyard.build/blog/claude-code-vs-gemini-cli, 2026.01.15) 반면 Plan 모드는 그 약점을 보완하기 위한 구조적 해법입니다. Plan 모드 없이 Gemini CLI를 쓰는 건 장점을 절반만 쓰는 것과 비슷합니다.
Plan 모드를 꺼야 하는 경우 vs 켜야 하는 경우
솔직히 말하면, Plan 모드가 무조건 좋은 건 아닙니다. 간단한 수정 작업에 Plan 모드가 기본으로 켜져 있으면 불필요하게 계획 단계를 거치면서 요청 수만 줄어듭니다. 아래 기준으로 판단하는 게 현실적입니다.
✅ Plan 모드 켜두면 유리한 경우
- DB 마이그레이션, 대규모 리팩터링
- 처음 접하는 코드베이스 분석
- 여러 파일에 걸친 아키텍처 변경
- 보안 감사 또는 취약점 탐색
- Conductor 확장 프로그램과 연계할 때
❌ Plan 모드 꺼두는 게 나은 경우
- 오타 수정, 단순 변수명 변경
- 한두 줄짜리 버그픽스
- 무료 API 키 250회/일 한도 내에서 쓸 때
- 빠른 프로토타입 실험
- 이미 머릿속에 구현 계획이 명확할 때
Plan 모드를 끄는 방법은 간단합니다. /settings 명령어 → “Plan” 검색 → Default Approval Mode를 Default 또는 Auto-Edit으로 변경하면 됩니다. 이렇게 하면 Plan 모드가 Shift+Tab 순환에서도 제거됩니다.
💡 Plan 모드 비활성화 후에도 언제든 수동으로 켤 수 있습니다
기본값에서 제외된다는 의미일 뿐, /plan을 입력하거나 자연어로 “먼저 계획을 세워줘”라고 요청하면 해당 세션에서 Plan 모드로 전환됩니다.
자주 나오는 질문들
마치며
다만 몇 가지는 써보기 전에 확인해야 합니다. 기본값으로 켜진 Plan 모드는 단순 작업에서는 요청 수를 늘릴 뿐입니다. Google AI Plus 구독으로는 CLI 한도가 늘어나지 않습니다. API 키 무료 사용자는 Plan 모드의 핵심인 Pro 모델 자동 라우팅을 누리지 못합니다.
이 부분을 인지하고 나면, Plan 모드를 언제 켜고 언제 꺼야 하는지 판단이 분명해집니다. 복잡한 작업엔 켜고, 간단한 작업엔 끄는 것. 그리고 무료 한도가 걱정된다면 API 키 대신 Google 계정 로그인으로 쓰는 게 낫습니다. 이것만 알고 써도 Gemini CLI를 훨씬 효율적으로 쓸 수 있습니다.
📎 본 포스팅 참고 자료
본 포스팅은 2026년 3월 21일 기준으로 작성됐습니다. Gemini CLI는 빠르게 업데이트되는 서비스로, 본 포스팅 작성 이후 서비스 정책·UI·기능·요금이 변경될 수 있습니다. 수치·정책 확인은 geminicli.com 공식 문서를 통해 최신 정보를 확인하세요.
댓글 남기기