Como conseguir uma chave de API Claude (guia 2026)

Updated 2026-07-15

Crie uma conta em console.anthropic.com, compre créditos pré-pagos com um cartão, depois gere uma chave em Settings e API Keys. Se você não pode adicionar um cartão, uma chave de gateway pré-paga chega por e-mail e funciona com o mesmo código.

Resposta rápida: três passos para uma chave de API Claude

Para conseguir uma chave de API Claude da Anthropic: crie uma conta em console.anthropic.com, compre créditos pré-pagos em Plans and billing (é necessário um cartão de crédito ou débito), depois abra Settings, vá em API Keys e clique em Create Key. A chave começa com sk-ant- e é exibida exatamente uma vez, então copie-a imediatamente para um gerenciador de senhas ou uma variável de ambiente. Duas coisas costumam confundir as pessoas. Primeiro, uma assinatura de chat Claude Pro ou Max não inclui acesso à API; o Console é um produto separado, com faturamento separado. Segundo, as requisições falham com um erro de crédito até que você realmente tenha comprado créditos, mesmo que a criação da chave em si funcione sem pagamento. Se sua primeira chamada retornar um erro sobre seu saldo, esse é o motivo. Se você não pode adicionar um cartão, ou quer uma chave só que alcance o Claude e outras famílias de modelos, um gateway pré-pago é a alternativa prática. Essa rota é coberta no final deste guia, com os trade-offs colocados de forma direta.

Passo 1: crie uma conta no Console da Anthropic

O Console em console.anthropic.com é o painel de desenvolvedor da Anthropic, e é diferente do app de chat claude.ai. Cadastre-se com um endereço de e-mail ou uma conta Google. A Anthropic pede para verificar um número de telefone durante o onboarding, e o acesso à API é limitado a países suportados, então confira a lista de disponibilidade da Anthropic se o fluxo de cadastro te bloquear nessa etapa. Durante a configuração você cria uma organização. Chaves, créditos, limites de taxa e logs de uso pertencem todos à organização, não ao seu login pessoal. Isso importa depois, se você convidar colegas de equipe: todo mundo compartilha o mesmo pool de créditos, e admins conseguem ver o uso detalhado por chave. Nada custa dinheiro ainda nesta etapa. Você pode navegar pela lista de modelos, ler a referência da API e abrir o Workbench, um playground no navegador para testar prompts nos modelos Claude, antes de adicionar qualquer detalhe de faturamento. O Workbench é útil para checar se um prompt se comporta como esperado antes de escrever uma linha de código de integração.

Passo 2: configure o faturamento antes da sua primeira requisição

A API da Anthropic é pré-paga. Em Plans and billing, adicione um cartão e compre um bloco inicial de créditos; a compra mínima é pequena, historicamente cinco dólares. Toda chamada de API debita desse saldo em taxas por token, então não existe fatura surpresa no final do mês. Quando o saldo chega a zero, as requisições param. Duas configurações valem a pena serem ajustadas logo no primeiro dia. O auto-reload recarrega o saldo automaticamente quando ele cai abaixo de um limiar que você define. Ative para cargas de trabalho de produção, para que um saldo esgotado nunca vire uma queda de serviço. Deixe desativado para experimentos, para que um loop descontrolado não consiga gastar mais do que você carregou de propósito. Os limites de taxa escalam com os níveis de uso. Organizações novas começam no nível mais baixo, e os limites de requisições por minuto e tokens por minuto sobem conforme seu gasto acumulado cresce. Se você vir respostas 429 durante uma rajada de tráfego em uma conta jovem, o sistema de níveis geralmente é a causa, não o seu código.

Passo 3: crie a chave e faça sua primeira chamada

No Console, abra Settings, depois API Keys, depois Create Key. Dê à chave um nome que identifique o app ou o ambiente ao qual ela pertence, porque em algum momento você vai ter várias, e chaves sem nome ficam impossíveis de auditar. O valor completo da chave só é exibido no momento da criação; depois que você fecha o diálogo, o Console mostra apenas uma versão truncada. Exporte a chave como uma variável de ambiente e teste pelo terminal antes de mexer no código da aplicação. Dois detalhes específicos da Anthropic pegam quem está migrando de outros provedores: a autenticação usa um cabeçalho x-api-key em vez de Authorization: Bearer, e toda requisição precisa incluir um cabeçalho anthropic-version. A falta do cabeçalho de versão falha com uma mensagem de erro clara, então leia o corpo da resposta quando algo quebrar.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

Segurança de chaves: cinco hábitos que evitam uma semana ruim

Esses hábitos são baratos de adotar no primeiro dia e caros de implementar depois de um incidente. Se você commitar uma chave por acidente, trate-a como vazada mesmo em um repositório privado: revogue, rotacione e limpe o histórico de commits. Scanners de segredos como o gitleaks em um pre-commit hook pegam o erro antes que ele saia da sua máquina.

  • Apenas variáveis de ambiente ou um gerenciador de segredos. Uma chave colada no código-fonte eventualmente vai acabar commitada, e scrapers vigiam repositórios públicos especificamente atrás do prefixo sk-ant-.
  • Uma chave por app e por ambiente. Chaves separadas para desenvolvimento, staging e produção deixam os logs de uso legíveis e permitem revogar uma superfície sem quebrar as outras.
  • Nunca coloque uma chave em código de navegador ou mobile. Qualquer coisa em JavaScript do lado do cliente é pública por definição. Roteie as chamadas pelo seu próprio backend e mantenha a chave no lado do servidor.
  • Revogue imediatamente diante de qualquer suspeita de vazamento. Apagar uma chave no Console a mata instantaneamente; crie a chave de substituição antes, se o app precisar continuar no ar durante a rotação.
  • Configure notificações de gasto. Um limiar de alerta de faturamento transforma uma chave vazada ou em loop de uma fatura grande em uma pequena, e não custa nada para configurar.

