Gemini CLI v0.33.0
IT/AI
Gemini CLI Plan 모드,
이 조건에서만 Pro가 됩니다
Plan 모드는 2026년 3월 11일부터 모든 사용자에게 기본 활성화됐습니다. 코드 한 줄 건드리기 전에 먼저 설계도를 그리는 방식인데, 겉으로 보면 단순합니다. 그런데 핵심 기능인 고추론 Gemini 3.1 Pro 자동 라우팅은 모든 사람에게 열려 있지 않습니다. 로그인 방식과 요금제에 따라 작동이 달라집니다.
Plan 모드가 생긴 이유 — 기존 방식의 실제 문제
AI 코딩 에이전트의 가장 큰 불안 요소는 속도가 아니라 예측 불가능성입니다. 프롬프트를 입력하는 순간, 에이전트는 검토 없이 파일을 수정하기 시작합니다. 대규모 리팩토링이나 데이터베이스 마이그레이션처럼 돌이키기 어려운 작업일수록 이 문제는 커집니다. 구글 자체적으로도 같은 문제를 인식했고, 그 결과물이 바로 Plan 모드입니다.
Gemini CLI v0.33.0 릴리즈 노트에는 이렇게 적혀 있습니다. “Plan mode is a read-only mode that restricts Gemini CLI to a subset of its tools.” (출처: Gemini CLI GitHub Discussions, 2026.03.11) 에이전트가 쓸 수 있는 도구 자체를 제한해 버린다는 뜻입니다. 실수할 수 있는 도구를 아예 꺼두는 방식입니다.
DevOps 분석 매체 DevOps.com은 이 변화를 “act first, review after”에서 “research first, act when approved”로의 전환이라고 표현했습니다. (출처: DevOps.com, 2026.03.16) 에이전트 거버넌스가 기능 속도만큼 중요해진 시점에 나온 기능입니다.
Plan 모드 작동 방식 — 읽기 전용이 전부가 아닙니다
Plan 모드는 진입 방법이 세 가지입니다. 터미널에서 /plan을 입력하거나, Shift+Tab을 눌러 모드를 순환하거나, 자연어로 “~에 대한 계획을 세워줘”라고 요청하면 됩니다. 기본값이 Plan 모드로 고정되어 있어서 세션을 시작할 때부터 읽기 전용 상태로 진입하도록 설정할 수도 있습니다. (출처: Gemini CLI 공식 문서, geminicli.com/docs/cli/plan-mode/)
이 모드에서 에이전트가 쓸 수 있는 도구는 엄격하게 제한됩니다. 읽기 전용 파일시스템 도구(read_file, glob, grep_search), 웹 검색, 읽기 전용 MCP 도구, 그리고 ask_user만 허용됩니다. 파일을 쓸 수 있는 유일한 예외는 ~/.gemini/tmp/ 아래에 저장되는 계획 마크다운 파일뿐입니다.
여기서 눈여겨볼 도구가 ask_user입니다. 에이전트가 추측으로 진행하는 대신, 설계 결정 시점에 멈추고 직접 물어봅니다. 구글 공식 블로그 표현으로는 “A plan is only as good as its requirements”입니다. (출처: Google Developers Blog, 2026.03.11) 계획의 품질이 요구사항 정확도에 달려 있다는 뜻입니다.
💡 공식 발표문과 실제 도구 제한 목록을 같이 놓고 보니 이런 차이가 보였습니다 — Plan 모드는 MCP 도구도 지원하지만 읽기 전용으로 등록된 것만 허용합니다. GitHub 이슈를 읽거나 Postgres 스키마를 조회하는 건 되지만, 이슈를 닫거나 스키마를 수정하는 것은 Plan 모드 안에서는 원천 차단됩니다.
고추론 Pro 모델이 켜지는 정확한 조건
Plan 모드의 가장 중요한 기술적 특징은 자동 모델 라우팅입니다. Plan 모드 진입 시 고추론 Pro 모델로 전환하고, 계획이 승인되어 실행 단계로 넘어가면 빠른 Flash 모델로 자동 교체됩니다. 구글 공식 문서는 이 동작을 이렇게 설명합니다. “Higher reasoning Pro models like the new Gemini 3.1 Pro model being used during planning to ensure robust architectural decisions.” (출처: Google Developers Blog, 2026.03.11)
그런데 이 자동 라우팅은 auto 모델 설정을 사용할 때만 작동합니다. 세션 설정에서 모델을 직접 고정했다면 Plan 모드에 진입해도 모델 전환이 일어나지 않습니다. 또한 이 라우팅이 실제로 Gemini 3.1 Pro를 사용하려면, 해당 모델에 접근 권한이 있는 인증 방식이어야 합니다. API Key 무료 쿼터로 로그인한 경우, Gemini 3.1 Pro가 아닌 Flash 계열 모델만 사용 가능합니다. (출처: Gemini CLI 공식 문서 — Quotas and Pricing, geminicli.com/docs/resources/quota-and-pricing/)
💡 Plan 모드를 활성화했다고 해서 자동으로 가장 좋은 모델이 붙는 게 아닙니다 — 로그인 방식과 쿼터 등급이 일치해야 Pro 라우팅이 실제로 동작합니다.
자동 라우팅 자체를 끄고 싶다면 settings.json에서 "modelRouting": false로 설정하면 됩니다. 단, 이 경우 Plan 모드와 실행 모드 모두 동일한 모델을 사용합니다.
요금제별 실제 차이 — 이게 핵심입니다
여기가 가장 많이 헷갈리는 부분입니다. Gemini CLI는 구글 계정 로그인, API Key 로그인, Vertex AI 세 가지 인증 방식을 지원하는데, 같은 Plan 모드를 쓰더라도 모델 접근 범위가 다릅니다.
| 인증 방식 | 일일 무료 요청 | Plan 모드 Pro 라우팅 | 분당 요청 한도 |
|---|---|---|---|
| 구글 계정 로그인 (Gemini Code Assist 개인) |
1,000회 | ✅ Gemini 3.1 Pro | 60회/분 |
| API Key 무료 쿼터 | 250회 | ❌ Flash만 가능 | 10회/분 |
| Google AI Pro 구독 | — | ❌ 미지원 | — |
| Google AI Ultra 구독 | — | ✅ 지원 | — |
| Gemini Code Assist 엔터프라이즈 | 2,000회 | ✅ 지원 | 120회/분 |
출처: Gemini CLI 공식 문서 — Quotas and Pricing (geminicli.com/docs/resources/quota-and-pricing/), 2026.03 기준
💡 월 $29,000원 수준의 Google AI Pro를 구독하고 있어도 Gemini CLI Plan 모드에서 Pro 라우팅이 작동하지 않습니다. 공식 문서에 “Google AI Plus와 Google AI Pro는 지원되지 않습니다”라고 명시돼 있습니다. Ultra($124.99/월 3개월 기준)이거나, 구글 계정으로 무료 로그인하는 경우에만 Pro 모델이 붙습니다.
Plan 모드를 진짜로 쓸 수 있는 경우와 그렇지 않은 경우
Plan 모드는 기본 활성화됐지만, 실제로 의미 있게 활용되는 시나리오는 따로 있습니다. 데이터베이스 마이그레이션, 대규모 리팩토링, 멀티 서비스 연동처럼 돌이키기 어려운 변경 앞에서 사전 탐색이 필요한 경우입니다. DevOps.com은 이런 상황에서 Plan 모드에서 20분을 쓰는 것을 “오버헤드가 아니라 리스크 관리”라고 표현했습니다. (출처: DevOps.com, 2026.03.16)
반대로 간단한 함수 수정이나 파일 하나를 바꾸는 작업에 Plan 모드를 매번 거치는 것은 불필요합니다. 공식 문서도 이 점을 인정하고 있습니다. “If plan mode isn’t your cup of tea, disabling it is easy!” (출처: Google Developers Blog, 2026.03.11) 설정에서 Plan을 비활성화하면 Shift+Tab 순환에서 완전히 제거됩니다.
CI/CD 파이프라인처럼 비인터랙티브 환경에서 쓰는 경우는 동작이 다릅니다. 이 환경에서는 Plan 모드 진입·종료가 사용자 확인 없이 자동 승인되고, 계획이 확정되면 자동으로 YOLO 모드(모든 편집 자동 수락)로 전환됩니다. 보안상 민감한 환경에서 이 동작을 모르고 쓰면 의도하지 않은 자동 실행이 발생할 수 있습니다. (출처: Gemini CLI 공식 문서, geminicli.com/docs/cli/plan-mode/)
⚠️ 주의 — CI/CD 환경에서 gemini --approval-mode plan -p "..."을 실행하면 Plan 승인 후 YOLO 모드로 자동 전환됩니다. 인터랙티브 환경과 동작이 다릅니다. (출처: Gemini CLI 공식 문서)
Claude Code Plan 모드와 무엇이 다른가
Plan 모드는 Claude Code에도 있습니다. Shift+Tab을 두 번 누르면 Claude가 실행 전 계획을 먼저 제시합니다. 개발자 Kevin Simper는 2025년 11월 기준 글에서 “It is weird that Gemini CLI has no plan mode”라고 지적하기도 했는데 (출처: kevinsimper.dk, 2025.11.27), 그 공백을 구글이 2026년 3월에 채운 셈입니다.
가장 큰 차이는 모델 라우팅 자동화입니다. Claude Code는 Plan 모드 진입 시 모델을 자동으로 바꾸지 않습니다. Gemini CLI는 계획 단계에서는 고추론 Pro를, 실행 단계에서는 빠른 Flash를 자동으로 씁니다. 설계에는 깊은 사고가, 실행에는 속도가 필요하다는 원칙을 코드에 직접 반영한 방식입니다.
비용 측면에서는 구글 계정 무료 로그인 기준으로 Gemini CLI가 압도적으로 유리합니다. Claude Code는 Pro 플랜($20/월) 없이 실질적인 Plan 모드 활용이 어렵습니다. 반면 포맷팅 완성도와 복잡한 추론 결과물의 일관성은 실사용 리뷰에서 여전히 Claude Code가 앞선다는 평가가 많습니다. Composio의 벤치마크 기준, 동일 프로젝트 완성 시간이 Claude Code 1시간 17분 대 Gemini CLI 2시간 2분이었습니다. (출처: Composio, 2025.07.02 / 단, 해당 벤치마크는 Plan 모드 도입 전 기준임을 참고)
자주 묻는 질문
마치며 — 실제로 써야 하는 사람과 그렇지 않은 사람
Gemini CLI Plan 모드는 출시된 지 2주가 됐습니다. 기본 활성화라는 결정은 “기능을 선택적으로 켜는 게 아니라 안전한 방식을 기본으로 두겠다”는 구글의 방향성을 보여줍니다. 이 방향은 기업 환경, 특히 감사 요건이 있거나 배포 리스크가 높은 팀에게 설득력이 있습니다.
솔직히 말하면, 단순 작업자에게 Plan 모드는 불필요한 단계입니다. 작은 수정 하나에 계획 수립 단계를 매번 거치는 것은 오히려 속도를 떨어뜨립니다. Plan 모드를 가장 잘 활용할 수 있는 경우는 복잡한 코드베이스를 처음 분석하거나, 여러 서비스를 연결하는 작업을 시작하기 전입니다.
핵심은 요금제입니다. 구글 계정 무료 로그인이 Plan 모드에서 Gemini 3.1 Pro를 쓸 수 있는 가장 쉬운 방법입니다. API Key 방식이나 Google AI Pro 구독으로는 동일한 경험을 기대하기 어렵습니다. 구글이 이 부분을 명확하게 커뮤니케이션하지 않은 점이 좀 아쉬웠습니다.
📚 본 포스팅 참고 자료
- Google Developers Blog — Plan mode is now available in Gemini CLI (2026.03.11)
https://developers.googleblog.com/plan-mode-now-available-in-gemini-cli/ - Gemini CLI 공식 문서 — Plan Mode
https://geminicli.com/docs/cli/plan-mode/ - Gemini CLI 공식 문서 — Quotas and Pricing
https://geminicli.com/docs/resources/quota-and-pricing/ - DevOps.com — Gemini CLI Plan Mode Separates Thinking From Doing (2026.03.16)
https://devops.com/gemini-cli-plan-mode-separates-thinking-from-doing/ - Gemini CLI GitHub Discussions — v0.33.0 릴리즈 노트 (2026.03.11)
https://github.com/google-gemini/gemini-cli/discussions/22078
본 포스팅은 2026년 3월 25일 기준 Gemini CLI v0.33.0 공식 문서를 바탕으로 작성되었습니다.
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. 최신 정보는 공식 문서에서 확인하세요.
댓글 남기기