Migrar do Claude Code para o Antigravity: o que você precisa reconfigurar antes de começar

O Antigravity abre rápido, e ele não enxerga nada do setup que você construiu no Claude Code

Fala aí, beleza? O susto não vem na hora de instalar, vem no primeiro prompt sério

O repositório é o mesmo, o código é o mesmo, o problema também… mas as regras que você escreveu, as permissões que você ajustou com cuidado, os servidores MCP e as skills moram todos em outro lugar agora

Esse post é o checklist do que precisa ser refeito ANTES da primeira tarefa de verdade, com o caminho exato de cada coisa dos dois lados 🙂

De-para: onde cada coisa mora no Claude Code e no Antigravity

Se você só quer o mapa e sair correndo pra configurar, é essa tabela aqui

Repara numa coisa: não existe um lado "igual" na tabela

Cada linha é um arquivo que você vai escrever de novo, na mão

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 114 aulas
• 4 projetos
• 9h 18min

Conhecer formação

Antes de migrar: faça o inventário do seu setup no Claude Code

Antes de tocar em qualquer coisa do outro lado, vale sentar e listar o que você tem hoje

Porque nada disso sai exportado automaticamente, e a chance de esquecer aquela regrinha que evitava o agente fazer besteira é alta

Se liga no que levantar:

/memory        lista e abre os CLAUDE.md em uso
/permissions   mostra as regras de deny, ask e allow

• Rode /memory e abra cada CLAUDE.md que aparecer, inclusive os arquivos puxados por import @path (eles carregam no início da sessão e contam como instrução ativa)
• Rode /permissions e anote as regras de deny, ask e allow como estão hoje, além do defaultMode que você deixou nos arquivos de settings
• Localize o .mcp.json e o .worktreeinclude na raiz do repositório, e o que você guarda em .claude/ no projeto e em ~/.claude/ no global
• Liste as pastas de skills: ~/.claude/skills/, o .claude/skills/ do projeto e os que vivem em diretórios adicionados

O objetivo aqui é sair com uma LISTA ESCRITA na mão

Parece exagero, mas migrar de cabeça é o jeito mais rápido de descobrir, no meio de um refactor, que o agente está trabalhando sem metade do contexto que ele tinha antes

Checklist de migração passo a passo

A estrutura de destino no Antigravity é mais ou menos essa aqui:

~/.gemini/GEMINI.md                    regras globais
~/.gemini/config/mcp_config.json       MCP global

seu-projeto/
├── GEMINI.md   (ou AGENTS.md)         descrição do projeto
└── .agents/
    ├── rules/                         regras do workspace
    ├── mcp_config.json                MCP do workspace
    └── skills/
        └── nome-da-skill/
            └── SKILL.md

Agora, na ordem:

1. Divida o CLAUDE.md em dois lugares

O que era preferência sua, que vale pra qualquer projeto, vai pro ~/.gemini/GEMINI.md

O que é regra daquele repositório vai pra pasta .agents/rules do projeto (a raiz do git também serve, e existe suporte retroativo a .agent/rules)

Erro comum deste passo: colar o CLAUDE.md inteirinho num arquivo só, sendo que cada arquivo de regra tem limite de 12.000 caracteres. Se o seu CLAUDE.md cresceu ao longo do ano (o meu cresceu), esse é o momento de quebrar em arquivos por assunto

2. Escolha o modo de ativação de cada regra

Aqui muda o modelo mental, e é a parte que mais pega gente desavisada

No Antigravity, a regra pode ser Manual (você chama por @mention no input do Agent), Always On, Model Decision (o modelo decide pela descrição) ou Glob (padrões como *.js ou src/**/*.ts)

Erro comum deste passo: assumir que toda regra está sempre carregada, do jeito que o CLAUDE.md é lido no início de cada sessão. Se você escreveu a regra e não marcou o modo certo, ela pode simplesmente não estar ali na hora que importa. Detalhe da documentação de regras do Antigravity que vale ler com calma

3. Crie a descrição do projeto na raiz do workspace

O Antigravity aceita um GEMINI.md ou um AGENTS.md na raiz do workspace pra descrever as configurações do projeto

É o lugar do "como esse projeto funciona": stack, comandos, convenções, aquilo que você explicava toda vez no chat

4. Remonte as listas de permissão

O Antigravity tem listas Deny, Ask e Allow, avaliadas nessa ordem, e cada operação sensível é um recurso no formato action(target)

A lógica de prioridade é parecida com a do Claude Code, que também resolve na ordem deny, depois ask, depois allow, com o primeiro match decidindo. Então o trabalho é de tradução, não de reaprender o conceito

Vale conferir o padrão antes de sair configurando: comando de terminal fica em Ask, ler e escrever arquivo dentro do diretório ativo do projeto já é permitido, e o resto que você não configurou (command, mcp, execute_url, arquivo fora do workspace) cai em Ask

