Your credit balance is too low to access the Anthropic API: solução

"Your credit balance is too low to access the Anthropic API" significa que você não tem créditos pré-pagos suficientes para pagar o uso da API do Claude. No Claude Code, ele aparece como "Credit balance is too low". Se você achava que estava usando um plano como Pro ou Max e mesmo assim vê o erro, a causa mais comum é que a chave de API da variável de ambiente ANTHROPIC_API_KEY tem prioridade sobre o login do seu plano, e por isso você passou a ser cobrado pela API.

400 invalid_request_error
Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.

Um exemplo da resposta da API. Ela aparece assim em logs que usuários colaram no GitHub do Claude Code (um relato de abril de 2025, um relato de agosto de 2026). A lista de erros da API da Anthropic não inclui essa frase exata.

Com base na documentação oficial do Claude Code e na Central de Ajuda da Anthropic (consultadas em 26 de outubro de 2026), este artigo explica o que o erro significa, como diferenciar as causas, as duas soluções e qual a diferença em relação aos créditos mensais de API incluídos no Max e no Team e aos "créditos de uso" do seu plano. As causas aparecem com cores como A Saldo e B Chave de API.

1. O que o erro significa e como ele aparece

A API do Claude é pré-paga, exceto para organizações com contrato comercial que recebem fatura no fim do mês. Segundo o artigo de ajuda da Anthropic, o uso da API, do Playground e do Claude Code por meio de uma organização do Claude Console é descontado dos créditos que você compra antecipadamente e, quando os créditos acabam, você não consegue chamar a API até adicionar mais. Este erro avisa que você chegou a esse estado de saldo insuficiente.

"Plans & Billing", no fim da mensagem, refere-se à tela de faturamento do Console. No Console atual, você confere o saldo e compra créditos na página Billing (platform.claude.com/settings/billing).

Fontes: Anthropic, "How do I pay for my Claude API usage?"; Claude Code, "Error reference: Credit balance is too low". A mensagem antiga vem de um relato no GitHub. Consultado em 26 de outubro de 2026.

A referência oficial de erros do Claude Code aponta duas causas: os créditos pré-pagos da sua organização no Console acabaram, ou você pretendia usar uma assinatura, mas as solicitações estão sendo enviadas com uma chave de API do Console. São as causas A e B acima.

2. Três perguntas para encontrar a causa

Responda na ordem e você saberá qual solução seguir.

1. P1 Você pretende usar o Claude Code com um plano Pro, Max, Team ou Enterprise?

   Sim Vá para a P2. Se você estiver usando seu plano, este erro não deveria aparecer

   Não (uso uma chave de API ou meu próprio app) Vá para a P3

2. P2 O /status mostra uma chave de API?

   SimCausa B Uma ANTHROPIC_API_KEY que você aprovou está tendo prioridade sobre o seu plano → Seção 4

   Não Confira a linha do método de login. Se você entrou com uma conta do Console, está pagando com o saldo do Console → execute /login para entrar de novo com a conta do seu plano (passo 5 da seção 4)

3. P3 Em Billing no Console, a organização da chave tem saldo?

   Nenhum ou poucoCausa A Compre créditos → Seção 3

   Sim Verifique se a chave pertence a outra organização, se você acabou de comprar os créditos e se você só tem os créditos mensais do Max ou do Team e os está usando para algo que eles não cobrem → Perguntas frequentes

Base da P2: a referência de erros do Claude Code orienta os usuários de plano que veem este erro a conferir a linha da chave de API no /status. Para trocar quando o seu método de login é o Console, veja Anthropic, "Use Claude Code with your Pro or Max plan" (se você entrou com uma conta do Console de pagamento por uso, mude para o seu plano com /login).

O que você paga por um plano como o Claude Pro não pode ser usado para pagar a API. A ajuda da Anthropic diz que os planos e o Console são produtos separados, e a API é cobrada à parte (Why is Claude API usage billed separately from my paid Claude plan?). Mesmo com um plano, você precisa de saldo no Console enquanto estiver usando uma chave de API.

3. Causa A Adicione créditos

Esta é a solução para quem usa uma chave de API. Só membros com a função Admin ou Billing na organização do Console podem comprar créditos. Se for a organização da sua empresa, peça a um administrador.

