Gemini CLI Plan 모드, 켜두면 달라지는 것 3가지

2026년 3월 11일, 구글이 Gemini CLI에 Plan 모드를 정식 추가했습니다. 단순한 안전장치처럼 보이지만, 내부를 들여다보면 생각보다 설계가 치밀합니다. 공식 발표문과 실제 작동 구조를 같이 놓고 보니 기존 소개글에서 빠진 부분이 꽤 보였습니다.

Plan 모드가 생긴 이유 — Claude Code에는 이미 있었습니다

구글이 이번에 내놓은 Plan 모드는 단순히 기능 하나를 따라잡은 수준이 아닙니다. 읽기 전용 정책 엔진, MCP 연동, ask_user 도구, Conductor 확장까지 한꺼번에 묶어서 출시했습니다. 공식 발표문(2026.03.11, Google Developers Blog)에 따르면 Plan 모드는 기본값으로 활성화된 상태로 배포됐습니다. 설치 후 별도 설정 없이 바로 쓸 수 있습니다.

핵심은 이겁니다. Plan 모드가 왜 필요한가. AI 코딩 도구들이 가진 공통 위험은 “즉시 실행”입니다. 코드베이스를 이해하기 전에 파일을 수정하거나, 의존성 파악 없이 구조를 건드리는 사례가 실제로 보고됩니다. Plan 모드는 이 단계를 강제로 분리합니다. 먼저 읽고, 물어보고, 계획을 세운 다음에야 구현으로 넘어갑니다.

읽기 전용 설계, 허용되는 도구와 금지되는 도구

Plan 모드가 활성화되면 Gemini CLI가 사용할 수 있는 도구가 공식 문서 기준으로 아래와 같이 제한됩니다. (출처: geminicli.com/docs/cli/plan-mode, 2026.03)

쓰기 권한이 허용되는 건 딱 한 곳뿐입니다. ~/.gemini/tmp/<project>/<session-id>/plans/ 디렉토리 안의 .md 파일만 허용됩니다. 이 설계 덕분에 AI가 계획을 문서화하는 동작 자체는 가능하면서, 실제 프로젝트 파일에는 절대 손을 댈 수 없습니다.

계획 단계에서 Pro 모델로 바뀌는 이유

많은 분들이 Plan 모드를 “느리고 안전한 모드”로 이해합니다. 그런데 공식 문서를 보면 정반대의 설계 의도가 있습니다.

공식 발표문에는 이렇게 나옵니다. “Planning Phase에서 Gemini CLI는 고추론 Pro 모델을 사용해 견고한 아키텍처 결정과 고품질 계획을 보장한다. 계획이 승인되고 Plan 모드를 종료하면, 고속 Flash 모델로 자동 전환한다.” (출처: developers.googleblog.com/plan-mode-now-available-in-gemini-cli, 2026.03.11) 계획할 때가 구현할 때보다 더 무거운 모델을 씁니다.

이게 중요한 이유는 이렇습니다. Auto 라우팅 설정에서 단순한 프롬프트는 자동으로 Flash로 처리됩니다. 그런데 Plan 모드로 진입하면 그 프롬프트의 복잡도와 무관하게 Pro가 먼저 붙습니다. 무료 사용자도 Plan 모드 안에서는 Pro 추론 결과를 받습니다. 단, 무료 한도를 소진하면 Gemini 2.5 Pro로 떨어지고, 이후엔 Flash로 내려갑니다.

쓰는 법은 간단하지만 이 조건에선 진입 자체가 안 됩니다

Plan 모드 진입 방법은 세 가지입니다. 어떤 방식이든 결과는 같습니다.

처음부터 Plan 모드로 시작하려면 gemini --approval-mode=plan으로 실행하거나, /settings에서 Default Approval Mode를 Plan으로 설정하면 됩니다. 세션마다 수동으로 진입할 필요가 없어집니다.

Claude Code와 실제로 다른 점

Plan 모드의 개념 자체는 Claude Code에서 먼저 등장했습니다. 두 툴 모두 Shift+Tab으로 진입한다는 것도 같습니다. 그런데 실제 작동 방식은 다릅니다.

Composio의 실측 비교(2025.07)에서 Claude Code는 같은 프로젝트를 1시간 17분에 완료했고, Gemini CLI는 2시간 2분이 걸렸습니다. 45분 차이입니다. Plan 모드가 생겼다고 이 속도 차이가 사라지진 않습니다. (출처: composio.dev/content/gemini-cli-vs-claude-code-the-better-coding-agent, 2025.07.02) 속도가 필요한 상황이라면 여전히 Claude Code가 유리합니다.

반면 Gemini CLI는 정책 파일을 직접 수정해서 Plan 모드의 허용 범위를 세밀하게 제어할 수 있습니다. 예를 들어 git status, git diff는 기본 차단 도구지만, ~/.gemini/policies/git-research.toml을 만들면 Plan 모드 안에서도 허용할 수 있습니다. 이 수준의 커스터마이징은 Claude Code에서는 제공하지 않는 영역입니다.

무료 사용자에게 실제로 어떤 의미인가

Plan 모드 안에서 모델 순서는 이렇습니다. 먼저 Gemini 3.1 Pro(혹은 3 Pro)가 붙고, 이 한도를 다 쓰면 Gemini 2.5 Pro로 내려가고, 이마저 소진되면 Gemini 2.5 Flash로 전환됩니다. 공식 문서에는 각 단계에서 Gemini CLI가 직접 알림을 줍니다. (출처: geminicli.com/docs/get-started/gemini-3, 2026.03) 사용자가 모른 채 하위 모델로 바뀌는 상황은 원천적으로 막아 놨습니다.

Plan 모드의 계획 파일은 기본적으로 30일간 보관됩니다. /settings에서 Session Retention을 조정하면 보관 기간을 바꿀 수 있고, gemini --delete-session <index>로 수동 삭제도 됩니다. 단, 커스텀 plans 디렉토리를 지정한 경우 자동 삭제가 안 되므로 직접 관리해야 합니다. (출처: geminicli.com/docs/cli/plan-mode, 2026.03)

Q&A

마치며 — 총평

개인적으로 가장 실용적으로 느낀 부분은 모델 라우팅 구조입니다. 계획 단계에는 Pro, 구현 단계에는 Flash. 무료 사용자도 계획할 때만큼은 Pro 품질을 받습니다. 아이디어는 좋지만, 무료 한도가 생각보다 빠르게 소진된다는 점은 솔직히 아쉽습니다.

한 가지 더. YOLO 모드 중에는 Plan 모드 진입이 막힌다는 점을 모르고 쓰다가 당황하는 경우가 생길 수 있습니다. 자동화 스크립트를 짜기 전에 이 부분은 먼저 확인해 두는 게 좋습니다.

본 포스팅 참고 자료

1. Plan mode is now available in Gemini CLI —
   developers.googleblog.com
   (2026.03.11)
2. Plan Mode 공식 문서 — Gemini CLI Docs —
   geminicli.com/docs/cli/plan-mode
   (2026.03)
3. geminicli.com/docs/get-started/gemini-3
   (2026.03)
4. Claude Code vs Gemini CLI (Jan 2026) — Shipyard —
   shipyard.build/blog
   (2026.01.15)
5. codelabs.developers.google.com