Solución de problemas

La aplicación no se instala ni se abre.

Windows

Si SmartScreen bloquea el instalador, elija Más información → Ejecutar de todos modos. La compilación del escritorio está firmada con código, por lo que normalmente no aparece.

macOS

Si macOS se niega a abrir la aplicación, abra Configuración del sistema → Privacidad y seguridad y permítala allí, luego iníciela nuevamente.

Asegúrate de haber arrastrado 9xChat a Aplicaciones en lugar de ejecutarlo desde la imagen de disco montada.

Linux

Compruebe que el archivo descargado esté marcado como ejecutable. Si no es así, configure el bit ejecutable y ejecútelo nuevamente.

Móvil

Instálalo a través de Google Play o App Store para que las actualizaciones lleguen automáticamente. Si la aplicación no se inicia, actualícela y luego reinicie su dispositivo.

Las respuestas fallan o se detienen parcialmente

Trabaje con estos en orden:

1. Comprueba tu conexión. Los modelos en la nube necesitan acceso a Internet. Los modelos locales lo hacen no. Si las solicitudes a la nube fallan pero las locales funcionan, el problema está en la red o en el proveedor, no en 9xchat.

2. Verifique su saldo de crédito. Si está utilizando créditos 9xchat y tienen se agotan, las solicitudes se detienen. Recarga o cambia a tu propia clave API.

3. Comprueba tu clave API. Si trajiste tu propia clave, confirma que todavía está válido y le queda cuota con ese proveedor.

4. Pruebe con un modelo diferente. Si un modelo falla y otro tiene éxito, el problema es con ese modelo o proveedor específico.

Falta un modelo o no se carga

• Los modelos en la nube necesitan créditos o una clave API configurada para eso proveedor. En Biblioteca → Modelos, un proveedor sigue marcado como Inactivo hasta que añadas su clave. Esa etiqueta es la forma más rápida de ver a qué proveedores no tienes acceso.

• Los modelos locales necesitan que hayas iniciado el servicio local de modelos para que 9xChat pueda conectarse a ellos. Inícielo primero, luego vuelva a abrir la lista de modelos.

Su clave API es rechazada

La falla está en el proveedor, por lo que la solución también está ahí:

1. Pegue la clave nuevamente, sin espacios iniciales ni finales.
2. Confirme que la clave pertenece al proveedor bajo el cual la agregó.
3. Verifique que la clave aún exista y no haya sido revocada ni rotada.
4. Verifique que tenga la facturación configurada y la cuota restante con ese proveedor: un Una clave válida sin saldo falla de la misma manera que una mala.
5. Confirme que el modelo que eligió sea uno que su cuenta pueda usar. algunos Los modelos necesitan un nivel separado con el proveedor.

Las claves se almacenan cifradas en su máquina. Si una clave deja de funcionar en todas partes, reemplácela con el proveedor en lugar de reinstalar 9xchat.

Un modelo local no se conecta

1. Inicie su corredor local y confirme que responde fuera de 9xchat.
2. Confirma que escucha en la dirección y el puerto que espera 9xChat.
3. Confirme que se tira y carga el modelo en sí, no solo el corredor en funcionamiento.
4. Vuelva a abrir Biblioteca → Modelos para que la lista se actualice.

Los modelos locales no necesitan clave ni créditos. Si un modelo local funciona y uno en la nube no, el problema es tu clave, tu saldo o la red.

Una herramienta o servidor MCP no funciona

1. Compruebe que la herramienta esté habilitada. Cada herramienta tiene un interruptor habilitado debajo Biblioteca → Herramientas.

2. Comprueba el plan. Las herramientas de agentes y la búsqueda web en tiempo real necesitan Pro. Consulta Gratis y Pro.

3. Lea la línea de Seguridad. Indica qué permisos necesita la herramienta. una herramienta que no puede alcanzar lo que necesita, fracasa en lugar de pedirlo.

4. Para servidores MCP, confirme que se proporcionaron los secretos requeridos: una entrada todavía marcado Necesita configuración no se ha configurado. La vista previa de la configuración muestra el comando exacto que ejecuta, que vale la pena volver a leer si el servidor nunca se inicia.

5. Aíslelo. Deshabilite la herramienta, haga la misma pregunta y vea si el cambios de comportamiento. Eso le indica si la herramienta está involucrada.

La búsqueda de conocimientos no encuentra nada.

Una colección debe indexarse antes de poder buscarse.

• Confirme que los archivos se agregaron a una colección, no solo se adjuntaron a un chat.
• Confirme que la herramienta Buscar conocimiento esté habilitada.
• Si no se podía acceder a su proveedor de incrustaciones cuando agregó los archivos, la búsqueda recurre a la concordancia de palabras clave y perderá todo lo que necesite el índice. Vuelva a agregar los archivos una vez que se pueda acceder al proveedor.

Ver Conocimientos y Memorias.

Un archivo adjunto no se procesará

• Confirme que el modelo que seleccionó acepta ese tipo de archivo. Un modelo de solo texto no puede leer una imagen y la lista de modelos marca las que manejan la visión.
• Los archivos muy grandes pueden exceder el contexto de un modelo. Pruebe con un extracto más pequeño o un modelo con una ventana de contexto más grande.
• Si el archivo se abre correctamente en otro lugar pero falla aquí, intente convertirlo a un formato común primero.

