Alternativas ao Gemini CLI: escolha por fluxo de trabalho e controle da API

O Gemini CLI não foi descontinuado, mas sua porta gratuita foi — portanto, “alternativas” se divide em duas decisões diferentes. O repositório está ativo: google-gemini/gemini-cli não está arquivado, usa Apache-2.0 e recebeu seu último push em 21 de setembro de 2026; o npm estável @google/gemini-cli é 0.60.0, publicado em 15 de setembro de 2026, com versões nightly ainda sendo compiladas diariamente e sem sinalização de descontinuação (APIs do GitHub e do npm, verificadas em 21 de setembro de 2026). O que terminou foi o acesso. Se você está saindo porque o login parou de funcionar, precisa de um novo acesso. Se está saindo porque quer seu próprio endpoint por trás do agente, precisa de um novo cliente — e essa segunda decisão é determinada por uma barreira de protocolo, não por preferência.

Uma desambiguação antes de qualquer número. Uma corretora de criptomoedas também chamada Gemini publica sua própria documentação da “Gemini API” e sua própria tabela de tarifas, a MacPaw vende um localizador de arquivos duplicados para macOS chamado Gemini 2, e o protocolo gemini:// tem seus próprios navegadores de terminal. Nenhum dos preços deles pertence a esta página. Os próprios nomes do Google também se dividem em seis — Gemini CLI, Antigravity CLI, Gemini Code Assist, as assinaturas do aplicativo Gemini, a Gemini API e a Gemini Enterprise Agent Platform — portanto, cada valor abaixo informa de qual deles veio.

Por que as pessoas estão deixando o Gemini CLI agora

O Google anunciou em 19 de maio de 2026 que estava migrando o Gemini CLI para o Antigravity CLI, afirmando que “Em 18 de junho de 2026, as extensões do Gemini CLI e do Gemini Code Assist para IDE deixarão de atender solicitações do Google AI Pro e Ultra, bem como daqueles que o utilizam gratuitamente”. A página de descontinuação para consumidores do Google, atualizada pela última vez em 2 de setembro de 2026, acrescenta que “você não pode mais usar a opção Login with Google para acessar as extensões de IDE ou o Gemini CLI”, que as assinaturas Standard e Enterprise “permanecem inalteradas” e que os usuários afetados podem migrar para a família Antigravity.

Espere que uma fonte desatualizada contradiga tudo isso. O README em main ainda anuncia “60 solicitações/min e 1.000 solicitações/dia com uma conta pessoal do Google”, repete o nível gratuito mais duas vezes e não menciona nem o Antigravity nem 18 de junho (obtido em 21 de setembro de 2026). As páginas de descontinuação datadas do Google são a informação mais recente; o README é a armadilha.

A segunda armadilha é uma âncora de preço de assinatura. O Google AI lista um nível gratuito a $0, Plus a $4.99 por mês e Pro a $19.99 por mês, e o anúncio de 19 de maio de 2026 do Google informa Ultra a $100 e $200 por mês — mas essas são assinaturas do aplicativo Gemini, e Pro é justamente o nível que a publicação sobre a transição menciona como tendo deixado de ser atendido, junto com Ultra e o Code Assist gratuito para indivíduos. Nenhum nível naquela página de assinaturas é documentado como compra de cota do Gemini CLI. Não foi verificado em uma página de preços atual se os valores do Ultra ainda são válidos; a página de assinaturas não lista Ultra de forma alguma.

Continuar: quanto custa o Gemini CLI depois que a porta gratuita é fechada

Restam dois caminhos medidos. O caminho da licença é uma compra por usuário, e as cotas do Gemini Code Assist (rodapé datado de 18 de setembro de 2026) limitam-no pela quantidade de solicitações, observando que os limites diários são “agregados em todas as interações com qualquer versão ou família de modelo (por exemplo, Pro, Flash) usada com o Gemini CLI ou o modo agente” — portanto, um prompt pode consumir várias solicitações, e mudar para um modelo mais barato não cria margem adicional.

Preços lidos na página de preços do Gemini do Google em 21 de setembro de 2026; a página também mostra equivalentes por hora e observa que as assinaturas são cobradas mensalmente. O caminho principal é por token. Os preços da Gemini API, atualizados pela última vez em 16 de setembro de 2026, listam estes e outros — e os valores do Flash são um preço introdutório datado que aumenta, o tipo de número que fica desatualizado em uma publicação de blog.

Essa mesma página lista uma Batch API com redução de custo de 50% e exibe colunas de lote para esses modelos com metade das tarifas padrão. Observe a diferenciação de contexto no Pro: um loop agêntico reenvia seu contexto a cada etapa, portanto citar apenas o valor abaixo de 200 mil subestima o custo. Itens de cache, grounding e uso de ferramentas não foram extraídos aqui; trate estes valores como tarifas básicas por token, não como um total. A cota do Gemini CLI aborda com mais detalhes o lado da contagem de solicitações.

