Solución de problemas y preguntas frecuentes

Cuando algo falla, haz clic en el ? arriba a la derecha de la ventana y elige Reportar un problema. También está en Ayuda, Reportar un problema… en la barra de menús, escribiendo bug en la paleta de comandos y en Ajustes, Ayuda. Cuenta qué pasó en una frase si puedes (es opcional) y pulsa Enviar reporte. Deska adjunta lo que sabe: los mismos datos que Diagnóstico, tu plan, cuántos proyectos y paneles tienes abiertos, la última parte de su registro y una captura de la ventana tal como se veía al abrir el reporte.

Antes de que algo salga, la carpeta personal en las rutas se convierte en ~, los enlaces conservan solo el sitio, y se quitan correos, claves y tokens. Puedes desactivar el registro y la captura, y Ver exactamente qué se incluye muestra el texto completo. Tu correo solo se envía si activas Pueden escribirme sobre esto. Nunca se incluyen conversaciones, prompts, contenido de archivos ni nombres de paneles.

Al enviarlo recibes un código corto como DSK-3F9A1C. Publícalo en el Discord de Deska para que podamos relacionar el reporte contigo y responderte ahí. Guardar en archivo guarda el mismo reporte en un archivo de texto, por si prefieres adjuntarlo tú. Donde una organización mantiene los reportes dentro de la empresa, guardar es la única opción.

Si es una pregunta y no un fallo, el mismo ? abre Únete a nuestro Discord, donde responden el equipo y otras personas que usan Deska. También lo encuentras en Ayuda en la barra de menús, escribiendo discord en la paleta de comandos y en Ajustes, Ayuda.

Ajustes, Diagnóstico es una instantánea de solo lectura con todo lo que necesita una respuesta de soporte: la versión de Deska y su canal de publicación, las versiones de Electron, Chromium, Node y V8, tu plataforma y kernel, las seis rutas en disco que importan, desde la carpeta de datos de aplicación hasta los worktrees de agentes (cada una con un botón Mostrar para abrirlas), una fila por agente de código con su versión y si tiene sesión iniciada, y el tamaño del registro de hilos de agente.

Copiar diagnóstico copia todo eso como texto plano. No lleva nombres de cuenta, tokens ni claves de API, así que es seguro pegarlo en un correo o en un issue. Adjuntarlo convierte la mayoría de las idas y venidas en una sola respuesta.

Dex funciona con tu propio agente de código (Claude Code, Codex, OpenCode, Cursor y Antigravity), así que casi todas las comprobaciones son sobre el motor y no sobre tu cuenta. Eso sí, Dex necesita que hayas iniciado sesión en Deska: sin sesión te pide iniciarla primero, y el plan gratuito permite cinco turnos de Dex al día.

• ¿Hay una CLI de agente instalada y con sesión iniciada? Ajustes, Agentes muestra con qué agente responde Dex y el estado de cada uno. Si ninguno está listo, usa Instalar o Conectar cuenta en su tarjeta y luego Probar Dex para confirmar que responde; las siguientes secciones cubren los fallos más habituales.
• La voz corre con las claves de Deska. Necesita una cuenta de Deska y minutos restantes, y se pausa cuando se agotan los minutos del mes. Comprueba el saldo en tu panel de cuenta. Consulta Planes y facturación.

Claude Code, Codex, OpenCode, Cursor y Antigravity son herramientas de línea de comandos independientes que Deska dirige; no vienen incluidas. La forma más sencilla de instalar una es Ajustes, Agentes: elige Instalar en la tarjeta del agente y Deska ejecuta el comando de instalación por ti en un panel de terminal. La Biblioteca de paneles (Cmd/CtrlShiftE) ofrece el mismo Instalar en la tarjeta de un agente que dice No instalado, o un enlace a su guía de instalación cuando el agente necesita npm y esta computadora no lo tiene. Cada herramienta gestiona su propio inicio de sesión, que Conectar cuenta abre en una terminal.

Cuando un agente ya configurado se niega a arrancar, casi siempre es una de estas:

