① Gemini CLI Plan 모드란 무엇인가?

Gemini CLI Plan 모드는 2026년 3월 11일 구글이 공식 블로그를 통해 발표한,
터미널 기반 AI 코딩 도구 Gemini CLI의 최신 기능입니다. 한마디로 정의하면,
AI가 코드를 수정하기 전에 반드시 ‘읽기 전용 분석 → 계획서 작성 → 사용자 승인’
순서를 거치도록 강제하는 안전 모드입니다.

기존 Gemini CLI는 사용자의 명령을 받으면 즉시 파일을 수정하거나 명령을 실행하는 방식으로
동작했습니다. 속도는 빠르지만, AI가 코드베이스를 충분히 파악하지 못한 상태에서 덤벼들어
엉뚱한 파일을 고치거나 의존성 충돌을 일으키는 사례가 빈번했습니다. Plan 모드는 이 문제를
구조적으로 차단합니다.

이 기능은 기본값으로 모든 사용자에게 활성화되어 있습니다. 터미널에서 /plan을
입력하거나, Shift+Tab으로 모드를 순환하거나, 자연어로
“이 기능을 추가할 계획을 세워줘”라고 말하는 것만으로 즉시 진입할 수 있습니다.

▲ 목차로 돌아가기

② “바로 실행”의 진짜 문제 — 기술 부채가 쌓이는 구조

“AI한테 시키면 알아서 잘 짜주겠지”라는 생각은 절반만 맞습니다. GPT-5.4든 Gemini 3.1이든,
대규모 코드베이스의 맥락을 충분히 파악하지 못한 AI가 즉각적으로 코드를 수정하면
반드시 부작용이 발생합니다. 특히 실무 프로젝트에서 이 문제는 치명적입니다.

AI가 “바로 실행”할 때 생기는 3가지 실수 패턴

1의존성 충돌 무시:
AI가 특정 라이브러리의 최신 버전을 설치하면서, 기존 패키지와의 호환성을 확인하지 않아
빌드가 깨지는 경우가 가장 흔합니다. 이를 발견하고 롤백하는 데만 수 시간이 걸리기도 합니다.

2중복 구현 생성:
이미 프로젝트 내에 같은 기능을 하는 헬퍼 함수나 유틸리티가 존재하는데도, AI가
코드베이스 전체를 살펴보지 않고 새로운 함수를 또 만들어 코드가 비대해지는 경우입니다.

3아키텍처 방향 오해:
“로그인 기능 추가해줘”라는 명령 하나에 AI가 프로젝트의 인증 구조를 이해하지 못하고
새로운 auth 시스템을 처음부터 구현해버리는 경우, 수정 비용이 새로 짜는 것보다 커집니다.

Plan 모드는 이 세 가지 문제를 모두 구조적으로 차단합니다. AI가 먼저 전체 코드베이스를 읽고,
의존성을 파악하며, 중복 코드 여부를 검토한 뒤, Markdown 계획서를 작성해 사용자에게 보여줍니다.
사용자가 “좋아, 이대로 진행해”라고 승인하는 순간 비로소 코드 수정이 시작됩니다.

▲ 목차로 돌아가기

③ Plan 모드 3단계 실전 워크플로우

실전에서 어떻게 흘러가는지 단계별로 살펴보겠습니다.

STEP 1 — 목표 입력과 탐색

터미널에서 /plan을 입력하거나, 자연어로 “이 데이터베이스를 PostgreSQL로
마이그레이션하는 계획을 세워줘”라고 말하면 Plan 모드가 시작됩니다. 이 시점부터 AI는
읽기 전용 도구만을 사용해 프로젝트를 탐색합니다. 현재 데이터베이스 스키마, ORM 설정 파일,
의존성 목록, 기존 마이그레이션 히스토리를 순서대로 분석합니다.

STEP 2 — ask_user 도구로 대화하며 계획 정교화

Plan 모드의 핵심 신기능 중 하나는 ask_user 도구입니다. AI가 분석 중
불확실한 부분이 생기면 사용자에게 질문을 던집니다. 예를 들어, “기존 데이터를 보존하면서
마이그레이션할까요, 아니면 새 스키마로 완전히 재구성할까요?”처럼 중요한 아키텍처 결정을
사용자와 함께 협의합니다. 추측하지 않고 물어보는 것, 이것이 Plan 모드가 다른 점입니다.

STEP 3 — Markdown 계획서 작성 → 승인 또는 수정

모든 분석이 끝나면 AI는 단계별 실행 계획서를 Markdown 파일로 작성합니다.
사용자는 Ctrl+X를 눌러 VS Code나 Vim 등 자신의 에디터에서 직접 계획서를
수정하거나 코멘트를 남길 수 있습니다. “여기서 기존 Logger 클래스를 써야 하지 않나?”처럼
인라인 피드백을 남기면, AI가 이를 반영해 계획을 다듬습니다. 최종 승인 시 Plan 모드에서
자동으로 빠져나와 코드 수정이 시작됩니다.

