Pular para o conteúdo
Como usar o Google Gemini CLI no Terminal Linux

Como usar o Google Gemini CLI no Terminal Linux

Um guia simples para instalar e usar a Gemini CLI do Google no Ubuntu, uma maneira de linha de comando gratuita e de código aberto para acessar o Gemini LLM e usá-lo para trabalhar com arquivos locais.

Uma série de ferramentas de desenvolvedor com infusão de IA têm sido disponibilizadas para Linux recentemente, desde o emulador de terminal Warp até o Kiro, um IDE 'agêntico' apoiado pela Amazon e atualmente em fase de pré-visualização.

O Google, por outro lado, adota uma abordagem distinta. Em vez de um aplicativo independente, a empresa oferece o Gemini CLI, uma ferramenta gratuita e open-source para acessar seu LLM através de qualquer emulador de terminal moderno em Linux (ou macOS e Windows – não é exclusivo).

O CLI do Gemini realiza a maioria das funções do Gemini tradicional, mas dentro do ambiente da linha de comando. Isso permite que ele interaja diretamente com o sistema, leia e edite arquivos e execute comandos (útil para depuração assistida). E sim, se a sua criatividade esgotou, pode usá-lo para diluir a web com mais lixo derivado que afoga os esforços humanos genuínos, desenvolver um problema de saúde mental ou criar um aplicativo elegante com código que você não entende – como os LLMs de fato!

O que o Gemini CLI pode fazer?

O Google destaca a capacidade do Gemini CLI na codificação, mas destaca-o como um utilitário versátil aplicável a diversos tipos de tarefas. Algumas das funcionalidades mais interessantes incluem:

  • Consultar e editar grandes bases de código;
  • Gerar aplicativos a partir de PDFs ou esboços usando recursos multimodais;
  • Automatizar tarefas como revisar solicitações pull ou realizar rebases;
  • Consultas terrestres com a Pesquisa do Google, integrada ao Gemini.

gemini-screenshot

Você pode usar o Gemini CLI gratuitamente, mas existe um porém. Você está limitado a 100 solicitações por dia (RPD) Gemini e 5 solicitações por minuto (RPM) no modelo Gemini 2.5 Pro. Superar esses limites de taxa levará a um modelo menos capaz, mas ainda compatível.

Se você planeja usá-lo com frequência para tarefas complexas nas quais requer muitas consultas rápidas em um período curto, precisa de um plano pago.

Lembre-se de verificar os Termos de Serviço e Política de Privacidade antes de usá-lo. Executá-lo com arquivos locais, que podem conter informações pessoais, é um risco.

Instalando o Gemini CLI no Ubuntu

Aqui é onde as coisas se complicam um pouco.

O Gemini CLI é distribuído como pacote Node. Ele requer Node.js versão 20.x ou superior para funcionar. O Ubuntu 24.04 LTS vem com o Node.js 18.

Para executar o Gemini CLI no Ubuntu 24.04 LTS, você precisará atualizar o Node. https://deb.nodesource.com facilita esse processo através de um repositório APT, que pode ser adicionado ao sistema. Avalie se você se sente confortável em dar acesso root a projetos de terceiros.

Se você está no Ubuntu 25.04 (ou optar por atualizar o Node para uma versão mais recente no Ubuntu 24.04 de acordo com o guia acima), siga estes passos:

Etapa 1: Instale o Node e o NPM, o gerenciador de pacotes Node, caso ainda não os tenha instalado:

sudo apt install nodejs npm

Este comando irá instalar diversas dependências extras, então esteja ciente disso.

Etapa 2: Instale o Gemini CLI usando o npx (executando pacotes do Node sem instalar globalmente, evitando a necessidade de privilégios de root):

npx https://github.com/google-gemini/gemini-cli

No Ubuntu, o comando npx será concluído silenciosamente, então você pode ficar surpreso com o resultado.

Após a instalação, o Google afirma que você pode executar gemini para iniciar a ferramenta de linha de comando em qualquer emulador de terminal no seu sistema a qualquer momento.

No entanto, no Ubuntu, a execução simples do comando gemini não funcionará depois da instalação como descrito acima, por motivo que o Google não considera um problema https://github.com/google-gemini/gemini-cli/issues/2077.

Em vez disso, você precisará executar npx @google/gemini-cli todas as vezes. Menos memorável, eu sei. Você pode instalá-lo globalmente através do npm com privilégios de root https://github.com/… , mas... Eh, não gosto de fazer isso - e apostarei que você também não.

O básico no uso da CLI do Gemini

A primeira vez que você executar o Gemini CLI, será solicitado a fazer login com sua conta do Google (nenhuma assinatura especial do Gemini ou Vertex é necessária). Isso gerar um link no terminal que você pode clicar, autenticando-se em seu navegador. A CLI será logada.

Uma recomendação é cd para um diretório de projeto antes de executar o Gemini CLI, para que você possa dar tarefas relevantes para o conteúdo está dentro.

Por exemplo, se você cd em um repositório Git, poderá iniciar a CLI do Gemini para pedir que ele "gerar um resumo de todas as alterações de ontem", "converter toda a base de código em Python" ou qualquer outra tarefa relacionada ao código.

Mas não é apenas para codificação que isso é útil. Digamos que você cd em uma pasta cheia de imagens. Você pode executar o Gemini CLI e pedir para "converter todas as imagens neste diretório para png e renomeá-las usando datas da data exif".

Se uma tarefa exigir que o Gemini CLI faça algo como instalar um pacote, acessar uma pasta diferente ou editar um arquivo, você será solicitado a permitir. Você pode fazer isso uma vez ou conceder permissão contínua.

Ele pode fazer muito mais do que isso, e existem comandos de barra bacanas que você pode utilizar para ajustar (ou esmurrar) o Gemini para trabalhar da forma que você deseja, concatenando comandos personalizados que ele (ou você) pode executar para automatizar ações comuns.

Um bom comando é /compress. Isso pode ajudar a reduzir o tamanho da entrada enviada ao modelo de linguagem, o que é útil para preservar 'tokens'. Se estiver trabalhando com arquivos grandes ou uma tarefa em andamento, isso o ajudará a permanecer dentro dos limites do nível gratuito.

Vale a pena usar o Gemini CLI?

Não estou aqui para dizer que o Gemini CLI é um produto milagroso que você "deve" usar. Como qualquer software que apresento, faço isso para informar: se existe ou não essa opção.

Comparado às ferramentas de IA baseadas em IDE, o Gemini CLI é um pouco mais interessante para mim, pois fica no mesmo terminal que uso para tudo mais. Ter acesso direto ao contexto de um diretório para trabalhar é tentador.

Mas a IA não é mágica, é uma ferramenta. Desenvolvedores que já utilizam o Gemini em um navegador da web para tarefas relacionadas a código podem achar útil ter o assistente de IA disponível no terminal, com acesso para ler e modificar arquivos locais.

Outros... Provavelmente prefeririam não convidar o monstro da IA para o seu armário.

Por · Última atualização: