Source: https://aiprimetech.io/pt/learn/how-to-get-a-claude-api-key/

[Início](/pt/) / [Aprenda](/pt/learn/) / Como obter uma chave de API do Claude 

# 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](/pt/learn/claude-api-vs-subscription/) antes de comprar uso da API. 

  | Opção  | Onde criar uma chave  | Cobrança e endpoint  

 | Acesso direto à Anthropic | [Claude Console](https://platform.claude.com/) | Conta da Anthropic e cobrança da API; api.anthropic.com 

 | AI Prime Tech | [Crie uma conta](/register), depois abra Chaves de API no painel | Créditos do gateway ou um plano elegível por período; aiprimetech.io  

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  
- 

Entre no [Claude Console](https://platform.claude.com/) e selecione o espaço de trabalho que você usará.  
- 

Confira a cobrança da API e os limites de uso da conta. Conclua qualquer configuração que o Console exija para sua conta.  
- 

Abra [Chaves de API](https://platform.claude.com/settings/keys), crie uma chave para seu aplicativo e armazene-a com segurança quando ela for exibida.  
- 

Siga o [guia oficial de início rápido](https://platform.claude.com/docs/en/get-started) 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  
- 

[Cadastre-se na AI Prime Tech](/register) e conclua a verificação apresentada durante o cadastro.  
- 

Escolha [créditos pré-pagos de API](/pt/topup/) para cobrança baseada no uso ou confira os [planos do Claude por período](/pt/plans/). 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](/pt/learn/claude-api-free-trial/) mostra qualquer oferta de boas-vindas atual e suas condições.  
- 

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.  
- 

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. 

Copiar

```
export ANTHROPIC_API_KEY="YOUR_GATEWAY_KEY"
```

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

Copiar

```
$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: 

Copiar

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

Para PowerShell: 

Copiar

```
$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. 

Copiar

```
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](/pt/agents/) 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. 

Copiar

```
python -m pip install anthropic
```

test_claude.pyCopiar

```
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)
```

Copiar

```
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](/pt/learn/anthropic-python-sdk/) ou [guia da API compatível com OpenAI](/pt/learn/openai-compatible-claude-api/) 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](/pt/learn/claude-code-api-key-setup/); para um IDE, siga o [guia do Cursor](/pt/learn/unlimited-cursor-claude-api/). 

## Se sua chave de API do Claude não funcionar 

  | Sintoma  | O que verificar  

 | 401 ou API_KEY_REQUIRED | Confirme que a variável de ambiente está definida neste terminal e que a solicitação envia a chave ao provedor que a emitiu. 

 | 403 ou acesso negado | Verifique o status da chave, o grupo selecionado, as permissões da conta e o modelo solicitado. 

 | Modelo não encontrado ou não compatível | Copie o ID exato da lista de modelos da sua chave. Se ele estiver na lista, mas ainda falhar, entre em contato com o suporte informando o erro da solicitação e o ID, sem incluir a chave. 

 | Saldo insuficiente ou nenhum plano elegível | Verifique o saldo no painel, o período do plano e o grupo de acesso da chave. 

 | 404 ou uma resposta HTML | Verifique o nome do host, o formato da API e o caminho. Não duplique /v1 quando o cliente o adicionar por conta própria. 

 | 429, 500 ou 529 | Examine a resposta, reduza a concorrência quando necessário e siga o [guia de erros da API](/pt/learn/claude-api-errors-troubleshooting/).  

## 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](/pt/learn/claude-api-free-trial/) mostra qualquer oferta de boas-vindas disponível; os [página de recarga](/pt/topup/) e [planos](/pt/plans/) 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 

 Como obtenho uma chave de API do Claude?

