Plan 모드가 왜 이제서야 나왔는가

2025년 11월, AI 코딩 CLI 도구를 실제로 두 달 이상 써온 개발자 Kevin Simper는 비교 후기에서 이렇게 썼습니다. “Gemini CLI에 Plan 모드가 없다는 게 이상하다.” 당시 Claude Code는 이미 Shift+Tab 두 번으로 Plan 모드를 지원하고 있었고, Gemini CLI 사용자들은 코드를 직접 수정하기 전에 전략을 논의할 방법이 없었습니다.

이 공백이 3개월 뒤인 2026년 3월 11일 구글 공식 발표로 채워졌습니다. 구글 개발자 블로그는 “Plan 모드가 이제 Gemini CLI 전체 사용자에게 기본 활성화됐다”고 밝혔습니다. (출처: Google Developers Blog, 2026.03.11)

뒤늦게 따라간 것처럼 보이지만, 구글이 구현한 방식은 단순한 ‘따라 하기’가 아니었습니다. Claude Code의 Plan 모드가 토글 스위치에 가깝다면, Gemini CLI의 Plan 모드는 정책 엔진(Policy Engine)과 연동된 도구 제한 체계 위에 얹혀 있습니다.

Plan 모드는 정확히 무엇을 막고 무엇을 허용하는가

Plan 모드에서 Gemini CLI는 파일을 읽을 수 있지만 수정할 수 없습니다. 허용되는 도구 목록은 공식 문서에 명시돼 있습니다. 파일시스템은 read_file, list_directory, glob만 쓸 수 있고, 검색 계열인 grep_search와 웹 검색도 허용됩니다. MCP 도구는 읽기 전용만 됩니다. (출처: geminicli.com/docs/cli/plan-mode, 2026.03.11)

쓰기가 허용되는 건 딱 하나입니다. ~/.gemini/tmp/<project>/<session-id>/plans/ 경로에 있는 .md 파일, 즉 계획 문서 자체입니다. 코드베이스를 건드리지 않으면서 계획만 작성할 수 있는 구조입니다.

흥미로운 건 ask_user라는 새 도구입니다. Plan 모드에서 Gemini CLI가 먼저 질문을 던집니다. 기존 AI 코딩 도구들이 “일단 코드 짜고 보는” 방식이었다면, Plan 모드는 에이전트가 먼저 아키텍처 결정 사항을 확인한 뒤 계획서를 작성합니다.

기본값이 ON이라는 사실의 의미

구글 공식 발표문에는 이 문장이 명시돼 있습니다. “Plan mode is now enabled by default for all users.” (출처: Google Developers Blog, 2026.03.11) 설정을 켜지 않아도 이미 켜져 있다는 뜻입니다.

막상 확인해보면 다릅니다. Plan 모드가 기본 활성화됐다는 건, Shift+Tab을 누를 때 순환 목록에 Plan 모드가 포함돼 있다는 의미입니다. Gemini CLI를 실행하면 처음부터 Plan 모드로 시작하는 게 아니라, 기존의 Default 모드로 시작합니다. Plan 모드를 항상 처음부터 쓰고 싶다면 /settings에서 Default Approval Mode를 Plan으로 바꿔야 합니다. 또는 실행 시점에 gemini --approval-mode=plan을 입력해야 합니다.

Plan 모드를 아예 안 쓰고 싶다면 /settings에서 “Plan”을 검색해 토글을 끄면 됩니다. 그러면 Shift+Tab 순환에서 Plan 모드가 빠지고, enter_plan_mode와 exit_plan_mode 도구도 비활성화됩니다.

모델 자동 전환 — Pro로 올라가고 Flash로 내려온다

Plan 모드에서 가장 눈에 띄는 기술적 설계가 여기 있습니다. 공식 문서에는 이렇게 나옵니다. “Planning Phase: routes requests to a high-reasoning Pro model. Implementation Phase: automatically switches to a high-speed Flash model.” (출처: geminicli.com/docs/cli/plan-mode, 2026.03.11)

