Usar Gemini CLI com CometAPI

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

A disponibilidade de modelos muda com o 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 CometAPI	No seu Painel da CometAPI (começa com `sk-`)

Instalar Gemini CLI

npm install -g @google/gemini-cli

Ou via Homebrew (macOS / Linux):

brew install gemini-cli

Verifique:

gemini --version

Definir variáveis de ambiente

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.

Iniciar Gemini CLI

cd your-project
gemini

No primeiro lançamento, você será solicitado a escolher um tema, confirmar o aviso de segurança e confiar no diretório de trabalho.

Para evitar exportá-las novamente a cada sessão, adicione ao seu arquivo de configuração do 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.

Erro de chave de API inválida

Verifique se GEMINI_API_KEY está definido corretamente. Execute echo $GEMINI_API_KEY para verificar.

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 o Gemini CLI

Execute npm uninstall -g @google/gemini-cli.