Teapot Router / Documentação
Solução de problemas do Claude Code: conexão, 401 e cota
Associe o erro à correção: rede e proxy, chave e URL, saldo e cota — três verificações para três classes de falha.
Abrir espaçoConexão ou timeout: verifique primeiro o caminho de rede
- O CLI não herda o proxy do sistema. Rode `echo $https_proxy` — se vazio, exporte e tente de novo.
- A extensão do VSCode tem pilha de rede própria e pode não herdar proxy ou variáveis de ambiente — configure o proxy dentro da extensão.
- Com endpoint personalizado, confira o ANTHROPIC_BASE_URL (caracteres ou barras extras); não misture a URL oficial com a de um gateway.
Se funcionar em outra rede (hotspot do celular) e não na sua, é puramente rede — não a chave.
401 ou 403: verifique chave e endereço
- 401 geralmente é a chave: cópia incompleta (espaços), revogada ou expirada, ou chave de outro provedor.
- Com endpoint personalizado, chave e endereço formam um par — a chave de um provedor contra a URL de outro sempre dá 401.
- Nome de campo digitado errado no env do settings.json pode cair silenciosamente no endpoint padrão: parece configurado, mas ainda vai para a URL oficial.
Chave revogada não volta; reinicie o cliente depois de trocar a chave.
429, cota e modelo não encontrado
- 429 é limite de taxa: espere a janela ou reduza a concorrência.
- 'Cota insuficiente' tem duas camadas: saldo da conta e o limite próprio da chave — o limite da chave é um teto, não crédito extra.
- 'Modelo não encontrado': confira se o ID no cliente corresponde exatamente (caixa, versão) ao catálogo Modelos.
Cada requisição (modelo/tokens/custo) está no registro de uso — depois de resolver, concilie uma entrada para ver se retries silenciosos não cobraram duas vezes.