Conectando o Antigravity à sua chave de API da Anthropic: o que você precisa saber

Se você vem rodando fluxos de IA manualmente, copiando resultados entre ferramentas ou pagando várias assinaturas só para acessar diferentes modelos de linguagem, o Antigravity foi criado exatamente para esse incômodo. A plataforma permite configurar suas próprias credenciais de API, encaminhar as solicitações diretamente pela infraestrutura da Anthropic e manter controle total sobre faturamento, limites de taxa e seleção de modelos. Mas acertar essa conexão inicial, principalmente com o sistema de gerenciamento de credenciais da Anthropic, complica a vida de um número surpreendente de usuários. Este artigo mostra o processo exato, o que observar e o que se torna possível quando tudo se encaixa.

O que é o Antigravity (e por que a conexão importa)

O Antigravity é uma plataforma construída em torno da ideia de que você deve ser dono do seu conjunto de ferramentas de IA. Em vez de encaminhar suas solicitações por um intermediário que cobra uma margem sobre os custos ou esconde qual modelo você está de fato usando, o Antigravity repassa suas credenciais de API diretamente ao provedor. Com a Anthropic, isso significa que suas solicitações vão direto aos servidores do Claude, cobradas na sua conta da Anthropic, pelo preço exato que a Anthropic publica.

Isso importa por três motivos:

• Transparência de custos: você vê exatamente quanto cada solicitação custa, cobrado diretamente dos seus créditos da Anthropic.
• Controle do modelo: você escolhe a versão específica do Claude, e não aquela que a plataforma define por padrão.
• Limites de taxa: seus limites são definidos pelo seu nível na Anthropic, e não pelo pool compartilhado do Antigravity.

A contrapartida é que a responsabilidade pela configuração fica com você. Se suas credenciais estiverem erradas, expiradas ou com permissões incorretas, nada funciona. Acertar isso na primeira vez economiza horas de depuração.

O modelo de traga sua própria chave

A maioria das plataformas de IA se enquadra em uma de duas categorias: ou elas controlam o acesso à API e cobram uma margem sobre o preço, ou pedem que você traga suas próprias credenciais. O Antigravity está firmemente no segundo grupo.

Quando você adiciona seu token de API da Anthropic ao Antigravity, a plataforma o armazena de forma criptografada e o injeta como cabeçalho Authorization em cada solicitação que você inicia. Depois que você digita o token, nunca mais vê o token em texto puro, o Antigravity não o expõe em registros, e suas solicitações são contabilizadas na sua conta pessoal da Anthropic como se você as tivesse feito diretamente.

💡 Importante: isso também significa que, se sua conta da Anthropic ficar sem créditos, as solicitações do Antigravity vão falhar com um erro de autenticação, e não de plataforma. Sempre verifique primeiro o painel de faturamento da Anthropic ao depurar problemas de conexão.

Quem realmente usa essa configuração

O modelo de traga suas próprias credenciais atrai um tipo específico de usuário: desenvolvedores, gerentes de produto com perfil técnico e pesquisadores que precisam de fluxos de IA reproduzíveis sem abrir mão do controle financeiro. Casos de uso comuns incluem:

• Pipelines de processamento de documentos em que o custo por token importa
• Ferramentas internas nas quais você não pode usar uma credencial compartilhada
• Ambientes de pesquisa que precisam de trilhas de auditoria sobre o uso da API
• Prototipagem sem compromisso com uma assinatura de IA hospedada

Se você se encaixa em alguma dessas descrições, o processo de configuração abaixo vale os 10 minutos que leva.

Antes de mexer nas configurações

Duas coisas precisam estar prontas antes de você abrir o painel de credenciais do Antigravity: uma conta ativa na Anthropic com um token de API gerado e a noção de qual nível de modelo Claude sua conta pode acessar.

Como obter seu token de API da Anthropic

A Anthropic emite tokens de API pelo Anthropic Console. Os passos são simples:

1. Entre na sua conta da Anthropic
2. Acesse API Keys na barra lateral esquerda
3. Clique em Create Key
4. Dê ao token um nome descritivo, algo como antigravity-prod ou antigravity-test
5. Copie o token imediatamente, pois ele só será exibido uma vez

💡 Nomeie seus tokens pelo propósito, não pela data. Um token chamado antigravity-prod é mais fácil de revogar ou rotacionar do que token-june-2024 quando você precisar auditar o acesso.

O formato do token começa com sk-ant-api03-, seguido de uma longa sequência alfanumérica. Se o seu não começar com sk-ant, pode estar diante de um formato descontinuado. Gere um novo no Console.

Níveis da API e o que você precisa

A Anthropic opera um sistema de níveis de uso que afeta os limites de taxa e o acesso aos modelos:

Para a maioria dos usos do Antigravity, o Nível 1 é o mínimo que você deve ter. O limite de 5 solicitações por minuto do nível gratuito vai fazer o Antigravity enfileirar ou falhar solicitações em qualquer fluxo real.

💡 Verifique seu nível antes da configuração. Acesse o Anthropic Console, depois Billing e depois Usage Limits. Seu nível atual aparece ali. Faça o upgrade antes de conectar se ainda estiver no nível gratuito.

O processo de conexão, passo a passo

Com o token de API pronto e o nível confirmado, a conexão de fato no Antigravity leva menos de cinco minutos. A interface exata varia conforme a versão do Antigravity, mas o fluxo básico é o mesmo.

Onde inserir seu token

1. Abra o Antigravity e vá em Settings (geralmente um ícone de engrenagem no canto superior direito ou na barra lateral)
2. Encontre a seção chamada API Providers ou Credentials
3. Selecione Anthropic na lista de provedores
4. Cole seu token no campo chamado API Key ou Secret Key
5. Clique em Save ou Connect

O Antigravity normalmente faz uma chamada leve de validação ao endpoint /v1/models da Anthropic para confirmar que o token é válido. Se for aceito, você verá um indicador de status verde. Se não for, uma mensagem de erro vai indicar o problema.

💡 Não adicione caracteres extras. Tokens copiados de PDFs ou e-mails às vezes trazem caracteres de formatação invisíveis. Cole primeiro em um editor de texto simples, verifique o formato e copie de novo antes de colar no Antigravity.

Verificando se a conexão funciona

Depois do sinal verde, faça uma solicitação de teste antes de construir qualquer coisa em cima da conexão:

1. Abra um novo chat ou fluxo no Antigravity
2. Selecione explicitamente um modelo da Anthropic, como Claude 4 Sonnet ou Claude 4.5 Haiku
3. Envie um prompt simples: "Responda com a palavra CONNECTED."
4. Confirme que você recebeu uma resposta e que o painel de uso da Anthropic registrou uma nova solicitação

Esse último passo é importante. Uma resposta bem-sucedida na interface do Antigravity nem sempre significa que a solicitação foi encaminhada pelo seu token. Confirmar no Anthropic Console que o uso foi registrado descarta problemas de cache ou de roteamento.

Primeira solicitação após a configuração

A primeira solicitação real costuma surpreender quem veio de um ambiente com credenciais compartilhadas. Com o seu próprio token:

• A latência pode ser diferente do que você experimentava antes, seja mais rápida (roteamento dedicado) ou mais lenta (inicialização a frio)
• Os erros são específicos: em vez de mensagens genéricas de "serviço indisponível", você vai receber os códigos de erro exatos da Anthropic
• A versão do modelo é explícita: o cabeçalho da resposta inclui o modelo exato que processou sua solicitação

Modelos Claude pelo Antigravity

Depois de conectado, você tem acesso a todos os modelos Claude que o seu nível na Anthropic permite. É aqui que a configuração compensa: você não fica mais limitado ao modelo que a plataforma licencia.

Opus, Sonnet e Haiku comparados

A Anthropic organiza o Claude em três níveis de capacidade. Cada um oferece um equilíbrio diferente entre velocidade e qualidade:

O Antigravity permite alternar entre eles no menu seletor de modelo. A escolha fica salva por fluxo de trabalho, então você pode ter um pipeline rodando Opus para análise de documentos e outro rodando Haiku para classificação em lote, ambos sob o mesmo token de API.

Qual usar em cada caso

Essa pergunta aparece o tempo todo, e a resposta é sempre: comece com o Sonnet.

