Como Obter Chave API Anthropic e Fazer Sua Primeira Requisição Claude

Uma chave de API da Anthropic é a credencial que você envia a cada solicitação para a API Claude. Ela começa com sk-ant-, você a cria no Console do Claude e ela debita o uso dos créditos pré-pagos da sua organização. Se você nunca lidou com uma, nosso guia sobre o que é uma chave de API aborda a ideia geral. Este guia cobre o específico: criar uma conta no Console, carregar créditos, gerar uma chave com o escopo correto, enviar a primeira solicitação de Mensagens com curl e o SDK Python, e manter a chave segura depois.

A página oficial da Anthropic para obter sua chave de API informa onde fica o botão. Ela não informa por que a primeira solicitação retorna 401, qual ID de modelo está atual ou como testar a chave sem colá-la no histórico do seu shell. Isso é o que o resto deste guia cobre.

O que você precisa antes de começar

• Um e-mail para o Console do Claude em platform.claude.com (console.anthropic.com agora redireciona para lá).

• Um cartão de pagamento. A API é pré-paga, e apenas um administrador ou função de faturamento pode comprar créditos.
• Curl, ou Python 3.10+ para o exemplo do SDK.
• Apidog para armazenar a chave como uma variável local e salvar a solicitação como um teste repetível. O plano gratuito cobre equipes de até quatro pessoas.

Passo 1: crie uma conta no Console do Claude

Registre-se em platform.claude.com. Isso cria uma organização com um Espaço de Trabalho Padrão, e suas chaves, créditos e limites de taxa dependem dela. Se um colega de equipe já criou uma, peça um convite em vez de criar uma segunda organização: créditos e níveis de uso não são transferíveis.

Passo 2: adicione créditos antes da sua primeira chamada

Sim, os créditos vêm primeiro. A documentação de faturamento da Anthropic é direta: compre créditos antes de usar a API, e com saldo zero, nem a API nem o playground funcionam. Novos usuários recebem uma pequena quantidade de créditos gratuitos para testar, então verifique seu saldo antes de comprar, mas trate isso como um bônus e não como um plano.

Abra Configurações > Faturamento e clique em Comprar créditos. Ative o recarregamento automático se estiver executando algo sem supervisão. Consulte como comprar créditos para as etapas atuais. Sua organização também se enquadra em um nível de uso com um limite de gastos mensal, abordado na seção de limites de taxa.

Passo 3: crie a chave de API

Vá para Configurações > Chaves de API e clique em Criar chave. Quatro escolhas são importantes:

• Nome: nomeie-o com o nome do aplicativo, não da pessoa. orders-service-staging é melhor que minha chave.
• Expiração: 3 horas a 30 dias, personalizada ou Nunca. Escolha uma vida curta para testes; não pode ser alterada depois.
• Conta vinculada: você mesmo para uma chave pessoal, uma conta de serviço para qualquer coisa compartilhada. Uma chave pessoal morre quando você sai da organização.
• Espaço de trabalho: defina o escopo para um espaço de trabalho e você pode pular o cabeçalho anthropic-workspace-id. Uma chave de vários espaços de trabalho deve enviá-lo em cada solicitação ou você receberá um 400.

O Console mostra a chave completa exatamente uma vez, então copie-a diretamente para o seu gerenciador de segredos. Não há botão de revelação. Se Criar chave estiver desabilitado, sua função não pode criar chaves; peça a um administrador.

Passo 4: os três cabeçalhos que toda solicitação precisa

Toda chamada para POST https://api.anthropic.com/v1/messages leva três cabeçalhos.

Os SDKs oficiais enviam todos os três para você. HTTP puro e clientes de API precisam deles explicitados, que é onde a maioria das falhas de primeira solicitação se originam. Referência completa: Visão geral da API Claude.

Passo 5: envie sua primeira solicitação de Mensagens

O corpo precisa de model, max_tokens e messages. Use um ID de modelo atual: a partir de setembro de 2026, são claude-opus-5 (o padrão recomendado), claude-fable-5-1 (o mais capaz), claude-sonnet-5 e claude-haiku-4-5. IDs mais antigos 3.x e 4.x retornam 404 ou apontam para modelos desativados, e IDs atuais não possuem sufixo de data. O guia da API Claude Opus 5 se aprofunda em pensamento, esforço e streaming.

curl

export ANTHROPIC_API_KEY="sk-ant-api03-..."

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-opus-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Write a one-sentence OpenAPI description for POST /orders, which creates an order and returns 201."}
    ]
  }'

Uma resposta bem-sucedida, resumida:

{
  "id": "msg_01...",
  "role": "assistant",
  "model": "claude-opus-5",
  "content": [{"type": "text", "text": "Creates a new order and returns it with a 201 status."}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 31, "output_tokens": 24}
}

Leia o texto de content[].text, verifique se stop_reason é end_turn e mantenha usage para rastreamento de custos. O cabeçalho de resposta request-id é o que o suporte pede quando algo falha.

SDK Python

pip install anthropic

import anthropic

client = anthropic.Anthropic()  # lê ANTHROPIC_API_KEY do ambiente

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": "Write a one-sentence OpenAPI description for POST /orders, which creates an order and returns 201.",
    }],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

O SDK lê ANTHROPIC_API_KEY, adiciona os cabeçalhos de versão e tipo de conteúdo, e tenta novamente 429 e 5xx duas vezes com backoff. Nunca passe a chave como uma string literal; a variável de ambiente é o ponto principal.

Passo 6: armazene e teste a chave no Apidog

