Crie sua chave da API do Claude.

O que é a API do Claude e onde abrir a conta

A API do Claude é a interface que a Anthropic expõe para desenvolvedores. Em vez de alguém digitar no chat, a sua aplicação envia mensagens por HTTP e recebe a resposta em JSON. O uso é medido em tokens de entrada e de saída, e o preço por milhão de tokens muda de acordo com o modelo da família Claude.

A conta de desenvolvedor fica no console da Anthropic, em console.anthropic.com. É lá que ficam a organização, os membros do time, os créditos, os limites de gasto e as chaves. A conta do Claude.ai, do chat, é outra coisa: não gera chave nem crédito de API.

Antes de criar qualquer coisa, confirme em qual organização você está logado. Quem atende mais de um cliente normalmente cria uma organização por cliente, para separar consumo e fatura desde o primeiro dia. Confira o nome da organização no topo do console agora: depois de misturar o consumo, separar dá trabalho.

Passo a passo para gerar a chave no console da Anthropic

O fluxo é curto e acontece todo dentro do console. A ordem importa: sem saldo, a primeira chamada volta com erro mesmo com a chave correta.

Se você fechar a janela de criação sem copiar o valor, não existe recuperação. Nesse caso, apague a chave e crie outra.

• Crie a conta em console.anthropic.com e confirme o e-mail.
• Conclua a verificação de telefone quando ela for solicitada.
• Vá até a área de cobrança e adicione créditos antes do primeiro teste.
• Abra a área de API Keys e crie uma nova chave.
• Dê um nome que identifique projeto e ambiente, como crm-producao ou teste-local.
• Copie a chave inteira no momento em que ela aparecer.
• Guarde no gerenciador de segredos do time, nunca em bloco de notas ou conversa.

A chave completa aparece uma única vez

Depois que a janela de criação fecha, a chave completa não volta. A lista do console passa a mostrar apenas um trecho inicial da credencial, junto com informações de criação e de uso.

É por isso que o nome importa tanto. Meses depois, com várias chaves na mesma lista, o nome vai ser a única coisa que diz qual delas pode ser revogada sem derrubar produção.

Abra a sua lista de chaves agora: se alguma tiver nome genérico ou estiver sem uso há muito tempo, provavelmente ela pode ser apagada.

Formato próprio e endpoint compatível com OpenAI

A API da Anthropic tem formato próprio. O endpoint de mensagens é /v1/messages, a chave vai no cabeçalho x-api-key, existe um cabeçalho de versão obrigatório e o campo max_tokens é obrigatório no corpo. Quem começa um projeto do zero normalmente usa esse formato, direto ou pelo SDK oficial.

A Anthropic também publica um endpoint compatível com o formato de chat da OpenAI. Na prática, isso existe para quem já tem código escrito com o SDK da OpenAI: você aponta a base URL para a Anthropic, envia a chave como Bearer token e mantém a estrutura de chamada que já está no seu projeto.

A compatibilidade cobre o caminho comum de chat. Recursos específicos de cada lado nem sempre têm equivalente exato, então trate essa camada como atalho de integração, não como equivalência completa. Se a sua aplicação usa algo além de enviar mensagens e ler a resposta, teste esse ponto antes de mover produção.

Formato próprio da Anthropic
Endpoint: POST https://api.anthropic.com/v1/messages
Cabeçalhos: x-api-key: SUA_CHAVE + cabeçalho de versão
Corpo: model, max_tokens (obrigatório), messages

Endpoint compatível com OpenAI
Base URL do SDK: https://api.anthropic.com/v1/
Cabeçalho: Authorization: Bearer SUA_CHAVE
Corpo: o mesmo formato de chat que você já usa

Como testar a chave da API Claude no terminal

Um teste no terminal separa duas coisas que costumam ser confundidas: a chave está errada ou o código está errado. Exporte a credencial como variável de ambiente e faça a menor chamada possível antes de tocar na sua aplicação.

Substitua o ID do modelo pelo valor exato listado na documentação da Anthropic e confirme ali também o valor atual do cabeçalho de versão. O status HTTP de retorno já diz onde procurar.

• 200 com texto no corpo: chave válida, saldo disponível e modelo liberado para a sua organização.
• 401: problema de autenticação. Confira espaço extra, chave apagada ou organização errada.
• 400: revise o JSON, o max_tokens, o cabeçalho de versão e o ID do modelo.
• 429: limite de taxa. Reduza a frequência antes de repetir.
• Erro de crédito: volte à área de cobrança e confirme o saldo.

