Como obter uma chave da API Claude

Você pode obter uma chave de API do Claude no Claude Console da Anthropic para acesso direto à API ou criar uma conta na AI Prime Tech para acessar por meio deste gateway independente. Escolha primeiro seu provedor: a chave, a cobrança e a URL base devem corresponder a ele. As etapas abaixo abrangem as duas opções e mostram como verificar uma chave do gateway antes de enviar a primeira solicitação.

Escolha onde obter sua chave de API do Claude

Uma chave de API identifica a conta ou o projeto que paga pelas solicitações. Um login do chat do Claude e uma chave de API têm finalidades diferentes. Se você deseja a interface de chat ou os recursos de assinatura, compare o acesso à API do Claude e as assinaturas antes de comprar uso da API.

A AI Prime Tech é operada de forma independente e não é afiliada nem endossada pela Anthropic. Use a opção que atenda aos seus requisitos de integração, cobrança e suporte; as contas e as chaves são separadas.

Obtenha uma chave no Claude Console oficial

1. Entre no Claude Console e selecione o espaço de trabalho que você usará.
2. Confira a cobrança da API e os limites de uso da conta. Conclua qualquer configuração que o Console exija para sua conta.
3. Abra Chaves de API, crie uma chave para seu aplicativo e armazene-a com segurança quando ela for exibida.
4. Siga o guia oficial de início rápido da Anthropic para solicitações diretas. Mantenha o endpoint oficial para essa opção; o exemplo do gateway abaixo usa uma chave da AI Prime Tech.

Crie uma chave da AI Prime Tech

1. Cadastre-se na AI Prime Tech e conclua a verificação apresentada durante o cadastro.
2. Escolha créditos pré-pagos de API para cobrança baseada no uso ou confira os planos do Claude por período. Confira a oferta atual, os modelos elegíveis e os limites antes de pagar. Se quiser avaliar o serviço primeiro, o guia de avaliação mostra qualquer oferta de boas-vindas atual e suas condições.
3. Abra Chaves de API no painel e crie uma chave para este aplicativo. Confira o grupo selecionado e quaisquer restrições da chave para que correspondam ao acesso ao Claude que você comprou.
4. Copie a chave para uma variável de ambiente local ou um gerenciador de segredos. Use uma chave separada para cada aplicativo para poder identificar o uso e substituir uma chave sem alterar todas as integrações.

A criação da chave e o pagamento não comprovam que uma integração funciona. Primeiro, confira o catálogo de modelos com essa chave e, em seguida, faça uma pequena solicitação ao modelo que pretende usar.

Verifique a chave e os IDs de modelos disponíveis

No macOS, Linux ou WSL, defina sua chave do gateway no terminal atual. Substitua o marcador pela sua própria chave localmente; mantenha-a fora de scripts compartilhados e capturas de tela.

export ANTHROPIC_API_KEY="YOUR_GATEWAY_KEY"

No Windows PowerShell, use esta sintaxe de variável de ambiente:

$env:ANTHROPIC_API_KEY = "YOUR_GATEWAY_KEY"

Solicite a lista de modelos. Esta é uma solicitação ao catálogo; ela não gera uma resposta de modelo. O comando a seguir é para um shell compatível com Bash:

curl --fail-with-body --silent --show-error \
  https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY"

Para PowerShell:

$headers = @{ Authorization = "Bearer $env:ANTHROPIC_API_KEY" }
(Invoke-RestMethod "https://aiprimetech.io/v1/models" -Headers $headers).data | Select-Object id

Uma resposta bem-sucedida lista os IDs de modelos disponíveis para a chave. Escolha um modelo Claude e copie seu id exatamente para CLAUDE_MODEL. O acesso aos modelos pode depender do grupo e das permissões da chave; uma resposta do catálogo, por si só, não garante que um modelo do provedor upstream concluirá uma solicitação.

export CLAUDE_MODEL="PASTE_A_CLAUDE_MODEL_ID_FROM_THE_RESPONSE"
# PowerShell alternative:
# $env:CLAUDE_MODEL = "PASTE_A_CLAUDE_MODEL_ID_FROM_THE_RESPONSE"

Antes de conectar um agente, confirme que a chave usa o grupo correspondente ao acesso escolhido. O lista de verificação de configuração do agente relaciona essa verificação ao guia da ferramenta apropriada.

Faça sua primeira solicitação em Python

Instale o SDK Python da Anthropic no ambiente do seu projeto, salve o exemplo como test_claude.py e execute-o no terminal em que você definiu a chave e o modelo. Essa solicitação usa o modelo selecionado e está sujeita à cobrança ou ao plano da sua conta.

python -m pip install anthropic

import os
import anthropic

# Set CLAUDE_MODEL to an exact Claude model ID returned for your key.
client = anthropic.Anthropic(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url="https://aiprimetech.io",
)
message = client.messages.create(
    model=os.environ["CLAUDE_MODEL"],
    max_tokens=64,
    messages=[{"role": "user", "content": "Reply with hello."}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)

python test_claude.py

Para este SDK, a URL base do gateway é https://aiprimetech.io sem /v1; o SDK constrói o caminho da API Messages. Clientes que usam o formato compatível com OpenAI geralmente usam https://aiprimetech.io/v1. Consulte o guia do SDK Python da Anthropic ou guia da API compatível com OpenAI para o formato de que sua aplicação precisa.

Depois que a resposta chegar, verifique os detalhes da solicitação e do uso no painel. Para a CLI, continue com Configuração de chave de API do Claude Code; para um IDE, siga o guia do Cursor.

Se sua chave de API do Claude não funcionar

Onde encontrar e gerenciar sua chave

Abra Chaves de API no painel do provedor que emitiu a chave. Use os controles disponíveis para copiar, revelar e revogar a chave. Se não conseguir recuperar um segredo utilizável, crie uma chave substituta e revogue a antiga depois de atualizar sua aplicação.

Mantenha as chaves fora do controle de versão, de issues públicas e do JavaScript executado no navegador. Se uma chave for exposta, substitua-a e revise seu uso. Um cookie de sessão do navegador não substitui uma chave de API.

Uma chave de API do Claude é gratuita?

Criar uma chave e pagar pelo uso dos modelos são etapas separadas. Os termos atuais de conta da Anthropic são exibidos no Console. Na AI Prime Tech, o guia de avaliação mostra qualquer oferta de boas-vindas disponível; os página de recarga e planos mostram as opções pagas contínuas.

Verifique a elegibilidade e a oferta exibida no cadastro. Um crédito temporário ou período de avaliação não oferece uso gratuito por tempo indefinido.

Perguntas frequentes

AI Prime Tech é um gateway de API independente. Não tem afiliação com a Anthropic, não é endossado por ela e não é seu revendedor. Claude e os nomes dos modelos relacionados são marcas comerciais de seus respectivos proprietários.