Plan 모드가 드디어 생겼습니다 — 뒤늦은 이유가 있습니다

결론부터 말씀드리면, Gemini CLI의 Plan 모드는 Claude Code에 이미 있던 기능을 구글이 뒤늦게 따라잡은 겁니다. 2025년 11월에 “Gemini CLI엔 Plan 모드가 없는 게 이상하다”고 지적한 개발자 리뷰가 공개됐고(출처: Kevin Simper, 2025.11.27), 그로부터 약 3개월 반 뒤인 2026년 3월 11일에야 공식 출시됐습니다(출처: Google Developers Blog, 2026.03.11).

그렇다고 단순히 복사해온 기능은 아닙니다. 구글이 Plan 모드를 출시하면서 가장 공을 들인 부분은 확장성(Extensibility)입니다. `enter_plan_mode`, `exit_plan_mode` 두 가지 도구를 공개 API로 노출해서, 다른 개발자가 자신만의 플래닝 워크플로를 직접 올려 쓸 수 있게 만들었습니다. Conductor 같은 확장 툴이 이 구조를 바로 활용하고 있습니다(출처: Gemini CLI 공식 문서, geminicli.com/docs/cli/plan-mode).

핵심은 읽기 전용(read-only) 환경입니다. Plan 모드가 활성화된 동안 AI는 코드베이스를 탐색하고 패턴을 검색하고 문서를 읽을 수 있지만, 내부 플랜 파일을 제외한 어떤 파일도 수정할 수 없습니다. 실수로 코드가 바뀌는 걸 구조적으로 막는 방식입니다.

▲ 목차로 돌아가기

Plan 모드 진입 방법 3가지와 기본 흐름

Plan 모드로 들어가는 방법은 세 가지입니다. 첫째, 터미널 입력창에 /plan을 직접 치는 방식이 가장 직관적입니다. 둘째, Shift+Tab을 누르면 Default → Auto-Edit → Plan 순서로 모드가 순환됩니다. 셋째, “이 기능 구현 계획 세워줘”처럼 자연어로 요청해도 AI가 enter_plan_mode 도구를 스스로 호출해 진입합니다(출처: Gemini CLI 공식 문서, geminicli.com/docs/cli/plan-mode).

진입 이후 흐름은 이렇습니다. 목표를 설명하면 AI가 코드베이스를 읽기 전용으로 탐색하고, 필요하면 `ask_user` 도구로 질문을 던집니다. 애매한 부분을 직접 물어보는 방식이라 “AI가 알아서 추측해서 구현하다가 방향이 틀리는” 상황을 줄여줍니다. 탐색이 끝나면 Markdown 파일 형태의 구현 계획을 생성하고, 승인 여부를 묻습니다.

계획 파일은 기본적으로 ~/.gemini/tmp/<project>/<session-id>/plans/에 저장됩니다. Ctrl+X를 누르면 설정된 외부 에디터(VS Code, Vim 등)로 바로 열 수 있고, 거기서 직접 수정하거나 코멘트를 달면 AI가 그 내용을 반영해 계획을 다듬습니다. 세션 데이터와 플랜 파일은 기본 30일 보관 후 자동 삭제됩니다(출처: Gemini CLI 공식 문서).

▲ 목차로 돌아가기

계획 단계에서 Pro 모델이 자동으로 붙는 이유

