Chave de API do Claude Code. Uma pequena chave física encaixada em uma fechadura em forma de terminal, com um painel de configurações organizado e um cabo curto ao lado.

Chave de API do Claude Code — ANTHROPIC_API_KEY: como obtê-la, configurá-la e quando usar claude setup-token em seu lugar

O Claude Code precisa de uma chave de API para funcionar. Seja ao configurar o Claude Code pela primeira vez ou ao migrar de uma conta direta da Anthropic para um gateway com tarifa fixa, o processo envolve gerar uma chave, configurar duas variáveis de ambiente e verificar a conexão.

Chave de API do Claude Code: versão resumida

Uma chave de API do Claude Code é uma chave comum no formato da Anthropic (sk-...) que o Claude Code lê de ANTHROPIC_API_KEY. Obtenha uma no Claude Console (Configurações → Chaves de API, exibida uma única vez) ou no painel deste gateway (visível a qualquer momento), exporte-a e o Claude Code iniciará sem o login pelo navegador. Com uma chave de gateway, você também define ANTHROPIC_BASE_URL como o host do gateway. Essa é toda a configuração; o restante desta página traz os detalhes — a diferença entre uma chave de API, o token OAuth obtido com /login e uma chave de sessão de claude.ai, as etapas para cada sistema operacional e os erros que as pessoas encontram.

O que é uma chave de API do Claude Code

Uma chave de API do Claude Code é a credencial de autenticação que permite à CLI do Claude Code fazer solicitações a um provedor de modelos Claude. Sem ela, todos os comandos executados no Claude Code retornam um erro de autenticação. A chave é uma string armazenada em uma variável de ambiente — ANTHROPIC_API_KEY (enviada como cabeçalho x-api-key) ou ANTHROPIC_AUTH_TOKEN (enviada como token Bearer). Ambas funcionam com a AI Prime Tech.

Quando você usa um gateway como a AI Prime Tech em vez de acessar a Anthropic diretamente, a chave vem do painel do gateway, e não do Anthropic Console. O formato da chave pode variar, mas o processo de configuração no Claude Code é idêntico: defina a chave no seu ambiente, aponte a URL base para o gateway e o Claude Code cuida do restante. Sua chave está vinculada ao saldo ou à assinatura da sua conta no gateway, não ao faturamento da Anthropic.

Uma chave pode ser usada simultaneamente em várias máquinas e sessões do Claude Code. No entanto, se você compartilhar uma chave com uma equipe, todo o uso contará para os limites de requisições e o saldo da mesma conta. Para configurações de equipe, gere uma chave separada por desenvolvedor no painel para que o acompanhamento do uso e a limitação de requisições funcionem corretamente por pessoa.

Chave de API vs. token OAuth — e o que é uma "chave de sessão"

O Claude Code aceita dois tipos de credencial. Uma chave de API (ANTHROPIC_API_KEY, ou ANTHROPIC_AUTH_TOKEN enviada como token Bearer) gera cobranças por token sobre um saldo de API — é o que você usa com um gateway. Um token OAuth vem de uma assinatura Claude Pro ou Max: /login dentro do Claude Code faz seu login, e claude setup-token gera um token de longa duração que você pode colocar em CI ou em uma máquina sem interface gráfica para que ela use a assinatura em vez de um saldo de API.

Uma "chave de sessão do Claude" não é nenhum dos dois: é o cookie de sessão do navegador de claude.ai, que alguns clientes não oficiais extraem para operar a interface de chat. Ela não é uma credencial de API, viola os termos de uso para consumidores, expira e pode causar a suspensão da conta. Se você quer acesso programático, use uma chave de API — do console da Anthropic ou de um gateway como este.

Etapa 1 — Obtenha a chave: Claude Console ou painel do gateway

Dois locais emitem uma chave aceita pelo Claude Code. No Claude Console (a plataforma Claude em platform.claude.com), abra Configurações → Chaves de API, clique em Criar chave, dê um nome a ela e copie o segredo da chave — o Console o exibe uma única vez e, depois, lista apenas o nome e o prefixo, portanto gerenciar chaves ali significa criar uma nova chave em vez de recuperar uma antiga.

