Plan 모드가 생기기 전까지 Gemini CLI의 약점

2025년 11월, 개발자 Kevin Simper는 자신의 블로그에 이렇게 썼습니다. “Gemini CLI에 Plan 모드가 없다는 게 이상하다. Claude Code에서는 Shift+Tab 두 번으로 들어갈 수 있는데.” 당시 이 글은 개발자 커뮤니티에서 꽤 공감을 얻었습니다. Gemini CLI가 무료라는 건 매력적이지만, 코드를 건드리기 전에 먼저 분석하고 계획을 세우는 단계가 없다는 건 실무에서 치명적인 공백이었습니다.

그 시절 Gemini CLI의 기본 동작은 요청을 받으면 바로 파일을 수정하는 것이었습니다. 검토 없이 돌진하는 방식이죠. 실제로 커뮤니티에는 “기존 엔드포인트를 삭제했다”는 불만이 여럿 올라왔고, 자동 편집 모드(Auto-Edit)에서의 예기치 않은 파일 변경 사고 사례도 보고됐습니다.

결국 가장 큰 약점은 속도가 아니라 신뢰였습니다. 코드를 건드리기 전에 “이 도구가 무슨 계획을 갖고 있는지” 알 수 없다는 불안감이 Gemini CLI를 Claude Code 대비 실험적인 도구로 묶어두었습니다.

▲ 목차로 돌아가기

Plan 모드가 실제로 하는 일

2026년 3월 11일 Google 공식 블로그에 올라온 발표문에는 이렇게 나와 있습니다. “Plan 모드는 읽기 전용 환경입니다. 에이전트는 코드베이스를 탐색하고 패턴을 검색하고 문서를 읽을 수 있지만, 자체 계획 파일을 제외한 어떤 파일도 수정할 수 없습니다.” (출처: Google Developers Blog, 2026.03.11)

계획서는 ~/.gemini/tmp/<project>/<session-id>/plans/ 경로에 마크다운 파일로 저장됩니다. 여기서 중요한 점은 이 파일을 외부 에디터(VS Code, Vim 등)로 열어서 직접 단계를 수정하거나, 인라인 코멘트를 남기면 Gemini CLI가 자동으로 감지해 계획을 다듬는다는 겁니다. 단순히 “AI가 만든 계획을 보여주는 것”이 아니라, 사람이 계획에 참여하는 구조입니다.

출처: geminicli.com/docs/cli/plan-mode, 2026.03.11 기준

▲ 목차로 돌아가기

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

공식 문서에는 이렇게 나와 있습니다. “Planning Phase: While in Plan Mode, the CLI routes requests to a high-reasoning Pro model to ensure robust architectural decisions. Implementation Phase: Once a plan is approved, the CLI automatically switches to a high-speed Flash model.” (출처: geminicli.com/docs/cli/plan-mode, Automatic Model Routing 섹션)

이게 의미하는 바는 분명합니다. 유료 도구들이 강점으로 내세우는 “고사양 모델로 코드 분석”을 Gemini CLI 무료 계정으로도 누릴 수 있습니다. 단, Plan 모드 안에서만입니다. 이 자동 라우팅을 끄고 싶다면 settings.json에서 "modelRouting": false로 설정하면 됩니다.

같은 작업에서 Claude Opus 4.6 대비 Gemini 3.1 Pro의 API 비용은 절반 수준입니다. 구현 단계에서 Flash로 전환되면 비용이 훨씬 더 내려갑니다. 무료 티어에서는 이 차이가 0원 대 0원이지만, API 키 기반으로 사용한다면 장기적으로 의미 있는 차이입니다.

▲ 목차로 돌아가기

MCP 제한, 실무에서 막히는 지점

Plan 모드의 MCP 지원은 처음 봤을 때 “외부 데이터도 참조해서 계획 짠다”는 장점처럼 보입니다. GitHub 이슈 읽기, Postgres 스키마 확인, Google Docs 참조 등이 가능하다고 공식 발표문에도 나옵니다. 막상 써보면 중요한 제약이 있습니다.

이 문제를 해결하려면 정책 엔진(Policy Engine)을 써서 직접 예외를 만들어야 합니다. ~/.gemini/policies/ 경로에 .toml 파일을 만들고 특정 MCP 툴에 대해 allow 규칙을 주는 방식입니다. 공식 문서에 예시가 나와 있긴 하지만, 처음 쓰는 사람에게 이 진입장벽은 낮지 않습니다.

[[rule]]
toolName = "*"
mcpName = "*"
toolAnnotations = { readOnlyHint = true }
decision = "allow"
priority = 100
modes = ["plan"]

또 하나의 실무 함정은 계획서 저장 위치입니다. 기본값은 프로젝트 외부 임시 경로(~/.gemini/tmp/)라서, 팀과 공유하거나 버전 관리에 포함시키려면 settings.json에서 경로를 프로젝트 내부로 바꾸고, 그에 맞는 정책도 추가해야 합니다. 두 가지를 동시에 안 하면 계획서가 git에 안 잡힙니다.

