Perguntas frequentes do NextHub (FAQ)
Se encontrou algum problema, comece por aqui.
O que fazer quando aparece o erro 429?
O 429 significa que o limite de concorrência foi excedido ou que o saldo é insuficiente. Verifique se a cota e o saldo da conta são suficientes; se a cota estiver suficiente e o erro ainda ocorrer com frequência, pode ser que você tenha atingido o limite de taxa da ApiKey ou do grupo (janelas de 5 horas / diária / semanal); nesse caso, tente novamente mais tarde ou ajuste as configurações de limite de taxa.
Aparece "modelo indisponível" ou "requisição recusada"?
Na maioria dos casos, é um problema de grupo ou de ID do modelo. O grupo escolhido ao criar a ApiKey determina o intervalo de modelos que podem ser chamados; confirme se o modelo desejado pertence ao grupo selecionado e se o ID do modelo está escrito exatamente como em Canais e modelos.
Depois de salvar o settings.json, o comando claude ainda não conecta?
Confirme se o caminho do arquivo está correto (Windows: %USERPROFILE%\.claude\settings.json; macOS: ~/.claude/settings.json), verifique se o formato JSON é válido (a última linha não pode ter vírgula extra) e confirme que ANTHROPIC_BASE_URL está como https://api.nexthub.cc (sem /v1 no final).
Quais grupos estão disponíveis? Quais são os multiplicadores?
Atualmente há 9 grupos disponíveis publicamente (data do instantâneo: 2026-09-27): claude code (0.37x, sem restrição de cliente), Claude Max (0.5x, alta estabilidade e alto acerto de cache), Claude-AWSB (0.7x), GPT-Azure (0.47x), GPT-Pro (0.11x, sem geração de imagens), Gemini-aistudio (0.28x), Gemini-Vertex (0.49x), Grok (0.55x) e 国产模型组 (0.15x). Além disso, existem grupos exclusivos como o de geração de imagens, visíveis somente após entrar no console e ativar as permissões correspondentes. A cobrança efetiva = preço oficial × multiplicador de grupo; consulte os detalhes em explicação dos multiplicadores de grupo.
Depois de configurar o Claude Desktop, aparece um aviso e não surge a confirmação de "teste aprovado"?
Isso é normal. O modo de gateway de terceiros do Claude Desktop não passa pela verificação de login oficial, então a página de configuração não exibe a mensagem "conexão bem-sucedida"; após reiniciar, as barras de aviso "configuração não verificada" e "conexão de rede" na página de conversa também são falsos alertas rotineiros. Envie uma mensagem diretamente: se receber uma resposta normalmente, a configuração está ativa. Veja mais detalhes em tutorial de configuração do Claude Desktop.
O que fazer quando o Zed dá erro nas requisições após a configuração?
Primeiro confirme que a Base URL está preenchida como https://api.nexthub.cc/v1 (com /v1). O NextHub oferece suporte aos dois modos de requisição, chat/completions e Responses; basta manter o padrão. O ID do modelo precisa estar de acordo com Canais e modelos (por exemplo, claude-opus-5-5).
O Kilocode conectou mas não responde?
Verifique se a Base URL está preenchida corretamente (https://api.nexthub.cc/v1, com /v1) e confirme que o API Provider selecionado é OpenAI Compatible (Responses) e não outro tipo.