# Configuração de Chave de API do Claude Code

O Claude Code lê duas variáveis de ambiente para rotear solicitações para qualquer lugar: ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY. Aponte-as para o RunAPI e execute todos os modelos Claude pela metade da tarifa oficial. Este guia mostra os comandos exatos para Mac, Linux e Windows.

*Updated June 18, 2026 · RunAPI Editorial*

## Como definir uma chave de API personalizada no Claude Code?

O Claude Code usa duas variáveis de ambiente para decidir para onde as solicitações vão e como se autenticam. Defina ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY com valores do RunAPI e todas as solicitações serão roteadas pelo RunAPI com 50% de desconto. Quer usar um provedor totalmente diferente? O RunAPI também funciona como um gateway plug-and-play para que você possa executar modelos Claude sem uma conta direta da Anthropic.

- **Duas variáveis**: ANTHROPIC_BASE_URL define o endpoint. ANTHROPIC_API_KEY define a chave. Essa é toda a configuração — duas variáveis, nenhuma outra alteração.
- **Valor do endpoint**: Defina ANTHROPIC_BASE_URL como https://runapi.ai para que o Claude Code roteie através da RunAPI.
- **Persista**: Adicione ambas as exportações ao seu perfil de shell (.zshrc ou .bashrc) para não precisar redefini-las a cada sessão. Usuários do Windows as definem no PowerShell e abrem uma nova janela.
- **50% de desconto**: Cada modelo Claude cobra pela metade da taxa oficial da Anthropic. Sem assinatura, sem limite.

## O que você precisa antes de configurar o Claude Code?

A configuração leva alguns minutos. Você precisa do Claude Code instalado, uma conta RunAPI e um terminal. Execute claude --version primeiro para confirmar que o Claude Code está funcionando antes de mexer em qualquer configuração de chave de API.

### Claude Code instalado

Instale o Claude Code pela fonte oficial e confirme que ele roda com claude --version no seu terminal. Se esse comando gerar erro, corrija a instalação antes de definir qualquer chave de API.

### Uma conta RunAPI

Cadastre-se em runapi.ai. O nível gratuito inclui créditos para testar qualquer modelo Claude antes de financiar um saldo.

### Uma chave de API

Crie uma chave em Dashboard → API Keys. Copie-a uma vez — ela é mostrada completa apenas no momento da criação. Não a cole em repositórios públicos nem a compartilhe em capturas de tela.

### Acesso ao terminal

Você precisa de um shell para definir variáveis de ambiente. macOS e Linux usam .zshrc ou .bashrc. Usuários do Windows podem usar PowerShell — defina a variável e depois abra uma nova janela de terminal para que ela entre em vigor.


## Como configurar uma chave de API do Claude Code com RunAPI

Execute estes comandos em ordem. Eles definem o endpoint e a chave, persistem-nos no seu perfil de shell e confirmam que o Claude Code os detecta. Substitua o placeholder pela sua chave RunAPI real. Use ANTHROPIC_API_KEY (não CLAUDE_API_KEY) — essa é a variável que o Claude Code realmente lê.

## Quais variáveis de ambiente o Claude Code lê?

Claude Code lê um pequeno conjunto de variáveis para controlar endpoint, autenticação, modelo e tamanho da saída. A tabela lista as que importam para uma configuração de endpoint personalizado e o que cada uma faz. Observação: use ANTHROPIC_API_KEY (não CLAUDE_API_KEY) — essa é a variável que o Claude Code realmente lê.

| Variável | Propósito | Valor de exemplo |
|---|---|---|
| ANTHROPIC_BASE_URL | Endpoint personalizado para o qual o Claude Code envia solicitações | https://runapi.ai |
| ANTHROPIC_API_KEY | Chave usada para autenticar solicitações | sk-your-runapi-key |
| ANTHROPIC_MODEL | Modelo padrão para novas sessões | claude-sonnet-4-6 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | Limite de tokens retornados por resposta | '8192' |

## Qual modelo Claude executar no Claude Code?

O Claude Code aceita qualquer ID de modelo Claude pelo RunAPI. Escolha por tarefa: um modelo rápido e barato para edições rotineiras, um equilibrado para programação diária ou o mais forte para problemas difíceis. Defina ANTHROPIC_MODEL para alterar o padrão, ou troque de modelo dentro do Claude Code — a cobrança segue o modelo que você realmente chamar.

### claude-haiku-4-5

O mais rápido e barato a $1/M de entrada e $5/M de saída pela RunAPI. Melhor para edições de rotina e consultas rápidas.

### claude-sonnet-4-6

Padrão equilibrado para codagem diária a $3/M de entrada e $15/M de saída pela RunAPI. A maioria dos desenvolvedores usa este.

### claude-opus-4-7

O mais forte para problemas difíceis a $5/M de entrada e $25/M de saída pela RunAPI. Use-o para refatorações e revisões complexas.

### Alterne a qualquer momento

Defina ANTHROPIC_MODEL ou altere o modelo dentro do Claude Code a qualquer momento. A cobrança segue o modelo que você realmente chamar, tudo com 50% de desconto.


## Por que minha chave de API do Claude Code não está funcionando?

