Plan mode가 이제 Gemini CLI에서 사용 가능합니다

Source: Google Developers Blog

번역할 텍스트를 제공해 주시면 한국어로 번역해 드리겠습니다.

2026년 3월 11일

우리는 Gemini CLI에 plan mode를 도입하게 되어 기쁩니다. 플랜 모드에서는 Gemini CLI가 먼저 요청을 분석하고, 복잡한 변경 사항을 계획하며, 코드 베이스나 종속성을 이해하는 데 집중합니다. 이 모든 과정은 읽기 전용 모드에서 이루어져 실수로 인한 변경이나 실행으로부터 안전합니다. 플랜 모드는 또한 목표를 명확히 하기 위해 질문을 던진 뒤, 검토할 수 있는 전략을 제안합니다.

죄송합니다, 사용 중인 브라우저가 이 비디오 재생을 지원하지 않습니다.

플랜 모드란?

Plan mode는 Gemini CLI를 도구의 일부만 사용할 수 있게 제한하는 읽기 전용 모드입니다. 활성화된 동안 에이전트는 다음을 할 수 있습니다:

• 코드베이스 탐색
• 패턴 검색
• 문서 읽기

하지만 자체 내부 계획을 제외하고는 파일을 수정할 수 없습니다.

Gemini CLI에 “데이터베이스 마이그레이션 방법을 조사해줘” 혹은 “새 기능을 계획해줘”라고 요청하면, 의존성을 파악하고 해결책을 제안하지만 원치 않는 코드 변경 위험은 없습니다.

주요 기능

• 안전한 탐색 – read_file, grep_search, glob와 같은 읽기 전용 도구를 사용해 가정을 검증합니다.
• 아키텍처 매핑 – 에이전트는 codebase_investigator 또는 Agent Skills와 같은 특수 하위 에이전트를 활용해 복잡한 시스템 의존성 및 워크플로를 이해합니다.
• 반복 설계 – 구현을 위한 편집 가능한 모드로 전환하기 전에 대화를 통해 전략을 다듬습니다.
• 완전 확장 가능 – custom policies를 사용해 개인 필요에 맞게 플랜 모드를 확장하거나 enter_plan_mode와 exit_plan_mode 도구를 활용해 워크플로를 구축합니다.

ask_user 도구를 활용한 더 나은 협업

계획은 요구 사항만큼이나 중요합니다. 플랜 모드를 진정으로 효과적으로 만들기 위해 ask_user 도구를 도입했습니다. 이를 통해 에이전트는 연구를 일시 중지하고 목표를 명확히 하거나 누락된 정보를 수집하기 위해 여러분에게 구체적인 질문을 할 수 있습니다.

Gemini CLI는 이제 가정하거나 의도를 추측하는 대신 다음을 할 수 있습니다:

• 옵션을 제시하기
• 특정 아키텍처 선택에 대한 설명 요청하기
• 숨겨진 설정 파일의 위치를 물어보기

이러한 양방향 커뮤니케이션은 구현에 착수하기 전에 최종 계획이 여러분의 비전과 완벽히 일치하도록 보장합니다.

읽기 전용 MCP 도구를 활용한 확장된 범위

Plan mode는 로컬 파일 시스템에만 국한되지 않습니다. 또한 읽기 전용 MCP 도구를 지원하여 Gemini CLI가 전체 개발 스택에서 안전하게 컨텍스트를 가져올 수 있습니다.

• GitHub – 이슈, 풀‑리퀘스트 설명 또는 저장소 메타데이터를 읽습니다.
• PostgreSQL – 스키마, 테이블 정의 또는 쿼리 결과를 검사합니다.
• Google Docs – 디자인 문서 또는 사양의 최신 버전을 가져옵니다.

이러한 읽기 전용 통합을 사용하면 코드베이스의 무결성을 유지하면서 모든 관련 외부 데이터가 플랜에 반영됩니다.

복잡한 워크플로우를 Conductor와 함께

보다 복잡한 프로젝트의 경우 Conductor가 훌륭한 선택이 될 수 있습니다. Gemini CLI용 Conductor extension은 plan mode와 ask_user 도구를 모두 완벽히 활용합니다. Conductor는 다단계 개발 트랙의 오케스트레이터 역할을 하여 복잡한 마이그레이션이나 기능 구현을 안내함으로써 Context‑Driven Development를 가능하게 합니다.

• Plan mode – 위험 없이 포괄적인 사전 점검 및 조사 단계를 수행합니다.
• ask_user 도구 – 각 마일스톤에서 중요한 결정을 확인하도록 요청하여, 에이전트가 컨텍스트 수집 및 하위 작업 초안을 작성하는 동안 높은 수준의 방향성을 사용자가 직접 제어할 수 있게 합니다.

*Conductor는 확장성을 염두에 두고 설계된 plan mode의 좋은 예시이며, 사용자가 **자신만의 맞춤형 계획 워크플로우를 구축*할 수 있는 빌딩 블록을 제공합니다.

비디오 개요

(브라우저가 비디오 재생을 지원하지 않을 경우, 브라우저를 업데이트하거나 다른 곳에서 콘텐츠를 확인해야 할 수 있습니다.)

(여기에 비디오 임베드 또는 링크 삽입)

팀은 가까운 시일 내에 Conductor를 Gemini CLI에 내장 모드로 직접 통합하는 작업을 진행 중입니다… 계속 지켜봐 주세요!

플랜 모드 시작하기

플랜 모드는 이제 모든 사용자에게 기본적으로 활성화되었습니다! 언제든지 플랜 모드에 들어갈 수 있습니다:

• 입력란에 /plan을 입력하기
• 승인 모드를 순환하려면 Shift + Tab을 누르기
• 에이전트에게 “…에 대한 플랜을 시작해”라고 요청하기

Gemini CLI의 model routing 기능이 플랜 모드에도 적용됩니다. 새로운 Gemini 3.1 Pro와 같은 고급 추론 Pro 모델이 계획 단계에서 사용되어 견고한 아키텍처 결정과 고품질 플랜을 보장합니다.

모든 세션을 연구‑우선 사고방식으로 시작하고 싶다면 /settings 명령을 사용해 **“Default Approval Mode”**를 Plan으로 설정하세요.

간단하게 유지하기

여러분 중 일부는 터미널을 가볍게 유지하고 싶어 하거나, 직접 검증한 플래닝 프로세스를 가지고 있을 수도 있다는 것을 알고 있습니다. 플랜 모드가 마음에 들지 않다면, 비활성화는 아주 쉽습니다!

1. /settings를 입력하고 **“Plan”**을 검색하여 끕니다.
   이렇게 하면:
   • Shift+Tab 순환에서 플랜 모드가 제거됩니다.
   • enter_plan_mode와 exit_plan_mode 도구가 등록 해제됩니다.

우리는 Gemini CLI가 여러분의 워크플로에 맞게 작동하길 원합니다. 사전에 코딩된 계획의 구조적 안전성을 선호하든, Auto‑Edit 모드로 모험을 즐기든 선택은 여러분에게 달려 있습니다!

우리는 언제나 플래닝 워크플로를 개선하려고 노력하고 있습니다. 다음 큰 기능에 적용해 보고, 여러분의 의견을 알려 주세요.

• Plan mode documentation
• GitHub repository
• Follow Gemini CLI on X for the latest news and announcements.