Custos, cobrança e operações22 de outubro de 2026Flatkey Team

Chave de API da Anthropic (2026): como obter, tipos de chave, Claude Code e erros

Guia passo a passo da chave de API da Anthropic em 2026: configuração no Console, chaves pessoais e de conta de serviço, expiração, primeira requisição, Claude Code, custos e erros.

Chave de API da Anthropic (2026): como obter, tipos de chave, Claude Code e erros

Para obter uma chave de API da Anthropic, entre no Claude Console, abra API keys, clique em Create key, escolha um nome, uma expiração e uma conta vinculada (você ou uma conta de serviço) e copie a chave que começa com sk-ant-, porque o Console a mostra apenas uma vez. Adicione uma forma de pagamento ou créditos antes de chamar a API: o uso é cobrado por token e contas novas recebem só um pequeno crédito gratuito de teste, segundo a página de preços da Anthropic em 22 de outubro de 2026. A mesma chave funciona para todos os modelos Claude; não existe uma "chave da Claude API" nem uma "chave do Sonnet" separada.

Este guia é para desenvolvedores que precisam de uma chave para scripts, agentes de programação como o Claude Code ou um serviço em produção. Ele cobre os tipos de chave de 2026 (pessoal, de conta de serviço e a antiga chave de workspace), as regras de expiração, o cabeçalho anthropic-workspace-id que derruba muitas primeiras requisições, código funcional, os erros 401/400/429 mais comuns e quando uma única chave para vários provedores faz mais sentido.

A chave de API da Anthropic em 60 segundos

Passo	Onde	O que saber (verificado em 22/10/2026)
1. Entrar	platform.claude.com	As chaves de API ficam no Claude Console, não no app de chat claude.ai
2. Abrir API keys	Settings → API keys	Se Create key estiver cinza, seu papel não pode criar chaves
3. Criar a chave	Nome, expiração, conta vinculada, workspace opcional	Opções de expiração: 3 horas, 1 dia, 7 dias, 30 dias, personalizada ou Never
4. Copiar uma vez	Exibida só na criação	Começa com `sk-ant-`; chaves perdidas não podem ser vistas de novo
5. Configurar cobrança	Settings → Billing	Pagamento por uso em USD; cada nível tem um limite de gasto mensal
6. Testar	`POST https://api.anthropic.com/v1/messages`	Envie a chave como `Authorization: Bearer` (ou o antigo `x-api-key`)

Fonte: documentação da Anthropic Get your Claude API key e Authentication, verificada em 22 de outubro de 2026.

Passo a passo: crie sua chave de API da Anthropic

Crie uma conta no Console ou entre em platform.claude.com. A assinatura de chat do Claude e a API são cobradas separadamente, embora os planos Max incluam um crédito mensal de API (detalhes abaixo e no nosso guia de preços da API da Anthropic).
Abra a página API keys. Se sua organização tiver vários workspaces, você pode selecionar um para restringir a chave a ele.
Clique em Create key e preencha três campos: um nome descritivo (por exemplo ci-staging-claude), uma expiração e a Linked account. Vincular a você cria uma chave pessoal; vincular a uma conta de serviço cria uma chave para cargas de trabalho compartilhadas.
Copie a chave imediatamente. A documentação da Anthropic diz que a chave completa é exibida apenas uma vez. Guarde-a em um gerenciador de senhas ou de segredos, nunca em um repositório Git.
Adicione créditos ou um cartão na página Billing. Sem saldo, sua primeira requisição vai falhar mesmo com uma chave válida.
Exporte-a como variável de ambiente para que os SDKs a leiam automaticamente:

export ANTHROPIC_API_KEY="sk-ant-api03-..."   # macOS/Linux, current shell only
# Windows PowerShell:
# setx ANTHROPIC_API_KEY "sk-ant-api03-..."

Qual tipo de chave escolher?

Em 2026 a Anthropic distingue três tipos de chave. Escolher o errado é o motivo mais comum de uma chave "parar de funcionar do nada" quando alguém sai da equipe.

