Source: https://aiprimetech.io/pt/learn/claude-code-api/

[Início](/pt/) / [Aprenda](/pt/learn/) / A API do Claude Code, explicada 

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

Copiar

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

 Posso usar o Claude Code com minha própria chave de API?

Sim. Defina ANTHROPIC_API_KEY (ou ANTHROPIC_AUTH_TOKEN) e, opcionalmente, ANTHROPIC_BASE_URL no seu ambiente ou em ~/.claude/settings.json e, em seguida, inicie claude. A cobrança será feita nessa chave em vez de em uma assinatura. O Claude Code tem uma API própria?

Não — ele usa a Anthropic Messages API padrão. Qualquer serviço que se comunique nesse formato, incluindo gateways compatíveis com a Anthropic, pode atender ao Claude Code. Por que o Claude Code está ignorando minha assinatura e cobrando na minha chave de API?

Se ANTHROPIC_API_KEY estiver definida no shell, ela terá prioridade sobre a autenticação por assinatura. Remova a variável para usar seu plano Pro/Max. Posso configurar o Claude Code para apontar para outro endpoint?

Sim, por meio de ANTHROPIC_BASE_URL. É assim que gateways, proxies e configurações de roteamento empresarial funcionam com o Claude Code sem alterações.  

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

[Como obter uma chave de API do Claude](/pt/learn/how-to-get-a-claude-api-key/)[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](/pt/learn/unlimited-cursor-claude-api/)[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/)[Como usar Claude por meio de uma API compatível com OpenAI](/pt/learn/openai-compatible-claude-api/)[Comparação dos modelos Claude](/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 ilimitado com a API do Claude](/pt/learn/use-claude-api-with-aider/)[Claude ilimitado no VS Code](/pt/learn/use-claude-api-with-vscode/)[OpenCode ilimitado com a API do Claude](/pt/learn/use-claude-api-with-opencode/)[Como executar um agente Hermes ilimitado no Claude](/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 — como obter e configurar](/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 do Claude — limites de requisições e soluções para 400, 500 e 529](/pt/learn/claude-api-errors-troubleshooting/)[Como comprar créditos da API do Claude](/pt/learn/buy-claude-api-credits/)[Teste gratuito da API do Claude: o que realmente é grátis e o que não é](/pt/learn/claude-api-free-trial/)[API do Claude vs assinatura Claude Pro/Max — Qual escolher](/pt/learn/claude-api-vs-subscription/)[Como executar a CLI do Codex no Claude](/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/)[Integre Claude ao GitHub Copilot](/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/)[Direcione o LangChain para Claude no gateway](/pt/learn/use-claude-api-with-langchain/)[Execute o Factory Droid com o Claude](/pt/learn/use-claude-api-with-factory-droid/)[Como integrar a API do Claude à sua aplicação](/pt/learn/claude-api-integration/)