Claude Code instalado
Instale o Claude Code da fonte oficial e confirme que ele funciona com o comando claude no seu terminal.
Claude Code
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 a RunAPI e execute cada modelo Claude pela metade da taxa oficial. Este guia mostra os comandos exatos.
Atualizado em June 18, 2026
RunAPI Editorial
Em resumo
Como definir uma chave de API personalizada no Claude Code?
O Claude Code usa duas variáveis de ambiente para decidir para onde vão as solicitações e como elas se autenticam. Defina-as para valores RunAPI e cada solicitação é roteada pela RunAPI com 50% de desconto. Os cartões abaixo cobrem o essencial antes do guia completo.
Duas variáveis
ANTHROPIC_BASE_URL define o endpoint. ANTHROPIC_API_KEY define a chave. Essa é a configuração completa.
Valor do endpoint
Defina ANTHROPIC_BASE_URL como https://api.runapi.ai para que o Claude Code roteie através da RunAPI.
Persista
Adicione ambas as exportações ao perfil do shell ou .claude.json para não precisar redefini-las a cada sessão.
50% de desconto
Cada modelo Claude cobra pela metade da taxa oficial da Anthropic. Sem assinatura, sem limite.
Antes de começar
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. A lista abaixo cobre tudo o que é necessário antes do primeiro comando.
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 no Painel → Chaves de API. Copie-a uma vez — ela é exibida na íntegra apenas na criação.
Acesso ao terminal
Você precisa de um shell para definir variáveis de ambiente. macOS, Linux e WSL no Windows funcionam da mesma forma.
Passo a passo
Como configurar uma chave de API do Claude Code com RunAPI
Execute estes comandos em ordem. Eles definem o endpoint e a chave, os salvam no perfil do shell e confirmam que o Claude Code os detecta. Substitua o espaço reservado pela sua chave RunAPI real.
1
Definir a URL base
Isso diz ao Claude Code para enviar solicitações para a RunAPI em vez do endpoint Anthropic padrão.
export ANTHROPIC_BASE_URL=https://api.runapi.ai
2
Definir a chave de API
Cole sua chave RunAPI no lugar do espaço reservado. O Claude Code a usa para autenticar cada solicitação.
export ANTHROPIC_API_KEY=sk-your-runapi-key
3
Salvar ambas as variáveis
Adicione ambas as exportações a ~/.zshrc (ou ~/.bashrc) para que sobrevivam a novas sessões de terminal. Recarregue com source ~/.zshrc.
echo 'export ANTHROPIC_BASE_URL=https://api.runapi.ai' >> ~/.zshrc
4
Verificar a configuração
Confirme que a variável exibe a URL RunAPI. Se estiver vazia, recarregue o perfil do shell ou abra um novo terminal.
echo $ANTHROPIC_BASE_URL
5
Executar o Claude Code
Inicie o Claude Code no seu projeto. Agora ele roteia através da RunAPI com 50% da taxa oficial.
claudeVariáveis de ambiente
Quais variáveis de ambiente o Claude Code lê?
O Claude Code lê um pequeno conjunto de variáveis para controlar endpoint, autenticação, modelo e comprimento de saída. A tabela lista as que importam para uma configuração de endpoint personalizado e o que cada uma faz.
| Variável | Propósito | Valor de exemplo |
|---|---|---|
| ANTHROPIC_BASE_URL | Endpoint personalizado para o qual o Claude Code envia solicitações | https://api.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' |
Você também pode armazenar esses valores em um arquivo de configuração .claude.json no seu diretório home ou de projeto, em vez de exportá-los a cada sessão.
Escolhendo um modelo
Qual modelo Claude executar no Claude Code?
O Claude Code aceita qualquer ID de modelo Claude pela RunAPI. Escolha pela tarefa: um modelo rápido e barato para edições de rotina, um equilibrado para codagem diária ou o mais forte para problemas difíceis.
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 cobrança segue o modelo que você realmente chama, tudo com 50% de desconto.
Corrigindo erros comuns
Por que minha chave de API do Claude Code não está funcionando?
A maioria dos problemas de configuração vem de uma variável não definida, um shell desatualizado 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://api.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 |
Versão rápida
Configuração de chave de API do Claude Code em quatro etapas
1
Definir a URL base
Exporte ANTHROPIC_BASE_URL=https://api.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
Adicione ambas as exportações a ~/.zshrc ou ~/.bashrc e recarregue para que sobrevivam a novas sessões.
4
Executar o Claude Code
Inicie o claude no seu projeto. As solicitações agora são roteadas pela RunAPI com 50% da taxa oficial.
Perguntas frequentes
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://api.runapi.ai e ANTHROPIC_API_KEY para sua chave RunAPI. Adicione ambas ao perfil do shell para que persistam. O Claude Code as lê na inicialização e roteia cada solicitação através da RunAPI.
Onde obtenho uma chave de API do Claude Code?
Crie uma em runapi.ai. Cadastre-se, abra Painel → Chaves de API e gere uma chave. Copie-a imediatamente, pois a chave completa é exibida apenas na criação. O nível gratuito inclui créditos para testar qualquer modelo Claude antes de financiar um 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://api.runapi.ai roteia cada solicitação através da RunAPI, que cobra pelos mesmos modelos com 50% da taxa oficial.
Por que o Claude Code ainda cobra pela taxa completa?
A URL base provavelmente não está definida no shell atual. Execute echo $ANTHROPIC_BASE_URL — se estiver vazia, a exportação não persistiu. Adicione-a a ~/.zshrc ou ~/.bashrc, recarregue com source e abra um novo terminal e verifique novamente.
Posso armazenar a chave em um arquivo de configuração?
Sim. Coloque os valores em um arquivo .claude.json no diretório home ou de projeto, em vez de exportá-los a cada sessão. Ambas as abordagens funcionam; o arquivo é mais conveniente para chaves por projeto, enquanto as exportações são mais simples para uma configuração global única.
Como monitoro os custos após a configuração?
Abra o painel da RunAPI. Ele mostra os gastos 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 escolha um modelo mais barato como Haiku para edições de rotina.
Isso muda como o Claude Code se comporta?
Não. A RunAPI encaminha solicitações diretamente para os modelos Claude subjacentes. A saída, o uso de ferramentas e o comportamento são idênticos à configuração padrão. Você só muda para onde vão as solicitações e como são cobradas — a experiência de codagem permanece a mesma.
Qual modelo devo definir como padrão?
A maioria dos desenvolvedores define ANTHROPIC_MODEL como claude-sonnet-4-6 para codagem diária. Use claude-haiku-4-5 para edições rápidas e baratas ou claude-opus-4-7 para refatorações difíceis. Você pode alternar modelos dentro do Claude Code a qualquer momento, e a cobrança segue o modelo que você chama.
Aponte o Claude Code para a RunAPI com dois comandos.
Crie uma conta RunAPI gratuita, defina ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY e execute cada modelo Claude no Claude Code com 50% de desconto nos preços oficiais da Anthropic.