Tipo de chave	Age como	Para de funcionar quando	Use para
Chave pessoal	Você, com seus papéis	Você sai da organização, ou uma chave de workspace único perde esse workspace	Desenvolvimento local, seus scripts, seu próprio Claude Code
Chave de conta de serviço	Uma conta de serviço	A conta de serviço é arquivada ou removida do workspace	Pipelines de CI, serviços em produção, agentes compartilhados
Chave de workspace (legada)	Ninguém (pertence ao workspace)	Expira, é desativada/excluída ou o workspace é arquivado	Só integrações existentes; migre

Dados da página Authentication da Anthropic, 22 de outubro de 2026. A Anthropic recomenda chaves pessoais ou de conta de serviço porque são vinculadas a uma identidade e não sobrevivem à pessoa ou carga de trabalho dona delas. Para produção em AWS, Google Cloud, Azure, GitHub Actions ou Kubernetes, a mesma página recomenda o Workload Identity Federation, que troca chaves estáticas por tokens de curta duração.

Regras de expiração que vale conhecer

A expiração é escolhida na criação e não pode ser alterada depois.
A Anthropic envia e-mail ao criador 7 dias antes do vencimento para chaves com validade de pelo menos 14 dias, e 1 dia antes para chaves de pelo menos 7 dias; chaves mais curtas expiram sem aviso.
Depois de expirar, as requisições retornam 401 authentication_error, e chaves expiradas não podem ser reativadas, apenas excluídas.
Disable é reversível; Delete é permanente.

Um padrão prático: chaves de 30 dias para notebooks e agentes de programação, e chaves de conta de serviço guardadas em um gerenciador de segredos (com rotação) para servidores. Nossos guias de gestão segura de chaves de API para produtos de IA e de rotação de chaves atrás de um gateway aprofundam o tema.

Teste sua chave: primeira requisição em curl, Python e Node.js

O ID de modelo abaixo, claude-sonnet-5-5, é o modelo Sonnet atual na visão geral de modelos da Anthropic em 22 de outubro de 2026.

curl https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Reply with the word ok if this key works."}]
  }'

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Reply with the word ok if this key works."}],
)
print(next(b.text for b in msg.content if b.type == "text"))
print("tokens:", msg.usage.input_tokens, "in /", msg.usage.output_tokens, "out")

// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY
const msg = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 256,
  messages: [{ role: "user", content: "Reply with the word ok if this key works." }],
});
console.log(msg.content.find((b) => b.type === "text")?.text);

Um teste assim custa uma fração de centavo: no preço oficial do Sonnet 5.5, US$ 2 por milhão de tokens de entrada e US$ 10 por milhão de saída (preços da Anthropic, 22 de outubro de 2026), 30 tokens de entrada e 5 de saída custam cerca de US$ 0,0001.

O cabeçalho de workspace que quebra as primeiras requisições

Se sua chave não estiver restrita a um workspace, toda requisição precisa incluir anthropic-workspace-id; caso contrário, a API retorna 400 invalid_request_error com a mensagem "This API key is not scoped to a workspace...". O ID fica na página Workspaces do Console. A correção em Python:

client = anthropic.Anthropic(
    default_headers={"anthropic-workspace-id": "wrkspc_..."}  # only for keys not scoped to a workspace
)

Chaves criadas para um único workspace dispensam o cabeçalho, e é por isso que a Anthropic sugere restringir as chaves já na criação (documentação de Authentication).

Use sua chave de API da Anthropic com o Claude Code

O Claude Code pode se autenticar com uma assinatura do claude.ai, um login no Console, um provedor de nuvem ou uma chave de API. Segundo a documentação de autenticação do Claude Code, verificada em 22 de outubro de 2026:

