⚠️ 2026.03.25 이후 유료 정책 변경
Gemini CLI Plan 모드, 써봤더니 무료가 아닙니다
구글이 3월 11일 Gemini CLI v0.33.0에 Plan 모드를 정식 탑재했습니다. 코드 건드리기 전에 먼저 읽고, 분석하고, 계획만 잡는다는 개념은 솔직히 매력적입니다. 그런데 막상 쓰려고 보면 걸리는 조건이 있습니다. 특히 3월 25일 이후 바뀐 무료 정책을 모르고 시작하면 핵심 기능이 통째로 막힙니다.
Plan 모드가 생긴 이유 — AI가 먼저 묻는 구조
기존 AI 코딩 도구의 가장 큰 불만은 단 하나였습니다. “물어보지도 않고 코드부터 바꾼다”는 것입니다. 구글은 이 문제를 해결하기 위해 v0.33.0(2026.03.11)에 Plan 모드를 정식 탑재했습니다. (출처: Google Developers Blog, 2026.03.11)
Plan 모드는 읽기 전용(read-only) 상태에서만 작동합니다. 파일을 읽고, 패턴을 검색하고, 의존성을 파악하는 건 되지만, 코드를 직접 수정하거나 명령을 실행하는 건 완전히 차단됩니다. 공식 문서에 딱 이렇게 나옵니다: “Plan mode restricts Gemini CLI to a subset of its tools … it cannot modify any files except for its own internal plans.” (출처: geminicli.com/docs/cli/plan-mode)
여기서 주목할 점은 ask_user 도구입니다. AI가 가정하는 대신, 목표가 불분명하거나 선택지가 있을 때 직접 질문을 던집니다. 설계 방향을 정하기 전에 사용자와 합의하는 과정이 내장된 셈입니다.
실제로 어떻게 돌아가는가 — 3단계 흐름
Shift+Tab을 눌러 Plan 모드로 진입하거나, 터미널에 /plan을 입력하거나, 그냥 “이 기능 개발 계획 잡아줘”라고 자연어로 말해도 됩니다. 세 가지 방법 모두 같은 결과입니다. (출처: geminicli.com/docs/cli/plan-mode)
💡 공식 문서의 3단계 흐름을 직접 따라가 보면 이렇습니다
1단계 — 탐색: read_file, grep_search, glob을 이용해 코드베이스를 읽습니다. 파일 수정 권한은 없습니다.
2단계 — 설계 합의: ask_user로 아키텍처 선택지를 제시하고, 의사결정을 요청합니다. 가정 없이 진행합니다.
3단계 — 계획 파일 생성: ~/.gemini/tmp/<project>/plans/ 경로에 Markdown 파일로 저장합니다. Ctrl+X로 외부 편집기에서 직접 수정한 뒤 승인하면 구현 단계로 넘어갑니다.
GitHub 이슈에서 찾아낸 흥미로운 제약이 있습니다. 계획 파일(`.md`)의 저장 경로는 반드시 프로젝트 루트 안에 있어야 합니다. 커스텀 경로를 설정해도 프로젝트 경계를 벗어난 외부 파일 시스템에 쓰는 건 정책 엔진이 차단합니다. 민감한 파일이 덮어쓰이는 사고를 원천 차단한 설계입니다. (출처: geminicli.com/docs/cli/plan-mode/#custom-plan-directory-and-policies)
로컬 파일만이 아닙니다. 읽기 전용 MCP 도구도 Plan 모드에서 쓸 수 있어서, GitHub 이슈를 읽거나 PostgreSQL 스키마를 조회하는 것도 가능합니다. 다만 이것도 읽기에 한정됩니다.
무료라고 했는데, 핵심은 유료로 바뀌었습니다
🚨 2026.03.25부로 적용된 변경 사항
“Starting March 25, 2026, Gemini Pro models will only be accessible via paid subscriptions. Free tier users will be limited to Gemini Flash models.” (출처: GitHub Discussions #22970, google-gemini/gemini-cli)
Plan 모드 자체는 무료입니다. 그런데 Plan 모드의 핵심 강점인 자동 모델 라우팅이 문제입니다. 공식 문서에서 Plan 모드는 “고추론 Pro 모델(현재 Gemini 3.1 Pro)을 사용해 아키텍처 결정의 품질을 높인다”고 명시하고 있습니다. (출처: geminicli.com/docs/cli/plan-mode/#automatic-model-routing)
3월 25일 이후 API 키 무료 사용자에게는 Pro 모델 접근이 차단됩니다. 즉, 무료로 Plan 모드를 켜도 내부에서 돌아가는 모델은 Flash로 내려갑니다. 구글 계정으로 직접 로그인하는 방식(Gemini Code Assist for Individuals)은 하루 1,000회 요청까지 무료이고, 3월 25일 이후에도 Plan 모드 사용은 가능합니다. 다만 이 경우에도 Pro 모델이 보장되는 건 AI Pro/Ultra 유료 구독자입니다. 구글이 공식 답변을 내놓지 않은 부분이 있어서, Google One Premium이 이 범주에 포함되는지는 아직 불명확합니다. (출처: GitHub Issues #23049)
정리하면, Plan 모드를 제대로 쓰려면 Google AI Pro(월 약 29,000원) 이상의 구독이 필요합니다. 무료 구간에서도 Flash 모델로 Plan 모드를 돌릴 수 있지만, 복잡한 아키텍처 분석에서 Pro 대비 품질 차이가 발생할 가능성이 높습니다.
| 인증 방식 | 일일 요청 한도 | 3.25 이후 Pro 모델 | Plan 모드 사용 |
|---|---|---|---|
| 구글 계정 로그인 (무료) | 1,000회/일 | 제한 (Flash만) | 가능 |
| API 키 무료 사용 | 250회/일 | 차단 | Flash 기반만 |
| Google AI Pro/Ultra (유료) | 구독 기준 적용 | 유지 | Pro 라우팅 포함 |
| Code Assist Enterprise | 2,000회/일 | 유지 | Pro 라우팅 포함 |
(출처: geminicli.com/docs/resources/quota-and-pricing, GitHub Discussions #22970)
Pro → Flash 자동 전환, 속도가 더 빨라지는 이유
💡 계획 단계와 구현 단계에 각각 다른 모델을 쓰는 구조입니다
Plan 모드에서 Pro 모델이 설계를 잡고, 승인 후 구현 단계에서는 자동으로 Flash 모델로 넘어갑니다. 비용 효율과 속도를 동시에 잡는 구조입니다.
대부분의 사람들은 “Plan 모드 = 느리다”고 예상합니다. 분석하고 물어보고 계획 파일까지 만드는 과정이 추가되니까요. 그런데 공식 문서의 자동 모델 라우팅 항목을 보면 다릅니다.
Plan 모드에서는 Gemini 3.1 Pro가 아키텍처를 분석하고 계획을 만듭니다. 계획이 승인되면 구현 단계로 넘어가면서 CLI가 자동으로 Flash 모델로 전환합니다. DevOps.com은 이 구조를 “thinking from doing을 분리한다”고 정리했습니다. (출처: DevOps.com, 2026.03.16)
결과적으로 설계의 정확도는 Pro 수준으로 유지하면서, 실제 코드 작성 속도는 Flash 수준(더 빠름)으로 올라갑니다. 즉, Plan 모드를 쓰면 전체 작업 시간이 늘어나는 게 아니라 오히려 줄어드는 케이스가 발생합니다. 단, 이 자동 라우팅은 `modelRouting: true`가 기본값일 때만 작동하며, `settings.json`에서 `”modelRouting”: false`로 설정하면 비활성화됩니다. (출처: geminicli.com/docs/cli/plan-mode/#automatic-model-routing)
Claude Code, Copilot과 뭐가 다른가
AI 코딩 에이전트 시장에서 Plan 모드를 가진 건 현재 Gemini CLI가 사실상 유일합니다. Claude Code는 대화 흐름 안에서 계획을 세우지만, 별도의 읽기 전용 “계획 모드”로 강제 분리하는 구조는 없습니다. GitHub Copilot은 실시간 제안 방식이라 아키텍처 설계 단계 자체를 구조화하지 않습니다.
| 항목 | Gemini CLI | Claude Code | Copilot |
|---|---|---|---|
| 읽기 전용 설계 단계 | ✅ 별도 Plan 모드 | 대화 흐름 내 처리 | ❌ 별도 단계 없음 |
| 계획 파일 저장 | ✅ Markdown 파일 | 세션 내 임시 보관 | ❌ |
| MCP 읽기 연동 | ✅ (Plan 모드 내) | MCP 지원 | 제한적 |
| 모델 자동 전환 | ✅ Pro→Flash 자동 | 수동 선택 | GPT-4o 고정 |
| 무료 사용 (핵심 기능) | 3.25 이후 제한 | 유료 구독 필요 | 유료 구독 필요 |
(출처: geminicli.com, developers.googleblog.com, 2026.03 기준)
사실 비교표에서 가장 눈에 띄는 건 마지막 행입니다. Claude Code도, Copilot도 핵심 기능은 처음부터 유료입니다. Gemini CLI만 무료 구간이 넓었는데, 그 이점이 3월 25일을 기점으로 좁아졌습니다.
한편, Gemini CLI 관련 Reddit 커뮤니티에서는 “Ultra 구독자도 주간 할당량을 하루 이틀 만에 다 쓴다”는 사례가 이미 나오고 있습니다. Plan 모드가 Pro 모델 요청을 집중적으로 소모하는 구조라, 대형 코드베이스 분석 작업에서는 할당량 소진이 예상보다 빠를 수 있습니다. (출처: Reddit r/Bard, 2026.03.18)
쓸 만한 조건과 쓰면 손해인 조건
Plan 모드가 효과적인 상황
첫째로, 여러 파일에 걸친 대규모 리팩터링이나 DB 마이그레이션처럼 실수 하나가 치명적인 작업입니다. 읽기 전용으로 의존성 전체를 파악한 뒤 계획을 만들고, 그 계획을 직접 검토하고 수정한 다음에야 실행하는 흐름이 안전합니다.
둘째로, CI/CD 파이프라인 자동화입니다. 공식 문서에서 Plan 모드는 비대화형(headless) 환경에서 `–approval-mode=plan`으로 실행하면 자동 전환과 YOLO 모드(자동 승인)로 동작합니다. 이 구조를 이용하면 코드 변경 전에 항상 분석 단계를 거치는 파이프라인을 만들 수 있습니다. (출처: geminicli.com/docs/cli/plan-mode/#non-interactive-execution)
Plan 모드보다 직접 실행이 나은 상황
간단한 버그 수정이나 단일 파일 변경처럼 맥락이 명확한 작업은 Plan 모드를 거칠 필요가 없습니다. 오히려 Pro 모델 요청 할당량만 소모합니다. 특히 유료 구독의 주간 할당이 제한적인 상황이라면, Plan 모드는 꼭 필요한 복잡도 있는 작업에만 아껴서 쓰는 게 현명합니다.
또 하나, Plan 모드를 끄는 방법도 공식 문서에 명시돼 있습니다. `/settings`에서 “Plan”을 검색해 토글 오프하면 Shift+Tab 순환에서 완전히 제거됩니다. 기존 방식이 더 잘 맞는 개발자라면 굳이 쓸 이유가 없습니다.
💡 Conductor 확장 기능과 함께 쓰면 달라집니다
구글이 Plan 모드 위에 올려 만든 Conductor 확장(github.com/gemini-cli-extensions/conductor)은 대형 개발 프로젝트를 트랙 단위로 나눠 관리합니다. 계획 파일을 프로젝트 디렉토리에 영속적으로 저장하고, 각 마일스톤마다 `ask_user`로 의사결정을 체크하는 구조입니다. 구글은 향후 Conductor를 CLI 내장 모드로 통합할 예정이라고 밝혔습니다. (출처: Google Developers Blog, 2026.03.11)
자주 나오는 질문 5가지
Q1. Plan 모드는 어떻게 진입하나요?
Shift+Tab을 눌러 모드를 순환하거나(Default → Auto-Edit → Plan), 입력창에 /plan을 입력하거나, “이 기능 계획 세워줘”처럼 자연어로 요청해도 됩니다. 터미널 시작부터 Plan 모드로 열려면 gemini --approval-mode=plan을 씁니다. (출처: geminicli.com/docs/cli/plan-mode)
Q2. 무료로 Plan 모드를 쓸 수 있나요?
구글 계정으로 로그인하면 하루 1,000회까지 무료로 Plan 모드를 실행할 수 있습니다. 다만 2026년 3월 25일 이후 Pro 모델 라우팅은 유료 구독(Google AI Pro/Ultra 이상)에서만 보장됩니다. API 키 무료 사용자는 Flash 모델로만 돌아갑니다. (출처: GitHub Discussions #22970, geminicli.com/docs/resources/quota-and-pricing)
Q3. Plan 모드에서 만든 계획 파일은 어디에 저장되나요?
기본 경로는 ~/.gemini/tmp/<project>/<session-id>/plans/이고, 30일 후 자동 삭제됩니다. settings.json에서 커스텀 경로를 지정할 수 있지만, 반드시 프로젝트 루트 안에 있어야 합니다. Ctrl+X로 계획 파일을 외부 편집기에서 열어 직접 수정하는 것도 됩니다. (출처: geminicli.com/docs/cli/plan-mode)
Q4. Plan 모드를 끄고 싶으면 어떻게 하나요?
/settings에서 “Plan”을 검색한 뒤 토글 오프하면 됩니다. 이렇게 하면 Shift+Tab 순환에서 Plan 모드가 완전히 제거되고, enter_plan_mode와 exit_plan_mode 도구도 해제됩니다. (출처: Google Developers Blog, 2026.03.11)
Q5. CI/CD 파이프라인에서도 Plan 모드를 쓸 수 있나요?
네, 됩니다. 비대화형 환경에서는 gemini --approval-mode plan -p "분석 요청" 형태로 실행하면 됩니다. 이 경우 Plan 모드 진입/종료가 자동 승인되고, 구현 단계로 넘어가면 YOLO 모드로 자동 전환됩니다. 단, 유료 API 키가 필요합니다. (출처: geminicli.com/docs/cli/plan-mode/#non-interactive-execution)
마치며
솔직히 말하면, Plan 모드 아이디어 자체는 맞습니다. AI가 코드를 먼저 건드리고 나서 “이렇게 했어요” 하는 게 아니라, 설계 합의를 거친 뒤 실행하는 흐름은 실제 개발 과정과 훨씬 가깝습니다. 특히 읽기 전용 + ask_user + 계획 파일이라는 조합은 다른 도구들이 갖지 못한 구조입니다.
문제는 무료 구간에서 이 장점을 온전히 쓰기 어려워졌다는 점입니다. Plan 모드의 핵심인 Pro 모델 라우팅이 3월 25일부로 유료 구독에 묶였고, Reddit에서는 유료 구독자도 대형 작업 하나에 주간 할당량을 빠르게 소진한다는 사례가 나오고 있습니다. 할당량 관리를 의식해야 한다는 점은 아쉬운 부분입니다.
구글 계정으로 로그인하는 무료 사용자라면, 일단 간단한 프로젝트에서 Plan 모드 흐름을 직접 경험해보는 걸 권합니다. 복잡한 리팩터링이나 마이그레이션 작업처럼 설계가 중요한 상황에서 구독 비용 대비 가치가 나오는지 판단하는 게 순서입니다.
본 포스팅 참고 자료
- 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/ - GitHub gemini-cli Discussions #22978 — v0.33.0 Weekly Update
https://github.com/google-gemini/gemini-cli/discussions/22078 - GitHub gemini-cli Discussions #22970 — Service update: mitigating abuse
https://github.com/google-gemini/gemini-cli - DevOps.com — Gemini CLI Plan Mode Separates Thinking From Doing (2026.03.16)
https://devops.com/gemini-cli-plan-mode-separates-thinking-from-doing-and-makes-read-only-the-default/
본 포스팅은 2026년 03월 27일 기준으로 작성됐습니다. Gemini CLI는 오픈소스 프로젝트로 업데이트가 빠르게 이루어지며, 본 포스팅 작성 이후 서비스 정책·UI·기능·요금 체계가 변경될 수 있습니다. 최신 내용은 공식 문서(geminicli.com/docs)에서 직접 확인하세요.
댓글 남기기