Plan 모드가 뭔지, 결론부터 말씀드리면

Gemini CLI v0.33.0부터 기본으로 켜지는 Plan 모드는 한마디로 “코드에 손대기 전에 먼저 읽기만 하는 단계”입니다. 파일을 수정하거나 명령을 실행하는 게 아니라, 코드베이스를 읽고, 구조를 파악하고, 어떻게 바꿀지 계획을 마크다운 파일로 작성한 뒤 사용자 승인을 기다립니다. (출처: Google Developers Blog, 2026.03.11)

기존 AI 코딩 에이전트들의 가장 큰 불안감 — “말도 안 하고 파일을 바꿔버리는 것” — 을 직접 겨냥한 설계입니다. Plan 모드에서 허용되는 도구는 read_file, grep_search, glob 등 읽기 전용만이고, 쓰기는 자체 플랜 디렉터리(`~/.gemini/tmp/…/plans/`)의 `.md` 파일에만 허용됩니다. (출처: geminicli.com/docs/cli/plan-mode)

진입 방법은 간단합니다. 터미널에서 /plan을 입력하거나, Shift+Tab으로 모드를 전환하거나, 그냥 “…에 대한 계획을 세워줘”라고 말하면 자동으로 Plan 모드로 진입합니다.

▲ 목차로 돌아가기

무료인데 Pro 모델이 붙는 구조

솔직히 처음엔 저도 “어차피 무료 플랜엔 Flash 모델만 붙겠지”라고 생각했습니다. 그런데 공식 발표문을 직접 확인해보니 달랐습니다.

이 구조가 실질적으로 뭘 의미하냐면, Google 계정으로 로그인한 무료 사용자도 Plan 단계에서는 Pro 수준의 추론을 쓸 수 있다는 겁니다. 기획은 고급 모델로, 실행은 빠른 모델로 — 비용과 품질을 동시에 잡으려는 의도가 보입니다.

단, 이 혜택은 Google 계정(Gemini Code Assist Individual)으로 로그인한 경우에만 해당합니다. API 키 인증 방식은 다릅니다. 이 부분은 다음 섹션에서 자세히 다룹니다.

▲ 목차로 돌아가기

3월 25일 이후 달라지는 조건

Plan 모드 출시(3월 11일)와 같은 달에 중요한 정책 변경이 겹쳤습니다. 3월 18일 Google이 공식 GitHub 토론에 올린 서비스 업데이트 공지 내용을 직접 확인했습니다.