Crie uma chave no [Claude Console](https://platform.claude.com/settings/keys) para acesso direto à Anthropic, ou [cadastre-se na AI Prime Tech](/register), escolha o acesso adequado ao gateway e crie uma chave no painel. Use o endpoint do provedor que a emitiu. Onde encontro minha chave de API do Claude?

Abra Chaves de API no painel do provedor emissor e use os controles disponíveis para gerenciar as chaves. Armazene o segredo com segurança; se não conseguir recuperá-lo, crie uma chave substituta e revogue a antiga. Posso obter uma chave de API do Claude gratuita?

A criação de uma chave, por si só, não financia solicitações à API. Verifique os termos atuais do provedor emissor. O [guia de avaliação](/pt/learn/claude-api-free-trial/) da AI Prime Tech lista qualquer oferta de boas-vindas vigente e suas condições. Uma assinatura Claude Pro ou Max paga por este gateway?

Não. A AI Prime Tech tem sua própria conta, suas próprias chaves e seu próprio faturamento. Consulte [Acesso à API versus assinaturas](/pt/learn/claude-api-vs-subscription/) para escolher o produto de que você precisa. Qual ID de modelo devo usar?

Faça uma solicitação GET /v1/models com sua chave do gateway e escolha um ID exato de modelo Claude retornado para essa chave. Execute uma pequena solicitação Messages para verificar se o modelo funciona com seu acesso.  

Comece a usar o Claude em minutos

Obtenha uma chave de API — sem precisar de conta na Anthropic nem de lista de espera.[Obtenha sua chave de API](/register) 

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.    

## Mais guias da API do Claude

[Preços da API Claude explicados](/pt/learn/claude-api-pricing-explained/)[A maneira mais barata de usar a API do Claude](/pt/learn/cheapest-way-to-use-claude-api/)[Cursor ilimitado com a API do Claude](/learn/use-claude-api-with-cursor/)[Acesso ilimitado ao Claude Code](/pt/learn/use-claude-api-with-claude-code/)[Gateway da API do Claude vs. acesso direto à Anthropic](/pt/learn/claude-api-vs-anthropic-direct/)[Use Claude com o SDK da OpenAI: endpoint compatível com OpenAI, streaming, ferramentas e limites](/pt/learn/openai-compatible-claude-api/)[Modelos Claude explicados: uma comparação entre Claude Opus, Sonnet, Haiku e Fable — todos os modelos da API Claude, nomes e preços dos modelos Anthropic (2026)](/pt/learn/claude-api-models-compared/)[Pagamento da API do Claude com criptomoedas](/pt/learn/claude-api-with-crypto-payment/)[Acesso à API do Claude sem lista de espera](/pt/learn/claude-api-without-waitlist/)[Como reduzir o uso de tokens do Claude](/pt/learn/how-to-reduce-claude-token-usage/)[Cline ilimitado com a API do Claude](/pt/learn/use-claude-api-with-cline/)[Roo Code ilimitado com a API do Claude](/pt/learn/use-claude-api-with-roo-code/)[Claude ilimitado nas IDEs da JetBrains](/pt/learn/use-claude-api-with-jetbrains/)[Aider com Claude por meio de um gateway: ANTHROPIC_API_BASE, arquivos de configuração, modo arquiteto e correções](/pt/learn/use-claude-api-with-aider/)[Claude ilimitado no VS Code](/pt/learn/use-claude-api-with-vscode/)[Configuração do OpenCode para Claude: configuração do opencode.json, modelos e erros comuns](/pt/learn/use-claude-api-with-opencode/)[Hermes Agent com Claude por meio de um gateway: configuração de provedor personalizado, controles de custos e correções](/pt/learn/run-hermes-agent-with-claude-api/)[Executando OpenClaw ilimitado com Claude](/pt/learn/run-openclaw-with-claude-api/)[O que significa uma API compatível com a Anthropic](/pt/learn/anthropic-compatible-api/)[Chave de API do Claude Code — ANTHROPIC_API_KEY: como obtê-la, configurá-la e quando usar claude setup-token em seu lugar](/pt/learn/claude-code-api-key-setup/)[Custos da API do Claude Code — Preços e como reduzi-los](/pt/learn/claude-code-api-costs/)[Erros da API Claude explicados: erro de servidor 500, sobrecarga 529, limite de requisições 429, requisição inválida 400 — e a correção para cada um](/pt/learn/claude-api-errors-troubleshooting/)[Como comprar créditos da API Claude](/pt/learn/buy-claude-api-credits/)[API Claude gratuita: existe uma chave de API Claude gratuita e o que realmente é gratuito em 2026?](/pt/learn/claude-api-free-trial/)[API do Claude vs assinatura Claude Pro/Max — Qual escolher](/pt/learn/claude-api-vs-subscription/)[Codex CLI com um provedor personalizado: config.toml, modelos GPT e Claude, extensão para IDE e correções](/pt/learn/use-claude-api-with-codex/)[Conectando Claude ao n8n](/pt/learn/use-claude-api-with-n8n/)[Roteando LiteLLM para Claude](/pt/learn/use-claude-api-with-litellm/)[Usando Claude no Kilo Code](/pt/learn/use-claude-api-with-kilo-code/)[GitHub Copilot Chat com Claude por meio de um gateway: configuração de Custom Endpoint, modo agente e correções](/pt/learn/use-claude-api-with-github-copilot/)[Conecte o Zed ao Claude por meio do gateway](/pt/learn/use-claude-api-with-zed/)[Conecte o Cherry Studio ao Claude](/pt/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic no LangChain: importação, base_url, streaming, ferramentas e erros](/pt/learn/use-claude-api-with-langchain/)[SDK de Python da Anthropic: instale, defina base_url, use streaming e trate erros](/pt/learn/anthropic-python-sdk/)[Claude com o Vercel AI SDK: baseURL de createAnthropic, streaming e correções](/pt/learn/use-claude-api-with-vercel-ai-sdk/)[Execute o Factory Droid com o Claude](/pt/learn/use-claude-api-with-factory-droid/)[A API do Claude Code, explicada](/pt/learn/claude-code-api/)[Como integrar a API do Claude à sua aplicação](/pt/learn/claude-api-integration/)[Como obter uso ilimitado do Claude](/pt/learn/get-unlimited-claude-usage/)[O que significa acesso ilimitado à API do Claude](/pt/learn/unlimited-claude-api-access/)