Se ANTHROPIC_API_KEY estiver definida, o Claude Code pergunta no primeiro início se deve usá-la e pula o login pelo navegador depois que você aprova.
ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN e a configuração apiKeyHelper valem para a CLI, a extensão do VS Code, o Agent SDK e o GitHub Actions, mas não para o Claude Desktop nem para sessões na nuvem.
apiKeyHelper executa um script que retorna uma chave, útil para buscar uma chave de curta duração em um cofre. Se o script falhar três vezes, as requisições falham.
Usuários do Console agora podem entrar sem criar uma chave de API (Claude Code v2.1.242 ou posterior), o que salva um perfil OAuth em vez de uma chave estática. Remova ANTHROPIC_API_KEY antes de fazer isso.

export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude        # approve the key when prompted
# inside Claude Code, /status shows which credential is active

Se o Claude Code mostrar erros de token ou de login, veja nosso guia de erros de token de autenticação do Claude Code. Para apontar o Claude Code para um roteador em vez de direto para a Anthropic, veja a configuração de roteador de API para o Claude Code.

A chave de API da Anthropic é gratuita?

Criar a chave é grátis. Usá-la, não. O FAQ de preços da Anthropic diz que novos usuários recebem "uma pequena quantidade de créditos gratuitos para testar a API"; depois disso, cada requisição é cobrada por token. Uma exceção que vale conhecer: em claude.com/pricing, verificado em 22 de outubro de 2026, o plano Max 5x (US$ 100/mês) inclui US$ 100 por mês e o Max 20x US$ 200 por mês em créditos de API para a Claude Platform; o Pro (US$ 20/mês no plano mensal) não inclui nenhum. Preços de tabela atuais por milhão de tokens na página de preços da Anthropic, 22 de outubro de 2026:

Modelo	ID do modelo	Entrada	Saída	Leitura de cache
Claude Fable 5.1	`claude-fable-5-1`	$10.00	$50.00	$0.25
Claude Opus 5.5	`claude-opus-5-5`	$4.00	$20.00	$0.20
Claude Sonnet 5.5	`claude-sonnet-5-5`	$2.00	$10.00	$0.10
Claude Haiku 5.5 (prompts de até 100K)	`claude-haiku-5-5`	$0.10	$0.50	$0.01

A Batch API corta pela metade os preços de entrada e saída, e a inferência só nos EUA (inference_geo: "us") aplica um multiplicador de 1,1x. Para calcular cargas de trabalho, veja nosso guia completo de preços da API da Anthropic. Se precisar de um modelo realmente gratuito para prototipar, nossa comparação de APIs de LLM gratuitas lista opções com limites reais.

A chave vem com limites de gasto e de taxa

O nível de uso da sua organização controla tanto os limites de taxa quanto um teto de gasto mensal. Pela página de limites da Anthropic, verificada em 22 de outubro de 2026, os tetos são US$ 500 (Start), US$ 1.000 (Build) e US$ 200.000 (Scale) por mês; organizações novas podem começar em um nível Evaluation mais baixo. Ao atingir o teto, a API retorna HTTP 429 até 00:00 UTC do dia 1º do mês seguinte, a menos que você peça um nível maior. Você também pode definir seu próprio limite menor na página Billing, um bom hábito para qualquer chave usada por um agente autônomo.

Erros comuns da chave de API da Anthropic e como corrigir

Erro	Causa provável	Correção
`401 authentication_error`	Chave digitada errada, revogada, desativada ou expirada	Crie uma chave nova; chaves expiradas não podem ser reativadas
`400 invalid_request_error` citando workspace	Chave sem workspace definido e sem cabeçalho	Adicione `anthropic-workspace-id` ou crie uma chave restrita a um workspace
`404 not_found_error` "Workspace ... not found"	ID de workspace errado, ou a identidade da chave não tem acesso	Confira o ID na página Workspaces
`429` "reached your API usage limits"	Teto de gasto mensal do nível atingido	Peça aumento de nível ou aguarde o reinício mensal
`429` com `retry-after`	Requisições ou tokens por minuto excedidos	Espere e tente de novo; veja limites de taxa de LLM explicados
`529 overloaded_error`	Capacidade da Anthropic, não sua chave	Tente de novo com backoff ou faça failover; veja erro de API 529
Botão Create key desativado	Seu papel no Console não pode criar chaves	Peça a um admin uma mudança de papel ou uma chave de conta de serviço

