Guia de configuração completa de Gemini CLI para o seu terminal

Você já desejou um assistente de IA bem dentro da janela do terminal? Bem, seu sonho pode ter se tornado realidade porque o Google acabou de lançar a CLI Gemini. Neste tutorial, vou mostrar tudo o que você precisa saber sobre esse novo agente de IA de código aberto. Abordaremos como usá -lo, os preços e algumas dicas e truques úteis. Então, se você estiver pronto, vamos começar! 😉

” alt=”” aria-hidden=”true” />

O que é Gemini CLI?

O CLI Gemini é um agente de IA gratuito e de código aberto que funciona diretamente no seu terminal. Essa ferramenta poderosa leva os modelos de Gemini do Google para sua linha de comando, permitindo a interação da linguagem natural para realizar o trabalho. Você pode pedir para:

• Escreva e explique o código.
• Editar arquivos.
• Explique erros.
• Execute comandos do shell.
• E muito mais!

Você não precisa alternar constantemente entre um aplicativo da Web e seu terminal. E a melhor parte? Isso é livresem configuração complicada.

Introdução com Gemini CLI

Etapa 1: Instale a CLI Gemini no Linux

Você pode instalar CLI GEMINI sobre LinuxAssim, Mace Windows. Toda a configuração faremos dentro do terminal. Estou usando o Linux, mas para Mac e Windows, os comandos são quase os mesmos, para que você possa seguir minhas etapas.

Para começar, verifique se você tem Node.js versão 18 ou superior. Você pode verificar isso executando:

node -v

Se você não tiver, use o seguinte comando para instalá -lo:

sudo apt update && sudo apt install nodejs npm

Em seguida, instalei a CLI Gemini globalmente com:

npm install -g @google/gemini-cli

Se você não quiser instalá -lo globalmente, também pode usar:

npx 

Etapa 2: Execute e faça login

Após a instalação, basta digitar:

gemini

Depois disso, você precisa fazer login com sua conta pessoal do Google.

Isso oferece acesso a uma licença gratuita de assistência de código de gêmeos, que inclui:

• Acesso a Gemini 2.5 Pro.
• Uma enorme janela de contexto de 1 milhão de token.
• 60 solicitações de modelo por minuto.
• 1.000 solicitações de modelo por dia sem nenhum custo.

Você também pode usar uma chave de API do Google AI Studio, se preferir.

Etapa 3: Experimente

Agora você está pronto para começar a fazer perguntas e executar tarefas. Você pode pedir ao agente para criar um projeto, corrigir os bugs, explicar o código em arquivos específicos etc. Certifique -se de executar o agente na pasta do seu projeto.

> What does the file index.js do?

Ele leu o arquivo, analisou -o e deu uma explicação clara.

> Add error handling to index.js

Você também pode executar comandos de shell diretamente usando !assim:

!ls -al

Criando um aplicativo de tarefa simples com o Google CLI

Agora que estamos todos configurados, vamos pedir à IA que crie um aplicativo de tarefa simples usando HTML, CSS e JavaScript. Vou digitar “Crie um aplicativo de tarefa simples usando JS e HTML simples” na CLI Gemini. ” Assista ao vídeo para ver o processo passo a passo e o resultado.

Assista no YouTube:

O CLI Gemini tem algumas ferramentas internas úteis. Você pode usar comandos como:

Visão geral das ferramentas da CLI Gemini

