Gemini 문제 해결 가이드
Gemini와 OpenAI 호환 인터페이스는 서로 다릅니다. 제공업체가 Gemini / Google / Vertex 관련 인터페이스를 명시적으로 제공하거나, 튜토리얼에서 Gemini CLI 지원을 명확히 안내하는 경우에만 Gemini 방식으로 설정하세요.
먼저 확인해야 할 사항
| 확인 항목 | 확인 방법 | 이유 |
|---|---|---|
| 대상 도구 | Gemini CLI 문제 해결을 진행 중인지 확인 | Gemini CLI의 인증 방식은 Codex 및 Claude Code와 다릅니다. |
| 제공업체의 Gemini 지원 여부 | 대시보드나 튜토리얼에 Gemini / Google / Vertex 관련 항목 확인 | OpenAI 호환 인터페이스와 Gemini 인터페이스는 다릅니다. |
| 키 유형 | Gemini 또는 Vertex에 해당하는 키 사용 | 키 유형이 올바르지 않으면 401, 403 오류가 발생하거나 로그인을 반복적으로 요청받을 수 있습니다. |
| 모델 이름 | Gemini 모델 목록에 맞춰 입력 | Gemini에 OpenAI나 Claude 모델 이름을 입력하지 마세요. |
자주 발생하는 오류
| 현상 | 우선 점검 사항 | 해결 방법 |
|---|---|---|
| 여전히 Google 로그인을 요청함 | Gemini CLI 자체 인증 | 먼저 Gemini CLI가 안내하는 필수 인증을 완료하세요. 제공업체 설정은 해당 도구 자체에서 요구하는 로그인 절차를 대신할 수 없습니다. |
| 401 / 403 | Gemini 키 또는 권한 | 키가 Gemini / Google / Vertex 그룹에 속해 있는지, 그리고 현재 프로젝트나 계정에 해당 모델에 대한 사용 권한이 있는지 확인하세요. |
| 404 / model not found | Gemini 모델 이름 | 제공업체 대시보드의 Gemini 모델 목록을 참조하여 입력하세요. OpenAI나 Claude 모델 이름은 입력하지 마세요. |
| 연결 실패 | Gemini Base URL | Gemini에 일반 OpenAI 호환 Base URL을 입력하지 마세요. 대시보드에서 Gemini 지원을 명시적으로 안내하는 경우에만 설정하세요. |
| CC-Switch 전환 후 변화 없음 | 대상 도구 및 터미널 상태 | 적용 대상이 Gemini CLI로 되어 있는지 확인하고 저장한 뒤, 터미널을 다시 열어 다시 테스트하세요. |
최소 단위 테스트
먼저 Gemini CLI가 지정된 짧은 문장을 정상 반환하는지 확인한 후, 더 복잡한 작업의 문제 해결을 진행하세요.
Gemini 최소 테스트
gemini "Please reply only: Gemini configuration test successful"문의 양식
제공업체에 문의할 때 이렇게 작성하세요
Tool: Gemini System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened