“Credit balance is too low” no Claude Code: o que é e como resolver

Credit balance is too low

Nas versões mais antigas do Claude Code, esse aviso aparecia como “Credit balance too low · Add funds”. Já nos registros de log ou em outras ferramentas conectadas ao modelo, a mensagem completa costuma ser “Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.”. Em todos esses formatos, a causa e a solução são exatamente as mesmas.

O que essa mensagem quer dizer

Existem duas maneiras completamente separadas de pagar pelo uso do Claude Code. A primeira é a assinatura mensal do Claude (Pro, Max, Team ou Enterprise), que libera uma franquia de uso renovada automaticamente ao longo do dia e da semana. A segunda é a conta de desenvolvedor do Console da Anthropic, conhecida como API, em que você deposita créditos pré-pagos em dólar e cada comando desconta alguns centavos do saldo. O erro “Credit balance is too low” pertence exclusivamente a esse segundo modelo e avisa que o saldo pré-pago da API chegou a zero.

Quando o que acaba é a franquia da sua assinatura Pro ou Max, a mensagem na tela é outra, como “You've hit your session limit” ou “You've hit your weekly limit”. Nesse cenário não há erro de conta, e você pode ver no FAQ o que fazer quando o limite do Claude acaba para continuar trabalhando sem perder o ritmo.

Por que aparece mesmo você pagando o Pro ou o Max

Se você está com a assinatura Pro ou Max em dia e mesmo assim esbarrou nesse bloqueio, pode respirar aliviado: o seu plano não sumiu. Isso acontece porque o Claude Code está tentando se autenticar pela conta do Console em vez de usar a sua assinatura. Na prática, existem três situações que levam a esse desvio:

• Você escolheu a opção do Console na hora do login. Quando você digita /login, o Claude Code pergunta se deve entrar pela assinatura ou pelo Console da Anthropic. Se você marcou a segunda opção, ele ignora o seu plano mensal e tenta cobrar dos créditos de API.
• Existe uma chave de API salva no seu computador. Se o seu sistema tem uma variável de ambiente chamada ANTHROPIC_API_KEY e você autorizou o uso dela quando o terminal perguntou, essa chave passa na frente do login da assinatura. É muito comum ela ter sobrado de algum teste antigo, de outro programa de IA ou de um tutorial da internet.
• Você realmente usa o Claude Code via API e os créditos acabaram. Se você optou por pagar por uso no Console sem assinar plano mensal, o aviso apenas indica que é hora de recarregar o saldo ou migrar para uma assinatura.

Preciso de API key? Não

Você não precisa gerar nem colar nenhuma chave de API para usar o Claude Code se já assina o plano Pro ou o Max. O seu próprio login de assinante libera a ferramenta inteira, tanto no terminal quanto na extensão do VS Code. Colocar uma chave de API só faz a Anthropic cobrar por fora um uso que já está coberto na sua mensalidade, como mostro na comparação entre assinatura e API no guia de preço do Claude.

Primeiro, descubra por qual conta ele está entrando

1. 1Digite /status no chat do Claude Code para ver na tela a versão instalada, o modelo ativo e a credencial que está conectada.
2. 2Olhe se aparece uma linha indicando uma API key ativa. Se aparecer, a culpada é uma chave de API salva no seu computador, e basta seguir o passo a passo de remoção da chave logo abaixo.
3. 3Se não aparecer nenhuma chave no /status, digite /usage. Quando você está conectado pela assinatura, a tela mostra as barras de progresso da sessão e da semana; se em vez das barras aparecer o custo em dólar e a contagem de tokens, o seu login foi feito pela conta do Console.

Se você entrou pela conta do Console

1. 1Digite /logout no chat do Claude Code para desconectar a conta atual.
2. 2Em seguida, digite /login e selecione a primeira alternativa, chamada Claude account with subscription. Evite a opção Anthropic Console account, que é exclusiva para cobrança via API.
3. 3O seu navegador vai abrir automaticamente. Faça login com o mesmo e-mail da sua assinatura Pro ou Max, confirme a autorização e volte para o VS Code ou para o terminal.
4. 4Rode o comando /usage para confirmar a troca. Assim que as barras de limite da sessão e da semana aparecerem na tela, o Claude Code já está rodando no seu plano.