Erro comum deste passo: achar que escrever "pode rodar os testes sozinho" num arquivo de regra libera a ação. Não libera. O motor de permissão é do produto, não do modelo, e isso vale dos dois lados: no Claude Code, instrução dentro do CLAUDE.md também não muda o que é permitido

5. Defina o nível de autonomia

São dois comportamentos bem diferentes: Request Review nunca auto-executa terminal, com exceção do que estiver na lista Allow

Já o Always Proceed executa sem perguntar, com exceção do que estiver na lista Deny

Ou seja: no primeiro, sua lista Allow é a que trabalha. No segundo, é a Deny que segura a onda. Configurar a lista errada pro modo escolhido é o clássico "achei que estava protegido"

6. Recrie os servidores MCP

Aquilo que estava no .mcp.json da raiz agora vira JSON separado por escopo: ~/.gemini/config/mcp_config.json pro global e .agents/mcp_config.json no projeto ativo

Erro comum deste passo: recriar tudo no global "pra não repetir". Se o servidor é específico daquele cliente ou daquele repo, ele pertence ao workspace

7. Recrie as skills uma a uma

Cada skill vira uma pasta em .agents/skills/nome-da-skill/ com um SKILL.md como instrução principal

Erro comum deste passo: escrever uma descrição preguiçosa. O agente vê o nome e a descrição das skills no começo da conversa e só lê o SKILL.md completo se achar relevante, então a descrição é o que faz a skill ser usada ou ignorada

8. Reagrupe os plugins

No Claude Code, o plugin é uma unidade instalável com .claude-plugin/plugin.json juntando skills, hooks, subagents e servidores MCP

No Antigravity, o plugin é um bundle com namespace que agrupa skills, rules, servidores MCP e hooks, e ao instalar ou importar, o CLI grava os arquivos do bundle no caminho de configuração global

Conceito parecido, empacotamento diferente: dá trabalho, mas é mecânico

Uma decisão que eu deixaria pro final, depois que as listas estiverem no lugar: até onde o agente mexe no seu histórico. A conversa sobre deixar o agente commitar por você continua igualzinha aqui, só muda o nome do botão

O que muda no jeito de conduzir o agente

Essa é a parte que nenhum arquivo migra, e é onde mora a diferença real

O Antigravity tem duas superfícies de trabalho. A Editor view é a IDE que você já conhece de olhos fechados: Tab completions, comandos inline e o agente no painel lateral

A Manager view é outra história… é um mission control pra criar, orquestrar e observar VÁRIOS agentes, em vários workspaces, com Inbox e painel lateral

Se você conhece a sensação de abrir três terminais lado a lado pra rodar três tarefas em paralelo, a Manager view é a tentativa de dar interface pra isso

A segunda mudança é a revisão

Enquanto trabalha, o agente produz Artifacts, que são entregáveis revisáveis no lugar de tool calls crus: task lists, planos de implementação, walkthroughs, screenshots e gravações de navegador

A revisão acontece em marcos, não a cada passinho

É um hábito diferente de aprovar ferramenta por ferramenta, e leva um tempo pra confiar. Tome cuidado no começo: revisar em marco é ótimo quando o plano está certo, e péssimo quando o agente saiu do trilho no passo 2 e você só foi ver no passo 9

E tem a terceira, que costuma ser a que acalma quem vem do Claude Code: o produto é model-agnostic

Os modelos de agente disponíveis não são só do Google: tem modelos Gemini, tem modelos Claude e tem gpt-oss na lista

Ou seja, dá pra mudar de casa sem mudar de modelo, se o que você gosta é o Claude por dentro

E se a sua ideia é usar o Antigravity fora do editor, a autenticação do Antigravity no OpenCode tem alguns detalhes próprios que vale ver antes de conectar

Próximo passo depois de reconfigurar

Minha sugestão bem direta: não apague nada do lado do Claude Code

Mantenha os dois setups vivos por um tempo, porque a comparação honesta só aparece quando você consegue rodar a mesma tarefa nos dois e olhar o resultado

Comece por um projeto pequeno, de preferência um que você conheça de cor, só pra validar se as regras estão sendo ativadas do jeito que você marcou e se as permissões estão segurando o que deveriam segurar

Vale acompanhar o changelog do Antigravity também, porque o produto é novo (foi lançado em 18 de novembro de 2025, junto com o Gemini 3) e segue com releases frequentes, sendo a versão 1.1.13 de 14/08/2026 uma das recentes

Coisa que muda rápido merece atenção rápida, né? 😀

E se você for fazer só uma parte do checklist hoje, faz nessa ordem: regras e permissões primeiro, MCP e skills depois

Regra sem permissão certa é conselho que o agente pode ignorar, e permissão sem regra é agente trabalhando às cegas

até o próximo post!