export ANTHROPIC_API_KEY="cole-sua-chave-aqui"

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: COLE_AQUI_A_VERSAO_DA_DOC" \
  -H "content-type: application/json" \
  -d '{
    "model": "COLE_AQUI_O_ID_DO_MODELO",
    "max_tokens": 256,
    "messages": [{"role":"user","content":"Responda apenas: chave funcionando"}]
  }'

Segurança: trate a credencial como senha de produção

Quem tem a sua chave gasta o seu dinheiro. Não existe camada intermediária protegendo isso: uma credencial vazada é uma conta aberta até você revogá-la no console.

Revogar é uma ação direta no console. Perceber o vazamento pela fatura acontece bem depois do gasto. Por isso a ordem correta é apagar primeiro e investigar depois.

• Nunca coloque a chave no front-end, em aplicativo distribuído, em print ou em repositório.
• Faça a chamada a partir do seu backend quando o produto for usado por terceiros.
• Use uma chave por projeto e por ambiente, para revogar uma sem derrubar as outras.
• Configure limites de gasto e alertas no console antes de subir para produção.
• Se a chave vazar, apague no console imediatamente e crie outra.

Chave comitada continua exposta

Rode um scanner de segredos no seu repositório antes de considerar o assunto resolvido. Uma chave que entrou no histórico do Git continua acessível mesmo depois do commit que a removeu do arquivo.

Nos logs, registre o status HTTP, o modelo e o identificador da requisição. Não registre a chave, nem inteira nem em pedaço. Log de erro é o lugar mais comum de vazamento acidental, porque quase ninguém o trata como dado sensível.

Faça a verificação agora: procure o prefixo da sua chave no histórico do repositório e na sua ferramenta de logs.

A cobrança é em dólar: o que muda para quem está no Brasil

A Anthropic cobra em dólar. Você compra créditos pré-pagos no console com cartão internacional e o consumo é debitado desse saldo.

Para quem está no Brasil, três coisas se somam ao preço de tabela: o IOF sobre compra internacional, o spread do cartão e a variação do câmbio entre o dia da compra e o fechamento da fatura. As alíquotas e o spread mudam e dependem do produto, então confirme com o emissor do seu cartão em vez de assumir um número.

Do lado fiscal, o comprovante é um recibo internacional. Não é NFS-e. Empresa que precisa lançar a despesa com documento fiscal brasileiro costuma resolver isso por um intermediário nacional ou pelo processo de importação de serviço, junto com o contador.

Ao montar a estimativa de custo, some as três camadas em vez de olhar só o preço por token. Abra a sua última fatura de cartão e compare com o valor que você esperava gastar: a diferença costuma estar exatamente aí.

Acessar modelos Claude pela Roteia, com saldo em Real

A Roteia é um gateway brasileiro de APIs de IA: uma API compatível com o formato da OpenAI para vários modelos, com saldo pré-pago em Real. Quando um modelo Claude está publicado no catálogo, você o chama pela mesma estrutura de requisição que já usa e o custo é debitado em Real.

O limite disso precisa ficar claro: existir no laboratório não significa estar liberado aqui. O catálogo em /modelos/ é a fonte da verdade sobre quais modelos estão disponíveis e por quanto, e os preços em Real ficam em /precos/. Se um modelo não aparece no catálogo, ele não está disponível na Roteia.

O que muda na prática é a operação: uma chave só para vários modelos, recarga em Real por Pix, boleto ou cartão conforme a disponibilidade no painel, NFS-e mediante solicitação e suporte em português por suporte@roteia.ai. A Roteia é um produto da NOCLAF INOVAÇÕES TECNOLÓGICAS LTDA, CNPJ 34.133.258/0001-88, em Teresópolis, Rio de Janeiro.

A Roteia é independente e não pertence nem representa OpenAI, Anthropic, Google, DeepSeek ou OpenRouter. Para começar, crie a conta em https://app.roteia.ai e siga /docs/primeira-chamada/. Quem já tem código apontado para outro gateway encontra o checklist em /docs/migrar-openrouter/; para entender o modelo de camada única, veja /agregador-de-ia/ e a documentação em /docs/.

curl https://api.roteia.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROTEIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cole-o-id-exato-do-catalogo",
    "messages": [{"role":"user","content":"Responda apenas: integração concluída"}]
  }'