Gemini CLI - CometAPI Documentation

Use este guia para executar o Gemini CLI com a CometAPI como endpoint da API. Referências oficiais:

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

Pré-requisitos

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

Install Gemini CLI

npm install -g @google/gemini-cli

Ou via Homebrew (macOS / Linux):

brew install gemini-cli

Verifique:

gemini --version

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.

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.

Para evitar exportá-las novamente a cada 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.

Sintoma	Correção
`Invalid API Key` error	Verifique se `GEMINI_API_KEY` está definido 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`