Guia Definitivo: Gemini Code Assist

O Gemini Code Assist é o agente de codificação do Google que vive dentro da sua IDE — VS Code, JetBrains ou Android Studio. Se você já está no ecossistema Google Cloud, ele é a escolha natural: gratuito para uso individual, com Gemini 2.5 (e Gemini 3 chegando), agent mode com suporte a MCP servers, e integração profunda com serviços GCP.

Overview

O que é

Gemini Code Assist é uma extensão de IA para IDEs que oferece code completion, chat contextual e modo agente. Diferente de IDEs standalone como Cursor ou Google Antigravity, ele funciona como plugin — você instala na sua IDE existente e ganha superpoderes sem mudar de ambiente.

Posicionamento no mercado

O Gemini Code Assist compete diretamente com GitHub Copilot e Cline no espaço de extensões de IDE. Seu diferencial é a integração nativa com o ecossistema Google Cloud — se você trabalha com BigQuery, Firebase, Cloud Run ou Apigee, o Code Assist entende esse contexto de forma que nenhum concorrente consegue.

Modelo de execução

• Tipo: Extensão de IDE (plugin)
• IDEs suportadas: VS Code, JetBrains (IntelliJ, PyCharm, etc.), Android Studio
• Modelo de IA: Gemini 2.5 (Gemini 3 em breve)
• Execução: Cloud-based (processamento nos servidores do Google)

Planos e preços

O plano gratuito inclui code completion, chat, agent mode e quota para o Gemini CLI. Os planos pagos adicionam segurança enterprise, indemnificação de IP, code customization (Enterprise) e integrações expandidas com serviços Google Cloud.

Você pode aumentar os limites diários do plano gratuito assinando o Google AI Pro (US$ 7,99/mês) ou Ultra (US$ 19,99/mês), que compartilham quota entre Gemini Code Assist, Gemini CLI e agent mode.

Diferencial vs concorrentes

Enquanto o GitHub Copilot é agnóstico de cloud e o Cline é open-source e flexível, o Gemini Code Assist brilha quando você precisa de:

• Integração nativa com Google Cloud (Firebase, BigQuery, Cloud Run, Apigee)
• Compliance enterprise com VPC Service Controls e indemnificação de IP
• Code customization baseado nos seus repositórios privados (Enterprise)
• Quota compartilhada com Gemini CLI para workflows terminal + IDE

Tutorial

Instalação

VS Code

1. Abra o VS Code
2. Vá em Extensions (Ctrl+Shift+X)
3. Busque por “Gemini Code Assist”
4. Instale a extensão oficial do Google (publisher: Google Cloud Tools)
5. Após instalar, clique no ícone ✨ Gemini na barra de atividades

# Ou instale via terminal:
code --install-extension GoogleCloudTools.cloudcode

JetBrains (IntelliJ, PyCharm, etc.)

1. Abra Settings → Plugins → Marketplace
2. Busque “Gemini Code Assist”
3. Instale e reinicie a IDE
4. O ícone ✨ Gemini aparece na barra de ferramentas

O plugin está disponível no JetBrains Marketplace com ID 24198.

Configuração com Google Account

Na primeira vez que você clicar no ícone Gemini, será solicitado login com sua conta Google. Para o plano gratuito (Individual), basta uma conta Google pessoal. Para Standard/Enterprise, você precisa de um projeto Google Cloud com a API habilitada.

# Para Standard/Enterprise, habilite a API no projeto GCP:
gcloud services enable cloudaicompanion.googleapis.com --project=SEU_PROJETO

[IMAGEM: Screenshot da tela de login do Gemini Code Assist no VS Code]

Primeiro Uso

Após o login, o Gemini Code Assist já está ativo. Vamos testar as três funcionalidades principais:

Code Completion

Abra qualquer arquivo de código e comece a digitar. O Gemini sugere completions inline automaticamente — similar ao Copilot, com sugestões em cinza que você aceita com Tab.