• El binario no está en tu PATH. Por defecto Deska busca claude, codex, opencode, cursor-agent y agy por su nombre. Si instalaste alguno en un sitio que tu shell de inicio no exporta, la instancia aparece como No instalado y la sesión no llega a arrancar.
• Una provider instance lo está sustituyendo. Cada agente en Ajustes, Agentes puede fijar su propia ruta de binario y su directorio home en Avanzado. Una ruta que era correcta en tu máquina anterior, o un home que pertenece a otra cuenta, produce exactamente el mismo fallo que un binario ausente. Borra la sustitución para volver a la búsqueda por defecto.
• La CLI tiene la sesión cerrada. Deska comprueba las credenciales de cada instancia y muestra el resultado en su tarjeta. Sin sesión iniciada en esta computadora. significa que la herramienta necesita iniciar sesión, no Deska: elige Conectar cuenta, completa el inicio de sesión en la terminal que se abre y pulsa Actualizar. Aún sin comprobar. (Cuenta sin revisar en Herramientas y cuentas) es otra cosa: Deska no pudo confirmar la sesión sin ejecutar el agente, y es posible que sí esté iniciada. Ejecuta Probar tareas o Probar Dex en la tarjeta para saberlo; cada comprobación envía una petición breve con tu cuenta del proveedor.
• Una tarea falla con “OAuth session expired and could not be refreshed”. Es Claude Code diciendo que su sesión guardada ya no existe: el token que guarda ya no se puede renovar, a menudo porque cerraste sesión en otro lugar o la sesión se borró del llavero. El turno dice Sesión cerrada y Claude Code could not use the sign-in for [email protected]. Sign in again to keep going., con el mensaje del propio Claude Code plegado debajo, y Ajustes dice que la sesión de esa cuenta venció. Pulsa Volver a iniciar sesión, en la tarea o en la tarjeta del agente, termina el inicio de sesión y vuelve a enviar el mensaje. Los demás agentes que rechazan su sesión se ven igual, con su propio nombre.
• El inicio de sesión dice que Deska no pudo iniciar la CLI. En Herramientas y cuentas, un inicio de sesión que falla antes de que la herramienta llegue a ejecutarse muestra el motivo con las palabras de la propia herramienta y el comando de inicio de sesión, por ejemplo claude auth login. Haz clic para copiarlo, ejecútalo en una terminal de esa computadora y vuelve: la tarjeta se actualiza sola. Antes de la próxima actualización de escritorio, las computadoras con Windows fallaban aquí con exit null.
• La CLI es demasiado antigua. Cada driver tiene una versión mínima. Con Buscar actualizaciones de CLI activado (lo está por defecto), la tarjeta del agente muestra el comando de actualización exacto según cómo se instaló ese binario, con un botón para ejecutarlo en una terminal.
• Está instalado OpenCode 2. Desde la próxima actualización de escritorio, Deska usa OpenCode 1 y OpenCode 2 (el paquete de npm @opencode/cli, que usa el mismo comando opencode) y elige el correcto según la versión instalada. Antes de esa actualización, una tarea con OpenCode 2 se detiene con is not supported in Deska yet: actualiza Deska, o vuelve a OpenCode 1 con opencode service stop, luego npm uninstall -g @opencode/cli y luego npm i -g opencode-ai@latest --allow-scripts=opencode-ai. Una cuenta separada de OpenCode sigue necesitando OpenCode 1.
• OpenCode dice No instalado justo después de instalarlo. Las versiones nuevas de npm pueden saltarse el paso de preparación del paquete de OpenCode y dejar un comando opencode que no arranca (en Windows la tarjeta decía spawn UNKNOWN). Instálalo de nuevo permitiendo ese paso: npm i -g opencode-ai@latest --allow-scripts=opencode-ai, o para OpenCode 2 npm i -g @opencode/cli@latest --allow-scripts=@opencode/cli, y pulsa Actualizar en la tarjeta del agente. Desde la próxima actualización de escritorio, la tarjeta avisa cuando pasó esto y su botón Instalarpermite ese paso.

Agentes de código cubre las instancias, los modos de ejecución y lo que espera cada driver.

Instalar también funciona en Windows. Claude Code, Codex y OpenCode se instalan con npm; cuando npm no está disponible, el botón dice Guía de instalación y abre las instrucciones del proveedor, así que instala Node.js primero y vuelve a abrir Ajustes. Antigravity y Cursor usan sus instaladores oficiales de PowerShell, que Deska ejecuta en un panel de terminal.

Sigue el instalador en esa terminal y luego pulsa Actualizar en la tarjeta del agente. Si sigue apareciendo No instalado, abre Avanzado y pon en Ruta del binario el ejecutable, por ejemplo codex.exe. Conectar cuenta abre después el inicio de sesión en una terminal de la misma forma.

Las dos cosas significan que falta una herramienta en esta computadora: Git para Control de código, la CLI de GitHub para GitHub. Ahora Deska dice cuál y la instala: abre Herramientas y cuentas y pulsa Configurar en la fila de GitHub, o Instalar Git en Control de código. Los pasos vuelven a revisar solos, sin reiniciar. Leer más.