Fontes: documentação da Anthropic de Authentication, limites de taxa e erros, verificada em 22 de outubro de 2026.

Mantenha a chave segura

Nunca cole a chave em código front-end, apps móveis ou notebooks públicos. Para apps iOS e macOS que precisam chamar o Claude diretamente, a Anthropic oferece o App Attest, que emite tokens de dispositivo que expiram em 1 hora.
Use uma chave por ambiente e por agente para poder revogar uma sem quebrar as outras.
Defina uma expiração, mesmo longa, para que uma chave vazada tenha prazo de validade.
Rode varredura de segredos no CI; nosso guia de varredura de segredos de APIs de IA mostra uma configuração.
Acompanhe o uso no Console e defina um limite de gasto abaixo do teto do seu nível.

Quando uma chave para vários modelos é mais simples

Uma chave da Anthropic só libera o Claude. Se seu produto ou agente de programação também chama GPT, Gemini, DeepSeek, Qwen ou Kimi, você acaba gerenciando cinco chaves, cinco saldos e cinco conjuntos de limites. Uma API unificada como a Flatkey emite uma chave para todos eles. Em 22 de outubro de 2026, as páginas de modelos da Flatkey listavam o Claude Sonnet 5.5 a US$ 1,60 de entrada / US$ 8,00 de saída por milhão de tokens e o Claude Opus 5.5 a US$ 3,20 / US$ 16,00, contra os preços de tabela da Anthropic de US$ 2 / US$ 10 e US$ 4 / US$ 20. O SDK da Anthropic funciona trocando a base URL, segundo o guia do SDK da Anthropic da Flatkey:

import anthropic

client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Summarize this changelog in 3 bullets."}],
)
print(next(b.text for b in msg.content if b.type == "text"))

Fique com uma chave direta da Anthropic se precisar de recursos exclusivos da Anthropic no dia do lançamento, Workload Identity Federation, controles de residência de dados ou um contrato enterprise. Para uma comparação mais ampla, leia Flatkey vs. contas diretas nos provedores e uma chave de API para vários modelos de IA.

FAQ

Como obter uma chave de API da Anthropic?

Entre no Claude Console em platform.claude.com, vá em Settings → API keys, clique em Create key, defina nome, expiração e conta vinculada e copie a chave sk-ant- exibida uma única vez. Adicione créditos na página Billing antes de fazer requisições.

As chaves de API da Anthropic são gratuitas?

A chave é grátis para criar e contas novas recebem um pequeno crédito de teste, mas depois o uso da API é cobrado por token. Em 22 de outubro de 2026 não há um nível gratuito permanente para a API do Claude.

Chave da Claude API e chave de API da Anthropic são a mesma coisa?

Sim. A documentação da Anthropic diz que as chaves da API do Claude também são chamadas de chaves de API da Anthropic. Uma chave funciona para todos os modelos Claude que sua organização pode acessar.

Onde encontro minha chave de API da Anthropic existente?

Em platform.claude.com/settings/keys você vê nome, dica e expiração de cada chave, mas não o segredo completo. Se a perdeu, crie uma nova e exclua a antiga.

A assinatura Claude Pro ou Max inclui créditos de API?

O Pro não. Os planos Max mostram créditos mensais de API em claude.com/pricing em 22 de outubro de 2026 (US$ 100/mês no Max 5x e US$ 200/mês no Max 20x). Acima desses créditos, o uso da API com uma chave do Console é cobrado por token, à parte da assinatura de chat.

Por que minha chave de API da Anthropic retorna 401?

A chave está digitada errada, desativada, excluída ou expirada. Chaves expiradas não podem ser reativadas; crie uma nova. Se o erro mencionar um workspace, na verdade é um 400 causado pela falta do cabeçalho anthropic-workspace-id.

Como uso minha chave de API da Anthropic com o Claude Code?

Defina ANTHROPIC_API_KEY no shell, rode claude e aprove a chave quando solicitado. Use /status dentro do Claude Code para confirmar qual credencial está ativa.