Preguntas frecuentes de NextHub (FAQ)
Si tienes algún problema, empieza por aquí.
¿Qué hacer si aparece el error 429?
El 429 indica que se ha superado la concurrencia o que el saldo es insuficiente. Comprueba que el crédito y el saldo de tu cuenta sean suficientes; si el crédito es suficiente y el error sigue apareciendo con frecuencia, es posible que hayas alcanzado el límite de velocidad del ApiKey o del grupo (ventanas de 5 horas / diaria / semanal): inténtalo de nuevo más tarde o ajusta la configuración del límite de velocidad.
¿Qué significa «modelo no disponible» o «petición rechazada»?
Casi siempre es un problema del grupo o del ID del modelo. El grupo que eliges al crear el ApiKey determina qué modelos puedes llamar: confirma que el modelo de destino pertenece al grupo seleccionado y que el ID del modelo coincide con el que aparece en la lista de modelos.
Tras guardar settings.json, ¿el comando claude sigue sin conectarse?
Confirma que la ruta del archivo es correcta (Windows: %USERPROFILE%\.claude\settings.json; macOS: ~/.claude/settings.json), comprueba que el formato JSON es válido (la última línea no debe tener una coma sobrante) y verifica que ANTHROPIC_BASE_URL es https://api.nexthub.cc (sin /v1 al final).
¿Qué grupos hay disponibles y cuáles son sus multiplicadores?
Actualmente hay 9 grupos públicos (instantánea del 2026-09-27): claude code (0.37x, sin restricción de cliente); Claude Max (0.5x, alta estabilidad y alta tasa de acierto de caché); Claude-AWSB (0.7x); GPT-Azure (0.47x); GPT-Pro (0.11x, no permite generar imágenes); Gemini-aistudio (0.28x); Gemini-Vertex (0.49x); Grok (0.55x); 国产模型组 (0.15x). Además existen grupos exclusivos, como el de generación de imágenes, que solo son visibles tras iniciar sesión en la consola y activar los permisos correspondientes. El cargo real = precio oficial × multiplicador del grupo; consulta la explicación de los multiplicadores de grupo.
Tras configurar Claude Desktop, ¿aparecen advertencias y no se muestra «prueba superada»?
Es un comportamiento normal. El modo de gateway de terceros de Claude Desktop no pasa por la validación de inicio de sesión oficial, así que la página de configuración no muestra ningún mensaje de «conexión correcta»; las advertencias de «configuración no verificada» y «conexión de red» que aparecen en la página de conversación tras reiniciar también son falsos avisos habituales. Envía un mensaje directamente: si recibes una respuesta con normalidad, la configuración está activa. Consulta el tutorial de configuración de Claude Desktop.
¿Qué hacer si las peticiones fallan tras configurar Zed?
Primero confirma que has escrito https://api.nexthub.cc/v1 en Base URL (con /v1). Este sitio admite los dos modos de petición, chat/completions y Responses, así que puedes dejar el valor por defecto; el ID del modelo debe coincidir con el de la lista de modelos (por ejemplo claude-opus-5-5).
¿No hay respuesta después de conectar Kilocode?
Comprueba que Base URL es correcta (https://api.nexthub.cc/v1, con /v1) y confirma que en API Provider está seleccionado OpenAI Compatible (Responses) y no otro tipo.