Si falta un modelo nuevo, actualiza el agente en la computadora donde corre la tarea y elige Volver a descubrir en su tarjeta. Actualizar Deska no actualiza ese agente. Claude Code necesita la versión 2.1.280 o posterior para Opus 5.5; los modelos anteriores pueden seguir apareciendo como opciones. Que un modelo antiguo esté en la lista no significa que sea el más reciente disponible.

Deska lee la lista de modelos de cada agente desde la CLI y tu cuenta. Cuando esa lectura falla, la tarjeta del agente muestra No se pudieron descubrir los modelos con el motivo, y el menú de modelos de la tarea muestra No se pudieron cargar los modelos, conservando la última lista que tenía si existe.

• Pulsa Volver a descubrir (o Descubrir modelos) en la tarjeta, o Volver a cargar modelos en el menú.
• Si sigue fallando, comprueba que el agente está instalado y con sesión iniciada, y ejecuta Probar tareas en su tarjeta.
• Cuando la lista carga pero no incluye la familia recomendada, la tarjeta lo dice, por ejemplo, que no hay ningún modelo Sonnet disponible para esa conexión. Deska no arranca otro modelo en su lugar. Pon Elección del modelo en Modelo específico o Predeterminado del proveedor.

Una tarea o un turno de Dex que necesita un modelo que Deska no puede resolver se detiene con ese mismo mensaje en lugar de correr en silencio con otro. Consulta Modelos por defecto.

Una sesión sin turno activo y sin nada pendiente de ti se cierra tras 30 minutos de inactividad. Es deliberado: si no, las CLI ociosas retendrían procesos, puertos y memoria durante toda la vida de la app. El hilo no se pierde. Aparece como detenido, no como fallido, y el siguiente mensaje que envíes retoma la conversación donde se quedó.

Una insignia de error es otra cosa. Esas llevan un motivo (el proceso no pudo lanzarse, se rechazaron las credenciales, la CLI está por debajo de la versión mínima, se cerró el transporte, el proveedor nunca respondió, o el modelo siguió saturado) y necesitan alguna de las soluciones de esta página. Consulta Hilos de agente.

Versiones anteriores de Deska podían perder las actualizaciones de Codex al enviar varias capturas grandes, mientras Codex seguía trabajando. Actualiza Deska en la computadora que ejecuta la tarea. Cada imagen puede seguir teniendo hasta 10 MB; enviar varias juntas no reduce ese límite.

Si la conexión se cierra, la tarea muestra un error. Revisa los archivos que ya cambiaron y envía un mensaje nuevo en el mismo hilo para retomar la conversación guardada. Deska no repite automáticamente la solicitud interrumpida. Un comando rechazado por Codex o un tiempo de espera al consultar modelos es un aviso distinto; cambiar Acceso total no repara una conexión cerrada.

“Selected model is at capacity” viene de OpenAI: el modelo que elegiste no tiene capacidad para más solicitudes en este momento. No es el límite de tu plan, así que puede pasar aunque te quede casi todo tu uso. Codex abandona estas solicitudes de inmediato.

Deska mantiene la tarea en curso y vuelve a pedir con el mismo modelo: a los 15 segundos, luego a los 30 segundos, 1, 2 y 4 minutos. El hilo muestra una línea Reintentando con la espera. La conversación ya guarda tu solicitud y cada paso dado, así que el siguiente intento sigue donde se quedó el rechazado. Un mensaje enviado con Guiar ahora durante la espera sale enseguida como el siguiente intento, uno en cola espera a que termine el turno, y Detener termina la tarea como siempre.

Si el modelo sigue saturado después de cinco intentos (unos ocho minutos), el turno falla y lo dice. Envía un mensaje más tarde para continuar, o elige otro modelo en el compositor. Dex y los títulos automáticos no esperan: fallan enseguida, y Dex le pregunta al siguiente agente.

Cuando un hilo obtiene su propio worktree de git, Deska ejecuta una sola vez en el nuevo checkout el primer script marcado con runOnWorktreeCreate en el deska.json de tu proyecto, para que el agente nunca empiece en un árbol a medio instalar. Ese enganche es, por diseño, de mejor esfuerzo.

