Plan 모드가 이미 켜져 있다는 뜻

Gemini CLI를 쓰고 있다면, 이미 Plan 모드가 작동 중입니다. 2026년 3월 11일 v0.33.0 업데이트와 함께 Plan 모드가 모든 사용자에게 기본값으로 설정됐습니다. (출처: Google Developers Blog, 2026.03.11)

“기본값으로 켜진다”는 말의 실제 의미는 이렇습니다 — 터미널에서 Gemini CLI를 실행하면, AI가 코드를 수정하기 전에 먼저 분석하고 계획을 세우는 단계를 자동으로 거칩니다. 그 계획이 승인되기 전까지는 어떤 파일도 바뀌지 않습니다.

진입 방법도 세 가지입니다. 터미널에서 /plan을 입력하거나, Shift+Tab으로 모드를 전환하거나, “이 기능 구현 계획을 세워줘”처럼 자연어로 요청하면 됩니다. AI가 알아서 enter_plan_mode 툴을 호출합니다.

▲ 목차로 돌아가기

Plan 모드에서 실제로 뭘 하고, 뭘 못 하나

Plan 모드의 핵심은 읽기 전용(read-only)입니다. AI가 코드베이스를 분석하고, 패턴을 검색하고, 문서를 읽을 수 있지만, 파일을 수정하거나 커맨드를 실행하는 건 불가능합니다. 딱 하나 예외가 있습니다 — ~/.gemini/tmp/<project>/<session-id>/plans/ 경로에 Markdown 형식으로 계획서를 저장하는 것만 허용됩니다.

Plan 모드에서 쓸 수 있는 툴

(출처: Gemini CLI 공식 문서 — Plan Mode Tool Restrictions)

새로 추가된 ask_user 툴이 핵심입니다. AI가 추측으로 코드를 짜는 대신, 불분명한 부분이 있으면 먼저 질문합니다. “DB 마이그레이션 방향을 어떻게 할까요?” 같은 식입니다. 막연히 진행했다가 방향이 틀어지는 상황을 원천 차단합니다.

▲ 목차로 돌아가기

Pro 모델이 자동으로 붙는 이유

Plan 모드의 조용한 핵심 기능 하나를 놓치면 안 됩니다. 자동 모델 라우팅(Automatic Model Routing)입니다. 공식 문서에 이렇게 나와 있습니다:

“Planning Phase: While in Plan Mode, the CLI routes requests to a high-reasoning Pro model to ensure robust architectural decisions and high-quality plans. Implementation Phase: Once a plan is approved and you exit Plan Mode, the CLI automatically switches to a high-speed Flash model.”

(출처: geminicli.com 공식 문서 — Automatic Model Routing)

계획 단계에선 Gemini 3.1 Pro가 붙고, 코드 구현 단계에선 Flash 모델로 자동 전환됩니다. 생각하는 데 높은 추론력을 쓰고, 실행은 빠른 모델에 맡기는 구조입니다.

이 자동 전환이 마음에 들지 않으면 settings.json에서 끌 수 있습니다:

{
"general": {
"plan": {
"modelRouting": false
}
}
}

▲ 목차로 돌아가기

MCP 연동 — 외부 DB도 읽을 수 있지만 조건이 있습니다

Plan 모드가 로컬 파일에만 갇혀 있다고 생각하면 오해입니다. 읽기 전용 MCP 툴은 Plan 모드 안에서도 쓸 수 있습니다. GitHub 이슈 읽기, Postgres 스키마 확인, Google Docs 검색까지 외부 소스를 계획 단계에서 참조할 수 있습니다.

단, 중요한 조건이 있습니다. MCP 툴은 기본값으로 사용자 확인(confirmation)을 요구합니다. 읽기 전용 MCP 툴을 자동 승인하게 만들려면 정책 파일을 직접 설정해야 합니다. 공식 문서에 나온 예시입니다:

# ~/.gemini/policies/mcp-read-only.toml
[[rule]]
toolName = "*"
mcpName = "*"
toolAnnotations = { readOnlyHint = true }
decision = "allow"
priority = 100
modes = ["plan"]