Uma chave comum é o que o Claude Code precisa; uma chave de API de administrador é uma credencial diferente, usada para gerenciar uma organização, e não autenticará solicitações. Em seguida, execute export ANTHROPIC_API_KEY=sk-ant-... no seu shell e o Claude Code a usará sem /login. A Anthropic cobra por token e exige que a conta tenha uma forma de pagamento cadastrada antes.

O caminho mais rápido é uma chave de gateway: cadastre-se em aiprimetech.io, abra Chaves de API no painel, clique em Criar e a chave ficará visível no painel a qualquer momento — copie-a novamente, renomeie-a ou revogue-a quando quiser. Ela tem o mesmo formato sk- e funciona na mesma variável; a única etapa adicional é ANTHROPIC_BASE_URL, abordada na Etapa 2.

Neste ponto, você tem uma chave, mas não tem saldo. Faça uma pequena recarga antes de testar — a página de modelos mostra o que um dólar permite usar em cada modelo — ou escolha um plano ilimitado em /plans/ se já souber que usará o Claude Code o dia todo.

Etapa 2 — Defina as variáveis de ambiente

O Claude Code lê duas variáveis de ambiente para configurar o gateway: ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY. Defina ANTHROPIC_BASE_URL como o host raiz do gateway, sem nenhum sufixo de caminho. O SDK da Anthropic acrescenta /v1/messages automaticamente — se você incluir /v1 na URL base, as solicitações chegarão a /v1/v1/messages e retornarão erros 404.

No Linux ou macOS, adicione estas linhas ao perfil do seu shell (~/.bashrc, ~/.zshrc ou ~/.profile): export ANTHROPIC_BASE_URL="https://aiprimetech.io" e export ANTHROPIC_API_KEY="sua-chave-aqui". No Windows, defina-as como variáveis de ambiente do sistema em Configurações > Sistema > Configurações avançadas do sistema > Variáveis de Ambiente, ou adicione-as ao seu $PROFILE do PowerShell.

Para configurar por projeto, crie um arquivo .env na raiz do projeto com as mesmas variáveis. O Claude Code carrega arquivos .env do diretório de trabalho, e eles têm prioridade sobre as variáveis do sistema. Isso é útil se você usa provedores de API diferentes para projetos diferentes. Certifique-se de adicionar .env ao seu .gitignore para evitar incluir acidentalmente sua chave no controle de versão.

Etapa 3 — Verifique a conexão

Depois de definir as variáveis de ambiente, abra uma nova sessão de terminal (para que as variáveis sejam carregadas) e execute o Claude Code. Digite uma mensagem simples, como 'Olá, confirme que você consegue responder.' Se receber uma resposta do Claude, sua configuração está funcionando de ponta a ponta. A chave é válida, a URL base está correta e o gateway está encaminhando sua solicitação ao Claude com sucesso.

Se a verificação falhar, a mensagem de erro indicará o que deu errado. Um erro 401 ou 403 significa que a chave de API é inválida ou expirou — copie-a novamente do painel. Um erro 404 quase sempre significa que a URL base está errada — verifique se há um sufixo /v1 acidental ou barras no final. Um erro de conexão recusada significa que o gateway está inacessível — verifique sua rede, VPN ou configurações de firewall.

Você também pode verificar programaticamente acessando o endpoint de status do gateway com curl: curl -H 'Authorization: Bearer YOUR_KEY' https://aiprimetech.io/v1/models — isso retorna a lista de modelos disponíveis se sua chave for válida. Se isso funcionar, mas o Claude Code não, o problema está no carregamento das variáveis de ambiente, não na chave nem no próprio gateway.

Etapa 4 — Configure as preferências de modelos

Por padrão, o Claude Code usa suas seleções de modelos integradas para cada categoria (Sonnet, Opus, Haiku). Você pode substituí-las por meio de variáveis de ambiente adicionais: ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL e ANTHROPIC_DEFAULT_FABLE_MODEL. Defina-as com os identificadores exatos dos modelos compatíveis com o gateway.

Para a maioria dos desenvolvedores, definir ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 e ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6 é suficiente. O Claude Code usa Sonnet por padrão na maioria das interações e usa Opus quando você o seleciona pelo comando /model ou quando o modo de planejamento recorre a um modelo mais potente. O gateway oferece suporte a todas as versões atuais dos modelos Claude.

