Gemini CLI Plan 모드 직접 써봤습니다 — 무료인데 이게 빠집니다

결론부터 말씀드리면, Plan 모드 자체는 꽤 잘 만들어진 기능입니다. 문제는 무료 구간에서 생각보다 빠르게 한도가 소진되고, 플랜 파일이 30일 뒤에 자동으로 사라진다는 점입니다. 이 두 가지를 모르면 쓰다가 당합니다.

Plan 모드가 뭔지, 왜 갑자기 기본값이 됐을까요

2026년 3월 11일, 구글 개발자 블로그를 통해 Gemini CLI에 Plan 모드가 공개됐습니다. 공식 발표 기준으로, Plan 모드는 Gemini CLI가 코드에 손을 대기 전에 먼저 읽기 전용 상태로 프로젝트를 탐색하고 구현 계획서를 만드는 기능입니다. (출처: Google Developers Blog, 2026.03.11)

핵심은 read-only 강제입니다. Plan 모드가 켜진 상태에서는 read_file, grep_search, glob 같은 읽기 도구만 허용됩니다. 파일을 쓸 수 있는 유일한 예외는 ~/.gemini/tmp/ 아래에 저장되는 플랜 파일뿐입니다. (출처: Gemini CLI 공식 문서 geminicli.com/docs/cli/plan-mode)

왜 기본값으로 풀렸냐 하면, 기존에 AI 코딩 도구들의 가장 큰 불만이 “물어보지도 않고 파일을 바꿔버린다”는 것이었기 때문입니다. 계획서를 먼저 보고 승인해야 실행이 시작되는 구조로 바꾼 거고, 이 점은 솔직히 꽤 합리적인 결정이었습니다.

▲ 목차로 돌아가기

실제로 어떻게 켜고 끄는 건가요

Plan 모드는 이미 모든 사용자에게 기본으로 활성화돼 있습니다. 별도 설정 없이 Gemini CLI를 실행하면 Plan 모드가 포함된 상태로 시작됩니다. 진입 방법은 세 가지입니다.

Plan 모드가 필요 없다면 끄는 것도 간단합니다. /settings에서 “Plan”을 검색한 뒤 토글을 끄면 됩니다. 그러면 Shift+Tab 순환에서도 제거되고, enter_plan_mode와 exit_plan_mode 도구도 등록 해제됩니다. (출처: Google Developers Blog, 2026.03.11)

기본 세션 시작부터 Plan 모드로 고정하고 싶다면 gemini --approval-mode=plan 옵션을 쓰거나, /settings에서 “Default Approval Mode”를 Plan으로 바꾸면 됩니다. 이후부터는 매 세션이 읽기 전용 탐색으로 시작됩니다.

▲ 목차로 돌아가기

Pro 모델 쓴다고 했는데, 돈은 얼마나 나가나요

많은 분들이 “Plan 모드에서 Gemini 3.1 Pro를 쓴다고 하니까 유료 아닌가?”라고 생각합니다. 막상 해보면 다릅니다. Google 계정으로 로그인한 경우 무료 한도 내에서는 Pro 모델도 요금이 발생하지 않습니다. 한도는 하루 1,000회 요청, 분당 60회 요청입니다. (출처: geminicli.com/docs/resources/quota-and-pricing)

이게 가능한 이유는 자동 모델 라우팅(Automatic Model Routing) 구조 때문입니다. GitHub 이슈 #19454(2026.02.18)에 따르면, Plan 모드에서는 자동으로 Pro 모델로 라우팅되어 고품질 계획을 수립하고, 계획이 승인되어 구현 단계로 넘어가는 순간 Flash 모델로 전환됩니다. 이 전환은 사용자가 설정하는 것이 아니라 시스템이 자동으로 처리합니다. (출처: GitHub google-gemini/gemini-cli issues/19454)

이것이 의미하는 바는 이렇습니다: 계획 단계에서는 품질을 위해 Pro를, 실행 단계에서는 속도를 위해 Flash를 쓰는 두 단계 전략이 자동으로 이뤄집니다. 무료 구간에서도 이 흐름이 동일하게 적용됩니다.

출처: geminicli.com/docs/resources/quota-and-pricing (2026.03 기준)

▲ 목차로 돌아가기

무료 1000회, 생각보다 금방 없어집니다

여기서 걸립니다. 하루 1,000회 요청이라고 하면 “하루에 1,000번 채팅하는 것”처럼 느껴지지만, Plan 모드에서는 그렇지 않습니다. Plan 모드가 코드베이스를 탐색하는 동안 read_file, grep_search, glob 같은 도구 호출이 각각 별도로 카운트됩니다.

이 추정이 맞다면, 1,000회 한도는 하루 7~18개 Plan 세션에서 소진됩니다. 하루 종일 적극적으로 사용하는 개발자라면 오전에 한도가 다 차는 경우도 발생할 수 있습니다. 이 부분은 확인 필요합니다.

더 중요한 것은 로그인 방식에 따른 한도 차이입니다. Google 계정으로 로그인하면 1,000회이지만, Gemini API Key로 로그인하면 250회이고 Flash 모델만 사용됩니다. 숫자만 보면 4배 차이지만, Plan 모드에서 Pro 모델 자동 라우팅이 불가능해진다는 점에서 사실상 Plan 모드의 핵심 기능을 제대로 못 쓰게 됩니다. (출처: geminicli.com/docs/resources/quota-and-pricing)

