Erros e soluções
Todo erro da API traz um código estável no corpo da resposta. Ache o seu na tabela — em quase todos os casos é chave, IP ou plano.
{"error": "ip_not_allowed", "message": "IP not in whitelist"}Tabela de erros
| HTTP | Código | Significado | Correção |
|---|---|---|---|
| 401 | missing_api_key | a requisição chegou sem chave | a configuração não foi gravada nesta máquina: cole a linha da introdução (ou grave o arquivo à mão, em Começando) |
| 401 | invalid_api_key | chave inexistente ou revogada | a chave gravada não é a atual; crie outra no painel e cole a linha nova |
| 403 | ip_not_allowed | seu IP não é o autorizado da chave | atualize a whitelist no dashboard (Chaves e IP) |
| 403 | inactive_plan | conta sem plano ativo: nunca ativado, ou vencido | ative ou renove em infinitemodel.app/planos, com Pix; volta na hora |
| 403 | tier_not_allowed | o modelo pedido não está no seu plano | troque com /model, ou faça upgrade para o Max em infinitemodel.app/planos (é o caso do Fable 5.1 no Core; o Passe tem os três) |
| 429 | rate_limit_error | o saldo do mês (Core), do Passe ou o crédito avulso acabou. Vem sem Retry-After: saldo não volta com o tempo | a mensagem diz o que fazer: assinar, subir para o Max ou comprar crédito avulso, tudo em infinitemodel.app/planos. Ver Planos e pagamento |
| 429 | rate_limit_error | janela de proteção de 5 horas atingida, ou vazão por minuto. Vem com Retry-After | aguarde o tempo do header Retry-After; a mensagem diz qual foi. A janela está em Planos e pagamento |
| 5xx | — | problema do nosso lado ou da infraestrutura | confira status.infinitemodel.app; se persistir, fale com o suporte |
Diagnóstico em trinta segundos
Rode isto na máquina onde o erro aparece — as três respostas dizem exatamente onde está o problema.
# 1. A configuração existe? (o arquivo é o caminho normal)
cat ~/.claude/settings.json
echo $ANTHROPIC_BASE_URL # vazio aqui é NORMAL se você usou o arquivo
# 2. O serviço está de pé?
curl https://api.infinitemodel.app/health
# 3. Sua chave e seu IP passam?
curl https://api.infinitemodel.app/v1/models -H "x-api-key: sk-sua-chave-aqui"# 1. A configuração existe? (o arquivo é o caminho normal)
Get-Content "$env:USERPROFILE\.claude\settings.json"
echo $env:ANTHROPIC_BASE_URL # vazio aqui é NORMAL se você usou o arquivo
# 2. O serviço está de pé?
curl.exe https://api.infinitemodel.app/health
# 3. Sua chave e seu IP passam?
curl.exe https://api.infinitemodel.app/v1/models -H "x-api-key: sk-sua-chave-aqui"| Resultado | Conclusão |
|---|---|
| o passo 1 não acha o arquivo e a variável está vazia | a configuração não existe nesta máquina: cole a linha da introdução, ou refaça o passo 2 de Começando |
| o passo 2 não responde | problema de rede ou nosso; confira a página de status |
| o passo 3 devolve 401 | problema de chave |
| o passo 3 devolve 403 | problema de IP ou de plano — o código no corpo diz qual |
| o passo 3 lista modelos | está tudo certo com chave, IP e plano; o problema é da ferramenta |
Casos clássicos
O claude pediu login na Anthropic, ou perguntou o tema
Ele rodou antes da configuração. É o caso mais comum de quem instala primeiro e configura depois. Feche o CLI, cole a linha da introdução (ela grava a configuração e responde as perguntas do primeiro uso) e rode claude de novo. Não é preciso desinstalar nada.
Perdi a chave, e ela não aparece mais
A chave aparece uma única vez, por desenho: guardamos só uma impressão digital dela. Se a sua conta ainda não fez nenhuma requisição, a introdução oferece "Gerar uma chave nova" e monta a linha de novo. Se já rodou, revogue e crie outra no painel de chaves: o modal da chave nova entrega a mesma linha, pronta para colar.
Criei a conta com o Google e "não consigo entrar"
Conta criada com o Google não tem senha. Na tela de login, use o botão "Continuar com Google", o mesmo da primeira vez. O formulário de e-mail e senha não serve para ela.
A linha terminou com erro de IP
A chave é presa ao IP de onde foi criada, e o instalador testa a conexão de verdade no fim. Se você está em outra rede, no painel, em Chaves, clique em "Usar este IP" e cole a linha de novo. O porquê da regra está em Chaves e IP.
Funcionava ontem, hoje dá 403
É o erro mais comum do serviço: seu IP mudou (roteador reiniciado, rede nova, VPN ligada). Atualize a whitelist no dashboard e siga.
Configurei, mas o CLI diz que não há modelos, ou dá 401
Se você usou variável de ambiente, ela vale só naquela sessão: outro terminal não a enxerga, e o Claude Desktop precisa ser encerrado por completo. A forma que sobrevive a fechar o terminal é o arquivo, que a linha da introdução grava (passo 2 de Começando).
Se você usou o arquivo, confira se o JSON está íntegro (cat ~/.claude/settings.json): um arquivo malformado é ignorado inteiro, sem aviso, e o CLI se comporta como se nada tivesse sido configurado.
No Claude Desktop, git clone ou pip install dizem que o site está bloqueado
A mensagem é "O acesso a este site está bloqueado pelas configurações de saída de rede da sua organização", e o próprio Claude costuma dizer que só alcança api.infinitemodel.app. Não é a sua rede nem a nossa: no modo de gateway o app só deixa as ferramentas do Cowork e do Code saírem para os sites que você liberar, e essa lista começa vazia. Coloque * no campo Hosts de saída permitidos e reabra o app. O passo a passo está em Claude Desktop.
429 no meio do trabalho
Ou é a janela de 5 horas do plano (R$ 300 de uso no Core, R$ 500 no Max), ou a vazão por minuto segurando um pico, como um script disparando muitas chamadas em paralelo. O header Retry-After diz quantos segundos esperar, e a mensagem diz qual foi. Uso normal de programação raramente encosta em qualquer uma.
Se o 429 veio sem Retry-After, não é janela: é o saldo que acabou, e esperar não resolve. A mensagem traz o link da página de planos, onde dá para assinar, subir de plano ou comprar crédito avulso com Pix, e o trabalho continua de onde parou.
Resposta curta demais no Fable 5.1
Tarefas de raciocínio longo consomem parte do orçamento de saída. Peça continuação ou divida a tarefa em partes menores.
"Email ou senha inválidos" no login
A mensagem é a mesma para e-mail inexistente e senha errada, de propósito: não revelamos quais e-mails têm conta.
Ainda travado?
Escreva para suporte@infinitemodel.app com o código do erro, qual passo do diagnóstico falhou e o horário aproximado. Com isso resolvemos rápido.