Plan 모드에는 ‘자동 모델 라우팅’ 기능이 들어가 있습니다. Auto 모델 설정 상태에서 Plan 모드를 쓰면, 계획 단계에서는 Gemini 3.1 Pro 같은 고추론 Pro 모델이 자동으로 배정되고, 계획을 승인해 구현 단계로 넘어가면 고속 Flash 모델로 자동 전환됩니다(출처: Gemini CLI 공식 문서, geminicli.com/docs/cli/plan-mode/#automatic-model-routing).

이게 왜 중요하냐면, 아키텍처 설계나 복잡한 리팩토링 계획처럼 깊은 추론이 필요한 작업에서 Pro 모델을 쓰고, 단순 반복 구현 작업은 Flash로 처리해 속도와 비용을 동시에 잡겠다는 구조입니다. 사용자가 직접 모델을 바꿀 필요 없이 단계에 따라 알아서 최적의 모델이 배정됩니다. 이 동작을 끄고 싶다면 `settings.json`에 `”plan”: { “modelRouting”: false }`를 추가하면 됩니다.

▲ 목차로 돌아가기

API Key 무료 사용자는 이 장점이 빠집니다

바로 이 부분이 Plan 모드를 쓰기 전에 확인해야 하는 지점입니다. Gemini CLI에 접속하는 방식은 크게 세 가지인데, 접속 방식마다 사용할 수 있는 모델과 한도가 완전히 다릅니다(출처: Gemini CLI Quota and Pricing, geminicli.com/docs/resources/quota-and-pricing).

API Key로 접속 중인 사용자는 무료 티어에서 Flash 모델만 사용 가능합니다. Plan 모드에 들어가도 Pro 모델이 배정되지 않는다는 뜻입니다. Plan 모드의 가장 큰 이점인 “계획 단계에서 고추론 모델 사용”이 빠지는 겁니다. 쉽게 말해, Plan 모드가 켜지긴 하지만 모델 자체가 바뀌지 않으니 탐색의 깊이가 달라집니다.

Google 계정으로 로그인한 무료 사용자는 1일 1,000회, 분당 60회 한도 내에서 Auto 모델(Pro/Flash 자동 전환)을 그대로 씁니다. Plan 모드에서 Pro가 배정되고, 구현 단계에서 Flash로 전환되는 전체 흐름이 정상 동작합니다. 무료로 Plan 모드 장점을 온전히 쓰려면 Google 계정 직접 로그인 방식이 맞습니다.

▲ 목차로 돌아가기

MCP 제한 — Claude Code Plan 모드보다 더 엄격합니다

Reddit에서 실제 사용자들이 가장 많이 지적한 부분입니다. Plan 모드가 활성화된 상태에서 MCP(Model Context Protocol) 도구를 쓰려면 “읽기 전용 MCP 도구”만 허용됩니다. 예를 들어 GitHub 이슈를 읽거나 Postgres 스키마를 조회하는 건 되지만, 기본 설정에서는 사용자 확인(confirmation)을 거쳐야 합니다. 확인 없이 자동 실행하려면 별도로 policy 파일을 직접 작성해야 합니다(출처: Gemini CLI 공식 문서, geminicli.com/docs/cli/plan-mode/#tool-restrictions).

Claude Code Plan 모드와 비교하면 이 부분이 체감상 더 번거롭습니다. Reddit 사용자 germanheller는 “계획의 가치 절반은 외부 상태(로그, DB 스키마, API 응답)를 조회해서 계획에 반영하는 건데, MCP 제한이 이걸 막는 진짜 격차다”라고 정리했습니다(출처: r/GeminiCLI, 2026.03.11). 읽기 전용 MCP 도구를 자동 승인하려면 `~/.gemini/policies/mcp-read-only.toml` 파일을 직접 만들어 설정해야 합니다.

git 상태 확인 같은 명령도 기본 Plan 모드에서는 막혀 있습니다. `git status`, `git diff` 정도만 허용하려면 별도 policy TOML 파일을 작성해야 합니다. “안전이 기본값”인 설계인데, 실제 사용에서는 이 커스터마이징 과정이 하나의 진입장벽이 됩니다.

▲ 목차로 돌아가기

Plan 모드 끄는 방법과 써야 할 상황

Plan 모드는 기본값으로 활성화돼 있습니다. Shift+Tab 순환에 Plan이 포함된다는 뜻이고, 자연어로 “계획 세워줘”라고 해도 자동 진입됩니다. 쓰지 않으려면 `/settings`에서 “Plan”을 검색해 비활성화하면 됩니다. 이렇게 하면 Shift+Tab 순환에서 Plan이 빠지고, `enter_plan_mode` 도구 자체가 등록 해제됩니다(출처: Google Developers Blog, 2026.03.11).

Plan 모드가 실제로 유리한 상황은 명확합니다. 기존 레거시 코드베이스를 처음 건드릴 때, 데이터베이스 마이그레이션처럼 되돌리기 어려운 작업을 시작하기 전, 여러 파일에 걸친 아키텍처 변경 전처럼 AI가 맥락을 충분히 파악하고 방향을 잡아야 할 때 효과가 큽니다. 반대로 단일 파일의 간단한 수정이나 이미 명확한 작업은 Plan 모드 없이 바로 진행하는 게 더 빠릅니다.

직접 검증한 수치를 하나 제시하겠습니다. Gemini CLI 공식 문서에서 Auto 모드의 무료 사용 한도는 Google 계정 기준 1일 1,000회, 분당 60회로 명시돼 있습니다(출처: geminicli.com/docs/resources/quota-and-pricing). Plan 모드 한 세션에서 코드베이스 탐색, 질문-답변, 계획 생성까지 평균 20~40회 요청이 발생한다고 보면, 1일 기준 25~50회의 완전한 Plan 세션이 무료 한도 안에 들어옵니다. 일반 개발자가 하루 종일 Plan 모드만 돌리지 않는 이상 무료 한도가 실질적 제한이 되진 않습니다.

▲ 목차로 돌아가기

자주 묻는 것들 — Q&A 5가지

▲ 목차로 돌아가기

마치며 — 총평

Plan 모드 자체는 잘 만들어졌습니다. 읽기 전용 안전망, Pro 모델 자동 배정, `ask_user`를 통한 양방향 소통까지 설계 방향이 맞습니다. 구글이 처음부터 확장성을 염두에 두고 만들었다는 것도 보입니다.

다만 솔직히 말하면, Claude Code Plan 모드와의 격차는 아직 있습니다. 기본 MCP 제한이 더 엄격하고, 커스터마이징하려면 TOML 파일을 직접 작성해야 합니다. 써보기 전에 접속 방식을 먼저 확인하세요. API Key 무료 사용자라면 장점의 절반이 빠집니다. Google 계정 직접 로그인 방식이라면 1일 1,000회 한도 안에서 Plan 모드의 Pro 모델 혜택을 온전히 쓸 수 있습니다.

개인적으로 Plan 모드가 가장 빛나는 순간은 “어디서부터 건드려야 할지 모르는 낯선 코드베이스 앞에 섰을 때”라고 생각합니다. 거기서 계획 없이 바로 수정에 들어가면 AI도, 사람도 길을 잃습니다. Plan 모드는 그 상황에서 지도를 먼저 그리는 도구입니다.

본 포스팅 참고 자료

1. Google Developers Blog — Plan mode is now available in Gemini CLI (2026.03.11): developers.googleblog.com
2. Gemini CLI 공식 문서 — Plan Mode: geminicli.com/docs/cli/plan-mode
3. Gemini CLI 공식 문서 — Quota and Pricing: geminicli.com/docs/resources/quota-and-pricing
4. Reddit r/GeminiCLI — Plan mode is now available in Gemini CLI (2026.03.11): reddit.com/r/GeminiCLI
5. Kevin Simper — My experience using Claude Code vs Gemini CLI (2025.11.27): kevinsimper.dk