• ReadFolder (ls). Lista arquivos e pastas em um diretório – assim como o shell ls comando.
• ReadFile (read-file). Lê o conteúdo completo de um único arquivo, útil para resumos ou análises.
• ReadManyfiles (read-many-files). Lê vários arquivos de uma só vez, normalmente correspondendo a um padrão glob (por exemplo, todos .js arquivos)
• Encontrefiles (glob). Pesquisa por arquivos por padrão (por exemplo, encontre tudo config.json em todo o seu projeto).
• SearchText (grep). Pesquisa em arquivos como texto, como encontrar tudo TODO Comentários.
• Editar (edit). Aplica alterações de código via DIFFS. Gêmeos visualiza as edições e pede aprovação antes de aplicá -las.
• Writefile (write-file). Cria novos arquivos (por exemplo, README.md) com conteúdo fornecido pelo usuário.
• Concha (shell). Executa comandos que você prefixo com ! (por exemplo, !npm test) diretamente no terminal.
• WebFetch (web-fetch). Busca conteúdo da Web (HTML ou JSON), permitindo que Gemini analise dados externos.
• Googlesearch (web-search). Executa uma pesquisa no Google para aterrar respostas com informações do mundo real (por exemplo, explicação para um erro).
• Salve memória (memoryTool). Armazena fatos ou preferências durante uma sessão (como “eu prefiro assíncrono/aguardo”) para melhorar a consistência

Para ver todas as ferramentas disponíveis, você pode usar o /tools comando.

Recursos avançados

Você pode adicionar instruções específicas para a IA para um projeto específico, criando um Gemini.md arquivo no diretório raiz do seu projeto. Dentro deste arquivo, você pode definir regras do projeto, estilos de código e as ferramentas que o agente deve usar. Isso garante que o código gerado seja consistente com os padrões do seu projeto.

Integração do Google Cli MCP

Para a maioria dos usos do dia-a-dia, as ferramentas embutidas serão suficientes. Mas e se você quiser que a CLI Gemini faça algo muito específico para o domínio, como interagir com APIs específicas ou usar um modelo especializado (digamos um gerador de imagem ou uma ferramenta de análise de segurança)? É aqui que MCP (Model Context Protocol) entra.

MCP é essencialmente um padrão aberto que permite aos desenvolvedores Adicione novas ferramentas/habilidades à IA executando um servidor que a CLI pode se comunicar. Na CLI Gemini, você pode configurar “servidores MCP” em um arquivo de configurações JSON, e a CLI os tratará como ferramentas adicionais que podem usar.

Como configurar o servidor MCP no Google CLI

Como exemplo, vou mostrar como configurar o Servidor Github MCP na CLI Gemini.

Dentro da pasta do projeto, crie uma pasta usando o comando:

mkdir -p .gemini && touch .gemini/settings.json

Dentro do arquivo, adicione o seguinte código:

{  
  "mcpServers": {  
    "github": {  
      "command": "npx",  
      "args": ["-y", "@modelcontextprotocol/server-github"],  
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "[YOUR-TOKEN]" }  
    }  
  }  
}

Depois disso /quit da cli de Gêmeos e depois reabrir.

Escrever /mcp comando, e você verá uma lista de Ferramentas do GitHub.

Agora você, agente, pode interagir com o Github. Tão simples! 🙂

Preços de Gemini CLI

Você pode experimentá -lo gratuitamente para uso pessoal, mas também há uma versão paga que é cobrada com base no uso de token.

Nível de visualização gratuito

• Custo: Grátis com a conta do Google
• Limites: Até 60 solicitações/min e 1.000 solicitações/dia
• Ótimo para desenvolvedores individuais e uso em pequena escala

Uso de chave paga / API

• Use o seu próprio Chave da API de Gêmeos Para maior uso
• Cobrado com base nos tokens consumidos (dependente do modelo e do uso)

Opções corporativas

• Disponível através Código de Gêmeos Standard ou Empresa planos
• Inclui recursos avançados como governança, registros de auditoria e cotas compartilhadas

Conclusão

Como você pode ver, a CLI Gemini é uma ferramenta realmente poderosa com muito potencial. Estou animado para ver como vou usá -lo no meu fluxo de trabalho diário.

Se você escrever código, depurar coisas ou gerenciar arquivos com frequência, vale a pena conferir essa ferramenta.

Se você tiver algum feedback, compartilhe -o nos comentários abaixo. 😉

Saúde!