Como pedir edições cirúrgicas ao Gemini 4 Hydrogen sem reescrever arquivos

Ilustração de um editor de código com uma função destacada, representando uma edição cirúrgica feita pelo Gemini 4 Hydrogen em um repositório existente
Resposta rápida

Para obter edições cirúrgicas, feche o escopo no prompt com quatro itens: o arquivo, a função, o que muda e o que não pode ser tocado. No Google Antigravity, escolha o Hydrogen no seletor de modelos e trabalhe com a política Request Review. Assim, você revisa o Implementation Plan e o diff antes que qualquer alteração seja aplicada. No fim, confira com git diff --name-only e git diff --stat se só os arquivos combinados mudaram.

Para receber do Gemini 4 Hydrogen só a alteração que você pediu, sem um arquivo inteiro mexido, feche o escopo no prompt, peça a mudança como diff e revise antes de aplicar. Sem fronteira na tarefa, nada garante que imports, nomes de variáveis e formatação fiquem intactos. Aí uma revisão rápida vira uma caça às diferenças.

O Google lançou o Gemini 4 Hydrogen em 12 de novembro de 2026, segundo o anúncio oficial no Google Blog. Ele é uma versão destilada e rápida do Gemini 4 Carbon, pensada para execução: escrever e editar código, rodar testes, verificar mudanças e chamar ferramentas em fluxos agênticos.

Este guia monta um fluxo em quatro partes: prompt com escopo fechado, pedido de diff, revisão antes de aplicar e checagem final com Git.

O que você precisa antes de pedir a primeira edição

Você precisa de um repositório versionado com Git e de acesso ao Hydrogen por um canal oficial. Só isso.

Repositório com Git e árvore limpa. Faça commit de tudo que estiver pendente antes de começar. A ideia é que o Git mostre apenas o que o modelo mexeu. Para confirmar, rode git diff --name-only: se nada aparecer, você parte do zero.

Acesso ao modelo. Segundo o Google para desenvolvedores, o Hydrogen está disponível nestes canais:

  • Gemini API, com o ID gemini-4-hydrogen
  • Google AI Studio
  • Android Studio
  • Google Antigravity

Se liga num detalhe sobre o Antigravity. O anúncio de 12 de novembro restringe o acesso aos assinantes pagos do Google AI Pro e do Ultra. Já a página de planos do Antigravity diz que todos os planos, inclusive quem não assina o Pro ou o Ultra, recebem uma quota básica dos modelos Gemini, incluindo o Hydrogen, com quota semanal menor. As duas fontes oficiais não batem, então confira o que aparece no seu plano antes de contar com o modelo.

O fluxo de revisão deste tutorial usa os recursos do Antigravity. Lá, o Hydrogen aparece no seletor de modelos, ao lado do Carbon e do Argon, conforme o blog do Antigravity.

Passo a passo para obter alterações pontuais em vez de arquivos reescritos

Antes do como, o porquê: um agente pode ir além do pedido quando não sabe onde a tarefa termina. É como contratar um pintor para retocar uma parede sem dizer qual. Ele vai pintar a casa toda e ainda achar que caprichou.

Os passos abaixo servem para desenhar essa fronteira e fiscalizá-la antes de qualquer arquivo mudar.

  1. Escolha o Hydrogen e trabalhe com a política Request Review. No seletor de modelos do Antigravity, selecione o Hydrogen. O nível de raciocínio padrão é High. Existe também um quarto nível, Extra (Extra High). Se quiser entender quando vale subir, veja o guia sobre o nível de pensamento do Hydrogen.

    Para este fluxo, use a política de revisão Request Review, que é a recomendada no codelab oficial do Antigravity. Com ela, o agente para sempre que gera um plano de implementação ou um diff e só continua depois da sua aprovação explícita. Você também pode deixar comentários inline.

    O erro comum deste passo: trabalhar sem política de revisão e descobrir o que mudou só depois que os arquivos já foram alterados.

  2. Delimite o escopo no prompt. Escreva quatro coisas: o caminho do arquivo, o nome da função ou do trecho, o que deve mudar e uma lista explícita do que não pode ser tocado. Essa última parte é a que mais pesa, e é a que quase todo mundo esquece.

    O exemplo abaixo é didático. O arquivo e a função são fictícios, então troque pelos do seu projeto:

       Tarefa: alterar SOMENTE a função validarEmail em src/utils/validacao.ts.
    
       O que mudar:
       - Rejeitar e-mails com espaços no início ou no fim.
    
       Não toque em:
       - Nenhum outro arquivo do repositório.
       - Nenhuma outra função de src/utils/validacao.ts.
       - Imports, formatação, indentação e nomes de variáveis existentes.
    
       Antes de editar, gere o plano de implementação listando
       os arquivos que pretende alterar. Depois, mostre a mudança como diff.

    O erro comum deste passo: pedir algo como "melhore este arquivo". Sem fronteira, "melhorar" vale para qualquer linha, e o modelo pode usar essa liberdade.

  3. Revise o Implementation Plan antes de qualquer edição. No Antigravity, o Implementation Plan é um artefato com os detalhes técnicos das alterações. Segundo a documentação de revisão de artefatos, ele existe para ser revisado por você, e dá para comentar inline antes que o agente modifique os arquivos locais.

    Vá direto à lista de arquivos. Se aparecer qualquer arquivo além de src/utils/validacao.ts, recuse o plano e explique o motivo no comentário.

    O erro comum deste passo: aprovar o plano pela descrição bonita sem conferir quais arquivos ele pretende abrir.

  4. Peça o diff e revise antes de aplicar. No editor do Antigravity, Accept integra o diff proposto ao arquivo e Reject descarta a proposta, mantendo o código original, conforme a documentação de revisão de mudanças.

    Na Antigravity CLI, o comando /diff abre o Interactive Diff Viewer, com os modos VCS, Turn e Commit. Lá você comenta linha a linha para orientar o agente, como descrito na documentação do /diff.

    O erro comum deste passo: clicar em Accept no automático porque o plano já tinha sido aprovado. Plano e diff são duas revisões diferentes, e é no diff que a reescrita aparece de verdade.

  5. Corrija com um prompt curto quando o diff vier largo demais. Se a mudança da função veio junto com reformatação ou imports mexidos, não aceite pensando em limpar depois. Rejeite e mande uma correção objetiva, por exemplo:
   O diff alterou a formatação e os imports de src/utils/validacao.ts.
   Refaça mantendo todas as linhas fora da função validarEmail
   exatamente como estão. Mostre o novo diff antes de aplicar.