Ative a descoberta de modelos do gateway definindo CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1. Isso instrui o Claude Code a consultar o gateway para obter os modelos disponíveis, em vez de usar uma lista fixa no código. Defina também CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 para impedir que solicitações de telemetria sejam enviadas ao gateway — isso reduz o ruído e melhora ligeiramente a latência das solicitações.

Solução de erros comuns de autenticação

O problema mais frequente é o não carregamento das variáveis de ambiente. Depois de defini-las no seu perfil, você deve abrir um novo terminal — os terminais existentes usam o ambiente antigo. No Windows, pode ser necessário reiniciar completamente o aplicativo de terminal, e não apenas abrir uma nova aba. Verifique com echo $ANTHROPIC_BASE_URL (bash/zsh) ou echo $env:ANTHROPIC_BASE_URL (PowerShell).

Se você receber erros de 'modelo não encontrado' apesar de uma conexão válida, o identificador do modelo não corresponde ao que o gateway oferece. Os IDs dos modelos diferenciam maiúsculas de minúsculas e são específicos de cada versão. Consulte o painel ou o endpoint /v1/models para obter os identificadores exatos compatíveis. Erros comuns incluem usar 'claude-3-opus' em vez de 'claude-opus-4-6' ou adicionar espaços em branco extras ao valor da variável de ambiente.

Confira o saldo no painel. Para continuar sem interrupções, adicione saldo pré-pago para pagar conforme o uso ou faça upgrade para um plano ilimitado — 1 dia ($9) ou 1 semana ($39) para acessar todos os modelos por um preço fixo, sem cobrança por token.

# Add to ~/.bashrc or ~/.zshrc:
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_API_KEY="your-key-from-dashboard"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# Verify connection:
# $ source ~/.bashrc && claude
# Or test the gateway directly:
# $ curl -H "x-api-key: $ANTHROPIC_API_KEY" https://aiprimetech.io/v1/models

Perguntas frequentes

ANTHROPIC_API_KEY — como obter?

Crie uma chave no Claude Console (Configurações → Chaves de API → Criar chave; copie o segredo da chave, exibido uma única vez) ou crie uma no painel do gateway aqui, onde ela permanece visível. Exporte-a como ANTHROPIC_API_KEY; ao usar uma chave do gateway, defina também ANTHROPIC_BASE_URL.

Preciso de uma chave separada para o Claude Code e para outras ferramentas?

Não. A mesma chave de API funciona com Claude Code, Cursor, Cline, Aider e qualquer outra ferramenta que use a Anthropic Messages API ou um endpoint compatível com OpenAI. Uma chave, várias ferramentas.

Uma chave de sessão do Claude é igual a uma chave de API?

Não. Uma chave de sessão é o cookie de navegador claude.ai usado por clientes não oficiais; uma chave de API é a credencial esperada pela API e pelo Claude Code. Apenas a chave de API tem suporte, cobrança e estabilidade.

Como obtenho um ANTHROPIC_API_KEY?

No console da Anthropic (com cobrança pelo preço de tabela na sua conta Anthropic) ou no painel deste gateway (com cobrança sobre créditos comprados abaixo do valor nominal ou por um plano ilimitado). Em ambos os casos, a chave deve ser definida na variável de ambiente ANTHROPIC_API_KEY.

O que claude setup-token faz?

Ele cria um token OAuth de longa duração para uma assinatura do Claude, permitindo que o Claude Code seja executado em CI ou sem interface, sem login interativo. Ele consome a cota da assinatura, não créditos de API; com um gateway, você usa uma chave de API.

ANTHROPIC_BASE_URL deve incluir /v1?

Não. Defina apenas o host raiz: https://aiprimetech.io — o SDK da Anthropic acrescenta /v1/messages automaticamente. Incluir /v1 gera um caminho duplicado que retorna erros 404.

Posso usar a mesma chave em várias máquinas?

Sim. Uma chave funciona em todos os seus dispositivos simultaneamente. Todo o uso é contabilizado no saldo e nos limites de taxa da mesma conta. Para equipes, gere chaves separadas por desenvolvedor para acompanhar o uso individualmente.

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

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.