• Sin manifiesto no pasa nada. Un proyecto sin deska.json simplemente no ejecuta nada.
• Un manifiesto mal formado degrada a advertencia. Las claves desconocidas se ignoran y las entradas incorrectas se omiten, cada una con una advertencia que aparece como actividad del hilo. Un archivo escrito a mano nunca puede bloquear la creación de un hilo.
• Los scripts largos tienen un tope de 10 minutos. Las instalaciones de dependencias tardan minutos, así que el tope es generoso, pero un script colgado se termina en vez de retener para siempre el primer turno del hilo. Se guarda el final de su salida combinada para que veas el motivo.
• Un fallo es una advertencia, no un hilo bloqueado. El hilo se abre igualmente. Lee la salida registrada, arregla el script, y borra y vuelve a crear el hilo para ejecutarlo de nuevo.

Si al pulsar el atajo de voz no ocurre nada, o no vuelve nada, comprueba:

• Permiso del micrófono. Deska necesita acceso a tu micrófono. Concédeselo en los ajustes de privacidad de tu sistema operativo y vuelve a intentarlo.
• El atajo correcto. El dictado es CmdShiftV en macOS y CtrlAltV en Windows y Linux. Es global, así que funciona incluso cuando Deska está en segundo plano.
• Minutos e inicio de sesión. La voz gestionada necesita una cuenta y gasta minutos; si falta alguno de los dos, el dictado se pausa. Consulta Voz.
• El dispositivo de entrada. Una grabación que vuelve sin palabras casi siempre es el micrófono equivocado o uno silenciado. Elige el correcto en el menú de micrófono de Dex. La grabación se conserva en el historial de voz, así que puedes reintentarla ahí.

Sí, para eso sirve el acceso remoto. Con tus propias máquinas no hay nada que emparejar: activa Ajustes, Acceso remoto en el escritorio, inicia sesión en el teléfono con la misma cuenta de Deska y esta computadora aparece en su lista. Con Deska Pro puedes entonces engancharte a terminales que ya están corriendo, seguir hilos de agentes de código y responder a sus aprobaciones, previsualizar un servidor de desarrollo y hablar con Dex. En el plan gratuito la lista muestra tus computadoras y puede despertarlas, y abrir una te ofrece mejorar de plan.

Los códigos de un solo uso existen para otra cosa. Compartir esta computadora genera un código que da acceso a otra cuenta a esta máquina, y puedes revocar ese acceso más tarde desde la misma página. Si tu teléfono no lista una computadora, comprueba que el escritorio esté despierto, con sesión iniciada en la misma cuenta y con el interruptor de Acceso remoto activado.

El plan gratuito mantiene un dispositivo cliente con la sesión iniciada a la vez, así que iniciar sesión en un teléfono o navegador nuevo ofrece cerrar la sesión del anterior; aceptar es un toque y el dispositivo viejo simplemente te pide iniciar sesión de nuevo. En el plan gratuito esos dispositivos listan tus computadoras y pueden despertarlas, pero abrir una es parte de Deska Pro, e intentarlo lo explica y te ofrece mejorar de plan. El límite de computadoras es aparte: cuenta las máquinas que has vinculado, y el plan gratuito permite tres cambios de computadora por periodo. Cuando un cambio se rechaza, el mensaje muestra la fecha en la que se restablece el cupo.

Los planes de pago levantan el límite de computadoras. Consulta Planes y facturación.

Iniciar sesión abre tu navegador, y el navegador devuelve el resultado a la app de escritorio mediante un enlace deska://. Ese traspaso depende de que tu sistema operativo sepa qué app es dueña del esquema, algo que puede romperse tras mover Deska de carpeta, tener dos instalaciones a la vez o usar una compilación de desarrollo sin empaquetar. Si el navegador dice que iniciaste sesión pero la app sigue mostrando Sin sesión iniciada, cierra Deska por completo, ábrela desde su ubicación instalada y vuelve a iniciar sesión desde Ajustes, Cuenta. En Windows y Linux el enlace llega como un segundo arranque de la app, así que una Deska a la que se le impide volver a arrancar se lo tragará en silencio.

Cuando usas Deska en app.deska.dev desde un teléfono e inicias sesión con un agente o con GitHub en una de tus computadoras, la página de inicio de sesión se abre en otra pestaña. Los navegadores del teléfono pausan la pestaña de Deska mientras no estás en ella, y eso corta su conexión con la computadora. Las computadoras con versiones anteriores de Deska detenían el inicio de sesión en ese momento, así que la página podía decir que todo estaba listo sin que Deska se enterara.

Ahora la computadora mantiene el inicio de sesión diez minutos sin conexión. Vuelve a la pestaña de Deska después de aprobarlo: dice que se está reconectando y luego muestra la cuenta con la sesión iniciada. Si el navegador recargó la pestaña, el inicio de sesión se abre de nuevo donde estaba. Revisar ahora le pregunta a la computadora en ese momento. Si aún dice que el inicio de sesión se detuvo, actualiza Deska en esa computadora e inténtalo de nuevo.