▲ 목차로 돌아가기

Claude Code와 비교했을 때 실제 차이

SWE-bench Verified 기준으로 두 도구의 성능 차이는 0.2%p입니다. (출처: vibehackers.io, 2026.03 기준) 벤치마크만 보면 사실상 동점입니다. 그런데 실제로 10만 토큰 규모의 코딩 작업에서 Claude Code가 단일 세션으로 끝낸 일을, Gemini CLI는 세 번 시도하고 수동 개입이 필요했다는 테스트 결과가 있습니다. (출처: Composio 10M 토큰 테스트, vibehackers.io 인용)

출처: vibehackers.io (2026.03 기준) / Terminal-Bench 2.0 및 ARC-AGI-2 수치 포함

커뮤니티에서 많이 쓰이는 방식은 “정찰은 Gemini, 구현은 Claude”입니다. Gemini CLI의 무료 한도 안에서 코드베이스를 파악하고 계획을 세운 뒤, 실제 복잡한 멀티파일 수정은 Claude Code로 넘기는 겁니다. Plan 모드가 생기기 전에는 이 흐름이 어색했지만, 이제는 계획서를 마크다운으로 내보내서 Claude Code에 붙여넣는 식으로 연결할 수 있습니다.

솔직히 말하면, Plan 모드 하나로 Gemini CLI가 Claude Code를 대체할 수 있다는 건 과장입니다. 세션 지속성이 없고, Git 통합이 얕고, 복잡한 의존성 추적에서 여전히 한 단계 뒤처집니다. 하지만 “무료로 이 정도 된다”는 기준에서 보면 이야기가 달라집니다.

▲ 목차로 돌아가기

지금 바로 써볼 수 있는 진입 방법

Plan 모드는 새로 설치하거나 업데이트한 Gemini CLI에서 기본값으로 활성화됩니다. 진입 방법은 세 가지입니다.

Plan 모드에서 계획서가 생성되면 Ctrl+X로 외부 에디터에서 직접 수정할 수 있습니다. 마크다운 파일이라 VS Code나 Vim에서 단계를 추가하거나 삭제한 뒤 저장하면, Gemini CLI가 자동으로 변경을 감지해 계획을 갱신합니다.

팀 작업이라면 계획서 저장 경로를 프로젝트 내부로 옮기는 것을 권장합니다. settings.json에서 "directory": ".gemini/plans"로 설정하면 git 추적이 됩니다. 단, 이때 정책 파일도 같이 업데이트해야 Plan 모드에서 해당 경로 쓰기가 허용됩니다. 경로만 바꾸고 정책을 안 바꾸면 계획서 저장이 안 됩니다.

Plan 모드가 필요 없다면 /settings에서 “Plan” 항목을 끄면 됩니다. Shift+Tab 로테이션에서 제거되고 enter_plan_mode 툴도 등록 해제됩니다. 공식 문서에 이 두 가지를 명시적으로 나눠서 설명하고 있습니다.

▲ 목차로 돌아가기

자주 묻는 질문

▲ 목차로 돌아가기

마치며

Gemini CLI Plan 모드는 “없어서 아쉬웠던 기능”이 드디어 채워진 업데이트입니다. 코드를 건드리기 전에 읽기 전용으로 탐색하고, 질문하고, 계획서를 만들어 검토받는 흐름은 Claude Code가 먼저 증명한 방식인데, 무료 도구에서도 이게 됩니다.

그런데 솔직히 말하면 Plan 모드 하나로 판이 뒤집히는 건 아닙니다. 세션 지속성, Git 통합, 복잡한 멀티파일 리팩토링에서의 정확도 차이는 여전히 Claude Code 쪽이 유리합니다. 다만 “프로젝트 탐색과 계획 수립을 공짜로 하고 싶다”면, 이제 Gemini CLI가 그 용도에 맞는 도구가 됐습니다. Pro 모델이 계획 단계에서 자동으로 투입된다는 건, 무료라는 전제 위에서 꽤 파격적인 조건입니다.

MCP 제한과 계획서 경로 설정의 번거로움은 아직 개선이 필요한 부분입니다. 이 두 가지만 매끄러워지면, 개인 프로젝트나 탐색 작업에서 유료 도구에 손이 덜 가게 될 것 같습니다.

▲ 목차로 돌아가기

📚 본 포스팅 참고 자료

1. Google Developers Blog — Plan Mode Now Available in Gemini CLI (2026.03.11)
2. Gemini CLI 공식 문서 — Plan Mode (2026.03.11 기준)
3. Gemini CLI vs Claude Code (2026): Which Terminal AI Coding Tool Wins? — vibehackers.io
4. r/GeminiCLI — Plan Mode 출시 스레드 (2026.03.11)
5. Kevin Simper — My experience using Claude Code vs Gemini CLI (2025.11.27)