O Claude 4.5 Sonnet tem uma relação entre qualidade e custo que funciona para a maioria das tarefas de produção. Recorra ao Claude Opus 4.7 quando a tarefa realmente exigir raciocínio profundo, e não só porque você quer o resultado "melhor". Recorra ao Claude 4.5 Haiku quando estiver rodando centenas ou milhares de solicitações e as saídas individuais não precisarem de acabamento.

💡 Uma regra prática: se você está gastando mais de US$ 5 por dia em um único fluxo do Antigravity usando Opus, verifique se o Sonnet produziria resultados aceitáveis por uma fração do custo. Na maioria das vezes, produz.

Faturamento, cotas e limites de taxa

Uma das maiores surpresas para desenvolvedores novos em plataformas BYOK é descobrir que o faturamento e os limites de taxa funcionam de forma diferente do esperado.

O sistema de créditos da Anthropic

A Anthropic cobra por token: tokens de entrada e de saída têm preços separados, e as tarifas variam por modelo. Em meados de 2025, a precificação aproximada era esta (consulte a página de preços da Anthropic para os valores atuais):

• Modelos Opus: US$ 15 por milhão de tokens de entrada, US$ 75 por milhão de tokens de saída
• Modelos Sonnet: US$ 3 por milhão de tokens de entrada, US$ 15 por milhão de tokens de saída
• Modelos Haiku: US$ 0,25 por milhão de tokens de entrada, US$ 1,25 por milhão de tokens de saída

Esses custos se acumulam na sua conta da Anthropic, e não no sistema de faturamento do Antigravity. O Antigravity não adiciona margem sobre o preço da Anthropic; você paga a Anthropic diretamente.

Como os custos são repassados

O Antigravity mostra o uso de tokens no painel de fluxos. Cada solicitação concluída exibe:

• Total de tokens de entrada consumidos
• Total de tokens de saída consumidos
• Custo estimado com base no modelo selecionado
• Duração da solicitação em milissegundos

Isso torna prático auditar fluxos caros antes que eles aumentem sua fatura da Anthropic. O campo de custo estimado usa as tarifas publicadas pela Anthropic, então o valor que você vê deve bater com a fatura de uso da Anthropic no fim do mês.

💡 Configure um alerta de orçamento no Anthropic Console. Em Billing, você pode definir alertas em valores específicos: US$ 25, US$ 100, o que for confortável para você. O Antigravity não vai impedir automaticamente que você gaste além do limite; o sistema de alertas da Anthropic é a proteção.

Quando as coisas dão errado

Mesmo um token de API digitado corretamente pode causar problemas. Estes são os modos de falha mais comuns e como resolvê-los.

Erros de token inválido

Erro: 401 Unauthorized ou Invalid API Key

Isso quase sempre significa uma de três coisas:

1. O token foi copiado com espaços extras no início ou no fim
2. O token foi rotacionado no Anthropic Console depois de ser adicionado ao Antigravity
3. O token foi excluído totalmente do Anthropic Console

Solução: vá às configurações do Antigravity, apague o token salvo e digite-o novamente, copiado do Anthropic Console. Não use o histórico da área de transferência se o token estiver guardado ali há mais de alguns dias.

Problemas de permissão e cota

Erro: 403 Forbidden ou Rate limit exceeded

Um 403 significa que seu token não tem permissão para acessar o modelo selecionado. Isso acontece normalmente quando você está no nível gratuito e tenta usar um modelo que exige o Nível 1 ou superior.

Um erro de limite de taxa (429) significa que você atingiu o teto de solicitações por minuto. A solução é fazer o upgrade do seu nível na Anthropic ou adicionar espaçamento entre as solicitações nas configurações do seu fluxo no Antigravity.

Problemas de latência e tempo limite

Se suas solicitações do Antigravity funcionam, mas levam 30 segundos ou mais, o problema geralmente é o tamanho do prompt, e não a conexão. A Anthropic processa os tokens de forma linear, e uma janela de contexto de 10.000 tokens leva um bom tempo para ser processada, mesmo em modelos rápidos.

Soluções para latência alta:

• Use o Claude 4.5 Haiku para tarefas que não exigem raciocínio profundo
• Reduza o tamanho do prompt de sistema; corte o texto padrão que não muda a cada solicitação
• Ative o streaming nas configurações de solicitação do Antigravity para que as respostas comecem a aparecer imediatamente

O que se torna possível depois da conexão