▲ 목차로 돌아가기

④ Plan 모드에서 사용 가능한 도구 전체 정리

Plan 모드가 “안전하다”는 주장의 근거는 허용 도구 목록에 있습니다. 구글은 정책 엔진(policy engine)을
통해 Plan 모드 시 사용 가능한 도구를 엄격하게 제한합니다. 아래 표가 전체 목록입니다.

주목할 점은 읽기 전용 MCP 도구까지 지원한다는 것입니다. 로컬 파일에만
국한되지 않고, GitHub 이슈를 읽어 요구사항을 파악하거나, PostgreSQL 스키마를 직접 조회해
마이그레이션 계획에 반영할 수 있습니다. 외부 시스템의 데이터를 안전하게 참조할 수 있는 구조입니다.

▲ 목차로 돌아가기

⑤ 무료 사용 조건 & 요금 한도 완벽 정리

모든 기능을 무료로 사용할 수 있으며, 요금이 발생하는 조건은 아래 표와 같습니다.

무료 플랜에서도 일일 1,000회라는 넉넉한 한도 덕분에, 개인 개발자가 하루 종일 작업해도
한도에 걸리는 경우는 드뭅니다. 단, Plan 모드에서 자동 모델 라우팅이 작동할 때
무료 계정은 Gemini 2.5 Pro가 배정되고, 유료 AI Pro 구독자는 더 강력한 Gemini 3.1 Pro가
배정된다는 차이가 있습니다.

▲ 목차로 돌아가기

⑥ Conductor 확장과 자동 모델 라우팅의 진짜 가치

Plan 모드를 단독으로 쓰는 것도 충분히 강력하지만, 구글은 여기서 한 발 더 나아갔습니다.
Conductor라는 확장 기능은 Plan 모드를 기반으로
‘컨텍스트 중심 개발(Context-Driven Development)’을 구현합니다.

Conductor가 하는 일

Conductor는 복잡한 개발 프로젝트를 여러 ‘트랙(track)’으로 나눠 관리합니다. 각 트랙마다
Plan 모드를 통해 사전 분석을 수행하고, ask_user로 핵심 결정을 확인하며,
conductor/ 디렉토리에 영속적인 아티팩트를 저장합니다. 대규모 마이그레이션이나
멀티스텝 피처 구현처럼 며칠에 걸쳐 진행되는 작업에서 특히 빛을 발합니다.

자동 모델 라우팅 — Plan 중엔 Pro, 구현 중엔 Flash

전환됩니다. 아키텍처 결정처럼 깊이 있는 사고가 필요한 구간에는 무거운 모델을 쓰는 것입니다.
계획이 승인되어 실제 구현 단계로 넘어가면, 자동으로 빠른 응답 속도의 Flash 모델로
전환됩니다. 사용자가 모델을 직접 골라야 하는 수고 없이 품질과 속도가 자동으로 최적화됩니다.

▲ 목차로 돌아가기

⑦ Plan 모드 활성화·비활성화 방법 (초보자 가이드)

Plan 모드는 이미 기본 활성화 상태이므로 별도 설정 없이 바로 쓸 수 있습니다.
아래 방법들은 모드 전환 및 설정 조정에 사용합니다.

Plan 모드 진입 방법 3가지

1명령어 입력:
터미널의 Gemini CLI 입력창에 /plan을 타이핑하면 즉시 Plan 모드로 전환됩니다.
가장 직관적인 방법입니다.

2키보드 단축키:
Shift+Tab을 누르면 Default → Auto-Edit → Plan 순서로 모드가 순환됩니다.
단, AI가 현재 작업을 처리 중이거나 확인 대화창이 열려 있을 때는 비활성화됩니다.

3자연어:
“이 기능 추가 계획부터 세워줘”, “start a plan for refactoring this module” 처럼
자연어로 말해도 AI가 자동으로 enter_plan_mode 도구를 호출해 Plan 모드로 진입합니다.

기본 시작 모드를 Plan으로 고정하기

항상 Plan 모드로 시작하고 싶다면 /settings를 열고
Default Approval Mode를 Plan으로 설정하면 됩니다.
또는 터미널에서 gemini --approval-mode=plan으로 1회성 Plan 시작도 가능합니다.

Plan 모드를 원치 않으면?

/settings에서 “Plan”으로 검색한 뒤 토글을 끄면 됩니다. 이렇게 하면
Shift+Tab 순환에서 Plan 모드가 제거되고, enter_plan_mode /
exit_plan_mode 도구 등록이 해제됩니다. 자신만의 플래닝 방식이 있는
숙련 개발자라면 이 설정이 더 쾌적할 수 있습니다.

▲ 목차로 돌아가기