A barreira que determina sua lista final

O Gemini CLI oferece suporte a um endpoint personalizado. Sua referência de configuração no repositório documenta GOOGLE_GEMINI_BASE_URL como uma substituição da “URL base padrão para solicitações da Gemini API (ao usar a autenticação gemini-api-key)”, exigindo HTTPS, a menos que o destino seja localhost, com um GOOGLE_VERTEX_BASE_URL separado para o caminho que o Google renomeou desde então como Gemini Enterprise Agent Platform. O site da documentação renderizada do Google não lista nenhuma substituição de URL base, portanto a variável está documentada no repositório, mas não no site publicado — é real, apenas fácil de não encontrar.

A questão é o formato de transmissão. No código-fonte lançado em main, essa URL é passada ao SDK @google/genai como httpOptions.baseUrl, com vertexai definido como false; assim, toda solicitação sai no protocolo Gemini nativo do Google, e o enum de autenticação não oferece uma opção compatível com OpenAI nem com Anthropic. A chave é enviada por padrão em um cabeçalho x-goog-api-key; o mesmo arquivo lê GEMINI_API_KEY_AUTH_MECHANISM, e defini-lo como bearer move a chave para um cabeçalho Authorization nos caminhos gemini-api-key e vertex-ai — o que altera o cabeçalho, não o formato de transmissão, portanto também não é uma saída. Esse código-fonte também contém um tipo de autenticação GATEWAY não documentado, selecionado do ambiente sempre que GOOGLE_GEMINI_BASE_URL é definido — antes de GEMINI_API_KEY, ficando atrás apenas das opções explícitas de login do Google e Vertex — e cuja chave recorre a uma string vazia. A palavra “gateway” não aparece em lugar algum na documentação de configuração; ela foi interpretada como código, não como um contrato de API, e ainda fala o protocolo nativo, portanto não resolve nada.

A Kunavo oferece /v1/chat/completions, /v1/messages e /v1/responses. Testado novamente em 21 de setembro de 2026: api.kunavo.com/v1/models responde 401, enquanto /v1beta/models e /v1beta/models/<model>:generateContent respondem 404. A Kunavo não é um destino válido para GOOGLE_GEMINI_BASE_URL, e fingir o contrário faria você perder uma tarde. Mude o cliente, não o endpoint.

A Kunavo também não oferece nenhum modelo de embedding, conversão de texto em fala ou conversão de fala em texto; portanto, um fluxo de trabalho que precise de qualquer um deles mantém o provedor existente para essa etapa.

O Antigravity CLI herda a mesma barreira. Sua documentação de instalação e autenticação diz que você pode executá-lo “com sua própria chave de API do Gemini em vez de uma conta do Google conectada” e definir GOOGLE_GEMINI_BASE_URL para alcançar “um endpoint diferente compatível com Gemini” — compatível com Gemini, não compatível com OpenAI. Separadamente, sua página de planos afirma que atualmente não há suporte para “Bring-your-own-key ou bring-your-own-endpoint para limites de taxa adicionais”. Essas afirmações são compatíveis, e a ressalva é essencial: você pode executar usando sua própria chave, mas isso não compra cota de assinatura. O nível Individual está listado a $0 por mês (verificado em 21 de setembro de 2026), e nenhum limite de taxa numérico é impresso para qualquer nível. Leia as inclusões desse nível de forma restrita: a lista abaixo dele nomeia acesso a modelos, conclusões de abas ilimitadas, solicitações de comandos ilimitadas e “Basic weekly rate limits”, e não nomeia o CLI — o único plano em que essa página nomeia o CLI é o plano de organização via Google Cloud. Essa página também não responde se o nível gratuito alcança agy.

Qual alternativa se encaixa em cada motivo para sair

Status obtido da API REST do GitHub e do registro npm em 21 de setembro de 2026. Um alerta sobre o OpenCode: um repositório separado, opencode-ai/opencode, está arquivado desde setembro de 2025 e continuou como Crush; portanto, a configuração ou os preços encontrados ali descrevem a linhagem do Crush, não a do OpenCode. Compare os dois em Crush vs OpenCode e consulte preços do Qwen Code para saber quanto custam suas rotas.

O que migra e o que você deixa para trás

O Qwen Code é o salto mais curto, portanto é o que vale a pena precificar com precisão. Ambos os lados foram consultados em sua própria documentação em 21 de setembro de 2026: a referência de configuração e a referência de extensões do Gemini CLI, e as páginas de configurações e autenticação do Qwen Code. A afirmação sobre a linhagem abaixo vem do próprio README do Qwen Code, que declara que o projeto foi originalmente baseado no Gemini CLI v0.8.2 e deixou de sincronizar com o upstream na versão Qwen Code v0.1.