1. Abra a página Billing Entre no Console e abra Billing. O saldo de créditos da organização e o valor já gasto aparecem na mesma página. Se você faz parte de mais de uma organização, confirme que selecionou a organização em que a chave com falha foi criada. O saldo é por organização, e todas as chaves de API da mesma organização consomem o mesmo saldo.
2. Compre créditos Clique em "Buy credits", informe um valor e confirme. Segundo o artigo de ajuda, os créditos comprados ficam disponíveis na hora.
3. Ative a recarga automática (opcional) Na seção Credit balance, use "Set up auto-reload" para informar o saldo que dispara a recarga (When credit balance reaches) e o saldo até o qual recarregar (Bring credit balance back up to) e clique em "Turn on". Se o seu saldo já estiver nesse valor ou abaixo dele, o botão vira "Turn on and purchase" e a compra é feita na hora.
4. Tente de novo o que falhou No Claude Code, envie a mesma instrução outra vez.

Fonte: Anthropic, "How do I pay for my Claude API usage?" (passos da compra, disponibilidade imediata, configuração da recarga automática, validade de um ano após a compra, sem reembolso). Consultado em 26 de outubro de 2026.

Os créditos comprados expiram um ano após a data da compra e não são reembolsáveis. Comprar só o que você vai usar e deixar a recarga automática completar quando o saldo baixar tende a desperdiçar menos. A referência de erros do Claude Code também recomenda definir limites de gasto por workspace no Console, para que um único projeto não esgote o saldo da organização.

4. Causa B Remova a chave de API e use seu plano

Esta é a solução para quem pretende usar um plano Pro, Max, Team ou Enterprise. Quando há várias credenciais, o Claude Code escolhe uma em uma ordem fixa, e a variável de ambiente ANTHROPIC_API_KEY e o apiKeyHelper em um arquivo de configurações ficam acima do login do plano que você fez com /login. Quando a chave é usada, como explica a ajuda da Anthropic, a cobrança é por uso na organização dessa chave e, se essa organização não tiver saldo, você é barrado com este erro.

1. Confira com /status Execute /status dentro do Claude Code e veja a linha da chave de API. Quando há ao mesmo tempo um login e uma chave de API, aquele que não está em uso fica marcado.
2. Remova do shell atual Remova a variável do terminal que está aberto (comandos abaixo).
3. Remova a origem da chave Encontre e apague a linha export ANTHROPIC_API_KEY=... no arquivo de configuração do seu shell, a variável de ambiente de usuário do Windows e qualquer entrada no seu perfil do PowerShell ($PROFILE). Se não fizer isso, o próximo terminal que você abrir vai carregá-la de novo. Segundo a referência oficial de erros, ferramentas como o direnv ou o terminal de uma IDE podem carregar a chave do arquivo .env de um projeto, então confira também o .env da pasta do seu projeto. Como encontrá-la em env ou apiKeyHelper nos arquivos de configurações do Claude Code é explicado no nosso artigo sobre "claude.ai connectors are disabled".
4. Reabra o terminal e inicie o claude A ajuda oficial cita como erro comum alterar variáveis de ambiente sem reabrir o terminal.
5. Execute /login se precisar e depois /status de novo Se ainda não entrou com a conta do seu plano, execute /login. Quando o /status confirmar que nenhuma chave de API está em uso, está pronto.

# macOS / Linux: verificar se está definida
env | grep ANTHROPIC
# Remover do shell atual
unset ANTHROPIC_API_KEY
# Descobrir qual arquivo de configuração a define
grep -n ANTHROPIC_API_KEY ~/.zshrc ~/.bashrc ~/.bash_profile ~/.profile 2>/dev/null

# Windows (PowerShell): verificar se está definida
Get-ChildItem Env:ANTHROPIC*
# Remover do shell atual
Remove-Item Env:ANTHROPIC_API_KEY

# Windows (Prompt de Comando): verificar se está definida
echo %ANTHROPIC_API_KEY%
# Remover do shell atual
set ANTHROPIC_API_KEY=

No Windows, remova as configurações persistentes das variáveis de usuário em "Propriedades do Sistema" → "Avançado" → "Variáveis de Ambiente". Fontes: Anthropic, "Manage API key environment variables in Claude Code"; Claude Code, "Authentication precedence" e "Error reference" (os comandos de verificação e o .env estão na entrada "Invalid API key"). Consultado em 26 de outubro de 2026.

Se não quiser apagar a chave, você pode revogar sua aprovação. Quando o Claude Code é iniciado no modo interativo, ele pergunta uma vez se deve usar a ANTHROPIC_API_KEY na primeira vez que a encontra e lembra a sua resposta. Para mudar depois, alterne "Use custom API key" em /config (essa opção só aparece enquanto a variável estiver definida). Porém, com claude -p (não interativo), a chave é sempre usada se estiver presente. Se outros scripts precisarem da chave, passe-a apenas ao executar esses comandos.

Se aparecer na extensão do VS Code

