CC-Switch Gemini
Esta página explica como aplicar provedores relacionados ao Gemini no Gemini CLI por meio do CC Switch. As interfaces e os métodos de autenticação do Gemini são diferentes das interfaces compatíveis com a OpenAI, portanto você não pode simplesmente preencher a Base URL padrão da OpenAI e assumir que funcionará para o Gemini.
Informações oficiais Downloads e documentações estão sujeitos ao site oficial.
O que esta página explica
Recomenda-se configurar o Gemini no CC Switch apenas quando o provedor fornecer claramente interfaces relacionadas ao Gemini / Google / Vertex ou quando a documentação declarar explicitamente suporte ao Gemini CLI.
Confirmações antes de começar
| Itens a confirmar | Como verificar | Por quê |
|---|---|---|
| O Gemini CLI já inicia corretamente | Primeiro, confirme que o Gemini CLI pode ser aberto nesta máquina | O CC Switch é responsável apenas pela alternância de configurações |
| O provedor suporta o Gemini | Existem seções relacionadas ao Gemini / Google / Vertex no painel ou nos tutoriais | A interface compatível com OpenAI não é igual à interface do Gemini |
| O tipo de Key está correto | Confirme se a Key corresponde ao Gemini ou ao Vertex | Um tipo incorreto de Key causará falha na autenticação |
| O nome do modelo vem da lista do Gemini | Copie o nome do modelo Gemini a partir do painel do provedor | Não misture nomes de modelos do Claude ou da OpenAI |
Como preencher os campos
| Configuração | Como preencher | Atenção para iniciantes |
|---|---|---|
| Nome do Provider | Especifique a finalidade com clareza | Por exemplo, 'Provedor Gemini' ou 'Google Gemini' |
| Ferramenta de destino / Predefinição | Selecione predefinições relacionadas ao Gemini ou Google / Vertex | Não selecione predefinições compatíveis com OpenAI |
| Base URL | Copie o endereço de interface correspondente ao Gemini | Se o painel fornecer apenas o endereço da OpenAI, não tente preenchê-lo à força |
| API Key | Copie a Key correspondente ao Gemini / Vertex | O tipo de Key deve corresponder à Base URL |
| Nome do modelo | Copie da lista de modelos do Gemini | Os nomes dos modelos geralmente são diferentes dos do OpenAI e Claude |
Aplicar ao Gemini
- Abra o CC Switch e vá até a área de gerenciamento de Providers.
- Adicione um novo Provider do Gemini ou selecione um Provider do Gemini já configurado.
- Escolha predefinições relacionadas ao Gemini CLI como a ferramenta de destino.
- Preencha a Base URL, API Key e o nome do modelo correspondentes ao Gemini.
- Após salvar, execute Apply / Switch.
- Abra novamente o terminal e execute um teste mínimo usando o Gemini CLI.
Testar se está funcionando
Os motivos mais comuns para falhas na configuração do Gemini são preencher um endereço compatível com OpenAI para o Gemini ou usar um tipo de Key incompatível com o endereço da interface.
Teste mínimo do Gemini
gemini "Please reply only: CC-Switch Gemini is active"Se o Gemini CLI ainda solicitar login do Google, siga primeiro as instruções do próprio Gemini CLI; o CC Switch apenas sincroniza as configurações dos provedores suportados e não pode ignorar os requisitos de autenticação da própria ferramenta de destino.