OpenCode com Antigravity: como funciona a autenticação e o que você precisa saber antes de conectar

Fala aí, beleza? Se o teu login trava justo na hora de conectar o OpenCode ao Antigravity, tem uma chance grande do problema não estar no teu setup

O Google diz, no FAQ oficial do Antigravity, que usar software, ferramenta ou serviço de terceiros pra acessar o Antigravity é violação dos Termos de Serviço, e que isso pode ser motivo de suspensão ou encerramento da conta

Ou seja: não é "faltou uma flag", é política mesmo

Esse post é pra quem já roda as duas pontas, chegou aqui procurando como autenticar e quer entender o que essa autenticação libera, em que pé está o plugin da comunidade e qual é o caminho que o próprio fornecedor aponta como suportado

Como funciona a autenticação no OpenCode (e o que o Antigravity é):

Formação Recomendada

Formação Agentes de IA

Domine a criação de Agentes de IA e Venda para Empresas

• 402 aulas
• 32 projetos
• 38h 19min

Conhecer formação

No OpenCode, a autenticação de provedores é feita pela linha de comando

opencode auth login

Dentro do TUI dá pra chegar no mesmo lugar pelo comando /connect, é a mesma porta de entrada

E onde a credencial fica depois que tu autentica? Salva localmente, no diretório de dados do usuário

~/.local/share/opencode/auth.json

Guarda esse caminho na cabeça, beleza? Ele volta lá no fim do post, quando a gente separar "credencial local zoada" de "bloqueio do lado do provedor"

Do outro lado da mesa está o Antigravity: a plataforma de desenvolvimento agêntico do Google, construída como um fork do Visual Studio Code e anunciada em 18/11/2025, junto do Gemini 3

Se tu quer entender melhor como o agente dele é estendido, já falamos por aqui sobre Agent Skills no Google Antigravity

E o que o plugin de terceiros faz no meio disso?

Ele autentica via OAuth com a tua conta Google pra usar os limites de uso do Antigravity dentro do OpenCode

Tem suporte a múltiplas contas e rotação automática quando bate o limite, o que já entrega bem o espírito da coisa 😀

Se tu já mexeu com autenticação SSO e OAuth2 no n8n, a mecânica te soa familiar: tu autoriza uma vez pela conta e a ferramenta passa a falar em teu nome

O detalhe é que esse "em teu nome" é exatamente o ponto que o fornecedor não quer

Em que pé está o plugin opencode-antigravity-auth hoje?

Esse é o tipo de projeto que muda de estado rápido, então vamos pelo que dá pra checar

O repositório original NoeFabris/opencode-antigravity-auth foi arquivado pelo dono e está em modo somente leitura, com o arquivamento em 30/03/2026

O pacote npm original está na versão 1.6.0 e não consta como deprecado, o que confunde bastante gente: pacote no ar não quer dizer projeto vivo

Na discussão "Good news" (#493) do repositório, o motivo declarado do arquivamento foi o anúncio de que o Google adicionaria suporte nativo ao opencode via API

E aí vieram os forks da comunidade, entre eles insign/opencode-antigravity-auth-updated, shekohex/opencode-google-antigravity-auth, vibheksoni/opencode-antigravity-auth e theblazehen/opencode-antigravity-multi-auth

O fork opencode-antigravity-auth-updated está publicado no npm na versão 1.6.2-beta.0

Se liga nisso: existir código mantido não é o mesmo que existir permissão

São duas perguntas diferentes, e a segunda é a que custa caro

O ponto de atenção antes de conectar: o risco é a conta, não o setup

Aqui mora o motivo real do post

O FAQ oficial do Antigravity afirma que usar software, ferramentas ou serviços de terceiros pra acessar o Antigravity é violação dos Termos de Serviço, e que isso pode ser motivo pra suspensão ou encerramento da conta

E não ficou no genérico: o Google atualizou o FAQ citando nominalmente ferramentas de terceiros proibidas, entre elas OpenCode, OpenClaw e Claude Code

Já aconteceu na prática também

Em fevereiro de 2026 rolou uma onda de bloqueios: contas foram desabilitadas por violação de Termos de Serviço por usar o Antigravity com ferramentas de terceiros, com erros 403 PERMISSION_DENIED, sem aviso prévio e atingindo inclusive assinantes pagos do plano AI Ultra

A justificativa pública do Google foi o aumento de uso abusivo do backend do Antigravity, que degradava a qualidade do serviço pra quem usava o produto como esperado

Depois da repercussão veio um desbanimento automático em massa das contas recém sinalizadas, em coordenação com o time do Antigravity

Final feliz? Mais ou menos … a proibição de usar ferramentas de terceiros com login do Antigravity continua valendo, e o que o Google afirmou é que passaria a ter passos claros de restauração de conta caso novas restrições aconteçam

Tome cuidado com o tamanho do estrago aqui: a conta Google não é só o Antigravity, é o resto da tua vida digital junto

Caminhos para usar Gemini no OpenCode: o que cada um exige

Coloquei os três caminhos lado a lado, porque a diferença entre eles é menos técnica e mais contratual

A terceira linha é a mais fácil de passar batido: o Google passou a oferecer o Antigravity como agente gerenciado na Gemini API

Muita gente briga com OAuth de plugin sem saber que existe uma porta da frente 🙂

Login travado ou 403 PERMISSION_DENIED: o que costuma estar acontecendo?

Quando o login não vai, a primeira coisa é descobrir de que lado está o problema

São dois mundos bem diferentes, e o sintoma engana

1. Sintoma: o login não completa ou o provedor some da lista depois de um tempo. Causa provável: credencial local inconsistente, já que o OpenCode guarda tudo em ~/.local/share/opencode/auth.json. O que fazer: refazer a autenticação pelo opencode auth login (ou pelo /connect dentro do TUI) e conferir se o provedor voltou. O erro comum deste passo: sair editando o auth.json na mão em vez de refazer o login pelo comando

2. Sintoma: autentica, mas na hora de rodar volta 403 PERMISSION_DENIED com mensagem de violação de Termos de Serviço. Causa provável: não é o teu setup, é bloqueio do lado do provedor, exatamente o padrão visto na onda de fevereiro de 2026. O que fazer: parar de tentar novamente no mesmo caminho, porque reinstalar plugin não desfaz decisão de política. O erro comum deste passo: interpretar o 403 como bug e insistir com outro fork

3. Prevenção que realmente resolve: ir de chave de API paga. Tanto a Anthropic quanto o Google bloquearam o uso de assinaturas de planos pessoais pelo OpenCode, então o caminho que sobra em pé é a chave de API. O erro comum deste passo: assumir que a assinatura que tu já paga vale como credencial de API

Vale a pena conectar OpenCode e Antigravity via plugin?

Veredito curto: tecnicamente é possível pelos forks, mas o custo do erro é desproporcional, então não compensa

Tu ganha conveniência de usar os limites do Antigravity dentro do teu TUI favorito, e arrisca a conta Google inteira num caminho que o fornecedor listou nominalmente como proibido

E tem um detalhe que fecha o argumento: o próprio Google, no FAQ do Antigravity, recomenda chave de API do Vertex ou do AI Studio pra quem quiser usar um agente de código de terceiros com o Gemini

Quando o fornecedor te aponta a porta suportada, entrar pela janela vira escolha, não necessidade

Quem quer estabilidade vai de Vertex, AI Studio ou do modelo antigravity-preview-05-2026 na Gemini API

Quem quer experimentar mesmo assim, que faça com plena consciência do que está apostando na mesa

Conclusão

A lição do tema inteiro cabe numa frase: autenticação que funciona e autenticação que é permitida são coisas diferentes

O plugin resolve o "funciona"

O FAQ oficial, a onda de bloqueios de fevereiro de 2026 e o desbanimento que veio depois resolvem o "é permitido", e não é a favor do plugin

Próximo passo concreto se tu quer o Gemini rodando no OpenCode sem dor de cabeça: gera uma chave de API no Vertex ou no AI Studio e configura o provedor pelo opencode auth login

E de tempos em tempos dá uma olhada no FAQ do Antigravity, porque esse é o tipo de política que muda sem avisar ninguém …

até o próximo post! =)