Solución de problemas
La mayoría de los problemas tienen una solución rápida. Si el tuyo no aparece aquí, escribe a soporte indicando tu sistema operativo, la versión de PATerminal (Ajustes → Actualizaciones) y lo que has probado.
Escrito para PATerminal v1.8.3
Instalar y abrir
- Windows: «Windows protegió su PC»
- Haz clic en Más información y luego en Ejecutar de todas formas. SmartScreen avisa de las apps nuevas; si quieres asegurarte, compara el SHA-256 con el de la guía de instalación para Windows.
- macOS pregunta antes de abrir
- Elige Abrir. La app está firmada con un Developer ID y notarizada por Apple.
Git muestra un error
Cuando algo de tu equipo impide que git funcione, PATerminal muestra Git no puede ejecutarse en este equipo con la solución. Los casos habituales:
| Causa | Solución |
|---|---|
| macOS: licencia de Xcode sin aceptar (a menudo justo después de actualizar Xcode) | sudo xcodebuild -license accept |
| macOS: Command Line Tools ausentes o dañadas | xcode-select --install |
| Git no está instalado | Instálalo (Windows: winget install Git.Git); PATerminal lo detecta automáticamente. |
| «Dubious ownership» en otra unidad o en una carpeta compartida de red | git config --global --add safe.directory <path>, solo para carpetas de confianza. |
| Windows: ruta demasiado larga | git config --global core.longpaths true |
Los pull requests o las issues no cargan
Asegúrate de que gh está instalado y con la sesión iniciada (gh auth status), y de que el repositorio tiene un remoto de GitHub. Pulsa Reintentar cuando lo hayas corregido.
Una sesión se queda en «En ejecución»
- Algo sigue escribiendo salida en ella: un servidor de desarrollo, un watcher o un indicador animado. Es salida real, así que el estado es correcto.
- Codex 0.154.0 o posterior se inició antes de que PATerminal guardara
tui.whimsy = false: reinicia esa sesión de Codex. Un ajuste explícito a nivel de proyecto o en la línea de comandos puede anularlo. Consulta Nota para usuarios de Codex.
No llegan notificaciones
- Comprueba que Ajustes → Notificaciones esté activado.
- Permite las notificaciones de PATerminal en los ajustes de tu sistema y revisa Concentración / No molestar.
- Las notificaciones solo se envían para las sesiones que no estás mirando.
Una conversación no se reanuda
- Puede que el agente se cerrara antes de guardar la conversación. Ábrela desde el Historial.
- Mover Claude Code a una carpeta distinta requiere Claude Code v2.1.223 o posterior.
- Las opciones que pasaste solo en la línea de comandos original no se vuelven a aplicar.
Una actualización falla
Si la actualización firmada no se puede instalar, PATerminal no se reinicia y no cambia nada. Vuelve a intentarlo más tarde, o descarga el instalador más reciente desde la página de descarga e instálalo sobre la versión actual: tus sesiones y ajustes se conservan.
¿Dónde están mis datos?
Las sesiones, los grupos, las notas, las frases y los ajustes se guardan como archivos locales en tu equipo; las conversaciones de los agentes se quedan en las carpetas de cada agente (por ejemplo ~/.claude y ~/.codex). Nada se sincroniza con un servidor y PATerminal no tiene telemetría.
¿Sigues atascado?
Consulta las preguntas frecuentes o escríbenos indicando tu sistema operativo, la versión de PATerminal y lo que has probado. Respondemos a todos los mensajes.