Plan 모드가 생긴 배경 — AI 에이전트의 고질적 문제

Gemini CLI가 Plan 모드를 만든 이유는 단순합니다. AI 코딩 에이전트의 가장 흔한 실패 패턴이 “동의도 받지 않고 먼저 코드를 바꿔버리는 것”이었기 때문입니다. 에이전트가 개발자의 의도를 잘못 읽고 수십 개 파일을 수정한 뒤 “완료했습니다”라고 응답하는 상황, 한 번이라도 경험했다면 얼마나 당혹스러운지 압니다.

공식 발표문에 직접 나온 표현이 있습니다. “코드베이스를 탐색하고 의존성을 파악하되, 실수로 파일을 수정하거나 명령을 실행할 위험 없이 안전하게 수행한다”가 Plan 모드의 존재 이유입니다. (출처: Google Developers Blog, 2026.03.11) 즉, 실행보다 이해가 먼저라는 원칙을 코드로 강제한 것입니다.

DevOps.com의 분석에 따르면, 이 흐름은 비단 Gemini CLI만의 움직임이 아닙니다. Anthropic의 Code Review 에이전트, IronCurtain의 정책 엔진 등 2026년 초 AI 코딩 툴 업계 전반이 “실행 전 검증” 쪽으로 빠르게 기울고 있습니다. Plan 모드는 그 흐름 안에서 가장 먼저 기본값으로 탑재된 사례입니다.

▲ 목차로 돌아가기

Plan 모드의 핵심 구조 — 읽기 전용이 전부가 아닙니다

Plan 모드를 “그냥 읽기 전용”으로 이해하면 중요한 부분을 놓칩니다. 공식 문서에 나온 허용 도구 목록을 보면, 단순히 파일을 못 건드리는 게 아니라 꽤 정교한 범위 설계가 되어 있습니다.

허용 도구를 정리하면 이렇습니다. 읽기 파일시스템(read_file, list_directory, glob), 검색(grep_search, google_web_search), 리서치 서브에이전트(codebase_investigator), 그리고 사용자 질문 도구(ask_user)입니다. 외부 MCP 도구도 읽기 전용인 경우에만 허용됩니다. GitHub 이슈를 읽거나 Postgres 스키마를 확인하는 건 됩니다. 수정은 안 됩니다.

ask_user 도구가 새로 추가된 게 작은 것 같아도 실제로 꽤 큰 변화입니다. 기존에는 에이전트가 요청을 임의로 해석해서 진행하다가 엉뚱한 방향으로 가는 경우가 많았는데, 이제 에이전트가 “이 아키텍처 결정에서 A안과 B안 중 어느 쪽을 선호하십니까?”라고 먼저 묻고 방향을 맞출 수 있습니다. 의도가 어긋난 채로 실행되는 실패 패턴을 구조적으로 줄인 셈입니다.

계획이 완성되면 Ctrl+X를 눌러 외부 에디터(VS Code, Vim 등)로 바로 열 수 있고, 계획서를 직접 수정하거나 인라인 코멘트를 남기면 Gemini CLI가 이를 자동으로 감지해서 전략을 다시 조율합니다. 채팅으로 설명하는 것보다 계획서를 직접 고치는 게 더 빠른 경우가 많습니다.

▲ 목차로 돌아가기

Pro 모델이 자동으로 붙는 이유 — 이 부분이 핵심입니다