Uma chave colada em um shell vive no seu arquivo de histórico. Uma chave armazenada em uma solicitação compartilhada sincroniza com os colegas de equipe. O Apidog separa os dois: a estrutura da solicitação é compartilhada, o segredo permanece na sua máquina.

Armazene a chave como uma variável local. Abra Gerenciamento de Ambiente, crie um ambiente chamado Anthropic e adicione uma variável ANTHROPIC_API_KEY. Deixe o valor compartilhado como SET_LOCALLY e cole a chave real no valor local, que permanece no cache do seu cliente e nunca sincroniza. Nosso guia para ambientes e variáveis secretas do Apidog cobre as regras de escopo.

Defina os cabeçalhos uma vez. No mesmo painel, adicione dois parâmetros globais em Cabeçalhos: x-api-key definido como {{ANTHROPIC_API_KEY}} e anthropic-version definido como 2023-06-01. Eles se aplicam a todas as solicitações no projeto, e o Apidog adiciona content-type automaticamente para um corpo JSON.

Envie a primeira solicitação. Nova solicitação, POST para https://api.anthropic.com/v1/messages, cole o corpo JSON do exemplo curl, envie. Abra a guia Solicitação Real para confirmar que ambos os cabeçalhos foram enviados com a variável resolvida. Essa guia é a maneira mais rápida de provar que um 401 é um problema de cabeçalho, não um problema de chave.

Salve-o como um teste. Salve a solicitação como um caso de endpoint e, em seguida, adicione três asserções: status igual a 200, stop_reason igual a end_turn e usage.output_tokens acima de 0. Execute-o a partir da CLI do Apidog e injete a chave do seu armazenamento de segredos CI em tempo de execução. Isso é um teste rápido de um clique para a chave, os cabeçalhos e o ID do modelo. Baixe o Apidog para acompanhar; o plano gratuito inclui quatro licenças.

Limites de taxa e quanto custa uma solicitação

Os limites são por organização e por modelo: solicitações por minuto (RPM), tokens de entrada por minuto (ITPM) e tokens de saída por minuto (OTPM). Apenas a entrada não armazenada em cache conta para ITPM, então o cache de prompts aumenta a vazão sem uma mudança de nível. Da documentação de limites de taxa:

Sonnet 5 e Haiku 4.5 compartilham os números do Opus 5 em cada nível. Toda resposta carrega os cabeçalhos anthropic-ratelimit-*-remaining e -reset, para que você possa observar a folga sem consultar o Console.

Por milhão de tokens, da página de preços: Opus 5 custa $5 de entrada / $25 de saída, Sonnet 5 $2 / $10, Fable 5.1 $10 / $50, Haiku 4.5 $1 / $5. Leituras de cache custam 10% da entrada (2,5% no Fable 5.1) e a API de Lote reduz ambos os lados pela metade. Aquela primeira solicitação curl custa uma fração de centavo.

Erros comuns e como corrigi-los

Os erros retornam como JSON com um error.type e um request_id. A referência de erros lista todos os códigos; estes são os que você encontrará primeiro.

Higiene da chave: rotação, escopo e nunca em código de cliente

Nunca envie a chave para um navegador ou aplicativo móvel. Qualquer coisa em um pacote JavaScript ou APK é pública em minutos. Coloque a chamada por trás do seu próprio backend. Para aplicativos Apple que devem chamar o Claude diretamente, o App Attest emite tokens de curta duração para builds verificados em vez de uma chave estática.

Uma chave por aplicativo e ambiente. Chaves de staging e produção separadas em espaços de trabalho separados permitem que você limite os gastos de staging e revogue uma sem tocar na outra.

Gire em um cronograma. Crie a nova chave, implante, confirme que funciona e, em seguida, exclua a antiga. Desativar é reversível; Excluir é permanente. Se suspeitar de um vazamento, desative primeiro e investigue depois. Um scanner de segredos em seu repositório detecta chaves comprometidas antes que alguém perceba.

Prefira credenciais de curta duração em produção. O Workload Identity Federation troca o token de identidade do seu provedor de nuvem por um token Claude de curta duração, para que não haja string sk-ant- para vazar.

FAQ

Uma chave de API da Anthropic é o mesmo que uma chave de API do Claude?

Sim. O Console, os SDKs e a documentação agora dizem "API Claude", e o formato da chave e os cabeçalhos são idênticos. Tutoriais mais antigos que dizem "chave de API da Anthropic" significam a mesma credencial.

Posso obter uma chave de API da Anthropic gratuitamente?

Criar a chave é gratuito. Usá-la debita de créditos pré-pagos, e a página de preços da Anthropic diz que novos usuários recebem uma pequena quantidade de créditos gratuitos para testar. Se você está tentando executar cargas de trabalho reais sem pagar, leia nossa análise honesta sobre acesso gratuito à API Claude antes de construir algo em torno disso.

Uma assinatura Claude Pro ou Max inclui acesso à API?

Não. Assinaturas Claude.ai e créditos da API do Console são cobrados separadamente. Você precisa de uma organização no Console com créditos, mesmo que já pague por Claude.ai.

O que acontece quando minha chave expira?

As solicitações retornam 401 authentication_error. Chaves expiradas não podem ser reativadas, então crie uma nova e atualize a variável de ambiente. A Anthropic envia e-mails ao criador da chave sete dias e um dia antes da expiração para chaves com vida útil longa o suficiente.

Próximo passo

Crie a chave com uma expiração de 7 dias, coloque-a em uma variável local do Apidog, execute o teste de fumaça e só então a conecte ao código. Se isso passar, a credencial, os cabeçalhos e o ID do modelo estão todos corretos, e qualquer 401 depois disso é um problema real, e não um erro de digitação.