Deska busca versiones nuevas por su cuenta, pero nunca descarga ninguna a tus espaldas, con una excepción que se explica en Actualizaciones. El flujo es:

1. Una comprobación en segundo plano encuentra una versión y aparece una tarjeta.
2. Haces clic en Descargar. La descarga corre con un indicador de progreso visible.
3. Haces clic en Reiniciar ahora para instalarla de inmediato. Si prefieres no interrumpir tu trabajo, no hagas nada: una descarga terminada se instala la próxima vez que cierres Deska.

Los mismos estados viven en Ajustes, Actualizaciones, donde el botón dice Buscar actualizaciones, Descargar v…, una etiqueta de progreso, y finalmente Reiniciar para actualizar y Reiniciando…. Esa página también contiene las notas de la versión y el selector de Canal de versiones. Puedes forzar una comprobación cuando quieras desde Ayuda, Buscar actualizaciones….

Los canales, las notas de versión y lo demás se explican en Actualizaciones.

• La descarga se atasca o se reinicia. Suspender la máquina o perder la red puede matar una descarga en silencio, así que Deska vigila el progreso y reinicia la descarga por su cuenta, hasta unos cuantos intentos. Si se rinde, la tarjeta se convierte en un enlace de descarga manual.
• El reinicio no hace nada. Reiniciar ahora pasa a Reiniciando… en cuanto lo pulsas. Si Deska sigue abierto unos 20 segundos después, la tarjeta dice Deska no se cerró para reiniciar y ofrece Reintentar; cerrar Deska y volver a abrirlo también termina la actualización. Si Deska vuelve en la versión anterior, retoma la actualización sin descargarla. Consulta Si un reinicio no termina.
• Se ofrece la actualización pero falta el archivo. Las versiones se publican por sistema operativo de forma independiente, así que una versión puede estar descargable en macOS mientras la compilación de Windows aún se sube. Deska te dice que la compilación para tu plataforma está en camino en lugar de ofrecerte un enlace que fallaría. Vuelve a comprobarlo en un rato.
• macOS se niega a abrir una compilación descargada a mano. Si macOS dice que la app está dañada o que viene de un desarrollador no identificado, la descarga arrastra una marca de cuarentena. Bórrala con xattr -cr /Applications/Deska.app y vuelve a abrir la app.
• Windows avisa al abrir Deska. SmartScreen puede no reconocer todavía una versión nueva. Descomprime el ZIP de la página de descarga y sigue la guía de Windows si aparece Windows protegió su PC.

Si Deska abre en una pantalla que dice que no pudo abrir la ventana, la aplicación guardó algo en tu computadora que esta versión no puede leer. Suele pasar justo después de una actualización. No se pierde nada tuyo, y esa pantalla es el camino de vuelta.

Presiona Recargar primero. La mayoría se resuelven solas, y Deska lo intenta por ti: una ventana que falla dos veces seguidas limpia en el siguiente arranque los datos que puede reconstruir por su cuenta, que por ahora son la lista de paneles de la comunidad que guarda para dibujar tus paneles al instante. Nunca limpia tus borradores, tu acomodo, tus atajos ni tus respuestas de permisos sin que se lo pidas.

Si vuelve a pasar, presiona Reparar y reabrir. Eso aparta todo lo que esta ventana guardó en tu computadora, incluidos tus borradores y tus atajos, y conserva una copia de cada cosa en una carpeta que puedes abrir desde la misma pantalla. Tus proyectos, tus archivos y tu cuenta no se tocan: no viven ahí.

Copiar los detalles deja la versión y el error en tu portapapeles. Pégalo en el Discord de Deska y te decimos qué pasó.

• Atajos: restablece combinaciones sueltas o todas ellas en Ajustes, Atajos de teclado.
• Todos los ajustes: Ajustes, General, Restablecer contiene Restablecer todos los ajustes, que devuelve cada preferencia a su valor por defecto. No toca tus archivos de proyecto.
• ¿Te perdiste el recorrido de bienvenida? Se muestra en el primer arranque, y la app instalada no tiene un botón para repetirlo en Ajustes. Los consejos de una sola vez que se abren la primera vez que usas un panel siguen a Consejos en superficies nuevas, en Ajustes, General, Recorrido.

Reporta bugs, comparte ideas o pide ayuda en el Discord de Deska. También puedes escribir a [email protected] y te ayudaremos. Envía primero un reporte desde la app e incluye su código, o pega la salida de Copiar diagnóstico, y normalmente podremos responder a la primera.