Na extensão do Claude Code para VS Code, você confere as mesmas coisas. Digite /status no painel para ver sua conta e outros detalhes (Claude Code v2.1.280 ou posterior). Segundo a documentação oficial, o VS Code aberto a partir de um terminal com code . herda as variáveis de ambiente desse shell. Se a chave estiver no arquivo de configuração do seu terminal, ela pode chegar também à extensão. Depois de remover a chave, feche e reabra o VS Code antes de conferir.

Também é possível definir variáveis de ambiente na configuração claudeCode.environmentVariables da extensão. Nas configurações, em Extensões → Claude Code, confira se a ANTHROPIC_API_KEY não está definida ali.

Fonte: Claude Code, "Use Claude Code in VS Code" (herança das variáveis de ambiente, a configuração environmentVariables, /status). Consultado em 26 de outubro de 2026.

5. O que está pagando pelo seu uso

Há três coisas chamadas "créditos", e confundi-las leva a interpretar mal este erro: os créditos de API comprados no Console, os créditos mensais de API incluídos no Max e no Team e os créditos de uso, que pagam o uso além dos limites do seu plano Pro ou Max. Veja com o que cada tipo de uso pode ser pago.

Fontes: Anthropic, "Monthly API credits for Max and Team plans" (o Claude Code interativo e os créditos de uso não são cobertos; claude -p e o Agent SDK executados por você com uma chave de API são cobertos); "Manage usage credits for paid Claude plans" (os créditos de uso valem tanto para o Claude quanto para o Claude Code depois dos limites do plano e são separados dos créditos mensais de API); "Manage API key environment variables in Claude Code" (se houver uma chave de API, a cobrança é por uso na organização dessa chave); "How do I pay for my Claude API usage?". Consultado em 26 de outubro de 2026.

O que importa para este erro são as duas colunas da direita (o saldo da sua organização no Console). A tabela leva a três conclusões.

• Se o erro aparece quando você acha que está no seu plano, você está em uma das linhas de chave de API. Adicionar ao seu plano ou aos créditos de uso (as duas colunas da esquerda) não resolve, por mais que você adicione (causa B).
• Os créditos mensais de API do Max e do Team não podem ser usados no Claude Code interativo. Mesmo que os créditos do seu plano ainda apareçam na tela de saldo do Console, eles não pagam o Claude Code interativo com uma chave de API. Como resgatá-los e em que ordem são consumidos é explicado no nosso artigo sobre os créditos de API do Max e do Team.
• Os créditos de uso são um saldo separado nas configurações do claude.ai (Configurações → Uso). Como são separados do saldo do Console, recarregá-los não ajuda no uso com chave de API.

6. Erros parecidos, mas diferentes

Outros erros também envolvem saldo ou limites. Diferencie-os pelo começo da mensagem.

Fontes: Claude API, "Rate limits" (os dois erros de limite de gasto); Claude Code, "Error reference". Consultado em 26 de outubro de 2026.

Para ver outros erros do Claude Code, consulte Erros comuns do Claude Code e como resolver.

Resumo

Perguntas frequentes

P. A API do Claude tem um nível gratuito?

R. A ajuda oficial não menciona nível gratuito. Depois de criar uma organização no Console, a orientação é "adicionar créditos ao saldo da sua organização para usar a API e o Playground" (I created a Claude Console organization - how do I start using the Claude API?). A exceção são os créditos mensais de API incluídos nos planos Max e Team; os planos Free, Pro e Enterprise não são elegíveis.

P. Tenho o Claude Pro. Por que estou recebendo este erro?

R. Porque o Claude Code está rodando com uma chave de API. A mensalidade do seu plano não paga a API, então, se a organização da chave de API não tiver saldo, você recebe este erro. Verifique com /status se há uma chave de API em uso e remova-a seguindo os passos da seção 4.

P. Comprei créditos, mas o erro continua.

R. Segundo o artigo de ajuda, os créditos comprados ficam disponíveis na hora. Primeiro, confira se a organização em que você criou a chave é a mesma em que comprou os créditos. A página de status da Anthropic registra um incidente em 1º de setembro de 2026 (UTC) em que os créditos comprados demoraram a ser aplicados para usuários cujo saldo tinha chegado a zero, e algumas solicitações à API retornaram por engano "credit balance is too low" (Delays in credit purchases). Em 1º de outubro do mesmo ano, houve outro incidente em que as compras demoraram a ser aplicadas (Delayed credits on the Claude Platform). Se a organização for a mesma e o saldo aparecer, veja em status.claude.com se há algum incidente em andamento.

P. Ainda tenho créditos mensais de API do Max, mas recebo este erro no Claude Code.

R. Os créditos mensais de API não podem ser usados no Claude Code interativo no terminal, na IDE, no app para desktop ou na web (a tabela da seção 5). Para usar seu plano, remova a chave de API e use seu login; para usar uma chave de API, compre créditos no Console.