CC-Switch: Gemini
На этой странице рассказывается о подключении провайдеров с поддержкой Gemini к Gemini CLI через CC Switch. Интерфейсы и методы аутентификации Gemini отличаются от интерфейсов, совместимых с OpenAI, поэтому нельзя просто подставить стандартный OpenAI Base URL и ожидать, что он заработает с Gemini.
Официальная информация Загрузки и документация приведены в соответствии с официальным сайтом.
О чем эта страница
Настраивать Gemini в CC Switch рекомендуется только в том случае, если провайдер явно предоставляет интерфейсы Gemini / Google / Vertex или если в документации прямо указана поддержка Gemini CLI.
Что проверить перед началом
| Параметр для проверки | Как проверить | Зачем это нужно |
|---|---|---|
| Gemini CLI запускается | Сначала убедитесь, что Gemini CLI открывается на этом компьютере | CC Switch отвечает только за переключение конфигураций |
| Провайдер поддерживает Gemini | В панели управления или инструкциях есть упоминания Gemini / Google / Vertex | Интерфейс, совместимый с OpenAI, не совпадает с интерфейсом Gemini |
| Тип ключа указан верно | Убедитесь, что ключ соответствует Gemini или Vertex | Неверный тип ключа приведет к ошибке аутентификации |
| Название модели взято из списка 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 | Тип ключа должен совпадать с Base URL |
| Model Name | Скопируйте список моделей Gemini | Названия моделей обычно отличаются от моделей OpenAI и Claude |
Применение к Gemini
- Откройте CC Switch и перейдите в раздел управления провайдерами.
- Добавьте нового провайдера Gemini или выберите уже настроенного.
- Выберите в качестве целевого инструмента пресет для Gemini CLI.
- Укажите соответствующие Base URL, API Key и название модели для Gemini.
- После сохранения нажмите Apply / Switch.
- Перезапустите терминал и выполните минимальный тест с помощью Gemini CLI.
Проверка работоспособности
Чаще всего ошибки конфигурации Gemini возникают из-за указания адреса, совместимого с OpenAI, либо из-за несоответствия типа ключа адресу интерфейса.
Минимальный тест Gemini
gemini "Please reply only: CC-Switch Gemini is active"Если Gemini CLI все еще требует войти в аккаунт Google, сначала следуйте подсказкам самого Gemini CLI: CC Switch может только синхронизировать конфигурации поддерживаемых провайдеров и не может обойти требования авторизации целевого инструмента.