Configuração do Gemini CLI
O Gemini CLI é a ferramenta de IA para terminal do Google. É ideal para usar o Gemini na linha de comando para perguntas e respostas, compreensão de código e assistência em projetos.
Informações oficiais Downloads e documentação estão sujeitos ao site oficial.
Para que serve esta ferramenta e como ela é utilizada
Google GeminiFerramentas de terminalLogin do GoogleChave de API do Gemini
Escolha primeiro o método de autenticação
| Método | Para quem é indicado | Descrição |
|---|---|---|
| Login do Google | Usuários individuais e iniciantes | Execute o Gemini e faça login conforme as instruções |
| Chave de API do Gemini | Usuários que já possuem uma chave do Google AI Studio | Insira a chave em GEMINI_API_KEY |
| Vertex AI | Usuários corporativos ou de projetos em nuvem | Configure de acordo com os projetos e permissões do Google Cloud |
Como testar a chave de API
Teste temporário no PowerShell
$env:GEMINI_API_KEY = "YOUR_GEMINI_API_KEY" geminiTeste temporário no Terminal
GEMINI_API_KEY="YOUR_GEMINI_API_KEY" geminiLogin interativo
geminiO que fazer após um teste bem-sucedido
- Primeiro, execute o Gemini CLI em um diretório vazio; não abra diretamente projetos importantes.
- Faça apenas uma pergunta curta e predeterminada para confirmar que o modelo responde normalmente.
- Em seguida, peça para ele ler um arquivo de teste e solicite explicitamente que não modifique o arquivo.
- Se você quiser usar a chave de API a longo prazo, salve o método de autenticação no seu ambiente local ou configuração de acordo com a documentação oficial do Gemini CLI.
- Se você tiver trocado de provedor de IA ou no CC-Switch, teste novamente após reabrir o terminal.
| Sintoma | Verificação prioritária | Resolução |
|---|---|---|
| Continua exigindo login do Google | O método de autenticação atual é o fluxo de login do Google? | Conclua a autenticação primeiro de acordo com os avisos do próprio Gemini CLI; não misture a solução de problemas de chave de API com o processo de login |
| Chave inválida | A GEMINI_API_KEY é do Google AI Studio / Gemini? | Não insira chaves da OpenAI ou Claude no Gemini |
| Modelo indisponível | O nome do modelo está na lista do Gemini? | Não insira nomes de modelos da OpenAI / Claude no Gemini CLI |
O que observar na configuração de provedores de IA
O Gemini CLI e provedores compatíveis com OpenAI não são a mesma coisa. Siga o tutorial do provedor apenas quando ele indicar explicitamente o método de configuração para Gemini CLI, Google Gemini ou Vertex AI.
Não insira a Base URL padrão da OpenAI no Gemini CLI. OpenAI, Claude e Gemini são três protocolos diferentes. Se o provedor disponibilizar endereços separados no painel, você deverá inserir aquele correspondente a esta ferramenta.
Documentação oficial do Gemini CLI Veja pontos de entrada de instalação, comandos e configuração.
Documentação de autenticação do Gemini CLI Consulte sobre login do Google, chave de API do Gemini e Vertex AI.