Como obter uma chave da API do Claude

Obter uma chave da Anthropic, passo a passo

1. Inicie sessão na Claude Console em platform.claude.com, ou crie uma conta. A Console é o site da Anthropic para programadores, separado da aplicação de chat do Claude.
2. Adicione créditos. A API é pré-paga: na página de faturação, clique em Comprar créditos e introduza um montante. Enquanto não houver saldo, os pedidos falham com a mensagem "O seu saldo de créditos é demasiado baixo para aceder à API da Anthropic". Os créditos expiram um ano após a compra e não são reembolsáveis.
3. Crie a chave. Na página de chaves de API, clique em Criar chave, dê-lhe um nome, escolha uma data de expiração e, em Conta associada, selecione a sua conta ou uma conta de serviço para utilizações partilhadas, como um servidor ou CI. Também pode limitar a chave a um espaço de trabalho.
4. Copie-a já. A chave completa começa por sk-ant- e só é mostrada uma vez. Guarde-a num gestor de palavras-passe ou num gestor de segredos. Se a perder, não poderá voltar a vê-la: crie uma nova.

Se Criar chave estiver a cinzento, a sua função na organização não permite criar chaves; peça ajuda a um administrador.

Testar a chave

Defina-a como ANTHROPIC_API_KEY, que os SDKs da Anthropic leem automaticamente, e envie uma mensagem curta:

export ANTHROPIC_API_KEY="sk-ant-..."
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-5", "max_tokens": 64,
       "messages": [{"role": "user", "content": "Say hello"}]}'

Uma resposta JSON com o texto do Claude significa que a chave funciona. Uma chave que não esteja limitada a um espaço de trabalho também precisa do cabeçalho anthropic-workspace-id em todos os pedidos, pelo que é mais simples limitá-la a um espaço de trabalho ao criá-la.

Quanto custa uma chave da API do Claude

A chave em si é gratuita. Cada pedido é cobrado por token e descontado do seu saldo de créditos, a estes preços de tabela por 1M tokens:

A Anthropic também limita o que uma organização pode gastar por mês consoante o escalão de utilização: $500 no Start, $1,000 no Build e $200,000 no Scale. As novas organizações podem começar num escalão inferior, o Evaluation, e os limites aumentam à medida que utiliza a API, ou mais cedo através de Pedir aumento de escalão na página de limites de pedidos da Console. Ao atingir o limite, os pedidos ficam suspensos até ao primeiro dia do mês seguinte.

O Claude Pro ou o Max incluem uma chave de API?

O Claude Pro não inclui utilização da API: a API é um produto separado, faturado através da Console. O Max e o Team incluem créditos mensais para a API:

Para os obter, abra Definições → Faturação em claude.ai e associe uma organização da Console, pelo menos sete dias após a subscrição. Os créditos expiram no fim de cada ciclo de faturação e cobrem a API, o Agent SDK e o playground da Console, mas não o Claude Code.

Claude Code e chaves de API

• Com um plano Pro ou Max, não precisa de uma chave. Execute claude e inicie sessão com a sua conta claude.ai; a utilização conta para os limites do seu plano.
• Se ANTHROPIC_API_KEY estiver definida, o Claude Code usa-a assim que autorizar a sua utilização, em vez da sua subscrição, e cada token é faturado às tarifas da API. Para voltar a usar o seu plano, remova a variável e consulte /status.
• Para CI e scripts, claude setup-token cria um token válido por um ano para a sua subscrição, ou pode usar uma chave de API e pagar por token.

A comparação entre os planos e a API para o Claude Code está em Preços do Claude Code.

Existe uma chave de API do Claude gratuita?

Não através da Console: a ajuda de faturação da Anthropic não refere créditos gratuitos para novas contas, e o plano gratuito de claude.ai só inclui chat. Os únicos créditos para a API incluídos num plano são os créditos mensais do Max e do Team. Desconfie de sites que distribuem "chaves gratuitas do Claude": as chaves partilhadas acabam por ser revogadas, e alguns endpoints baratos disponibilizam outro modelo com o nome Claude (saiba como verificar em o que as APIs de IA baratas realmente vendem).

Mantenha a chave segura

• Guarde-a no servidor. Uma chave no código de front-end, numa aplicação móvel ou num repositório público fica visível para qualquer pessoa.
• Crie um espaço de trabalho próprio para cada projeto, com um limite de gastos, para que uma fuga de dados ou um ciclo de execução não esgote todo o saldo.
• Defina uma data de validade e substitua periodicamente as chaves que partilhou.
• Se uma chave for exposta, elimine-a na página de chaves de API e crie uma nova.

Outra opção: uma chave para o Claude e todos os outros modelos

Uma chave da Zurelay funciona onde funciona uma chave da Anthropic, através da mesma Messages API, e custa menos por token (65% abaixo do preço de tabela da Anthropic para o Opus 5.5). Registe-se, adicione saldo a partir de $10 e crie uma chave; começa por zr_live_. Depois, direcione o pedido para a Zurelay:

curl https://api.zurelay.com/v1/messages \
  -H "x-api-key: $ZURELAY_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-opus-5-5", "max_tokens": 64,
       "messages": [{"role": "user", "content": "Say hello"}]}'

A mesma chave dá acesso ao GPT, Gemini, DeepSeek e aos restantes modelos através de um endpoint compatível com a OpenAI, pelo que um único saldo cobre todos os modelos. A Zurelay disponibiliza a Messages API, mas não as APIs Batches ou Files da Anthropic; se precisar destas APIs ou de um contrato com a Anthropic, recorra diretamente à Anthropic. A página Alternativa à API da Anthropic compara as duas opções.

Os passos, créditos e regras dos planos foram consultados em Documentação de chaves de API, limites de pedidos, Créditos para a API no Max e no Team e Autenticação do Claude Code da Anthropic em 28 de outubro de 2026.