Plan 모드에서는 Gemini 3.1 Pro가 자동으로 붙고, 계획이 승인돼 구현 단계로 넘어가면 Gemini 3 Flash로 자동 다운그레이드됩니다. 이건 단순한 최적화가 아닙니다.

이 자동 라우팅은 "auto" 모델 설정을 쓸 때만 작동합니다. 특정 모델을 직접 고정하면 자동 전환이 꺼집니다. 끄고 싶다면 settings.json에서 "plan": { "modelRouting": false }로 설정하면 됩니다.

무료 티어에서 쓸 때 알아야 할 조건

Plan 모드는 무료 티어에서도 쓸 수 있습니다. 하지만 무료 티어에는 조건이 붙습니다. 구글 OAuth로 로그인하는 무료 사용자는 입출력 데이터 수집에 자동 동의됩니다. 개인 프로젝트라면 무방하지만, 회사 코드베이스에 Plan 모드를 쓰면 그 코드베이스 탐색 결과가 Google로 전송될 수 있습니다.

요청 한도는 Plan 모드 전용이 따로 있는 게 아닙니다. 일반 요청 한도와 공유됩니다. Plan 모드에서 코드베이스 분석을 여러 번 반복하면 일반 사용 한도가 같이 줄어듭니다. 무료 티어에서 대형 코드베이스를 Plan 모드로 깊게 탐색하면 하루 한도를 예상보다 빨리 소진할 수 있습니다.

Claude Code Plan 모드와 구조적으로 다른 부분

표면적으로 보면 두 도구의 Plan 모드는 비슷합니다. 코드 건드리기 전에 계획 먼저, 읽기 전용 탐색. 그런데 실제로 비교해보면 구현 방식이 다릅니다.

단, Gemini CLI의 약점도 그대로 남아 있습니다. 실사용 비교에서 반복적으로 언급된 문제입니다. “Claude Code는 오류 로그만 줘도 방향을 잡지만, Gemini는 정밀한 지시가 없으면 헤맨다.” (출처: shipyard.build/blog/claude-code-vs-gemini-cli, 2026.01.15) Plan 모드가 생긴다고 해서 기반 모델의 지시 따르기 능력 차이가 사라지진 않습니다.

자주 묻는 것들

마치며 — 쓸 만한 수준이 됐는가

솔직히 말하면, Gemini CLI는 Plan 모드가 없다는 이유만으로 Claude Code에 한 단계 밀렸습니다. 그 공백이 채워졌고, 계획 문서를 파일로 저장하고 외부 편집기에서 직접 수정할 수 있다는 점은 실제로 Claude Code가 못 하는 부분입니다.

다만 Plan 모드 하나가 모든 걸 바꾸진 않습니다. 지시가 애매할 때 방향을 스스로 잡아내는 능력은 여전히 Claude 쪽이 강하다는 평가가 실사용 비교에서 반복됩니다. 그리고 무료 티어의 데이터 수집 조건은 업무 환경에서 쓰기 전에 반드시 확인해야 할 부분입니다.

Plan 모드를 이유로 Gemini CLI를 포기하고 있었다면, 지금은 다시 써볼 시점입니다. 반대로 Claude Code로 이미 워크플로우를 다 잡은 상태라면, 계획 문서 공유와 팀 정책 통제가 필요한 상황이 아니라면 굳이 옮길 이유는 아직 크지 않습니다.

본 포스팅 참고 자료

1. Google Developers Blog — Plan mode now available in Gemini CLI (2026.03.11) developers.googleblog.com
2. Gemini CLI 공식 문서 — Plan Mode Reference geminicli.com/docs/cli/plan-mode
3. ADTmag — Google Adds “Plan Mode” to Gemini CLI (2026.03.12) adtmag.com
4. InfoWorld — Gemini CLI introduces plan mode (2026.03.11) infoworld.com
5. Shipyard — Claude Code vs Gemini CLI (2026.01.15) shipyard.build
6. Google Developers — Gemini Code Assist Quotas developers.google.com