Gemini CLI v0.32.1
IT/AI
Gemini CLI Plan 모드, 이 조건이면 Claude Code보다 낫습니다
터미널에서 쓰는 AI 코딩 에이전트 중 Gemini CLI에 Plan 모드가 생겼습니다. 코드 수정 전에 먼저 분석하고 계획만 짜는 read-only 모드인데, 막상 써보니 “무료이면서 Claude Code와 실질적으로 비슷한 흐름”이 가능한 조건이 있습니다. 반대로 기대했던 것과 다른 부분도 있고요.
Plan 모드가 뭔지, 왜 지금 주목해야 하는지
2026년 3월 11일, 구글이 Gemini CLI에 Plan 모드를 공식 탑재했습니다. (출처: Google Developers Blog, 2026.03.11) 쉽게 말하면 AI가 코드를 바로 수정하는 대신, 먼저 파일을 읽고 분석해서 작업 계획만 짜는 모드입니다. 파일 쓰기, 셸 명령 실행 같은 변경 작업은 이 모드에서 전부 막혀 있습니다.
기존에 Gemini CLI를 써봤다면 “AI가 갑자기 파일을 덮어쓴다”는 경험이 한 번쯤은 있었을 겁니다. Plan 모드는 그 불안감을 제거하기 위한 구조적 장치입니다. 코드베이스 전체를 분석하고, 마이그레이션 전략을 짜고, 의존성을 파악하는 작업을 완전히 안전한 환경에서 할 수 있습니다. 계획이 마음에 들면 그때 편집 모드로 전환해서 실행하면 됩니다.
주목해야 하는 이유는 타이밍입니다. Claude Code가 /plan 기능을 먼저 내놓았고, 개발자들 사이에서 “Gemini CLI는 계획 기능이 없어서 아쉽다”는 피드백이 쌓였습니다. 이번 업데이트는 그 격차를 직접 겨냥한 것이고, 무료로 쓸 수 있다는 점이 핵심입니다.
진입 방법 3가지와 모델 자동 전환 구조
Plan 모드에 들어가는 방법은 세 가지입니다. 입력창에 /plan을 치거나, Shift+Tab으로 승인 모드를 순환하거나, “start a plan for…”처럼 자연어로 요청하면 됩니다. (출처: Google Developers Blog, 2026.03.11) 세 방법이 완전히 같은 건 아닙니다. /plan은 즉시 전환이고, Shift+Tab은 Auto-Edit → Plan → 일반 모드를 순환하는 구조입니다.
💡 공식 발표문과 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다. — Plan 모드에서는 내부적으로 모델 라우팅이 바뀝니다. 일반 세션에서는 기본 Gemini 3 모델이 쓰이지만, Plan 모드 진입 시 Gemini 3.1 Pro로 자동 전환됩니다. 더 무거운 추론 모델을 쓰는 만큼 계획의 품질이 달라집니다. 같은 무료 할당량 안에서 일어나는 일이어서, Plan 모드가 비용 면에서 손해가 아닙니다.
또 하나 챙겨둘 게 있습니다. /settings에서 “Default Approval Mode”를 Plan으로 설정하면, 세션을 시작할 때마다 자동으로 Plan 모드로 열립니다. 새 프로젝트를 탐색하거나 낯선 코드베이스에 처음 진입할 때 유용합니다. 반대로 Plan 모드가 불필요한 경우라면 같은 메뉴에서 토글을 끄면 Shift+Tab 순환 목록에서 제거됩니다.
무료 할당량, 숫자가 다른 이유가 있습니다
“Gemini CLI는 무료”라는 말은 맞지만, 조건이 있습니다. 인증 방식에 따라 할당량이 4배까지 차이납니다. (출처: geminicli.com 공식 문서 / laozhang.ai, 2026년 3월 기준)
| 인증 방식 | 분당 요청(RPM) | 일일 요청(RPD) | 비용 | 주요 용도 |
|---|---|---|---|---|
| Google OAuth | 60 RPM | 1,000 RPD | 무료 | 대화형 터미널 작업 |
| Gemini API Key | 10 RPM | 250 RPD | 무료(제한적) | CI/CD, 자동화 스크립트 |
| Vertex AI | GCP 할당량 | GCP 할당량 | 사용량 과금 | 엔터프라이즈 |
OAuth 방식은 신용카드도 없고 체험 기간도 없습니다. 구글 계정 하나로 바로 시작됩니다. 여기서 눈여겨볼 건 “1,000건”이라는 숫자입니다. 하루 1,000번 요청이 가능하고, 각 요청이 최대 100만 토큰의 컨텍스트를 처리합니다. 1,000번의 짧은 질문이 아니라, 큰 파일 여러 개를 통째로 분석하는 작업 1,000번이 가능하다는 뜻입니다. 웬만한 개인 프로젝트에서는 하루 치 할당량을 다 쓰기 어렵습니다.
Plan 모드 자체가 추가 비용을 발생시키지는 않습니다. Plan 모드에서 Gemini 3.1 Pro로 자동 전환되더라도 같은 OAuth 무료 할당량이 적용됩니다. 단, API Key 방식은 분당 10건 제한 때문에 Plan 모드처럼 여러 파일을 순차 탐색하는 작업에서는 금방 제한에 걸릴 수 있습니다. Plan 모드를 제대로 쓰려면 OAuth 방식이 사실상 필수입니다.
MCP 도구 지원의 실제 범위와 주의할 점
공식 발표에서는 “Plan 모드가 read-only MCP 도구를 지원한다”고 밝혔습니다. GitHub에서 이슈를 읽거나, Postgres 스키마를 조회하거나, Google Docs 내용을 가져오는 게 가능하다는 뜻입니다. (출처: Google Developers Blog, 2026.03.11) 여기까지는 좋습니다.
💡 발표문에서 강조하지 않은 부분인데, 실제 사용자들이 발견한 갭이 있습니다. — MCP 서버는 read-only 라벨 없이도 Plan 모드에서 실행되는 경우가 있습니다. Reddit 커뮤니티(r/GeminiCLI)에서 사용자 germanheller가 직접 확인한 내용입니다: “MCP 제약이 실질적인 갭이다. 계획의 가치 절반은 외부 상태(로그, DB 스키마, API 응답)를 조회해서 계획에 반영하는 건데, 특정 MCP 도구를 read-only로 화이트리스트하는 방법이 없다면 Claude Code의 /plan 대비 경쟁력이 없다.” (출처: r/GeminiCLI, 2026.03.11)
정리하면 이렇습니다. Plan 모드의 MCP 지원은 “외부 데이터를 읽어서 계획에 반영할 수 있다”는 장점이 있지만, MCP 서버가 내부적으로 read-only인지 write 가능한지를 Plan 모드가 완벽하게 제어하지는 못합니다. 구글이 policy engine을 통한 커스텀 제어를 문서화해두었지만 (출처: geminicli.com policy-engine 문서), 이걸 직접 설정하지 않으면 MCP 서버가 Plan 모드의 안전 제약 밖에서 동작할 수 있습니다.
실용적인 결론은 하나입니다. Plan 모드에서 MCP를 쓴다면, 쓰는 MCP 서버가 실제로 read-only인지 먼저 확인하거나, policy engine 설정을 직접 잡아두는 것이 안전합니다.
Claude Code /plan과의 실질적 차이
“Plan 모드가 생겼으니 Gemini CLI로 갈아타도 되겠다”고 생각했다면, 잠깐 멈출 필요가 있습니다. 기능은 비슷해 보이지만 차이가 있습니다.
| 항목 | Gemini CLI Plan 모드 | Claude Code /plan |
|---|---|---|
| 기본 비용 | 무료 (OAuth) | 월 $20~ (Pro 플랜) |
| Plan 중 질문 기능 | ask_user 도구 지원 ✅ | 지원 ✅ |
| MCP read-only 보장 | 불완전 (policy 설정 필요) | 보다 엄격한 통제 |
| 모델 품질 | Gemini 3.1 Pro (Plan 중) | Claude Opus 4/Sonnet 4 |
| 컨텍스트 윈도우 | 100만 토큰 | 약 20만 토큰 (Sonnet 기준) |
| 멀티 에이전트 플로우 | Conductor 확장 (별도 설치) | 기본 내장 |
Claude Code가 유리한 조건은 복잡한 멀티 스텝 작업을 정확하게 끝까지 수행해야 할 때입니다. 같은 커뮤니티에서 사용자 vinnyduke가 언급했듯, Gemini CLI는 긴 작업 중간에 “완료”라고 선언하면서 중간 단계를 건너뛰는 경향이 있고, 이 부분은 모델이 더 강력해지기 전까지는 실사용 한계로 남아 있습니다.
Conductor 연동 시 달라지는 것들
Plan 모드 발표와 함께 Conductor라는 확장 도구가 같이 언급됩니다. Conductor는 Plan 모드와 ask_user 도구를 조합해서 복잡한 다단계 작업을 처리하는 오케스트레이터입니다. (출처: Google Developers Blog, 2026.03.11) 현재는 별도 설치가 필요한 확장이지만, 구글이 “곧 Gemini CLI에 기본 탑재할 예정”이라고 밝혔습니다.
💡 공식 문서에 있지만 일반 리뷰 글에서는 잘 다루지 않는 부분입니다. — Conductor가 작동하는 방식은 단순한 Plan 모드 실행과 다릅니다. Context-Driven Development 개념으로, Plan 모드에서 사전 조사를 전부 마친 뒤 단계별 구현 트랙을 생성하고, 각 마일스톤마다 ask_user로 사람의 확인을 받습니다. 프리플라이트 체크를 “파일 수정 없이” 전부 완료하는 구조입니다. 이 흐름이 Claude Code의 기본 내장 멀티 에이전트와 실질적으로 경쟁하는 방식입니다.
Conductor를 설치하는 방법은 다음 한 줄입니다.
gemini extensions install https://github.com/gemini-cli-extensions/conductor설치 후 복잡한 마이그레이션이나 새 기능 추가를 요청하면 Conductor가 Plan 모드를 먼저 실행하고, 분석 완료 후 단계별 계획을 사람에게 보여주고, 승인이 나면 각 단계를 순서대로 실행합니다. “AI가 알아서 다 해버리면 어디서 잘못됐는지 모른다”는 불안감이 있다면 이 흐름이 현실적인 대안입니다.
Q&A 5가지
Q1. Plan 모드는 유료 요금제에서만 쓸 수 있나요?
Q2. Plan 모드에서 작성된 계획은 어디에 저장되나요?
Q3. API Key로 Gemini CLI를 쓰는데 Plan 모드가 느립니다. 왜 그런가요?
Q4. Plan 모드 중에 AI가 질문을 너무 많이 합니다. 끌 수 있나요?
Q5. Gemini CLI v0.32.1보다 최신 버전이 있을 수 있나요? 확인 방법은?
gemini --version으로 현재 설치된 버전을 확인할 수 있고, npm으로 설치한 경우 npm update -g @google/gemini-cli를 실행하면 최신 버전으로 업데이트됩니다. Homebrew라면 brew upgrade gemini-cli로 동일하게 업데이트할 수 있습니다. 이 포스팅은 v0.32.1(2026년 3월 기준) 기준이며, 이후 버전에서 UI나 기능이 달라질 수 있습니다.
마치며 — 솔직한 총평
Plan 모드 추가로 Gemini CLI는 한 단계 올라섰습니다. 특히 대형 코드베이스를 안전하게 탐색하고 계획만 먼저 잡는 흐름은, 비용이 0원이라는 점과 합쳐져 현실적인 선택지가 됩니다. Claude Code를 구독하기 전에 먼저 Gemini CLI로 프로젝트를 분석해보는 것, 충분히 의미 있습니다.
아쉬운 부분도 있습니다. MCP의 read-only 제어가 완벽하지 않고, 긴 작업을 중간에 끊어버리는 모델 특성은 아직 개선 중입니다. Conductor가 기본 탑재되면 Claude Code와의 격차가 더 줄어들겠지만, 지금 당장은 “무료이면서 큰 파일 분석에 강한 도구”로 쓰는 게 현실적입니다.
개인적으로 Plan 모드에서 가장 유용하다고 느낀 건 ask_user 도구입니다. AI가 혼자 가정하고 나아가는 대신, 핵심 결정 지점에서 직접 묻는 구조는 오히려 더 안심됩니다. 특히 처음 진입하는 코드베이스에서 AI가 어떤 관점으로 코드를 이해하고 있는지를 확인하는 용도로도 씁니다.
본 포스팅 참고 자료
※ 본 포스팅은 2026년 3월 31일 작성 기준이며, Gemini CLI v0.32.1, Plan 모드 출시일(2026.03.11) 기준으로 작성되었습니다. 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. 무료 할당량(OAuth: 분당 60건 / 하루 1,000건)은 구글 정책에 따라 변경될 수 있으며, 최신 내용은 geminicli.com 공식 문서에서 확인하시기 바랍니다.
댓글 남기기