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 문자열로 변환.