CC-Switch Gemini
이 페이지에서는 CC Switch를 통해 Gemini 관련 제공자(Provider)를 Gemini CLI에 적용하는 방법을 설명합니다. Gemini의 인터페이스 및 인증 방식은 OpenAI 호환 인터페이스와 다르므로 일반 OpenAI Base URL을 그대로 입력하여 Gemini에 바로 사용할 수 없습니다.
공식 정보 다운로드 및 문서는 공식 사이트를 기준으로 합니다.
이 페이지에서 설명하는 내용
제공자가 Gemini / Google / Vertex 관련 인터페이스를 명확하게 제공하거나, 문서에 Gemini CLI 지원이 명시되어 있는 경우에만 CC Switch에서 Gemini를 설정하는 것을 권장합니다.
시작 전 확인 사항
| 확인 항목 | 확인 방법 | 이유 |
|---|---|---|
| Gemini CLI 정상 실행 여부 | 먼저 현재 기기에서 Gemini CLI가 정상적으로 실행되는지 확인합니다 | CC Switch는 설정 전환 역할만 담당합니다 |
| 제공자의 Gemini 지원 여부 | 관리자 페이지 또는 튜토리얼에 Gemini / Google / Vertex 관련 항목이 있는지 확인합니다 | OpenAI 호환 인터페이스와 Gemini 인터페이스는 서로 다릅니다 |
| API Key 유형 확인 | Key가 Gemini 또는 Vertex에 해당하는지 확인합니다 | 잘못된 Key 유형은 인증 실패를 유발합니다 |
| Gemini 목록 기반 모델명 | 제공자 관리자 페이지에서 Gemini 모델명을 복사합니다 | Claude나 OpenAI 모델명을 혼용하지 마세요 |
필드 입력 방법
| 설정 항목 | 입력 방법 | 초보자 주의사항 |
|---|---|---|
| Provider Name | 용도를 명확히 구분하여 입력합니다 | 예: 'Gemini provider' 또는 'Google Gemini' |
| Target Tool / Preset | Gemini 또는 Google / Vertex 관련 프리셋을 선택합니다 | OpenAI 호환 프리셋을 선택하지 마세요 |
| Base URL | Gemini에 해당하는 인터페이스 주소를 복사하여 입력합니다 | 관리자 페이지에서 OpenAI 주소만 제공하는 경우 임의로 입력하지 마세요 |
| API Key | Gemini / Vertex에 해당하는 Key를 복사하여 입력합니다 | Key 유형은 Base URL과 반드시 일치해야 합니다 |
| Model Name | Gemini 모델 목록을 복사하여 입력합니다 | 모델명은 일반적으로 OpenAI 및 Claude와 다릅니다 |
Gemini에 적용하기
- CC Switch를 열고 Provider 관리 영역으로 이동합니다.
- 새 Gemini Provider를 추가하거나 이미 설정된 Gemini Provider를 선택합니다.
- 대상 도구로 Gemini CLI 관련 프리셋을 선택합니다.
- Gemini에 해당하는 Base URL, API Key 및 모델명을 입력합니다.
- 저장한 후 Apply / Switch를 실행합니다.
- 터미널을 다시 열고 Gemini CLI를 사용하여 최소 테스트를 진행합니다.
정상 작동 테스트
Gemini 설정 실패의 가장 흔한 원인은 Gemini에 OpenAI 호환 주소를 입력했거나, Key 유형이 인터페이스 주소와 일치하지 않는 경우입니다.
Gemini 최소 테스트
gemini "Please reply only: CC-Switch Gemini is active"Gemini CLI에서 여전히 Google 로그인을 요구하는 경우 먼저 Gemini CLI 자체 안내를 따르세요. CC Switch는 지원하는 Provider의 설정을 동기화할 뿐이며 대상 도구 자체의 로그인 요구사항을 우회할 수는 없습니다.