A rota do Antigravity tem sua própria história de migração, e uma mais limitada do que parece à primeira vista: sua visão geral do CLI diz que a integração “oferece suporte a uma importação única para migrar automaticamente suas extensões, habilidades e configurações existentes do Gemini CLI”. Ela nomeia essas três coisas e não menciona histórico de chat, checkpoints nem histórico do shell — o que não é nem uma promessa nem uma negação sobre eles.

Para a rota do Qwen Code, toda a mudança é um único bloco de configurações mesclado. Defina a chave no ambiente, informe a URL base na raiz /v1 da API, em vez do caminho completo de chat-completions, e mantenha GEMINI.md na lista de contexto para que as instruções existentes do seu projeto continuem sendo carregadas:

{
  "context": { "fileName": ["QWEN.md", "GEMINI.md"] },
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-4-6",
        "name": "Claude Sonnet 4.6 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "env": { "KUNAVO_API_KEY": "sk-kn-..." },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "claude-sonnet-4-6" }
}

A reversão é simples e vale a pena prepará-la antes de começar. Nada disso altera sua instalação do Gemini CLI: ~/.gemini/ permanece intacto em uma configuração do Qwen Code, e, se você ainda possui uma licença Code Assist Standard ou Enterprise ou uma chave paga do Gemini, gemini continua funcionando exatamente como antes. Mantenha essa rota financiada até que uma tarefa real tenha sido executada de ponta a ponta no novo cliente. De qualquer forma, copie ~/.gemini/settings.json para um local seguro primeiro — é o arquivo com maior probabilidade de ser editado manualmente duas vezes.

Uma estimativa detalhada para o novo cliente

Esta é uma aritmética ilustrativa de tokens, não um custo de tarefa medido nem um teto de cobrança. Suponha uma sessão agêntica de 10 etapas, cada uma enviando 60,000 tokens de entrada não armazenados em cache — o loop reenvia seu contexto a cada etapa — e recebendo 1,500 tokens de saída: 600,000 de entrada e 15,000 de saída no total. Nenhum cache, sobrecarga de chamadas de ferramentas ou nova tentativa é modelado, e as sessões reais variam mais do que as diferenças abaixo. As tarifas são os preços atuais do catálogo da Kunavo por milhão de tokens.

Deixar o cliente não significa deixar a família de modelos: o catálogo da Kunavo inclui modelos Gemini junto com modelos Claude e GPT, portanto uma configuração do Qwen Code ou do OpenCode ainda pode chamar Gemini 3.8 Flash. Consulte o catálogo atual para saber o que está listado no dia em que você ler isto. O valor do catálogo da Kunavo é um piso de cobrança, não um limite máximo — quando o upstream informa sua cobrança, o valor faturado é o maior entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável. O carregamento mínimo é $10 em crédito pré-pago, um mínimo de financiamento, não uma taxa de tarefa nem uma assinatura; consulte os detalhes de cobrança.

Observe qual pergunta essa tabela responde. A tarifa mais barata listada e o menor custo para concluir sua tarefa são afirmações diferentes: um modelo que precisa de três tentativas a uma tarifa baixa pode custar mais do que um que acerta de primeira. Faça a lista final com base na tarifa, depois meça uma tarefa limitada em seu próprio repositório e leia o que sua conta realmente registrou para ela.

Configure e verifique a primeira tarefa

A Kunavo publica uma referência de configuração para o salto mais próximo. Essa é uma página de configuração publicada, não um teste de compatibilidade — o Qwen Code não foi testado em tempo de execução aqui contra o endpoint da Kunavo, e nenhum outro cliente desta página foi testado. Comece pelo guia de integração do Qwen Code, ou pelas páginas do OpenCode, Crush, Cline e Aider se uma delas se encaixar melhor no seu motivo para sair. Crie uma conta na Kunavo quando estiver pronto para financiar uma chave.

Ainda está decidindo se deve trocar de cliente? Gemini CLI vs Claude Code compara diretamente os fluxos de trabalho, e a comparação de provedores do OpenCode aborda a mesma questão de roteamento pelo outro lado.

Perguntas frequentes

O status do repositório e do npm, as páginas de descontinuação e preços do Google, a documentação de instalação e planos do Antigravity e a documentação própria de configuração do Qwen Code foram todos verificados em 21 de setembro de 2026; o endpoint da Kunavo foi testado novamente no mesmo dia. Nada nesta página foi testado em tempo de execução: nenhum CLI foi instalado e nenhuma sessão foi executada contra qualquer endpoint. As tarifas por token da Kunavo vêm do catálogo atual, e o exemplo em dólares é uma aritmética ilustrativa de tokens.