A maioria dos problemas de configuração vem de uma destas três coisas: o nome errado da variável de ambiente (use ANTHROPIC_API_KEY, não CLAUDE_API_KEY), uma sessão de shell desatualizada que ainda não captou as alterações do seu perfil, ou um erro de digitação na chave. A tabela lista os erros comuns e a correção para cada um.

| Erro ou sintoma | Causa provável | Correção |
|---|---|---|
| 401 Unauthorized | Chave de API incorreta ou expirada | Verifique novamente o ANTHROPIC_API_KEY e crie uma nova chave no painel RunAPI, se necessário |
| Solicitações ainda chegam à Anthropic | ANTHROPIC_BASE_URL não definido neste shell | Execute echo $ANTHROPIC_BASE_URL; se estiver vazio, recarregue o perfil ou abra um novo terminal |
| 404 Not Found | Barra final ou caminho errado na URL base | Defina a URL base exatamente como https://runapi.ai sem caminho final |
| Model not found | ID de modelo inválido ou com erro de digitação | Use um ID válido como claude-sonnet-4-6 ou claude-opus-4-7 |
| Variáveis perdidas ao reiniciar | Exportações não escritas no perfil do shell | Adicione ambas as exportações a ~/.zshrc ou ~/.bashrc e recarregue |

## Como configurar uma chave de API do Claude Code com RunAPI

1. **Definir a URL base** — Exporte ANTHROPIC_BASE_URL=https://runapi.ai para rotear solicitações através da RunAPI.
2. **Definir a chave de API** — Exporte ANTHROPIC_API_KEY com sua chave RunAPI do Painel → Chaves de API.
3. **Salvar ambas as variáveis** — Acrescente ambas as exportações a ~/.zshrc ou ~/.bashrc e recarregue com source ~/.zshrc para que sobrevivam a novas sessões. No Windows, defina-as no PowerShell e abra uma nova janela de terminal.
4. **Executar o Claude Code** — Execute claude --version para confirmar a instalação, depois inicie claude no seu projeto. As solicitações agora são roteadas pelo RunAPI com 50% de desconto sobre a tarifa oficial.

## FAQ sobre Chave de API do Claude Code

### Como adiciono uma chave de API ao Claude Code?

Defina duas variáveis de ambiente. Exporte ANTHROPIC_BASE_URL para https://runapi.ai e ANTHROPIC_API_KEY para sua chave RunAPI. Acrescente ambas ao seu perfil de shell (.zshrc ou .bashrc) para que persistam entre sessões. O Claude Code as lê na inicialização e roteia todas as solicitações pelo RunAPI.

### Onde obtenho uma chave de API do Claude Code?

Crie uma em runapi.ai. Cadastre-se, abra Dashboard → API Keys e gere uma chave. Copie-a imediatamente — a chave completa é mostrada apenas na criação. O plano gratuito inclui créditos para testar qualquer modelo Claude antes de você adicionar saldo.

### Para que serve o ANTHROPIC_BASE_URL?

Ela diz ao Claude Code para qual endpoint enviar solicitações. Por padrão, o Claude Code chama Anthropic diretamente. Defini-la como https://runapi.ai roteia cada solicitação através da RunAPI, que cobra pelos mesmos modelos com 50% da taxa oficial.

### Posso usar o Claude Code com outros provedores de API como OpenAI?

Existe uma forma de usar o Claude Code com outros provedores de API como OpenAI? Sim — o Claude Code oferece suporte a qualquer endpoint compatível com OpenAI via ANTHROPIC_BASE_URL. O RunAPI expõe um gateway compatível para que você possa trocar de provedor sem alterar seu código, usando uma chave para Claude, GPT e outros modelos.

### Por que o Claude Code ainda cobra a tarifa cheia?

Execute echo $ANTHROPIC_BASE_URL no seu terminal. Se não imprimir nada, a exportação não persistiu. Acrescente ambas as exportações a ~/.zshrc ou ~/.bashrc, execute source ~/.zshrc, depois abra um novo terminal e verifique novamente. Usuários do Windows precisam abrir uma nova janela do PowerShell após definir variáveis de ambiente.

### Posso armazenar a chave em um arquivo de configuração em vez disso?

Sim. Coloque os valores em um arquivo .claude.json no seu diretório home ou do projeto, em vez de exportá-los a cada sessão. Ambas as abordagens funcionam — o arquivo é útil para chaves por projeto, enquanto exportações são mais simples para uma única configuração global.

### Como monitoro o custo após a configuração?

Abra o painel do RunAPI. Ele mostra o gasto por chave e por solicitação em tempo real. Para limitar o custo de saída, defina CLAUDE_CODE_MAX_OUTPUT_TOKENS para que cada resposta seja limitada, e use claude-haiku-4-5 para edições rotineiras.

### Isso muda o comportamento do Claude Code?

Não. O RunAPI encaminha solicitações diretamente aos modelos Claude subjacentes. Saída, uso de ferramentas e comportamento são idênticos a chamar a Anthropic diretamente. Você só muda para onde as solicitações vão e como são cobradas — a experiência de programação permanece a mesma.