🔥 3월 11일 공식 출시
Gemini CLI Plan 모드, 실제로 써보니
계획이 먼저였습니다
코드를 건드리기 전에 먼저 읽기만 한다는 개념, 당연한 것 같지만 기존 AI 터미널 도구들은 그냥 실행부터 했습니다. Gemini CLI v0.33.0에서 Plan 모드가 기본값으로 추가됐는데, 공식 문서와 실사용 피드백을 교차해서 살펴보니 생각보다 더 구체적인 맥락이 있었습니다.
Plan 모드가 생긴 이유 — 기존 문제가 뭐였나요?
솔직히 말하면, 2025년 6월 Gemini CLI 초기 버전에는 치명적인 불편함이 하나 있었습니다. 사용자가 “이 DB 마이그레이션 계획 세워줘”라고 입력하면, AI가 계획을 세우기도 전에 바로 파일을 수정하기 시작했습니다. LinkedIn의 한 리뷰는 당시를 이렇게 표현했습니다. “No opportunity to review plan before it went off to execute — Claude and (other tools) do this better.” 계획을 확인할 틈도 없이 실행이 먼저 이뤄졌다는 것입니다.
구글은 이 문제를 인지하고 2026년 2월 17일 v0.29.0에서 Plan 모드의 초기 버전을 preview로 도입했습니다. 그리고 2026년 3월 11일 v0.33.0에서 기본값(enabled by default)으로 전환했습니다. (출처: Gemini CLI 공식 changelog, geminicli.com/docs/changelogs/)
여기서 포인트는 “기본값”이라는 점입니다. 대부분의 AI 에이전트 도구들은 실행 우선이 기본값이고, 사용자가 직접 제한을 걸어야 합니다. Gemini CLI는 반대로 제한이 먼저입니다. 이것이 실제로 어떤 의미인지는 다음 섹션에서 구체적으로 살펴봅니다.
Plan 모드가 실제로 하는 일 (허용 툴 목록 포함)
Plan 모드는 한마디로 읽기 전용(read-only) 모드입니다. 활성화되면 AI는 코드베이스를 탐색하고, 패턴을 검색하고, 문서를 읽을 수 있지만, 파일을 수정하거나 코드를 실행하지 않습니다. 오직 ~/.gemini/tmp/ 경로에 있는 Markdown 계획 파일만 예외적으로 쓸 수 있습니다. (출처: 구글 공식 블로그, developers.googleblog.com/plan-mode-now-available-in-gemini-cli/)
💡 공식 발표문과 실제 제한 목록을 같이 놓고 보니 이런 차이가 보였습니다
Plan 모드에서 허용되는 도구는 정확히 아래와 같이 정해져 있습니다. “읽기 전용”이라고 통칭하지만, 실제로는 허용 목록이 세부적으로 열거돼 있어서 어떤 작업이 되고 안 되는지 명확히 파악할 수 있습니다.
| 카테고리 | 허용 툴 | 가능 여부 |
|---|---|---|
| 파일시스템 | read_file, list_directory, glob | 읽기 ✅ |
| 파일 수정 | write_file, replace | 계획 파일(.md)만 ⚠️ |
| 검색 | grep_search, google_web_search | 허용 ✅ |
| MCP 외부 도구 | github_read_issue, postgres_read_schema 등 | 읽기 전용만 ⚠️ |
| 셸 명령 실행 | run_shell_command | 기본 차단 ❌ |
※ 셸 명령은 정책 파일로 일부 허용 가능 (예: git status, git diff). 출처: geminicli.com/docs/cli/plan-mode#tool-restrictions
모델이 자동으로 바뀐다는 게 무슨 말인가요?
이게 Plan 모드에서 가장 흥미로운 부분입니다. 기대했던 것과 달랐습니다. Plan 모드가 단순히 “실행 금지”에 그치는 게 아니라, 모델 라우팅(Model Routing)과 연동됩니다.
💡 공식 문서와 실제 동작 흐름을 같이 보니 이런 구조가 보였습니다
같은 세션 안에서 단계에 따라 모델이 자동으로 교체됩니다. 계획 단계에서는 Gemini 3.1 Pro가 투입되고, 계획을 승인해서 구현 단계로 넘어가면 Gemini Flash로 전환됩니다. 무거운 추론이 필요한 시점에만 Pro를 씁니다.
구체적으로 보면 이렇습니다. auto model 설정을 쓰면 Plan 모드 진입 시 Gemini 3.1 Pro Preview로 라우팅되고, 계획 승인 후 구현 단계 전환 시 Flash 모델로 자동 전환됩니다. (출처: geminicli.com/docs/cli/plan-mode#automatic-model-routing)
이게 실질적으로 의미하는 바는 이렇습니다. 무료 티어에서 일일 1,000 요청이 주어지는데, 계획 수립처럼 정확도가 중요한 순간에는 Pro 모델을 쓰고, 반복적인 코드 구현에서는 Flash로 요청 소모를 아낀다는 뜻입니다. 손 안 대고 코 푸는 것처럼 비용·속도·정확도를 동시에 관리합니다. 이 자동 전환 기능은 settings.json에서 "modelRouting": false로 끌 수도 있습니다.
ask_user 도구 — 이게 핵심입니다
Plan 모드와 함께 새로 추가된 ask_user 도구가 있습니다. 생각보다 간단합니다. AI가 분석 도중 “이 부분은 어떻게 할까요?”라고 멈추고 사용자에게 질문을 던집니다.
기존 AI 코딩 도구의 가장 흔한 실패 패턴은 이렇습니다. AI가 의도를 추측해서 엉뚱한 방향으로 구현을 끝내놓습니다. ask_user 도구는 이 패턴을 정면으로 차단합니다. 숨겨진 설정 파일 위치를 물어보거나, 아키텍처 선택지 두 가지를 제시하고 어떤 방향을 원하는지 확인한 뒤 계획을 수립합니다. (출처: 구글 공식 블로그, developers.googleblog.com/plan-mode-now-available-in-gemini-cli/)
💡 이 기능이 추가된 배경을 changelog와 같이 보면 타이밍이 명확합니다
Conductor 익스텐션(2025년 12월 v0.22.0 추가)이 ask_user를 먼저 활용하다가, v0.33.0에서 Plan 모드의 핵심 도구로 정식 편입됐습니다. 즉, 커뮤니티 익스텐션이 입증한 방식이 공식 기능으로 흡수된 사례입니다.
Conductor 익스텐션을 설치하면 ask_user를 더 적극적으로 활용하는 워크플로우를 경험할 수 있습니다. 설치 명령은 gemini extensions install https://github.com/gemini-cli-extensions/conductor입니다.
막상 써보면 이 부분에서 멈춥니다
Reddit r/GeminiCLI와 r/ClaudeCode의 실사용자 피드백을 정리하면, Gemini CLI의 약점은 Plan 모드가 아닌 다른 곳에 있습니다. 이 부분이 좀 아쉬웠습니다.
⚠️ 실사용자 피드백 — 개선이 필요한 부분
- 파일 편집 루프 문제: 간혹 파일 수정이 반복 실패하면서 컨텍스트를 소진하는 사례가 보고됨 (출처: r/GeminiCLI, 2026.03.06)
- 대화 메모리 단절: 긴 세션에서 대화 초반 내용을 잊어버리는 경향 — 메모리 설정 별도 조정 필요
- 복잡한 코딩 작업: 단순 CRUD를 넘어서는 작업에서는 Claude Code 대비 정확도가 낮다는 평가 다수
- MCP 읽기 도구 승인: Plan 모드에서 외부 MCP 도구는 기본적으로 매번 사용자 승인 필요 — 정책 파일로 해제 가능하지만 초기 설정 필요
여기서 걸립니다. Plan 모드 자체는 잘 동작하지만, 계획 승인 후 구현 단계에서 파일 편집이 루프에 빠지면 Plan 모드의 장점이 희석됩니다. 특히 비표준 아키텍처나 이벤트 드리븐 시스템에서 빈도가 높다고 알려져 있습니다. (출처: r/GeminiCLI 커뮤니티 피드백, 2026.03 기준, 확인 필요)
Claude Code와 어떻게 다른가요?
결론부터 말씀드리면, Plan 모드 하나만 놓고 보면 Gemini CLI가 앞서 있습니다. Claude Code에도 계획 기능은 있지만, 기본값이 Plan 모드인 도구는 현재 Gemini CLI가 유일합니다. (출처: DevOps.com, 2026.03.16)
| 항목 | Gemini CLI | Claude Code |
|---|---|---|
| Plan 모드 기본값 | ✅ 기본 ON | 수동 설정 |
| 무료 티어 | 일 1,000 요청 | Pro $100/월 필요 |
| 복잡한 코딩 정확도 | 보통 | 높음 |
| 오픈소스 | ✅ GitHub 공개 | ❌ 비공개 |
| 모델 자동 라우팅 | Plan↔Flash 자동 전환 | 수동 선택 |
※ Claude Code 요금 정보 출처: Anthropic 공식 사이트 기준 / Gemini CLI 무료 한도 출처: geminicli.com/docs, 2026.03 기준. 서비스 정책은 변경될 수 있습니다.
💡 수치를 직접 따라해 볼 수 있는 비교
무료 티어에서 Gemini CLI Plan 모드를 쓰면 하루 1,000 요청 안에서 Gemini 3.1 Pro 추론이 포함됩니다. Claude Code를 같은 수준으로 쓰려면 월 $100 Pro 플랜이 필요합니다. 단순 비용만 보면 월간 약 $100의 차이, 즉 같은 작업에 대한 접근 비용이 100배 이상 차이납니다. 단, 코딩 정확도에서는 Claude Code가 여전히 앞선다는 평가가 다수입니다. (출처: r/ClaudeCode 비교 스레드, 2025.12 / Claude Code vs Gemini CLI, shipyard.build, 2026.01.15)
자주 묻는 것들
마치며
Gemini CLI Plan 모드는 “AI가 먼저 실행하고 나중에 물어보는” 구조를 뒤집어서, “먼저 읽고 물어보고 나서 실행”으로 바꿔놓습니다. 이것 자체가 기존 AI 터미널 도구들과의 차이를 만드는 지점입니다.
개인적인 의견을 덧붙이자면, Plan 모드의 진짜 가치는 모델 라우팅과의 조합에 있습니다. 계획 수립에 Pro, 구현에 Flash를 자동으로 배분하는 구조는 무료 사용자가 할당량을 오래 유지하면서도 중요한 순간에는 높은 추론 품질을 쓸 수 있게 해줍니다. 이건 단순한 기능 추가가 아니라 리소스 관리 방식 자체의 변화입니다.
단, 파일 편집 루프 문제와 복잡한 코딩에서의 정확도는 아직 과제로 남아 있습니다. DB 마이그레이션이나 대규모 리팩토링처럼 실수가 허용되지 않는 작업이라면, Plan 모드를 켜고 계획을 반드시 검토한 뒤 승인하는 습관이 중요합니다.
📚 본 포스팅 참고 자료
- 구글 공식 블로그 — 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 공식 Changelog
https://geminicli.com/docs/changelogs/ - 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/ - GitHub — Gemini CLI 공식 저장소
https://github.com/google-gemini/gemini-cli
※ 본 포스팅은 2026년 3월 17일, Gemini CLI v0.33.0 기준으로 작성됐습니다. 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. 모든 수치와 기능은 공식 문서를 기준으로 하며, 개인 사용 환경에 따라 경험이 다를 수 있습니다.
댓글 남기기