“Model restrictions for free tier users: Starting March 25, 2026, Gemini Pro models will only be accessible via paid subscriptions. Free tier users will be limited to Gemini Flash models.” (출처: google-gemini/gemini-cli Discussion #22970, 2026.03.18)

이 공지가 가리키는 건 API 키 기반 무료 티어입니다. API 키로 접속하는 무료 사용자는 3월 25일부터 Flash 모델만 쓸 수 있습니다. Plan 모드의 Pro 모델 자동 라우팅도 이 경우엔 적용되지 않습니다.

인증 방식별 Plan 모드 조건 비교 (2026.03.25 기준)

※ 출처: geminicli.com/docs/resources/quota-and-pricing (2026.03.27 기준), google-gemini/gemini-cli Discussion #22970

결론적으로, Google 계정으로 로그인하면 무료로 Plan 모드의 Pro 라우팅까지 쓸 수 있습니다. 반면 API 키로 연결해서 쓰던 사람은 3월 25일 이후 실질적으로 Plan 모드의 핵심 장점이 사라집니다.

▲ 목차로 돌아가기

Claude Code와 직접 비교하면

Plan 모드 자체는 Gemini CLI만의 기능이 아닙니다. Claude Code도 Shift+Tab으로 Plan 모드를 쓸 수 있고, 플랜 파일을 Ctrl+G로 열어서 직접 편집하는 것도 됩니다. 구조 자체는 거의 같습니다.

가장 큰 차이는 비용과 접근성입니다. Gemini CLI는 Google 계정 로그인 기준 무료로 하루 1,000회까지 사용 가능합니다. Claude Code는 무료 티어가 없고 최소 $20/월(Pro 플랜)부터 시작합니다. (출처: datacamp.com, 2026.03.27)

※ 출처: datacamp.com/blog/gemini-cli-vs-claude-code (2026.03.27), geminicli.com/docs/resources/quota-and-pricing

▲ 목차로 돌아가기

무료인데 토큰을 더 쓰는 이유가 있습니다

무료 티어에서는 어차피 요금이 없으니 토큰 수가 무관합니다. 그런데 API 키로 Pay-as-you-go 방식을 쓴다면 얘기가 달라집니다. Gemini 3.1 Pro 기준 API 요금은 입력 토큰 100만 개당 $2, 출력 100만 개당 $12입니다. (출처: datacamp.com, 2026.03.27)

단순 계산으로 같은 작업에서 Gemini CLI는 입력 토큰만 Claude Code보다 약 171,000개 더 씁니다. 100만 개당 $2라면 이 차이는 작업당 약 $0.34, 하루 수백 건 작업을 처리하는 팀에선 무시할 수 없는 차이가 됩니다.

다만 이 수치는 API 키 유료 사용 기준입니다. Google 계정 로그인 방식으로 하루 1,000회 무료 한도 안에서 쓴다면 토큰 비용은 관계없습니다. 어떤 방식으로 쓰느냐에 따라 비용 구조가 완전히 달라집니다.

▲ 목차로 돌아가기

Plan 모드 실전 사용 흐름

공식 문서를 기반으로 실제 작업 흐름을 단계별로 정리합니다. (출처: geminicli.com/docs/cli/plan-mode)

1. 진입: /plan 입력 또는 Shift+Tab으로 모드 전환
2. 탐색: Gemini CLI가 코드베이스를 읽기 전용으로 분석. 이 단계에서 Gemini 3.1 Pro 자동 라우팅
3. 질문: ask_user 도구로 아키텍처 선택지 제시 또는 추가 정보 요청
4. 계획서 작성: 마크다운 파일로 구현 계획 생성 (Ctrl+X로 외부 에디터에서 직접 편집 가능)
5. 승인: “Yes, automatically accept edits” 또는 “Yes, manually accept edits” 선택
6. 구현: Plan 모드 종료 후 Flash 모델로 자동 전환해 구현 시작

ask_user 도구가 생긴 게 이번 업데이트의 핵심 중 하나입니다. 기존엔 AI가 알아서 판단하고 구현했다면, 이제는 “DB 마이그레이션 방식 A와 B 중 어느 쪽으로 할까요?”라고 중간에 멈추고 물어봅니다. 잘못된 가정으로 구현해버리는 가장 흔한 실패 패턴을 막기 위한 장치입니다.

외부 데이터 연동도 됩니다. Plan 모드에서는 읽기 전용 MCP 도구를 쓸 수 있어서, GitHub 이슈, Postgres 스키마, Google Docs 같은 외부 소스에서 컨텍스트를 가져오면서도 코드베이스엔 손대지 않습니다.

▲ 목차로 돌아가기

이 조합이 아니면 쓸 이유가 줄어듭니다

Gemini CLI가 Claude Code보다 분명히 나은 상황도 있습니다. 우선 무료로 시작하고 싶을 때, Google Cloud나 Workspace 서비스와 연동이 필요할 때, 오픈소스 코드를 직접 보거나 포크하고 싶을 때입니다. 멀티모달 입력(이미지, PDF, 오디오)도 Gemini CLI가 지원하고 Claude Code는 현재 지원하지 않습니다.

반면 기존 코드베이스의 대규모 리팩토링이나 다중 파일 작업에서는 아직 Claude Code가 안정적이라는 커뮤니티 보고가 많습니다. Composio 비교 테스트에서 Claude Code는 같은 CLI 도구 빌드를 1시간 17분에 완료한 반면, Gemini CLI는 2시간 2분이 걸렸습니다. (출처: datacamp.com, 2026.03.27) 재시도 횟수도 Claude Code 쪽이 적었습니다.

Plan 모드를 기본으로 켜둔 건 방어적 관점에서 좋은 선택입니다. 데이터베이스 마이그레이션이나 대형 리팩토링처럼 되돌리기 어려운 작업 전에 20분 계획 단계를 거치는 게 리스크 관리 측면에서 훨씬 낫습니다. The Futurum Group 측도 “Plan 모드 같은 실행 전 검토 단계는 엔터프라이즈 채택의 기준선이 될 것”이라고 밝혔습니다. (출처: devops.com, 2026.03.16)

▲ 목차로 돌아가기

자주 나오는 질문 5개

▲ 목차로 돌아가기

마치며

Gemini CLI Plan 모드는 말 그대로 “먼저 생각하고 나중에 손댄다”는 원칙을 기술적으로 구현한 기능입니다. 오픈소스, 무료, Pro 모델 자동 라우팅까지 — 종이 위 스펙만 보면 매우 경쟁력 있습니다.

다만 3월 25일 이후 인증 방식에 따라 조건이 다르고, 복잡한 다중 파일 작업에서의 안정성은 아직 Claude Code에 밀리는 커뮤니티 보고가 많습니다. 처음 시작하거나 Google Cloud 워크플로우가 중심이라면 Gemini CLI + Plan 모드 조합이 충분히 써볼 만합니다. 대규모 코드베이스 리팩토링처럼 정확성이 핵심인 작업이라면 아직은 두 도구를 병행하는 게 현실적인 선택입니다.

업데이트 속도가 빠른 영역이라 두 달 뒤엔 상황이 달라져 있을 수도 있습니다. 공식 GitHub 저장소와 geminicli.com을 주기적으로 체크해두는 게 좋습니다.

▲ 목차로 돌아가기

📎 본 포스팅 참고 자료

1. Google Developers Blog — Plan mode now available in Gemini CLI (2026.03.11)
2. Gemini CLI 공식 문서 — Plan Mode (geminicli.com)
3. Gemini CLI 공식 문서 — Quotas and Pricing (geminicli.com)
4. google-gemini/gemini-cli Discussion #22970 — Service update (2026.03.18)
5. DataCamp — Gemini CLI vs. Claude Code: Differences and Use Cases (2026.03.27)
6. DevOps.com — Gemini CLI Plan Mode Separates Thinking From Doing (2026.03.16)