(출처: Gemini CLI 공식 문서 — Custom Policies)

DB 마이그레이션을 계획할 때를 예로 들면 — AI가 현재 스키마를 읽고, 관련 GitHub 이슈를 확인하고, 기존 문서를 참조한 뒤 실제 코드는 한 줄도 건드리지 않고 계획서만 작성합니다. 승인하고 나서야 구현에 들어갑니다.

▲ 목차로 돌아가기

Claude Code와 결정적으로 다른 지점

Reddit에서 실사용자들이 직접 비교한 내용을 보면 솔직한 평가가 나옵니다. “Plan 모드는 Claude Code에서 이미 있던 기능을 따라간 것”이라는 의견이 있는 반면, “읽기 전용 제약 자체는 enterprise 환경에서 실질적인 차이를 만든다”는 반론도 있습니다.

(비교 참고: Gemini CLI vs Claude Code 비교 분석, 2026.03.05)

결론적으로 Gemini CLI는 속도와 프론트엔드 작업에서, Claude Code는 복잡한 백엔드 아키텍처와 디버깅에서 각각 강점을 보입니다. 두 도구를 병행하는 팀도 늘고 있습니다.

▲ 목차로 돌아가기

끄거나 커스터마이징하는 방법

Plan 모드가 작업 흐름과 맞지 않으면 끌 수 있습니다. /settings 명령어에서 “Plan”을 검색하면 토글이 나옵니다. 끄면 Shift+Tab 로테이션에서 제거되고 enter_plan_mode/exit_plan_mode 툴도 비활성화됩니다.

계획서 저장 위치 바꾸기

기본적으로 계획서는 세션 임시 폴더에 저장되고 30일 후 자동 삭제됩니다. 프로젝트 안에 보관하고 싶으면:

// settings.json
{
"general": {
"plan": {
"directory": ".gemini/plans"
}
}
}

단, 커스텀 경로를 쓸 때는 정책 파일에 해당 경로의 쓰기 권한을 따로 추가해야 합니다. 그냥 경로만 바꾸면 Plan 모드가 파일을 저장하지 못합니다.

Git 커맨드를 Plan 모드에서 쓰고 싶을 때

기본적으로 git status나 git diff 같은 확인용 커맨드도 Plan 모드에서 막힙니다. 정책 파일 하나로 해결됩니다:

# ~/.gemini/policies/git-research.toml
[[rule]]
toolName = "run_shell_command"
commandPrefix = ["git status", "git diff"]
decision = "allow"
priority = 100
modes = ["plan"]

▲ 목차로 돌아가기

Q&A

▲ 목차로 돌아가기

마치며

솔직히 말하면, Plan 모드가 “기본값으로 켜진다”는 사실이 가장 중요한 포인트입니다. 아무것도 하지 않아도 이미 바뀌어 있는 겁니다. AI 코딩 도구가 “일단 짜고 보자”에서 “먼저 설계하고 승인받자”로 방향을 바꾸는 흐름이 뚜렷해지고 있습니다.

자동 모델 라우팅은 아직 많이 알려지지 않았는데, 실제로 꽤 실용적인 기능입니다. 계획 단계에서 추론 품질을 높이고, 구현 단계에서 속도를 확보하는 구조는 비용 효율과 품질 사이의 균형을 자동으로 잡아줍니다.

MCP 제한과 YOLO 모드 비호환성은 알아두지 않으면 막힐 수 있습니다. 기억해 두는 것만으로도 불필요한 시간 낭비를 막을 수 있습니다.

▲ 목차로 돌아가기

📚 본 포스팅 참고 자료

1. Google Developers Blog — Plan mode is now available in Gemini CLI (2026.03.11)
2. Gemini CLI 공식 문서 — Plan Mode
3. GitHub Discussions — Gemini CLI v0.33.0 March 11th Update
4. InfoWorld — Gemini CLI introduces plan mode (2026.03.12)
5. DevOps.com — Gemini CLI Plan Mode Separates Thinking From Doing