v0.33.0 기준
IT/AI
Gemini CLI Plan 모드, 기본값인데 조심할 게 있습니다
3월 11일, Google이 Gemini CLI에 Plan 모드를 전체 사용자 기본값으로 활성화했습니다. “코드를 건드리기 전에 먼저 생각한다”는 아이디어는 단순해 보이지만, 막상 실제로 쓰다 보면 예상과 다른 지점이 두어 곳 나옵니다. 특히 무료 계정이라면 더 그렇습니다.
Plan 모드가 뭔지 한 줄로 정리하면
Gemini CLI Plan 모드는 “파일을 건드리기 전에 읽기만 하는 상태”입니다. 명령을 받으면 코드베이스를 탐색하고, 의존성을 파악하고, 전략을 수립한 다음 마크다운 플랜 파일을 작성합니다. 실제 코드 변경은 사용자가 승인해야만 시작됩니다.
Plan 모드에서 사용 가능한 툴은 읽기 전용으로 제한됩니다. 공식 문서에 딱 이렇게 나옵니다 — read_file, grep_search, glob 만 허용되고, 자체 플랜 파일 외에는 어떤 파일도 수정하지 못합니다. (출처: Google Developers Blog, 2026.03.11)
DB 마이그레이션처럼 실수 한 번이 치명적인 작업에서 “일단 실행부터”가 아니라 “먼저 지도를 그리고”라는 접근으로 시작하게 됩니다.
기본값이라는 게 실제로 어떤 의미인지
v0.33.0부터 Plan 모드는 모든 사용자에게 기본값으로 활성화됐습니다. 별도 설정 없이 Gemini CLI를 실행하면 Shift+Tab 순환 목록에 Plan 모드가 포함돼 있고, /plan을 입력하면 즉시 진입합니다.
💡 여기서 많은 사람들이 놓치는 부분이 있습니다
“기본값으로 켜져 있다”는 게 곧 “자동으로 더 좋은 모델을 쓴다”는 의미는 아닙니다. Plan 모드가 Gemini 3.1 Pro를 자동 라우팅하는 건 맞지만, 그게 실제로 작동하려면 유료 구독이 필요합니다. 무료 계정에서는 Flash 모델 한도 안에서 돌아가고, Pro 모델 라우팅은 조용히 스킵됩니다. 이유는 아직 공식 문서에서 별도 설명을 하지 않았습니다.
비활성화하고 싶으면 /settings에서 “Plan”을 검색해 토글을 끄면 됩니다. 이 경우 Shift+Tab 순환 목록에서 제거되고 enter_plan_mode, exit_plan_mode 툴도 언등록됩니다. (출처: Google Developers Blog, 2026.03.11)
기존에 Auto-Edit 모드로만 작업하던 방식이 더 맞는다면 끄는 게 낫습니다. Plan 모드가 좋은 기능이라도 워크플로에 맞지 않으면 불필요한 대기 시간만 늘어납니다.
Pro 모델이 자동 투입된다고 했는데 — 정확한 조건
공식 발표문과 실제 사용 흐름을 같이 놓고 보면 이런 구조가 보입니다 — Plan 모드는 플래닝 단계에서 Gemini 3.1 Pro를 쓰고, 실행 단계에서는 더 빠른 Flash 모델로 전환합니다. “전략은 고성능, 실행은 고속”이라는 모델 라우팅 로직입니다.
🔍 이게 왜 중요한가
같은 Plan 모드를 써도 유료 구독자와 무료 사용자가 실제로 받는 서비스는 다릅니다. 유료(Google AI Pro ~$20/월)면 플래닝에 Gemini 3.1 Pro가 투입되지만, 무료 계정은 Flash 모델(일 1,000회 한도) 안에서 돌아갑니다. Plan 모드가 기본으로 켜져 있어도 무료 계정에서 복잡한 플래닝을 하면 Gemini 3.1 Pro 없이 돌아가는 셈입니다. (출처: Google Developers Blog, 2026.03.11 / DataCamp 비교 분석, 2026.03)
모델 라우팅 구조를 정리하면 아래와 같습니다.
| 단계 | 사용 모델 (유료) | 사용 모델 (무료) |
|---|---|---|
| 플래닝 (Plan 모드) | Gemini 3.1 Pro | Flash (3 Flash 계열) |
| 실행 (Edit 모드 전환 후) | Flash (빠른 모델) | Flash (동일) |
| 일일 무료 요청 한도 | 구독 한도 적용 | 약 1,000회/일 (Flash) |
이 구조 덕분에 Pro 구독 기준으로는 의도대로 돌아가지만, “무료인데 Plan 모드 써보니 별 차이 없다”는 후기가 나오는 배경이 됩니다.
토큰 소비가 많아지는 이유와 수치 비교
“Plan 모드가 실수를 줄여주니까 오히려 효율적이다”는 게 직관적인 예상입니다. 맞는 말인데, 비용 면에서는 다른 이야기가 됩니다.
⚠️ 실측 수치로 확인한 차이
DataCamp의 2026년 3월 비교 분석에서 동일한 작업 기준으로 Gemini CLI는 입력 토큰 약 432K를 소비한 반면 Claude Code는 약 261K를 소비했습니다. 약 66% 더 많이 쓴 셈입니다. (출처: DataCamp Blog “Gemini CLI vs. Claude Code”, 2026.03) Plan 모드가 먼저 탐색하고 플랜을 짜는 구조라 그 자체로 추가 토큰이 발생합니다.
이 수치가 말하는 건 Plan 모드를 쓸수록 무료 한도가 더 빨리 소진된다는 것입니다. 무료 계정에서 하루 1,000회 요청 한도가 있는데, Plan 모드가 켜진 상태로 복잡한 작업을 하면 Flash 요청이 훨씬 빠르게 줄어들 수 있습니다.
직접 확인하는 방법은 간단합니다 — Gemini CLI 화면 상단에 현재 컨텍스트 사용량이 표시됩니다. v0.33.0부터 남은 양이 아닌 소비된 양 기준으로 표시되도록 UI가 바뀌었습니다. (출처: GitHub Changelog v0.33.0, 2026.03.11) 소비 추이를 보면서 Plan 모드 사용 여부를 판단하는 게 좋습니다.
ask_user 툴이 바꾸는 것
Plan 모드와 함께 ask_user 툴이 새로 들어왔습니다. 말 그대로 AI가 먼저 질문을 던지는 기능인데, 이게 기존 AI 코딩 에이전트와 다른 지점입니다.
💡 에이전트가 먼저 말을 거는 방향으로 구조가 바뀌고 있습니다
지금까지 AI 코딩 에이전트는 프롬프트를 받으면 “알아서 추론하고 실행”하는 방식이었습니다. 잘못된 방향으로 달려갔다가 한참 후에야 수정하는 일이 자주 생겼습니다. ask_user는 탐색 중간에 에이전트가 멈추고 “이 설정 파일 위치가 어디입니까?” 또는 “A 방식과 B 방식 중 어느 쪽으로 갈까요?”를 먼저 물어봅니다. 엉뚱한 방향으로 플랜을 완성한 뒤 다시 짜는 비용보다 낫습니다.
실제로 DevOps.com 분석에서 “AI가 추측한 것을 구현하는 방식에서 AI가 확인한 것을 구현하는 방식으로 전환”이라고 표현했습니다. (출처: DevOps.com “Gemini CLI Plan Mode Separates Thinking From Doing”, 2026.03.16)
단, ask_user가 많이 뜰수록 사람이 계속 옆에 있어야 한다는 뜻이기도 합니다. 자리를 비운 채 자동화 작업을 돌리려면 미리 충분한 컨텍스트를 제공해두거나, GEMINI.md 파일에 자주 묻는 사항을 정리해두는 게 낫습니다.
Claude Code Plan 모드와 어디서 다른지
Claude Code에도 Plan 모드가 있습니다. 진입 방식도 /plan 또는 Shift+Tab으로 같습니다. 그런데 설계 철학과 실제 작동에서 갈리는 부분이 있습니다.
| 항목 | Gemini CLI (v0.33.0) | Claude Code (2026.03) |
|---|---|---|
| 기본값 여부 | ✅ 기본 활성화 | 수동 설정 필요 |
| 플래닝 모델 | Gemini 3.1 Pro 자동 라우팅 (유료) | Haiku Explore 서브에이전트 |
| 외부 컨텍스트 | 읽기 전용 MCP 지원 (GitHub, DB 등) | 로컬 파일 기반 |
| 플랜 파일 편집 | /plan copy로 클립보드 복사 가능 | Ctrl+G로 기본 에디터에서 직접 편집 |
| 무료 사용 여부 | 무료 계정 가능 (Flash 한도 내) | 없음 (최소 $20/월) |
| SWE-bench 점수 | Gemini 3.1 Pro 약 80.6% | Claude Opus 4.6 약 80.8% |
※ SWE-bench Verified 기준 (출처: DataCamp Blog, 2026.03) / 약 0.2%p 차이로 사실상 동등 수준
솔직히 말하면 Plan 모드 성능 자체로는 큰 차이가 없습니다. 차이는 생태계와 비용에서 납니다. Gemini CLI는 오픈소스(Apache 2.0)라 기업이 포크해 사용할 수 있고, 무료 티어가 있습니다. Claude Code는 독점 소프트웨어이고 무료 티어가 없습니다.
실제로 2026년 기준 많은 개발자들이 두 도구를 병행하는 방식을 씁니다 — Gemini CLI로 탐색하고 플랜을 짠 다음, 실제 구현은 Claude Code로 진행합니다. (출처: DataCamp Blog, 2026.03)
Q&A
마치며
Gemini CLI Plan 모드는 방향성이 맞습니다. “먼저 탐색하고, 질문하고, 승인 받고, 그다음 실행”이라는 흐름은 AI 코딩 에이전트가 점점 더 복잡한 작업을 맡게 될수록 필요한 구조입니다. 기업 환경에서도 이 플로우가 있어야 감사(audit)와 승인(approval) 요건을 맞출 수 있다는 분석도 나왔고요. (출처: The Futurum Group 분석, DevOps.com, 2026.03.16)
다만 기본값으로 켜졌다는 이유로 무조건 좋다고 받아들이면 곤란한 상황도 있습니다. 무료 계정에서 토큰 소비가 기대보다 빠르게 늘거나, Pro 모델 라우팅이 실제로 작동하지 않는 환경인데 기대하고 있는 경우가 그렇습니다.
Plan 모드는 간단한 작업보다 복잡한 리팩터링이나 DB 마이그레이션처럼 한 번 잘못되면 되돌리기 어려운 작업에서 진가를 발휘합니다. 간단한 스크립트 수정 한 줄에 Plan 모드를 쓰면 토큰만 더 씁니다. 작업 성격에 따라 켜고 끄는 습관이 생기면 충분합니다.
📌 본 포스팅 참고 자료
- Google Developers Blog — Plan mode is now available in Gemini CLI (2026.03.11)
- GitHub — Gemini CLI v0.33.0 Release Notes & Plan Mode Discussion
- DevOps.com — Gemini CLI Plan Mode Separates Thinking From Doing (2026.03.16)
- DataCamp — Gemini CLI vs. Claude Code: Differences and Use Cases (2026.03)
- ADTmag — Google Adds Plan Mode to Gemini CLI (2026.03.12)
※ 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. 본 포스팅은 Gemini CLI v0.33.0 기준(2026.03.11 출시)으로 작성됐으며, 이후 업데이트에 따라 내용이 달라질 수 있습니다. 가격 및 무료 한도는 Google AI 공식 페이지에서 최신 정보를 확인하시기 바랍니다.
댓글 남기기