La generación de imágenes falla

• Editar una región de una imagen, regenerar una imagen generada y usar imágenes en el chat requieren Pro. El espacio de pruebas de imágenes es gratuito.
• Confirma que tienes seleccionado un modelo de imágenes. Se elige por separado de tu modelo de chat.
• Consulta tu saldo de crédito si estás generando a través de créditos 9xchat.
• Algunos proveedores rechazan ciertos prompts; no es 9xChat quien los rechaza. Reformularlos es normalmente más rápido que volver a intentarlo.

El dictado o la lectura en voz alta fallan

Ambos necesitan un proveedor de audio que funcione y ninguno tiene una opción local.

• Confirme que su Proveedor de transcripciónesté configurado enConfiguración → Predeterminado Modelos.
• Concede a 9xChat permiso para usar el micrófono en los ajustes de privacidad de tu sistema operativo. En macOS, Ajustes del Sistema → Privacidad y seguridad → Micrófono.
• Ambos necesitan una conexión incluso cuando su modelo de chat sea local.

El dictado y el chat de voz requieren Pro; la lectura en voz alta es gratuita.

Los créditos se agotan más rápido de lo esperado

Cada mensaje muestra su propio costo, latencia y desglose de tokens, y la sesión muestra un total acumulado. Si un total parece incorrecto, abra las cifras por mensaje para ver qué intercambio lo tiene en cuenta: el contexto largo, los tokens de razonamiento y los archivos adjuntos grandes aumentan el costo de un solo turno.

Puede limitar esto por chat reduciendo los tokens de finalización máximos y el límite de contexto en la configuración del modelo, y Context Shield reduce la cantidad de historial que se reenvía con cada mensaje.

Para dejar de gastar créditos por completo, agregue su propia clave API o utilice un modelo local.

Una función está atenuada o falta

Las funciones que requieren Pro abren un diálogo de Función Pro en una cuenta gratuita, y los ajustes Pro muestran la etiqueta Premium: entre ellas están las pestañas múltiples, la ventana de chat, el asistente rápido, las herramientas de agentes, la búsqueda web en tiempo real, la edición de imágenes, el dictado y el chat de voz. Gratis y Pro muestra el reparto completo.

Si ya pagas, confirma que este dispositivo ha iniciado sesión con el UID que tiene la suscripción. Abre Perfil para comprobar el plan y los días restantes. Sigue Tu UID y tus dispositivos para conectar, cambiar o eliminar un dispositivo.

«No hay suficientes créditos para esta solicitud»

La solicitud cuesta más que tu saldo restante. Elige Comprar créditos, o cambia el chat a un modelo con tu propia clave de API o a un modelo local, que nunca consumen créditos. Tu saldo aparece en Perfil.

«Límite de dispositivos alcanzado»

Todas las plazas de dispositivos de tu UID están ocupadas: una con una cuenta gratuita o durante la prueba, tres con Pro. Elige Gestionar dispositivos y elimina uno que ya no uses (en iOS, usa la página de licencia en un navegador); después, vuelve a iniciar sesión. No crees un UID nuevo: no tendría tu plan ni tus créditos. Consulta Tu UID y tus dispositivos.

«Pago no detectado»

Tras pagar en el navegador, 9xChat comprueba tu cuenta cuando eliges Confirmar pago. Si muestra Pago no detectado, puede que el pago siga procesándose: espera un minuto y elige Intentar de nuevo. Si cerraste la página de pago por error, elige Abrir página de pago. Las compras de Google Play o del App Store se pueden recuperar con Restaurar compras en la pantalla de precios.

Un código de Handoff no funciona

• Los códigos caducan al cabo de unos minutos y solo se usan una vez. Cancela en el dispositivo emisor y elige Obtener un código de emparejamiento otra vez.
• Introduce los 6 dígitos en el dispositivo receptor, en Recibir chat….
• Mantén ambos diálogos abiertos y ambos dispositivos conectados hasta que termine la transferencia.

Consulta Handoff.

Falta algo en otro dispositivo

Su espacio de trabajo se almacena localmente en cada dispositivo, por lo que una segunda máquina iniciada con el mismo UID no hereda sus chats, notas o recuerdos. Esto es algo que se espera más que un defecto.

• Las memorias son por dispositivo. Una nueva instalación comienza sin ninguna.
• Handoff empareja dos dispositivos para una conversación; no copia el resto de su espacio de trabajo.
• Para mover material usted mismo, use Configuración → Datos y exportaciones.

Su suscripción sigue el UID, por lo que un dispositivo que verifica con él elige Pro aunque el contenido no viaje.

Nada aquí ayudó

Marca Incluir diagnóstico cuando escribas. Adjunta versiones, cifras de almacenamiento, recuentos y las categorías de errores recientes, nunca tus prompts, títulos, nombres de archivos ni claves. Es la forma más rápida de evitar una ronda de preguntas, y Privacidad detalla exactamente qué se envía.

Comuníquese a través de support con:

• tu sistema operativo y la versión de 9xChat,
• el modelo y proveedor que estaba utilizando,
• ya sea que tuviera créditos, su propia clave o un modelo local,
• lo que hiciste y el error visible exacto.