Solução de problemas do Gemini
As interfaces compatíveis com Gemini e OpenAI não são a mesma coisa. Configure de acordo com o Gemini apenas se o provedor disponibilizar explicitamente interfaces relacionadas ao Gemini / Google / Vertex, ou se o tutorial declarar claramente suporte ao Gemini CLI.
O que deve ser confirmado primeiro?
| Itens a verificar | Como verificar | Por quê |
|---|---|---|
| Ferramenta de destino | Confirme que você está diagnosticando o Gemini CLI | O método de autenticação do Gemini CLI é diferente do Codex e do Claude Code |
| O provedor oferece suporte ao Gemini | Existem entradas relacionadas ao Gemini / Google / Vertex no painel ou nos tutoriais | A interface compatível com OpenAI não é a mesma que a interface do Gemini |
| Tipo de chave | Use a chave correspondente para Gemini ou Vertex | Se o tipo de chave estiver incorreto, você poderá receber 401, 403 ou ser solicitado repetidamente a fazer login |
| Nome do modelo | Preencha de acordo com a lista de modelos do Gemini | Não insira nomes de modelos da OpenAI ou Claude no Gemini |
Erros comuns
| Problema | Verificação prioritária | Soluções |
|---|---|---|
| Ainda solicita login no Google | Autenticação própria do Gemini CLI | Primeiro complete a autenticação exigida pelo Gemini CLI; a configuração do provedor não pode substituir o processo de login exigido pela própria ferramenta de destino. |
| 401 / 403 | Chave do Gemini ou permissões | Confirme se a chave pertence ao grupo Gemini / Google / Vertex e se o projeto ou conta atual possui permissões para o modelo correspondente. |
| 404 / model not found | Nome do modelo Gemini | Preencha de acordo com a lista de modelos Gemini no painel do provedor; não insira nomes de modelos OpenAI ou Claude. |
| Falha na conexão | Base URL do Gemini | Não insira a Base URL padrão compatível com OpenAI no Gemini; configure-a apenas quando o painel declarar explicitamente suporte ao Gemini. |
| Sem alterações após alternar no CC-Switch | Ferramenta de destino e status do terminal | Confirme se o destino da aplicação é o Gemini CLI, salve, reabra o terminal e teste novamente. |
Teste mínimo
Primeiro confirme se o Gemini CLI consegue retornar uma frase curta pré-definida, depois prossiga para diagnosticar tarefas mais complexas.
Teste mínimo do Gemini
gemini "Please reply only: Gemini configuration test successful"Modelo de feedback
Ao enviar feedback ao provedor, escreva assim
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