공식 문서에 직접 나와 있는 내용인데, 많은 리뷰가 언급을 생략합니다. Plan 모드는 단순히 실행을 막는 게 아니라, 자동 모델 라우팅(Automatic Model Routing)을 통해 계획 단계에서는 고추론(Pro) 모델을 자동으로 사용합니다. 구체적으로는 Gemini 3.1 Pro가 라우팅됩니다. (출처: geminicli.com/docs/cli/plan-mode#automatic-model-routing)

이게 왜 중요하냐면, 아키텍처 결정의 품질이 달라지기 때문입니다. 동일한 요청에 Flash 모델이 계획을 세울 때와 Pro 모델이 계획을 세울 때의 결과물은 다릅니다. 특히 복잡한 데이터베이스 마이그레이션이나 멀티 서비스 간 인터페이스 설계처럼 맥락이 많이 필요한 작업에서 차이가 납니다.

이 자동 라우팅은 settings.json에서 "modelRouting": false로 끌 수 있습니다. 고정된 모델을 쓰고 싶거나 비용을 직접 통제하고 싶을 때 유용합니다. 단, 끄면 Plan 모드에서도 현재 세션 기본 모델이 그대로 적용됩니다.

▲ 목차로 돌아가기

3월 25일 이후 달라지는 것 — 무료 사용자에게 직접 영향

Plan 모드가 Pro 모델을 자동으로 쓴다는 사실과, 3월 25일부터 무료 티어에서 Pro 모델 접근이 막힌다는 사실을 연결해 보면 문제가 명확해집니다.

이게 Plan 모드에 실질적으로 어떤 영향을 미치냐면, 무료 사용자는 Plan 모드에서 자동 라우팅되는 Pro 모델을 쓸 수 없게 됩니다. 대신 Flash 모델로 계획이 수립됩니다. Flash도 충분히 쓸만하지만, 공식 문서가 “강력한 추론 Pro 모델을 써서 견고한 아키텍처 결정을 보장한다”라고 명시한 Plan 모드의 핵심 강점은 유료 구독자에게 집중됩니다.

Reddit(r/Bard) 커뮤니티에서는 이 변경에 대해 “낮 시간 동안 열심히 써도 주간 한도가 바닥난다”는 불만도 나오고 있습니다. Ultra 구독자조차 집중 작업 2시간 만에 한도에 도달했다는 후기가 있습니다. Google이 공식적으로 이 문제에 대한 답변을 내놓지 않은 부분입니다.

정리하면 이렇습니다. Plan 모드 자체는 무료로 계속 쓸 수 있습니다. 하지만 Plan 모드의 실질적 강점인 “계획 단계 Pro 라우팅”은 3월 25일 이후 유료 구독(AI Pro 또는 API 유료 키)이 있어야 제대로 활용 가능합니다.

▲ 목차로 돌아가기

Claude Code·Codex CLI와 비교하면 어디가 다릅니까

세 툴을 나란히 놓으면 각각의 설계 철학 차이가 뚜렷합니다.

emergent.sh의 비교 분석에 따르면, 2026년 현재 세 툴의 능력 차이 자체는 줄어들었고 오히려 “어떤 작업에 어떤 툴을 쓰느냐”가 실질적인 차별점이 됐습니다. Plan 모드는 데이터베이스 마이그레이션, 대규모 리팩터링, 멀티 서비스 신기능 설계처럼 “잘못 건드리면 롤백이 힘든” 작업에서 가장 빛납니다.

반면 빠른 반복이 필요한 프로토타이핑이나 간단한 수정 작업에서는 Plan 모드가 오히려 느리게 느껴질 수 있습니다. Plan 모드를 기본값으로 끄는 설정(/settings에서 “Plan” 검색 후 토글 OFF)이 있는 이유가 여기 있습니다.

▲ 목차로 돌아가기

Plan 모드 실전 활용 — /plan 하나로 달라지는 흐름

실제로 써보면 진입 방식이 세 가지입니다. 터미널에서 /plan을 입력하거나, Shift+Tab으로 모드를 순환시키거나, 그냥 “이 기능의 구현 계획을 세워줘”라고 자연어로 말하면 됩니다. 세 방식 모두 같은 Plan 모드로 진입합니다.

CI/CD 파이프라인에서 비대화형으로 실행할 때는 gemini --approval-mode plan -p "텔레메트리 분석 후 개선안 제시" 형식으로 쓰면 됩니다. 이 경우 Plan 모드에서 승인 단계가 자동으로 처리되고, 구현 단계는 YOLO 모드(자동 수락)로 전환됩니다. CI 환경에서 인간 개입 없이 전체 흐름을 돌릴 때 쓰는 방식입니다.

Conductor 확장을 함께 쓰면 Plan 모드 종료 시점에 AfterTool 훅으로 계획서를 GCS(구글 클라우드 스토리지)에 자동 아카이빙할 수 있습니다. 공식 문서에 쉘 스크립트 예시까지 나와 있습니다. 감사(Audit) 요건이 있는 기업 환경에서 유용합니다.

▲ 목차로 돌아가기

Q&A 5가지

▲ 목차로 돌아가기

마치며 — 총평

Plan 모드는 “읽기 전용 안전장치”라는 설명만으로는 반만 설명됩니다. 진짜 핵심은 계획 단계에 Pro 모델을 자동으로 쓰고, 구현 단계에선 Flash로 전환해서 품질과 속도를 동시에 잡는 구조입니다. 이 자동 라우팅이 기본값으로 켜져 있다는 게 다른 툴과의 실질적 차이입니다.

다만 3월 25일 무료 Pro 접근 제한이 이 강점을 희석시킵니다. 무료로 Plan 모드를 계속 쓸 수는 있지만, 공식 문서가 강조하는 “견고한 아키텍처 결정을 위한 Pro 라우팅”은 유료 구독 없이는 온전히 경험하기 어렵습니다. 개인 프로젝트에서 가끔 쓴다면 Flash로도 충분하지만, 팀 단위로 의존하는 상황이라면 이번 변경을 같이 검토해 두는 게 좋습니다.

Conductor가 내장 기능으로 통합되면 Plan 모드의 활용 범위가 한 단계 더 넓어질 것입니다. 지금은 그 준비 단계를 직접 경험할 수 있는 시점이기도 합니다.

▲ 목차로 돌아가기

📚 본 포스팅 참고 자료

1. Google Developers Blog — Plan mode is now available in Gemini CLI (2026.03.11) https://developers.googleblog.com/plan-mode-now-available-in-gemini-cli/
2. Gemini CLI 공식 문서 — Plan Mode https://geminicli.com/docs/cli/plan-mode/
3. Google Gemini API Pricing 공식 페이지 https://ai.google.dev/gemini-api/docs/pricing
4. DevOps.com — Gemini CLI Plan Mode Separates Thinking From Doing (2026.03.12) https://devops.com/gemini-cli-plan-mode-separates-thinking-from-doing-and-makes-read-only-the-default/
5. google-gemini/gemini-cli GitHub Discussions #22970 — Service update: mitigating abuse (2026.03.18) https://github.com/google-gemini/gemini-cli/discussions/22970