# Exemplo: comece a digitar uma função e veja a sugestão
def calculate_shipping_cost(weight, distance):
    # O Gemini completa automaticamente baseado no contexto
    base_rate = 5.0
    weight_factor = 0.5 * weight
    distance_factor = 0.1 * distance
    return base_rate + weight_factor + distance_factor

As completions consideram o contexto dos arquivos abertos na IDE, então quanto mais contexto relevante estiver visível, melhores as sugestões.

Chat Contextual

Clique no ícone ✨ Gemini na barra lateral para abrir o chat. Ele tem consciência dos seus arquivos abertos e do projeto local.

Prompts úteis para começar:

• “O que este repositório faz? Me ajude a entender a arquitetura.”
• “Escreva testes unitários para este código.”
• “Me ajude a debugar este erro.”
• “Torne este código mais legível.”

O chat suporta seleção de código — selecione um trecho no editor e pergunte sobre ele diretamente.

Smart Actions

Selecione código no editor, clique com botão direito e veja as opções do Gemini:

• Explain this code — explicação detalhada do trecho
• Generate unit tests — testes para o código selecionado
• Fix this code — correção de bugs identificados
• Make more readable — refatoração para legibilidade

No VS Code, você também pode usar slash commands na barra de quick pick (/) para ações rápidas.

[IMAGEM: Screenshot mostrando smart actions no menu de contexto]

Uso Intermediário: Agent Mode

O agent mode é onde o Gemini Code Assist se transforma de assistente em agente de codificação. Em vez de apenas responder perguntas, ele executa tarefas complexas de múltiplos passos.

Ativando o Agent Mode

VS Code:

1. Abra o chat do Gemini (ícone ✨)
2. Clique no toggle Agent no topo do painel
3. O toggle fica destacado quando ativo

IntelliJ:

1. Clique em ✨ Gemini na barra de ferramentas
2. Selecione a aba Agent
3. Descreva a tarefa

O que o Agent Mode pode fazer

No modo agente, o Gemini pode:

• Ler e escrever arquivos no seu projeto
• Executar comandos no terminal
• Usar ferramentas de busca (grep, find)
• Conectar-se a MCP servers externos
• Planejar e executar tarefas multi-step
• Gerar código a partir de issues, TODOs e documentos de design

# Exemplo de prompt para agent mode:
"Adicione autenticação JWT ao endpoint /api/users. 
Use a biblioteca jsonwebtoken, crie middleware de validação,
e adicione testes para os cenários de token válido e expirado."

O agente vai planejar os passos, pedir aprovação para ações (a menos que você ative o auto-approve), e executar sequencialmente.

Controlando o Agente

Você pode:

• Comentar no plano — editar ou redirecionar antes da execução
• Aprovar/rejeitar ações — controle granular sobre cada passo
• Parar a execução — botão Stop a qualquer momento

⚠️ Cuidado: O agent mode tem acesso ao sistema de arquivos e terminal. Não ative auto-approve em projetos de produção sem entender as implicações.

Configuração Avançada

Arquivo de Contexto (GEMINI.md)

Assim como o Cursor usa .cursorrules e o Claude Code usa CLAUDE.md, o Gemini Code Assist usa GEMINI.md para regras de projeto:

# GEMINI.md (exemplo)

## Regras do Projeto

- Use TypeScript strict mode
- Siga o padrão de arquitetura hexagonal
- Testes com Vitest, mínimo 80% de cobertura
- Commits em português seguindo Conventional Commits
- Nunca modifique arquivos em /config/production/

Contextos mais específicos (subdiretórios) sobrescrevem ou complementam os mais gerais.

Configurando MCP Servers

O agent mode suporta Model Context Protocol (MCP) servers para estender suas capacidades. Configure em ~/.gemini/settings.json:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_seu_token_aqui"
      }
    },
    "cloudflare": {
      "command": "npx",
      "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
    }
  }
}

Para IntelliJ, crie um arquivo mcp.json no diretório de configuração da IDE.

Após configurar, recarregue a janela (Developer: Reload Window no VS Code). Use /mcp no chat para verificar o status dos servers.

Controlando Ferramentas Built-in

Você pode restringir quais ferramentas o agente pode usar via settings.json:

{
  "coreTools": ["ShellTool(ls -l)", "ReadFileTool", "WriteFileTool"],
  "excludeTools": ["ShellTool(rm -rf)"]
}

Isso é útil para ambientes onde você quer limitar o que o agente pode executar no terminal.

Yolo Mode (Auto-approve)

Para workflows onde você confia no agente e quer velocidade máxima:

// VS Code settings.json
{
  "geminicodeassist.agentYoloMode": true
}

⚠️ Só funciona em workspaces confiáveis (trusted workspaces). Em restricted mode, o agente sempre pede aprovação.

Usando API Key própria

Se você esgotar a quota diária, pode continuar usando com uma API key:

// VS Code settings.json
{
  "geminicodeassist.geminiApiKey": "SUA_CHAVE_API"
}

Aceita tanto Gemini API key quanto Vertex AI API key.

Deep Dive

Arquitetura Interna

O Gemini Code Assist opera em três camadas:

1. Extensão local — captura contexto (arquivos abertos, seleção, projeto), gerencia UI e aplica diffs
2. Gemini API — processamento do modelo (Gemini 2.5/3), reasoning e geração de código
3. Ferramentas e MCP — execução de ações (file I/O, terminal, servers externos)

No agent mode, o fluxo é:

1. Você envia um prompt
2. O modelo planeja os passos necessários
3. Para cada passo, solicita aprovação (ou executa direto no yolo mode)
4. Executa a ação via ferramenta apropriada
5. Observa o resultado e decide o próximo passo
6. Repete até completar a tarefa ou encontrar um bloqueio

Integração com Google Cloud

Aqui é onde o Gemini Code Assist realmente se diferencia. Nos planos Standard e Enterprise, ele se integra com:

Para quem trabalha full-stack no GCP, isso significa que o mesmo assistente que te ajuda no VS Code também entende seu schema do BigQuery, suas Cloud Functions e suas APIs no Apigee.

Code Customization (Enterprise)

No plano Enterprise, você pode conectar seus repositórios privados (GitHub, GitLab, Bitbucket) para que o Gemini gere sugestões baseadas nos padrões do seu código:

• O modelo aprende os padrões, convenções e arquitetura do seu codebase
• Sugestões ficam alinhadas com o estilo da equipe
• Funciona como um “onboarding automático” para novos devs

Isso é configurado via Google Cloud Console e requer permissões de admin no projeto GCP.

Gemini 3 no Code Assist

O Gemini 3 já está disponível no agent mode, chat e code generation. Ele traz:

• Reasoning avançado para planejamento de tarefas complexas
• Melhor compreensão de codebases grandes
• Capacidade aprimorada de interação com ferramentas e MCP servers

A página oficial indica que o Gemini 2.5 é o modelo padrão atual, com Gemini 3 “coming soon” para disponibilidade geral em todas as features.

Code Review no GitHub

O Gemini Code Assist pode revisar PRs automaticamente no GitHub:

• Análise de qualidade de código
• Sugestões de melhorias
• Detecção de bugs potenciais
• Customização do estilo de review

Isso é configurado separadamente e funciona como um reviewer automático nos seus pull requests.

Local Codebase Awareness

Uma feature poderosa: o Gemini usa sua janela de contexto grande para entender o codebase local inteiro, não apenas os arquivos abertos. Isso significa que ele pode:

• Navegar entre arquivos para entender dependências
• Sugerir código consistente com padrões existentes
• Responder perguntas sobre a arquitetura geral

Configure em ~/.gemini/settings.json ou nas configurações da extensão.

Exclusão de Arquivos

Para projetos com dados sensíveis, você pode criar um arquivo .aiexclude para impedir que o Gemini acesse determinados arquivos:

# .aiexclude
*.env
secrets/
config/production/

Isso é especialmente importante em ambientes enterprise com compliance rigoroso.

Gemini Code Assist vs Google Antigravity

Essa é uma confusão comum, então vamos esclarecer de vez:

Resumo: O Gemini Code Assist é para quem quer IA na IDE que já usa, especialmente se trabalha com Google Cloud. O Antigravity é para quem quer uma experiência completamente nova, agent-first, com múltiplos agentes trabalhando em paralelo.

