Docs
구성
모델 선택

Gemini CLI 모델 선택 (/model 명령)

Gemini CLI 모델을 선택하세요. /model 명령을 사용하면 Gemini CLI에서 사용하는 모델을 구성하여 결과에 대한 더 많은 제어 권한을 얻을 수 있습니다. 복잡한 작업과 추론에는 Pro 모델을, 빠른 결과를 위해서는 Flash 모델을, 작업에 가장 적합한 모델을 선택하려면 (권장) Auto 설정을 사용하세요.

참고: /model 명령(및 --model 플래그)은 하위 에이전트가 사용하는 모델을 재정의하지 않습니다. 따라서 /model 플래그를 사용하는 경우에도 모델 사용 보고서에 다른 모델이 사용되는 것을 볼 수 있습니다.

/model 명령 사용 방법

Gemini CLI에서 다음 명령을 사용하세요:

/model

이 명령을 실행하면 옵션이 있는 대화 상자가 열립니다:

옵션설명모델
Auto (Gemini 3)시스템이 작업에 가장 적합한 Gemini 3 모델을 선택하도록 함.gemini-3-pro-preview (활성화된 경우), gemini-3-flash-preview (활성화된 경우)
Auto (Gemini 2.5)시스템이 작업에 가장 적합한 Gemini 2.5 모델을 선택하도록 함.gemini-2.5-pro, gemini-2.5-flash
Manual특정 모델 선택.사용 가능한 모든 모델.

위의 Auto 옵션 중 하나를 선택하는 것이 좋습니다. 그러나 Manual을 선택하여 사용 가능한 모델 중에서 특정 모델을 선택할 수도 있습니다.

Gemini 3 및 미리보기 기능

참고: 현재 Gemini 3는 모든 계정 유형에서 사용할 수 있는 것은 아닙니다. Gemini 3 액세스에 대한 자세한 내용은 Gemini CLI의 Gemini 3를 참조하세요.

Gemini 3 Pro 및 Gemini 3 Flash(사용 가능한 경우)를 활성화하려면 settings 명령을 사용하여 미리보기 기능을 활성화하세요.

시작 시 --model 플래그를 사용하여 특정 Gemini 모델을 지정할 수도 있습니다. 자세한 내용은 구성 문서를 참조하세요.

이러한 설정 변경 사항은 Gemini CLI와의 모든 후속 상호 작용에 적용됩니다.

모델 선택 모범 사례

  • 기본적으로 Auto 사용. 대부분의 사용자에게 Auto 옵션 모델은 속도와 성능 간의 균형을 제공하며 작업의 복잡성에 따라 올바른 모델을 자동으로 선택합니다. 예: 웹 애플리케이션 개발에는 복잡한 작업(아키텍처 구축 및 프로젝트 스캐폴딩)과 간단한 작업(CSS 생성)이 혼합되어 포함될 수 있습니다.

  • 원하는 결과를 얻지 못하면 Pro로 전환. 모델이 조금 더 "똑똑"해야 한다고 생각되면 수동으로 Pro를 선택할 수 있습니다. Pro는 가장 높은 수준의 추론과 창의성을 제공합니다. 예: 복잡하거나 다단계 디버깅 작업.

  • 더 빠른 결과가 필요하면 Flash 또는 Flash-Lite로 전환. 간단한 응답이 빨리 필요하다면 Flash 또는 Flash-Lite가 가장 좋습니다. 예: JSON 객체를 YAML 문자열로 변환.