Quanto custa uma chamada ao Claude, com as opções mais baratas por perto

O Claude é cobrado por token, com taxas separadas de entrada e saída, e os tokens de saída dominam a fatura em gerações longas. Compare as duas colunas, não só o preço de entrada em destaque. Para dar escala, a tabela abaixo lista o Claude ao lado de outros modelos disponíveis pelo catálogo do gateway descrito na próxima seção. O DeepSeek é, de forma geral, o favorito da comunidade para tráfego econômico de alto volume, e o Claude continua sendo a escolha quando a qualidade da prosa é a prioridade.

Preços do catálogo em USD por 1M de tokens. grok-4.5 ($1.60 / $4.80), kimi-k2.6 e MiMo também estão disponíveis.
ModeloEntrada / 1M tokensSaída / 1M tokens
claude-opus-4-7$4.00$20.00
claude-sonnet-4-6$2.40$12.00
gpt-5.5$4.00$24.00
gemini-3.5-flash$1.20$7.20
glm-5$0.514$2.314
deepseek-v4-pro$0.3915$0.783
deepseek-v4-flash$0.126$0.252

Sem cartão? Consiga uma chave funcional por um gateway

Se a exigência de cartão, um bloqueio regional, ou a própria criação de conta é o obstáculo, a APIsRouter é a rota de gateway que este site documenta. É um gateway compatível com OpenAI: o checkout em /topup não exige cadastro, você paga primeiro e a chave chega por e-mail. O faturamento é pague conforme o uso, sem assinatura. Modelos globais saem 20% abaixo do preço de tabela oficial, modelos chineses ficam abaixo das taxas oficiais, e o seu primeiro depósito adiciona 100% ao saldo. Aponte qualquer SDK da OpenAI para https://api.apisrouter.com/v1 e passe um ID de modelo do catálogo: claude-sonnet-4-6 ou claude-opus-4-7 para a família Claude, deepseek-v4-flash ou glm-5 quando você quiser tokens mais baratos com a mesma chave. A mesma chave também funciona em apps voltados ao usuário final. Usuários do SillyTavern colam a base URL terminando em /v1 e a lista de modelos se preenche automaticamente a partir de /v1/models. O JanitorAI precisa do endpoint completo https://api.apisrouter.com/v1/chat/completions mais um nome de modelo e a chave. O trade-off em relação a uma chave direta da Anthropic é honesto e simples: você está confiando seu tráfego a um intermediário, e recursos do lado da Anthropic chegam no ritmo do gateway. A vantagem é um saldo só e um endpoint só cobrindo Claude, GPT, Gemini, DeepSeek e GLM, em vez de uma conta de faturamento separada por provedor.

Chave do Console AnthropicChave de gateway
Cartão exigidoSim, cartão de crédito ou débitoNão, pague no checkout
Criação de contaCadastro no Console mais verificação de telefoneNenhuma, a chave chega por e-mail
Modelo de faturamentoCréditos pré-pagos, auto-reload opcionalDepósitos pague conforme o uso
Modelos cobertosSomente a família ClaudeClaude, GPT, Gemini, DeepSeek, GLM, Kimi
Formato da APIAPI Messages da AnthropicChat completions compatível com OpenAI
Endpointhttps://api.anthropic.com/v1/messageshttps://api.apisrouter.com/v1/chat/completions
from openai import OpenAI

client = OpenAI(
    api_key="sk-...",  # chega por e-mail após o checkout
    base_url="https://api.apisrouter.com/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(response.choices[0].message.content)

Perguntas frequentes

Como consigo uma chave de API da Anthropic?

Crie uma conta em console.anthropic.com, verifique seu número de telefone, compre créditos pré-pagos em Plans and billing, depois vá em Settings, API Keys, Create Key. Copie a chave sk-ant- imediatamente; ela é exibida apenas uma vez.

A API do Claude é grátis?

Não. Não existe nível grátis de API. O app de chat claude.ai tem um plano gratuito, mas o acesso à API é cobrado por token e exige créditos comprados antes que as requisições funcionem. Um pequeno depósito pré-pago cobre um número surpreendente de requisições de teste curtas, então experimentar o Claude custa centavos, não dólares.

Posso usar a API do Claude sem cartão de crédito?

Não diretamente pela Anthropic, que exige um cartão para compras de crédito. O contorno é uma chave de gateway pré-paga: pague por um checkout que aceite seu método de pagamento, receba uma chave por e-mail e chame os modelos Claude por um endpoint compatível com OpenAI.

Por que minha chave de API do Claude não está funcionando?

Quatro causas usuais, em ordem de probabilidade: nenhum crédito comprado ainda (a chave autentica, mas as requisições são rejeitadas), o cabeçalho de autenticação errado (a Anthropic espera x-api-key, não Authorization: Bearer), um cabeçalho anthropic-version faltando, ou um ID de modelo digitado errado. O corpo do erro nomeia a parte que falhou, então leia antes de mudar o código.

Uma assinatura Claude Pro inclui acesso à API?

Não. O Claude Pro e o Max cobrem apenas os apps claude.ai. A API é cobrada separadamente pelo Console com créditos pré-pagos, e nenhum saldo se transfere para o outro.

As chaves de API da Anthropic expiram?

Não. As chaves continuam válidas até você revogá-las no Console. É exatamente por isso que chaves por app e rotação periódica importam: uma chave esquecida de um projeto paralelo antigo continua funcionando até alguém apagá-la.