O erro comum deste passo: aceitar um diff "quase certo" e consertar na mão. Isso abre espaço para uma alteração sutil passar despercebida no meio das linhas de formatação.

Checagem final: confirmar que nada fora do alvo foi tocado

Depois de aplicar, confirme pelo Git, que não depende do que o agente diz que fez. A documentação oficial do Git cobre os dois comandos usados aqui.

  1. Liste os arquivos alterados. Rode:
       git diff --name-only

    O resultado esperado é apenas o arquivo combinado no prompt, src/utils/validacao.ts no exemplo. Se aparecer qualquer outro nome, algo saiu do escopo.

  2. Confira o tamanho da mudança. Rode:
       git diff --stat

    Esse comando mostra um resumo por arquivo, com as linhas adicionadas e removidas. Numa edição pontual, a contagem deve ser pequena. O sinal clássico de reescrita é um monte de linhas removidas e readicionadas num arquivo em que a tarefa era trocar uma função.

  3. Se aparecer arquivo extra ou contagem desproporcional, volte ao diff. Rejeite a parte indevida ou mande um prompt de correção como o do passo 5. Depois, repita os dois comandos até a lista e a contagem baterem com o combinado.

Tome cuidado! Rodar os comandos com a árvore suja de antes mistura mudanças antigas com as do modelo, e aí você culpa o Hydrogen por algo que já estava lá. Por isso a árvore limpa é pré-requisito.

O vídeo de lançamento do canal mostra o Gemini 4 Hydrogen na Antigravity CLI em tarefas de código, incluindo o modo Orchestrator, em que o Argon planeja e o Hydrogen executa.

Próximo passo

Escolha uma tarefa pequena e real do seu repositório, como uma validação, uma mensagem de erro ou um ajuste numa função específica. Monte o prompt com as quatro partes (arquivo, trecho, o que muda e o que não pode ser tocado) e passe pelo plano, pelo diff e pela checagem com git diff --name-only e git diff --stat.

Se a lista de arquivos e a contagem de linhas baterem com o combinado, o fluxo funcionou no seu projeto. Se não baterem, você já sabe em qual etapa apertar o prompt.

Quando a tarefa crescer, vale olhar o Orchestrator do Antigravity, que junta um modelo maior para planejar e revisar com o Hydrogen fazendo a implementação. No Google AI Ultra, há as opções Orchestrator (Carbon) e Orchestrator (Argon). No Google AI Pro pago, há o Orchestrator (Argon), segundo o blog do Antigravity. O hábito continua o mesmo: ler o plano e o diff antes de aceitar 🙂.

Perguntas frequentes

Quanto custa usar o Gemini 4 Hydrogen pela API paga?

Segundo a VentureBeat, o Gemini 4 Hydrogen custa US$ 1,50 por milhão de tokens de entrada e US$ 7,50 por milhão de tokens de saída na API paga. A entrada em cache implícito sai por US$ 0,075 por milhão de tokens.

Qual é o tamanho da janela de contexto do Hydrogen e qual o ID para chamar o modelo na API?

O Gemini 4 Hydrogen tem janela de contexto de 1 milhão de tokens. Na Gemini API, o model ID usado para chamá-lo é gemini-4-hydrogen.

O que a política Request Review faz no Google Antigravity?

Com a Request Review, que é a política recomendada no codelab oficial do Antigravity, o agente sempre para quando gera um plano de implementação ou um diff de código. Ele só segue depois da sua aprovação explícita, e você pode deixar comentários inline.

Fontes consultadas

Consulta em .

Encontre outros guias no YouTube da Hora de Codar.

Escrito por | Matheus Battisti

Matheus Battisti
Fundador da Hora de Codar

Programador apaixonado pelo mundo das tecnologias, sempre buscando em aprender e se aprofundar em linguagens, frameworks e o que mais for necessário para executar um bom trabalho. Agora tem uma nova missão que é de passar seu conhecimento adiante para formar novos programadores e especializar mais os que já são.

Formações

Formação Vibe Coding

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

  • 474 aulas
  • 20 projetos
  • 39h 30min

Blog | Mais populares