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.
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 o RunAPI e execute todos os modelos Claude pela metade da tarifa oficial. Este guia mostra os comandos exatos para Mac, Linux e Windows.
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 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.
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. Execute claude --version primeiro para confirmar que o Claude Code está funcionando antes de mexer em qualquer configuração de 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.
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, 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ê.
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://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
Acrescente ambas as exportações a ~/.zshrc (ou ~/.bashrc) para que sobrevivam a novas sessões de terminal. Recarregue com source ~/.zshrc. No Windows, defina-as no PowerShell e abra uma nova janela de terminal para que a alteração entre em vigor.
echo 'export ANTHROPIC_BASE_URL=https://runapi.ai' >> ~/.zshrc
4
Verificar a configuração
Confirme que a variável imprime a URL do RunAPI. Se estiver vazia, recarregue seu perfil de shell ou abra um novo terminal — variáveis definidas em uma sessão não são automaticamente transferidas.
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ê?
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' |
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 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.
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 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 |
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://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.
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://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.
RELACIONADO
Explorar mais
Preços do Claude Code
Comparativo de custos do Claude Code: cobrança por API vs assinatura Max.
Configuração da API no Cursor
Conecte o Cursor ao RunAPI em dois minutos e economize 50% nas tarifas de API.
Configuração da API no VS Code
Use modelos RunAPI no VS Code Copilot Chat e extensões.
RunAPI CLI
Execute qualquer modelo pelo terminal com um único comando.
Aponte o Claude Code para a RunAPI com dois comandos.
Crie uma conta gratuita no RunAPI, defina ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY no seu perfil de shell e execute todos os modelos Claude no Claude Code com 50% de desconto sobre o preço oficial da Anthropic.