Se você precisa de estabilidade e integração enterprise com GCP → Gemini Code Assist. Se você quer experimentar o futuro das IDEs com agentes autônomos → Google Antigravity.

[IMAGEM: Diagrama comparativo lado-a-lado entre Code Assist e Antigravity]

Avaliação: Spider Chart

Notas de 1 a 10 baseadas em benchmarks públicos + avaliação prática.

Média geral: 7.0/10

Metodologia: Código baseia-se em SWE-bench Verified (maio/2026) + comparação com líderes do mercado. Autonomia em avaliação prática do agent mode vs CLIs concorrentes. Demais eixos são avaliação prática comparativa. Escala: 1-4 (fraco), 5-6 (adequado), 7-8 (bom), 9-10 (excelente/líder).

[IMAGEM: Spider chart radar com 8 eixos mostrando as notas do Gemini Code Assist]

Prós e Contras

Prós

• Gratuito e generoso — O plano Individual oferece code completion, chat e agent mode sem custo. Poucos concorrentes oferecem agent mode gratuito
• Integração Google Cloud imbatível — Se você trabalha com BigQuery, Firebase, Cloud Run ou qualquer serviço GCP, nenhum outro agente entende esse contexto tão bem
• Agent mode com MCP — Suporte completo a MCP servers, permitindo estender o agente com ferramentas customizadas
• Arquivo de contexto (GEMINI.md) — Sistema de regras de projeto similar ao CLAUDE.md, com hierarquia de escopos
• Multi-IDE — Funciona em VS Code, JetBrains e Android Studio com a mesma conta
• Enterprise-grade — VPC Service Controls, indemnificação de IP, code customization — features que empresas grandes exigem
• Gemini CLI incluso — A quota é compartilhada com o Gemini CLI, então você tem agente na IDE e no terminal

Contras

• Dependência de cloud — Todo processamento é remoto. Sem internet, sem Gemini. Não há modo offline
• Latência variável — Em horários de pico, as respostas podem demorar mais que concorrentes com processamento local
• Agent mode em Preview — Ainda não é GA completo. Algumas features podem mudar ou ter instabilidades
• Menos autonomia que CLIs — Comparado com Claude Code ou Codex (CLIs), o agent mode ainda é mais conservador e pede mais aprovações
• Lock-in no ecossistema Google — As integrações avançadas só fazem sentido se você usa GCP. Fora do ecossistema Google, perde o diferencial principal
• Code customization só no Enterprise — A feature mais poderosa para times (sugestões baseadas no seu código) exige o plano mais caro (~US$ 45/mês por usuário)
• IntelliJ com menos features — Algumas funcionalidades do agent mode (como controle de tools e slash commands) não estão disponíveis no JetBrains ainda

Veredicto

Ideal para:

• Desenvolvedores que trabalham com Google Cloud diariamente
• Times enterprise que precisam de compliance, indemnificação de IP e VPC controls
• Quem quer um agente de codificação gratuito e capaz sem trocar de IDE
• Projetos que usam Firebase, BigQuery ou Cloud Run

Não é ideal para:

• Quem busca máxima autonomia do agente (prefira Claude Code ou Codex)
• Desenvolvedores que não usam nenhum serviço Google Cloud (o diferencial se perde)
• Quem precisa de modo offline ou processamento local
• Times que querem multi-agente paralelo (prefira Google Antigravity)

Se você está no ecossistema Google Cloud e quer um agente de codificação que entende seu stack de ponta a ponta — do BigQuery ao Cloud Run, do Firebase ao Apigee — o Gemini Code Assist é a escolha mais natural. O plano gratuito já é surpreendentemente capaz, e o agent mode com MCP servers coloca ele no mesmo patamar de ferramentas pagas.

Para quem precisa de ajuda implementando Gemini Code Assist em escala enterprise, com customização de code suggestions e integração com pipelines CI/CD no Google Cloud, a ft.ia.br oferece consultoria especializada em agentes de codificação para times de desenvolvimento.