Gemini CLI

Configure o Gemini CLI com a CometAPI: instale via npm ou Homebrew, configure GEMINI_API_KEY e GOOGLE_GEMINI_BASE_URL, e comece a usar modelos Gemini no seu terminal.

Use este guia para executar o Gemini CLI com a CometAPI como endpoint da API.

Referências oficiais:

• Gemini CLI GitHub
• Gemini CLI Authentication

A disponibilidade dos modelos muda ao longo do tempo. Consulte a página de Modelos da CometAPI para ver os modelos Gemini disponíveis no momento.

​

Pré-requisitos

Requisito	Detalhes
Node.js	22+ (LTS recomendado)
SO	macOS, Linux ou Windows
Chave da CometAPI	No seu Painel da CometAPI (começa com sk-)

​

Configuração

1. Install Gemini CLI

   npm install -g @google/gemini-cli
   

   Ou via Homebrew (macOS / Linux):

   brew install gemini-cli
   

   Verifique:

   gemini --version
   
2. Set environment variables

   export GEMINI_API_KEY="sk-your-cometapi-key"
   export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
   

   Substitua sk-your-cometapi-key pela sua chave real da CometAPI.

3. Start Gemini CLI

   cd your-project
   gemini
   

   Na primeira execução, será solicitado que você escolha um tema, confirme o aviso de segurança e confie no diretório de trabalho.

​

Persistir variáveis de ambiente

Para evitar exportá-las novamente em toda sessão, adicione ao arquivo de configuração do seu shell:

# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

Reinicie o terminal para que as alterações tenham efeito.

​

Solução de problemas

Sintoma	Correção
Invalid API Key error	Verifique se GEMINI_API_KEY está definida corretamente. Execute echo $GEMINI_API_KEY para conferir
fetch failed	Restrições de rede podem bloquear a conexão. Tente um proxy em todo o sistema
Versão errada do Node.js	O Gemini CLI requer Node.js 22+. Execute node --version para verificar
Desinstalar	npm uninstall -g @google/gemini-cli