Configure o Gemini CLI
Leve o Gemini para seu terminal.
Instale e configure com um comando
Escolha o sistema e cole no terminal. As instruções são em inglês. A chave fica oculta; escolha um modelo autorizado e confirme a configuração. Claude, Gemini e OpenClaw usam uma ferramenta Node.js 22+. Hermes usa Python 3.9+ com PyYAML, sem Node.js. A instalação do cliente exige confirmação separada.
curl -fsSL https://www.modelkiwi.com/install/gemini.sh | bashirm https://www.modelkiwi.com/install/gemini.ps1 | iexcurl -fsSL https://www.modelkiwi.com/install/gemini.sh | bashDurante a instalação
- Crie uma chave com saldo e acesso ao modelo desejado.
- Execute o comando e aceite a instalação do ambiente/cliente, se necessário.
- Cole a chave, escolha o modelo e confirme a alteração. A versão anterior recebe um backup .bak-.
- Feche e reabra o cliente. Conversas reais consomem saldo.
Regras deste cliente
A referência mostra npm e variáveis por sistema, sem script Gemini próprio. Nossa ferramenta grava ~/.gemini/.env e seleciona gemini-api-key em settings.json. Variáveis de processo e .env do projeto podem prevalecer.
Para configurar sem instalar o cliente, baixe o script e execute com --config-only. O ambiente da ferramenta continua necessário. Nenhuma conversa paga é iniciada automaticamente.
curl -fsSL https://www.modelkiwi.com/install/gemini.sh -o modelkiwi-setup.sh
bash modelkiwi-setup.sh --config-only$setup = irm https://www.modelkiwi.com/install/gemini.ps1
& ([ScriptBlock]::Create($setup)) --config-onlyO que será configurado
| Item | Valor |
|---|---|
| Arquivo | ~/.gemini/.env + ~/.gemini/settings.json |
| API | https://api.modelkiwi.com |
| Protocolo | Gemini · /v1beta/models/{model}:generateContent |
| Modelo | Selecionado da lista autorizada para sua chave. |
O instalador restringe as permissões dos arquivos e backups. Mescla os campos necessários, preservando outros provedores, skills e regras de aprovação. JSON/TOML/YAML são reformatados; o backup mantém o original.
Configuração manual e referência
Ver instalação e configuração manual
npm install -g @google/gemini-cli
gemini --versionGOOGLE_GEMINI_BASE_URL="https://api.modelkiwi.com"
GEMINI_API_KEY="YOUR_MODELKIWI_API_KEY"
GEMINI_MODEL="gemini-3.8-flash"No cliente, escolha autenticação por Gemini API Key. OAuth Google e Vertex AI usam rotas diferentes. Um .env do projeto ou variável do processo pode prevalecer sobre ~/.gemini/.env. Use o ID exato do catálogo.
Verificação e restauração
gemini --versionA consulta de versão não cobra uso. Faça uma conversa curta e confira os registros de uso. Em 401, verifique a chave; sem canal disponível, confira grupo/modelo; erros de protocolo ou ferramentas exigem conferir a compatibilidade do canal.
Para restaurar, feche o cliente, substitua o arquivo alterado pelo backup .bak- indicado e reinicie. Os backups podem conter chaves antigas; não publique os arquivos.