Se tem uma chave de API guardada no computador

Quando existe uma chave salva nas variáveis do sistema, apenas refazer o /login não resolve o problema, porque a variável ANTHROPIC_API_KEY tem prioridade sobre a assinatura. A solução definitiva é apagar essa variável do computador e reiniciar o editor.

No Windows, abra o PowerShell pelo menu Iniciar e cole o comando abaixo. Ele remove a variável ANTHROPIC_API_KEY da sua conta de usuário imediatamente e conclui em silêncio, sem exibir mensagem na tela.

No Mac, essa chave costuma ficar gravada em um dos arquivos de inicialização do Terminal. Abra o aplicativo Terminal e rode o comando a seguir para descobrir exatamente em qual arquivo e linha ela foi parar.

O Terminal vai responder indicando o arquivo e o número da linha encontrada, como /Users/voce/.zshrc:12:export ANTHROPIC_API_KEY=.... Abra esse arquivo no editor de textos padrão (para o .zshrc, basta rodar open -e ~/.zshrc), apague a linha inteira do export ANTHROPIC_API_KEY, salve e feche a janela.

Tanto no Windows quanto no Mac, o passo final é fechar todas as janelas abertas do VS Code e abrir o programa de novo, já que o editor só atualiza a leitura das variáveis do sistema quando inicia. Depois de reabrir, digite /status para confirmar que a chave sumiu e, se necessário, rode /login escolhendo Claude account with subscription.

Se você precisa manter a variável ANTHROPIC_API_KEY no computador por causa de outro sistema e usa o Claude Code direto no terminal, existe um atalho sem apagar a chave: digite /config e desative a opção Use custom API key.

Se você usa a API de propósito

Caso você realmente prefira trabalhar sem assinatura e pagar por token consumido, basta adicionar saldo no painel platform.claude.com/settings/billing, onde também dá para ativar a recarga automática (auto-reload) para não travar no meio de uma entrega. Agora, se você já paga o Pro ou o Max, não faz sentido pagar duas vezes pelo mesmo trabalho: volte para o login da assinatura seguindo os passos acima e veja a diferença de valores detalhada no guia sobre quanto custa o Claude.

Como evitar que volte

• Sempre que fizer login no Claude Code, escolha a opção Claude account with subscription em vez da conta do Console.
• Se o terminal detectar uma chave no ambiente e perguntar se pode usá-la (Do you want to use this API key?), escolha No (recommended) para manter o uso na sua assinatura.
• Não cole chaves de API nas configurações do sistema só porque algum vídeo na internet mandou: quem assina o Pro ou o Max resolve tudo apenas com e-mail e senha.
• Sempre que instalar uma extensão nova de IA no computador, rode um /status rápido para garantir que nenhum instalador alterou a sua autenticação.

Se nada funcionou

• Se o comando /status continuar exibindo a chave mesmo depois de limpar o sistema, ela pode estar gravada direto nas configurações internas do Claude Code. Abra o arquivo ~/.claude/settings.json, procure o bloco env e apague a linha ANTHROPIC_API_KEY.
• No Windows, se a chave tiver sido cadastrada nas variáveis globais da máquina (Sistema) em vez das variáveis do seu usuário, o comando do PowerShell acima não vai apagá-la. Nesse caso, abra o painel de Variáveis de Ambiente do Windows e remova a linha manualmente.
• Tire um print da mensagem de erro e da resposta do /status, abra o claude.ai no navegador e peça ajuda informando se você usa Windows ou Mac.
• Se houve alguma cobrança indevida de créditos no seu Console, acione diretamente o suporte oficial na central de ajuda do Claude.
• Se você é aluno do MazyOS, mande o print lá no grupo da comunidade seguindo as instruções de como funciona o suporte da turma. E, se bateu a dúvida se esse aviso tem relação com o seu acesso ao MazyOS, pode ficar tranquilo: esse saldo é exclusivo da API da Anthropic, já que o MazyOS não trabalha com créditos pré-pagos nem tem cobrança mensal.

Destravou o login e quer dominar o próximo passo? Veja no guia completo o que é o Claude Code e como tirar o seu primeiro projeto do papel.