Gemini CLI v0.33.0
IT/AI
Gemini CLI Plan 모드, 공짜인데 Pro가 자동으로 켜집니다
2026년 3월 11일, Google이 Gemini CLI에 Plan 모드를 공식 추가했습니다.
“그냥 안전 장치 아닌가?”라고 생각하기 쉬운데, 실제로는 무료 계정에서도
플래닝 단계에서 Gemini 3.1 Pro 모델이 자동 투입되는 구조입니다.
공식 문서에 그대로 나와 있는데 대부분의 글에서 이 부분을 그냥 넘깁니다.
Plan 모드가 뭔지, 한 줄로 먼저
파일을 열고, 패턴을 검색하고, 의존성을 파악하지만 파일 수정은 일절 하지 않습니다.
공식 발표(Google Developers Blog, 2026.03.11)에서는 이를 “read-only mode that restricts Gemini CLI to a subset of its tools”라고 정의했습니다.
쓸 수 있는 도구는 공식 문서에 딱 정해져 있습니다. read_file, grep_search, glob 같은 읽기 전용 도구, 그리고 ask_user를 통한 질문 도구만 허용됩니다.
플래닝 결과물은 ~/.gemini/tmp/<project>/<session-id>/plans/ 경로의 마크다운 파일로만 저장되고 다른 어떤 파일도 손대지 않습니다.
진입 방법은 세 가지입니다. 터미널 입력창에 /plan을 치거나, Shift+Tab으로 모드를 전환하거나, “지금부터 계획을 세워줘”라고 자연어로 요청하면 됩니다.
2026년 3월 11일 v0.33.0부터 모든 사용자에게 기본 활성화 상태로 배포됐습니다.
무료인데 Pro가 켜지는 이유
💡 공식 발표문과 실제 설정 파일을 같이 놓고 보니 이런 흐름이 보였습니다. 플래닝 단계에서 자동으로 모델이 바뀐다는 내용은 대부분의 한국어 글에서 빠져 있습니다.
Plan 모드를 단순히 “안전 장치”로만 보면 놓치는 부분이 있습니다.
공식 문서(geminicli.com/docs/cli/plan-mode, 2026.03.11 기준)에는 “Automatic Model Routing” 항목이 따로 있습니다.
Auto 모델로 설정된 상태에서 Plan 모드에 진입하면 Gemini CLI가 자동으로 고추론(High-Reasoning) Pro 모델로 라우팅합니다.
현재 기준으로 이 Pro 모델은 Gemini 3.1 Pro입니다. (출처: Google Developers Blog, 2026.03.11)
무료 계정이어도 Plan 모드 진입 시에는 Gemini 3.1 Pro가 투입되고, 플래닝이 끝나고 실행 단계로 넘어가면 자동으로 고속(Flash) 모델로 다시 전환됩니다.
이건 꽤 중요한 구조입니다. 플래닝은 정확도가 중요하고, 실행은 속도가 중요하다는 점을 감안해 모델이 자동으로 최적화됩니다. 공식 문서에서는 이 동작을 “the best balance of quality and performance”라고 설명합니다. 비용을 더 쓰는 게 아니라, 무료 한도 안에서 단계별로 모델을 바꿔 쓰는 구조입니다.
이 자동 전환을 끄고 싶다면 settings.json에서 "modelRouting": false로 설정하면 됩니다. 하지만 끄면 플래닝도 Flash로 처리되기 때문에 Plan 모드의 핵심 이점이 줄어듭니다.
실제로 막히는 조건 3가지
Plan 모드가 기본 활성화됐다고 해서 모든 환경에서 똑같이 동작하지는 않습니다. 공식 문서와 실사용 후기를 교차해보면 막히는 지점이 세 군데 있습니다.
Plan 모드는 YOLO 모드(전자동 실행 모드)와 함께 쓸 수 없습니다. 공식 문서에 “This tool is not available when Gemini CLI is in YOLO mode”라고 명시돼 있습니다. YOLO 모드는 승인 없이 모든 명령을 자동 실행하기 때문에 Plan 모드의 읽기 전용 정책과 충돌합니다. 단, 비대화형 환경(CI/CD)에서는 예외가 있습니다. 이 부분은 아래 섹션에서 따로 다룹니다.
Plan 모드에서 GitHub나 Postgres 같은 외부 MCP 도구를 쓸 수 있습니다. 하지만 읽기 전용 MCP 도구라 해도 기본 상태에서는 매번 사용자 승인을 요청합니다. 자동 승인하려면 ~/.gemini/policies/에 별도 TOML 정책 파일을 만들어야 합니다. 이걸 모르면 MCP 도구 쓸 때마다 계속 승인 창이 뜨는 상황이 됩니다.
플랜 파일을 저장하는 경로를 커스텀으로 바꿀 수 있지만, 반드시 프로젝트 루트 안에 있어야 합니다. 공식 문서에서는 “user-configured paths for the plans directory are restricted to the project root”라고 명시합니다. 프로젝트 바깥 경로(예: ~/shared-plans/)를 지정하면 작동하지 않습니다. 또한 커스텀 디렉토리를 쓰면 자동 세션 정리(30일 보존)가 적용되지 않아 수동으로 파일을 관리해야 합니다.
Claude Code와 비교해보면 달라지는 것
💡 2025년 11월에는 “Plan 모드 없음”이 Gemini CLI의 가장 큰 약점이었습니다. 당시 실사용 비교 리뷰에서 개발자들이 직접 불만을 남겼고, 3개월 뒤 그 기능이 추가됐습니다. 같은 기능인데 구현 방향은 꽤 다릅니다.
2025년 11월, 실사용 비교 글(kevinsimper.dk, 2025.11.27)에는 이런 문장이 그대로 들어 있습니다. “It is weird that gemini cli has no plan mode.” 당시 Claude Code에서는 Shift+Tab으로 Plan 모드 전환이 됐는데 Gemini CLI에는 없었습니다. 2026년 3월에 도입된 Gemini CLI Plan 모드는 정확히 같은 단축키(Shift+Tab)를 씁니다.
기능 자체는 같지만 비용 구조에서 차이가 납니다. Claude Code는 Plan 모드를 쓰려면 최소 월 $20짜리 Pro 플랜이 필요합니다. Gemini CLI Plan 모드는 무료 계정에서도 쓸 수 있고, 플래닝 단계에서 Gemini 3.1 Pro가 자동 투입됩니다. SWE-bench Verified 기준(2026년 3월) 두 모델의 성능 차이는 0.2%입니다. (출처: vibehackers.io/blog/gemini-cli-vs-claude-code, 2026.03 기준) 같은 기능에서 실질적인 추론 성능 차이는 미미한 수준입니다.
다만 Claude Code에서 Plan 모드가 먼저 있었다는 건 다른 강점으로 이어집니다. 세션 연속성(이전 대화 기억), 멀티 파일 리팩토링 시 의존성 추적, 코드 품질 면에서는 여전히 Claude Code가 우위라는 평가가 많습니다. (출처: Composio 10M 토큰 비교 테스트, 2026) Plan 모드 하나만 놓고 “이제 Gemini CLI가 더 낫다”고 결론 내리는 건 성급합니다.
CI/CD에서 Plan 모드가 더 강력한 이유
💡 대화형으로 쓰는 것만 생각하면 놓치는 부분입니다. Plan 모드는 비대화형 환경에서 오히려 특별하게 동작합니다. 공식 문서에 따로 섹션이 있을 만큼 설계에 의도가 담겨 있습니다.
Plan 모드에는 “Non-interactive execution” 항목이 공식 문서에 별도로 있습니다. CI/CD 파이프라인처럼 사람이 개입하지 않는 환경에서는 동작 방식이 달라집니다.
비대화형 환경에서 Plan 모드를 실행하면, 플래닝 단계가 끝난 뒤 구현 단계로 전환할 때 자동으로 YOLO 모드로 바뀝니다. 원래 대화 중에는 YOLO 모드와 Plan 모드를 같이 쓸 수 없지만, 비대화형에서는 플래닝 → YOLO 실행으로 이어지는 흐름이 자동으로 구성됩니다. (출처: geminicli.com/docs/cli/plan-mode, Non-interactive execution 항목, 2026.03.11)
실행 명령어는 이렇게 씁니다.
gemini --approval-mode plan -p "텔레메트리를 분석하고 개선안을 제안해줘"
이 구조가 의미하는 건 분명합니다. 플래닝에서 Pro 모델로 설계를 검토하고, 실행은 Flash 모델로 처리하면서, 중간에 사람이 개입하지 않아도 됩니다. Claude Code의 공식 GitHub Actions 연동이 없다는 점과 비교하면, 오픈소스 CI/CD 파이프라인 자동화 용도에서는 Gemini CLI만의 강점이 됩니다.
Plan 모드 설정, 딱 이것만 건드리면 됩니다
기본 활성화 상태라 설치하면 바로 쓸 수 있습니다. 그런데 실제로 써보면 두 가지 설정만 건드려도 사용감이 꽤 달라집니다.
기본 시작 모드를 Plan으로 고정하기
매번 /plan을 입력하기 귀찮다면, 세션 시작 시 Plan 모드로 자동 진입하도록 설정할 수 있습니다. /settings에서 “Default Approval Mode”를 Plan으로 바꾸면 됩니다. 또는 실행 시 gemini --approval-mode=plan을 쓰면 그 세션만 Plan으로 시작됩니다.
Plan 모드 자체를 끄고 싶을 때
Shift+Tab 순환에서 Plan이 자꾸 나온다면 /settings에서 “Plan”을 검색해 토글을 끄면 됩니다. 그러면 Shift+Tab 순환에서 Plan이 사라지고, enter_plan_mode와 exit_plan_mode 도구도 비활성화됩니다.
플랜 복사 단축 명령어
v0.33.0부터 /plan copy 명령어가 추가됐습니다. 생성된 플랜을 클립보드로 바로 복사할 수 있습니다. 플랜 내용을 다른 문서에 붙여넣거나 팀원에게 공유할 때 유용합니다.
플랜 파일 편집 — Ctrl+X
Plan 모드에서 플랜이 제시됐을 때 Ctrl+X를 누르면 플랜 파일이 외부 에디터(VS Code, Vim 등)로 열립니다. 단계를 직접 수정하거나 “여기서 기존 Logger 클래스를 써야 하지 않나요?”처럼 코멘트를 남기면 저장 후 Gemini CLI가 그 내용을 반영해 플랜을 재조정합니다.
자주 묻는 것들
마치며
다만 “이제 Gemini CLI가 Claude Code를 따라잡았다”는 식의 결론은 성급합니다. 세션 연속성, 멀티 파일 의존성 추적, 코드 품질 면에서는 여전히 실사용 데이터(Composio 10M 토큰 테스트, 2026 기준)가 Claude Code 쪽을 가리킵니다. Plan 모드 하나로 격차가 좁혀진 건 아닙니다.
그래도 무료로 Gemini 3.1 Pro 수준의 플래닝을 쓸 수 있고, CI/CD에서 Plan→YOLO 자동 전환 흐름을 파이프라인에 넣을 수 있다는 건 실질적인 강점입니다. 조용히 손해 볼 이유가 없는 기능이라는 건 맞습니다.
본 포스팅 참고 자료
- Google Developers Blog — Plan mode is now available in Gemini CLI (2026.03.11)
- Gemini CLI 공식 문서 — Plan Mode Documentation (2026.03.11 기준)
- GitHub gemini-cli Discussions — v0.33.0 Release Notes (2026.03.11)
- Google Codelabs — Gemini CLI 실습 (2026.03.14 기준)
- vibehackers.io — Gemini CLI vs Claude Code (2026.03 기준)
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다.
2026년 3월 11일 v0.33.0 기준입니다. 최신 내용은 공식 문서에서 직접 확인하세요.
댓글 남기기