실시간으로 사용량을 확인하고 싶다면 /stats model 명령어를 치면 됩니다. 현재 세션의 토큰 사용량과 적용 중인 한도를 바로 볼 수 있습니다. 세션 종료 시에도 사용량 요약이 자동 출력됩니다.

▲ 목차로 돌아가기

플랜 파일이 사라진다는 게 무슨 말인가요

Plan 모드가 생성하는 플랜 파일은 기본적으로 ~/.gemini/tmp/<project>/<session-id>/plans/ 경로에 저장됩니다. 프로젝트 폴더 안이 아니라 홈 디렉토리 아래 임시 경로에 저장된다는 점이 핵심입니다. (출처: geminicli.com/docs/cli/plan-mode)

그리고 공식 문서에는 세션 데이터가 기본으로 30일 후 자동 삭제된다고 명시돼 있습니다. 오늘 팀원과 함께 작성한 구현 계획서가 한 달 뒤에 흔적 없이 사라진다는 의미입니다. 장기 프로젝트나 팀 협업에서 이 기본 설정을 그대로 쓰면 계획 문서가 유실될 수 있습니다.

이 문제를 해결하는 방법은 두 가지입니다. 첫째, settings.json에서 플랜 디렉토리를 프로젝트 루트 아래 커스텀 경로로 지정하는 것입니다. 예를 들어 .gemini/plans로 지정하면 Git으로 버전 관리가 가능합니다. 단, 이 경우 커스텀 경로에 대한 정책 파일(.toml)도 별도로 작성해야 합니다. 둘째, /settings에서 Session Retention 값을 직접 늘리는 것입니다.

▲ 목차로 돌아가기

Claude Code랑 비교해보면 어떤가요

AI 터미널 코딩 도구를 이미 쓰고 있다면 이 비교가 제일 궁금할 겁니다. 비용 관점에서 명확한 차이가 있습니다.

비용 면에서 Gemini CLI가 압도적으로 유리한 건 사실입니다. Claude Code Pro는 월 $20(약 2만9천원)부터 시작하는데, Gemini CLI는 구글 계정만 있으면 1,000회/일 무료로 쓸 수 있습니다. (출처: shipyard.build/blog/claude-code-vs-gemini-cli, 2026.01.15)

단, 복잡한 추론이 필요한 리팩토링이나 레거시 시스템 분석 작업에서는 Claude Code가 여전히 우위에 있다는 평가가 많습니다. Gemini CLI는 Google 생태계(Google Cloud, Firebase, BigQuery 등)와의 통합이 강점이고, Claude Code는 대규모 코드베이스에서의 이해력이 강점입니다.

이 부분은 개인적인 판단이 필요합니다. 팀 예산이 빠듯하거나 혼자 사이드 프로젝트를 진행하는 상황이라면 Gemini CLI Plan 모드가 충분히 실용적입니다. 다만 Plan 모드에서 쓰이는 요청 횟수가 생각보다 빠르게 소비된다는 점은 미리 알고 시작하는 게 낫습니다.

▲ 목차로 돌아가기

Q&A — 실제로 자주 막히는 질문들

▲ 목차로 돌아가기

마치며

Gemini CLI Plan 모드는 AI 코딩 도구의 고질적인 문제였던 “물어보지도 않고 파일을 바꿔버리는” 행동을 구조적으로 막은 기능입니다. 기술적으로도 Pro→Flash 자동 전환이라는 꽤 세련된 설계가 들어가 있습니다. 무료로 이 품질을 쓸 수 있다는 점은 분명히 인상적입니다.

다만 플랜 파일이 30일 뒤에 자동으로 사라지는 기본값, API Key 로그인 시 한도가 4분의 1로 줄어드는 구조, Plan 모드에서의 도구 호출이 요청 횟수에 합산된다는 점은 미리 알아두지 않으면 예상치 못한 상황으로 이어집니다. 이 세 가지만 알고 시작하면 충분히 실용적으로 쓸 수 있습니다.

팀 프로젝트에서 쓸 예정이라면 플랜 파일을 Git으로 관리하는 커스텀 경로 설정을 처음부터 해두는 것을 권합니다. 그냥 기본값으로 두면 나중에 찾을 수가 없습니다.

본 포스팅 참고 자료

1. Google Developers Blog — Plan mode now available in Gemini CLI
   https://developers.googleblog.com/plan-mode-now-available-in-gemini-cli/ (2026.03.11)
2. Gemini CLI 공식 문서 — Plan Mode
   https://geminicli.com/docs/cli/plan-mode/
3. Gemini CLI 공식 문서 — Quotas and Pricing
   https://geminicli.com/docs/resources/quota-and-pricing/
4. GitHub — google-gemini/gemini-cli issues #19454 (Auto Model Routing for Plan Mode)
   https://github.com/google-gemini/gemini-cli/issues/19454 (2026.02.18)
5. InfoWorld — Gemini CLI introduces plan mode
   https://www.infoworld.com/article/4144594/gemini-cli-introduces-plan-mode.html (2026.03.12)