A API do Claude Code, explicada

O Claude Code é um agente de terminal, mas, por trás de cada ação, há uma chamada à mesma Anthropic Messages API que você pode usar diretamente. Isso tem uma consequência útil: você controla com qual endpoint ele se comunica, em qual chave o uso é cobrado e, portanto, quanto custa uma sessão. Esta página explica os componentes envolvidos e traz links para os guias detalhados de configuração.

O que “API do Claude Code” realmente significa

Não existe um produto separado chamado API do Claude Code. O Claude Code se autentica por meio de uma assinatura do Claude (Pro/Max) ou de uma chave de API e, no modo API, envia requisições padrão da Messages API — prompt de sistema, conversa, definições de ferramentas e resultados de ferramentas — ao endpoint indicado pelo seu ambiente.

Esse endpoint é configurável. Duas variáveis de ambiente controlam tudo: ANTHROPIC_BASE_URL (para onde as requisições vão) e ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_API_KEY (qual conta paga). Configure-as para apontar diretamente para a Anthropic ou para um gateway compatível com a Anthropic, e o Claude Code se comportará da mesma forma.

Como usar sua própria chave de API com o Claude Code

Defina as duas variáveis no perfil do seu shell ou em ~/.claude/settings.json e inicie claude normalmente. O passo a passo completo, com exemplos de settings.json, está no nosso <a href="/pt/learn/claude-code-api-key-setup/">guia de configuração de chave de API do Claude Code</a>.

Um detalhe que merece atenção: se ANTHROPIC_API_KEY estiver definida no seu shell, o Claude Code cobrará pelas tarifas da API mesmo que você também tenha uma assinatura — a variável de ambiente tem prioridade. Remova essa variável se quiser usar seu plano Pro/Max.

Quanto custa uma sessão do Claude Code

Sessões com agentes consomem muitos tokens: cada leitura de arquivo, resultado de ferramenta e diff entra no contexto. Uma hora de trabalho focado pode consumir milhões de tokens de entrada, e é por isso que o cache de prompts é tão importante — o contexto repetido é relido do cache por uma fração do preço nos endpoints compatíveis.

Detalhamos valores reais por sessão, o comportamento do cache e como manter sessões longas acessíveis no <a href="/pt/learn/claude-code-api-costs/">guia de custos da API do Claude Code</a>.

Anthropic diretamente ou um gateway

O acesso direto à API da Anthropic oferece cobrança conforme o uso e suporte do próprio fornecedor — a opção padrão adequada para equipes com orçamentos estáveis. Gateways independentes, como a AI Prime Tech (sem afiliação ou endosso da Anthropic), revendem acesso por tarifas fixas ou com desconto e expõem o mesmo formato de comunicação, permitindo que o Claude Code funcione alterando apenas a URL base e a chave.

Qualquer que seja a opção escolhida, verifique se o streaming funciona de ponta a ponta e se os modelos de que você precisa estão disponíveis com os IDs exatos solicitados pelo Claude Code — consulte <a href="/pt/learn/use-claude-api-with-claude-code/">como usar a API do Claude com o Claude Code</a> para ver a lista completa de verificações.

# Claude Code with your own key + custom endpoint
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

# or persist in ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

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.