Colocar o token no lugar é só o ponto de partida. O que o Antigravity realmente possibilita é mais interessante do que o próprio processo de conexão.

Automatizando tarefas repetitivas

Com seu token de API ativo, o Antigravity pode rodar fluxos agendados que acionam o Claude em intervalos. Configurações automatizadas comuns incluem:

• Resumo diário de documentos: puxe documentos de uma fonte, envie-os pelo Claude 3.5 Sonnet e mande os resumos para um destino
• Classificação em lote: passe uma lista de tickets de clientes pelo Claude 4.5 Haiku para marcar categorias
• Apoio à revisão de código: envie os diffs de pull requests pelo Claude 4.5 Sonnet para gerar comentários de revisão automatizados

Cada um desses fluxos roda sob o seu token de API, com os custos indo para a sua conta da Anthropic. O custo de tokens por fluxo fica visível no painel do Antigravity.

Criando ferramentas internas com o Claude

Além da automação, o Antigravity permite criar ferramentas internas que usam o Claude como camada de raciocínio. Equipes de produto já usaram isso para criar:

• Bases de conhecimento internas em que os funcionários fazem perguntas e o Claude sintetiza respostas a partir dos documentos da empresa
• Ferramentas de revisão de contratos que sinalizam cláusulas incomuns usando o Claude Opus 4.7
• Apoio à redação de atendimento ao cliente em que o Claude 3.7 Sonnet sugere respostas aos atendentes antes de eles responderem

A principal vantagem aqui é que essas ferramentas não exigem que você construa sozinho uma camada de integração com a API. O Antigravity cuida do roteamento das solicitações; você só define o fluxo e o modelo.

💡 Mantenha dados sensíveis fora dos prompts. Mesmo com seu próprio token de API, os prompts enviados pela Anthropic estão sujeitos às políticas de tratamento de dados da Anthropic. Revise essas políticas antes de enviar dados pessoais, financeiros ou informações proprietárias pela API.

Escalando sem perder o controle

Quando um fluxo está rodando bem, a maioria das equipes passa a se perguntar como escalar sem perder a visibilidade dos custos.

Vários tokens para diferentes ambientes

A abordagem mais limpa é um token de API da Anthropic separado para cada ambiente:

• Token de antigravity-development com um limite de gastos definido no Anthropic Console
• Token de antigravity-production com monitoramento e alertas configurados
• Token de antigravity-testing rotacionado mensalmente

Isso permite acompanhar os custos por ambiente, revogar um token sem afetar os outros e auditar o uso separadamente. No Antigravity, você adiciona cada token ao respectivo workspace ou projeto.

Identificando custos descontrolados cedo

O Console da Anthropic mostra o uso separado por token e por modelo. Cruze esses dados semanalmente com o painel de fluxos do Antigravity para identificar casos em que um fluxo rodou mais do que o esperado ou selecionou um modelo mais caro do que o pretendido.

Uma verificação semanal simples:

1. Abra o Anthropic Console e vá em Usage
2. Filtre pelo token usado no Antigravity
3. Confira a divisão por modelo: as solicitações estão indo para o modelo que você pretendia?
4. Verifique se a contagem de tokens por solicitação está dentro do intervalo esperado

Picos inesperados normalmente significam que um fluxo entrou em loop e rodou mais iterações do que o planejado, ou que a janela de contexto cresceu mais do que a média. Os dois casos são fáceis de corrigir quando você os identifica.

💡 Defina max_tokens em todas as solicitações à Anthropic. O Antigravity expõe isso como um parâmetro que você pode configurar por fluxo. Limitar o tamanho da saída evita custos descontrolados em tarefas de geração sem limite que, de vez em quando, produzem respostas muito longas.

Experimente com imagens geradas por IA

Se você já resolveu a conexão com a API e quer ver o que a IA pode produzir além de texto, as ferramentas de geração de imagens do PicassoIA valem alguns minutos de experimentação. A plataforma dá acesso a mais de 90 modelos de texto para imagem, de geradores fotorrealistas a estilos artísticos, tudo sem precisar configurar credenciais nem gerenciar faturamento por conta própria. Comece com um prompt simples e vá refinando a partir dele. É a forma mais rápida de ver o que esses modelos realmente fazem quando você não está lutando com painéis de configuração.