46 46
47Antes de enviar su primer mensaje, configure cuatro cosas en el área de solicitud:47Antes de enviar su primer mensaje, configure cuatro cosas en el área de solicitud:
48 48
49* **Entorno**: elija dónde se ejecuta Claude. Seleccione **Local** para su máquina, **Cloud** para una [sesión en la nube](#cloud-sessions) que continúa después de cerrar la aplicación, una [**conexión SSH**](#ssh-sessions) para una máquina remota que usted administra, o en Windows una [**distribución WSL**](/docs/es/desktop-wsl). Consulte [configuración del entorno](#environment-configuration).49* **Entorno**: elige dónde se ejecuta Claude. Selecciona **Local** para tu máquina, **Cloud** para una [sesión en la nube](#cloud-sessions) que continúa después de cerrar la aplicación, una [**conexión SSH**](#ssh-sessions) para una máquina remota que tú administras, o en Windows una [**distribución WSL**](/docs/es/desktop-wsl). Una tarea en una sesión SSH puede [seguir ejecutándose mientras Desktop está desconectado](#keep-a-task-running-while-desktop-is-disconnected), pero con una cuenta de Claude puede detenerse cuando su inicio de sesión expire. Consulta [configuración del entorno](#environment-configuration).
50* **Carpeta del proyecto**: seleccione la carpeta o repositorio en el que Claude trabaja. Para sesiones en la nube, puede agregar [múltiples repositorios](#run-long-running-tasks-in-the-cloud).50* **Carpeta del proyecto**: seleccione la carpeta o repositorio en el que Claude trabaja. Para sesiones en la nube, puede agregar [múltiples repositorios](#run-long-running-tasks-in-the-cloud).
51* **Modelo**: elija un [modelo](/docs/es/model-config#available-models) del menú desplegable junto al botón de envío. Puede cambiar esto durante la sesión.51* **Modelo**: elija un [modelo](/docs/es/model-config#available-models) del menú desplegable junto al botón de envío. Puede cambiar esto durante la sesión.
52* **Modo de permisos**: elija cuánta autonomía tiene Claude desde el [selector de modo](#choose-a-permission-mode). Puede cambiar esto durante la sesión.52* **Modo de permisos**: elija cuánta autonomía tiene Claude desde el [selector de modo](#choose-a-permission-mode). Puede cambiar esto durante la sesión.
236 Ejecutar comandos en la terminal236 Ejecutar comandos en la terminal
237</h3>237</h3>
238 238
239La terminal integrada te permite ejecutar comandos junto a tu sesión sin cambiar a otra aplicación. Haz clic en **Terminal** en la barra de título de la sesión o presiona **Ctrl+\`** en macOS o Windows. La terminal se abre en el directorio de trabajo de tu sesión y comparte el mismo entorno que Claude, por lo que comandos como `npm test` o `git status` ven los mismos archivos que Claude está editando. Para abrir una segunda pestaña de terminal, haz clic en **+** en el encabezado del panel de terminal o haz clic con el botón derecho en una carpeta en el chat para elegir **Open in terminal**. La terminal está disponible en sesiones locales y [SSH](#ssh-sessions).239La terminal integrada te permite ejecutar comandos junto a tu sesión sin cambiar a otra aplicación. Haz clic en **Terminal** en la barra de título de la sesión o presiona **Ctrl+\`** en macOS o Windows. La terminal se abre en el directorio de trabajo de tu sesión y comparte el mismo entorno que Claude, por lo que comandos como `npm test` o `git status` ven los mismos archivos que Claude está editando. Para abrir una segunda pestaña de terminal, haz clic en **+** en el encabezado del panel de terminal o haz clic con el botón derecho en una carpeta en el chat para elegir **Open in terminal**.
240
241La terminal está disponible en sesiones locales y [SSH](#ssh-sessions), con una limitación en [máquinas remotas Windows](#windows-remote-machines).
240 242
241<h3 id="open-and-edit-files">243<h3 id="open-and-edit-files">
242 Abrir y editar archivos244 Abrir y editar archivos
468 470
469Consulta [Usar Claude Code en la nube](/docs/es/claude-code-on-the-web) para obtener más información sobre cómo funcionan las sesiones en la nube. Cuando un conjunto de trabajo necesita muchas sesiones en la nube, selecciona **Projects** en la barra lateral para crear un [proyecto](/docs/es/claude-projects), donde Claude inicia y da seguimiento a las sesiones por ti desde una sola conversación.471Consulta [Usar Claude Code en la nube](/docs/es/claude-code-on-the-web) para obtener más información sobre cómo funcionan las sesiones en la nube. Cuando un conjunto de trabajo necesita muchas sesiones en la nube, selecciona **Projects** en la barra lateral para crear un [proyecto](/docs/es/claude-projects), donde Claude inicia y da seguimiento a las sesiones por ti desde una sola conversación.
470 472
473<Note>
474 Una tarea en una [sesión SSH](#ssh-sessions) también puede [seguir ejecutándose mientras Desktop está desconectado](#keep-a-task-running-while-desktop-is-disconnected), pero con una cuenta de Claude puede detenerse cuando expira su inicio de sesión.
475</Note>
476
471<h3 id="continue-in-another-surface">477<h3 id="continue-in-another-surface">
472 Continuar en otra superficie478 Continuar en otra superficie
473</h3>479</h3>
772 778
773* **Local**: se ejecuta en su máquina con acceso directo a sus archivos779* **Local**: se ejecuta en su máquina con acceso directo a sus archivos
774* **Cloud**: se ejecuta en la infraestructura administrada por Anthropic de forma predeterminada. Las sesiones continúan incluso si cierra la aplicación.780* **Cloud**: se ejecuta en la infraestructura administrada por Anthropic de forma predeterminada. Las sesiones continúan incluso si cierra la aplicación.
775* **SSH**: se ejecuta en una máquina remota a la que se conecta a través de SSH, como sus propios servidores, máquinas virtuales en la nube o contenedores de desarrollo781* **SSH**: se ejecuta en una máquina remota a la que te conectas a través de SSH, como tus propios servidores, máquinas virtuales en la nube o contenedores de desarrollo. Una tarea en ejecución puede [seguir mientras Desktop está desconectado](#keep-a-task-running-while-desktop-is-disconnected), pero con una cuenta de Claude puede detenerse cuando su inicio de sesión expira.
776* **WSL** (Windows): se ejecuta dentro de una [distribución WSL 2](/docs/es/desktop-wsl) en su máquina, utilizando su cadena de herramientas Linux y rutas nativas782* **WSL** (Windows): se ejecuta dentro de una [distribución WSL 2](/docs/es/desktop-wsl) en su máquina, utilizando su cadena de herramientas Linux y rutas nativas
777 783
778<h3 id="local-sessions">784<h3 id="local-sessions">
812 818
813Las sesiones SSH le permiten ejecutar Claude Code en una máquina remota mientras usa la aplicación de escritorio como su interfaz. Esto es útil para trabajar con bases de código que viven en máquinas virtuales en la nube, contenedores de desarrollo o servidores con hardware o dependencias específicas.819Las sesiones SSH le permiten ejecutar Claude Code en una máquina remota mientras usa la aplicación de escritorio como su interfaz. Esto es útil para trabajar con bases de código que viven en máquinas virtuales en la nube, contenedores de desarrollo o servidores con hardware o dependencias específicas.
814 820
821<Note>
822 Si usas Desktop con un [proveedor externo](/docs/es/third-party-integrations), las sesiones SSH necesitan su propia configuración. Consulta [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
823</Note>
824
815Para agregar una conexión SSH, abre el menú desplegable de entorno en el cuadro de prompt antes de iniciar una sesión, luego selecciona **SSH > Add SSH connection…** y completa los detalles de la conexión:825Para agregar una conexión SSH, abre el menú desplegable de entorno en el cuadro de prompt antes de iniciar una sesión, luego selecciona **SSH > Add SSH connection…** y completa los detalles de la conexión:
816 826
817* **Name**: una etiqueta amigable para esta conexión827* **Name**: una etiqueta amigable para esta conexión
822 832
823Una vez agregada, la conexión aparece en **SSH** en el menú desplegable de entorno. Selecciónala para iniciar una sesión en esa máquina. Claude se ejecuta en la máquina remota con acceso a sus archivos y herramientas.833Una vez agregada, la conexión aparece en **SSH** en el menú desplegable de entorno. Selecciónala para iniciar una sesión en esa máquina. Claude se ejecuta en la máquina remota con acceso a sus archivos y herramientas.
824 834
825La máquina remota debe ejecutar Linux o macOS. La aplicación de escritorio instala Claude Code en la máquina remota automáticamente la primera vez que se conecta. Una vez conectado, las sesiones SSH admiten modos de permisos, conectores, plugins y servidores MCP.835La máquina remota puede ejecutar Linux, macOS o [Windows](#windows-remote-machines). Desktop instala Claude Code en la máquina remota automáticamente la primera vez que te conectas. Una vez conectado, las sesiones SSH admiten modos de permisos, conectores, plugins y servidores MCP.
836
837<h4 id="remote-machine-requirements-for-ssh-sessions">
838 Requisitos de la máquina remota para las sesiones SSH
839</h4>
840
841Una máquina remota Linux o macOS necesita un procesador compatible, un servidor SSH con SFTP, una carpeta de instalación que no esté montada con `noexec`, un shell funcional y acceso a la red. Revisa cada requisito antes de conectarte, o cuando una conexión falle después de iniciar sesión:
842
843* **Sistema**: un procesador x86\_64 o arm64. La máquina también tiene que cumplir los [requisitos del sistema](/docs/es/setup#system-requirements) de Claude Code.
844* **SFTP**: el servidor SSH tiene que ofrecer el subsistema SFTP, que se activa con una línea `Subsystem sftp` en su `sshd_config`. Para comprobarlo, conéctate al mismo host y puerto con `sftp` en una terminal de tu computadora. Un servidor que funciona muestra el prompt `sftp>`.
845* **Sesiones por conexión**: Desktop en macOS y Linux abre varias sesiones en una sola conexión SSH. Si el `sshd_config` del servidor establece `MaxSessions 1`, auméntalo, por ejemplo al valor predeterminado de OpenSSH, 10.
846* **Carpeta de instalación**: Desktop instala un programa auxiliar y Claude Code en `~/.claude/remote/` dentro de tu directorio home. Los ejecuta desde allí, por lo que esa carpeta no puede estar en un sistema de archivos montado con `noexec`. Reserva aproximadamente 1 GB de espacio en disco en el directorio home de cada usuario que se conecte.
847* **Shell**: el shell establecido para tu cuenta en la máquina remota tiene que ejecutar los comandos enviados a través de SSH, como lo hacen Bash, Zsh y `sh`
848* **Red**: Claude Code se ejecuta en la máquina remota y realiza sus solicitudes de red desde allí, por lo que la máquina necesita el [acceso a la red que requiere Claude Code](/docs/es/network-config#network-access-requirements). Si la máquina no puede descargar Claude Code, Desktop lo descarga en tu computadora y lo sube. Las demás solicitudes de Claude Code siguen saliendo desde la máquina remota.
849
850<h4 id="use-your-ssh-configuration-on-macos-and-linux">
851 Usar tu configuración SSH en macOS y Linux
852</h4>
853
854En macOS y Linux, Desktop se conecta ejecutando el cliente OpenSSH en tu computadora, por lo que usa tu `~/.ssh/config`. Conectarse a través del cliente OpenSSH requiere Claude Desktop v1.37937.0 o posterior. Ingresa un nombre de `Host` de ese archivo en el campo **SSH host** para usar la configuración de su entrada, como `HostName`, `User`, `IdentityFile`, `CertificateFile`, `ProxyJump` y `ProxyCommand`.
855
856Antes de agregar la conexión, revisa el cliente y la entrada en una terminal de tu computadora:
857
858* **Versión del cliente**: ejecuta `ssh -V`. El cliente tiene que ser OpenSSH 7.6 o posterior.
859* **Entrada**: ejecuta `ssh` con el nombre de `Host`, como `ssh devbox`. Si falla, corrige primero la entrada.
860
861Puedes dejar vacíos los campos **SSH port** y **SSH key (optional)**. Si completas uno, Desktop lo usa junto con la entrada:
862
863* **SSH port**: un valor aquí sobrescribe el `Port` de la entrada
864* **SSH key (optional)**: Desktop ofrece el archivo de clave que elijas además del `IdentityFile` de la entrada y las claves de tu agente SSH
865
866<h5 id="reach-a-machine-behind-a-jump-host">
867 Llegar a una máquina detrás de un host de salto
868</h5>
869
870Para llegar a una máquina detrás de un host de salto, también llamado bastión, establece `ProxyJump` o `ProxyCommand` en la entrada. La siguiente entrada llega a `devbox.internal.example.com` a través de `bastion.example.com`:
871
872```text ~/.ssh/config theme={null}
873Host devbox
874 HostName devbox.internal.example.com
875 User alice
876 ProxyJump bastion.example.com
877```
878
879Ingresa `devbox` en el campo **SSH host**.
880
881<h5 id="raise-the-ssh-connection-timeout">
882 Aumentar el tiempo de espera de la conexión SSH
883</h5>
884
885Si tu configuración SSH no establece ningún `ConnectTimeout` para el host, Desktop le da a `ssh` 30 segundos para conectarse. A través de un host de salto o un `ProxyCommand`, ese tiempo incluye el tiempo que tarda la ruta en conectarse. Si tu ruta necesita más tiempo, agrega un valor más alto a la entrada:
886
887```text ~/.ssh/config theme={null}
888Host devbox
889 HostName devbox.internal.example.com
890 User alice
891 ProxyJump bastion.example.com
892 ConnectTimeout 120
893```
894
895`ssh` usa el primer valor que encuentra para un host, así que mantén la entrada por encima de cualquier entrada `Host *` que establezca `ConnectTimeout`. Para confirmarlo, ejecuta `ssh -G devbox` en una terminal de tu computadora. Su salida incluye `connecttimeout 120`. Después de cambiar el valor, cierra y vuelve a abrir Desktop.
896
897<h4 id="windows-remote-machines">
898 Máquinas remotas Windows
899</h4>
900
901Una máquina remota Windows requiere Claude Desktop v2.31226.0 o posterior.
902
903Usa OpenSSH Server de Microsoft. La máquina puede ser x64 o ARM64. El shell que inicia el servidor SSH puede ser `cmd.exe`, Windows PowerShell 5.1 o Git Bash.
904
905Las máquinas remotas Windows se prueban menos que las Linux. Prueba tu propio trabajo allí antes de depender de ellas.
906
907Espera estos límites, entre otros, en una máquina remota Windows:
908
909* **Terminal**: la [terminal](#run-commands-in-the-terminal) no se abre en una sesión cuya carpeta es una ruta de Windows, como `C:/projects/app`
910* **Sandbox**: Claude Code se ejecuta allí en Windows nativo, donde ejecuta los comandos fuera del sandbox. Consulta [dónde se ejecuta el sandbox](/docs/es/sandboxing).
911* **Plugins**: Desktop no copia un plugin que contenga un nombre de archivo o carpeta que Windows no pueda almacenar, como un nombre con `:`. La sesión muestra los plugins que Desktop dejó fuera.
912* **Servidores MCP**: en algunas máquinas remotas Windows, las llamadas de Claude a los servidores MCP de `claude_desktop_config.json` pasan por Desktop, por lo que Claude no puede llamar a sus herramientas [mientras Desktop está desconectado](#limits-while-desktop-is-disconnected). Antes de Claude Desktop v2.37337.0, esto ocurre en todas las máquinas remotas Windows.
913* **Worktrees**: los worktrees van en `<project-root>/.claude/worktrees/`. Si [eliges otra carpeta](#choose-where-ssh-session-worktrees-go), Desktop la ignora.
914* **Mensajes anteriores**: si el shell del servidor SSH es `cmd.exe` o Windows PowerShell, es posible que tengas que conectarte antes de ver los mensajes anteriores de una sesión
915* **Bifurcaciones**: si el shell del servidor SSH es `cmd.exe` o Windows PowerShell, solo puedes bifurcar una sesión en su primer mensaje
916* **Ejecución mientras está desconectado**: una tarea [sigue ejecutándose mientras Desktop está desconectado](#keep-a-task-running-while-desktop-is-disconnected) solo si el servidor SSH permite que un programa sobreviva a la conexión que lo inició. Para averiguarlo, [prueba la máquina remota](#prepare-a-long-task).
917* **Procesos sobrantes**: después de que termine una sesión, revisa la máquina en busca de programas que Claude Code haya iniciado, porque pueden seguir ejecutándose. El [programa auxiliar en segundo plano](#keep-a-task-running-while-desktop-is-disconnected) que instala Desktop no se detiene por sí solo allí.
918
919<h4 id="keep-a-task-running-while-desktop-is-disconnected">
920 Mantener una tarea en ejecución mientras Desktop está desconectado
921</h4>
922
923Si tu computadora entra en suspensión, pierdes la red o cierras Desktop, la tarea continúa hasta que termina, te necesita o alcanza uno de los [límites](#limits-while-desktop-is-disconnected). Cerrar la tapa cuenta como suspensión. Un reinicio de Desktop o de tu computadora, incluso por una actualización, cuenta como cerrar Desktop.
924
925Claude Code se ejecuta como un proceso en la máquina remota, bajo un programa auxiliar en segundo plano que Desktop instala allí, por lo que no necesita tu conexión SSH para seguir ejecutándose. El comportamiento de esta sección requiere Claude Desktop v2.31226.0 o posterior.
926
927<Warning>
928 Si inicias sesión en Desktop con una cuenta de Claude, no cuentes con que una tarea se ejecute durante toda la noche. Desktop renueva ese inicio de sesión para la tarea solo mientras Desktop está en ejecución y conectado, por lo que el inicio de sesión de la tarea puede expirar después de que te desconectes, y entonces la tarea se detiene. El tiempo que queda cuando te desconectas varía.
929
930 El trabajo hecho hasta ese momento permanece en la máquina remota, y puedes continuar con un mensaje cuando vuelvas.
931
932 Si la tarea debe ejecutarse durante toda la noche:
933
934 * [Mantén tu computadora despierta](/docs/es/desktop-scheduled-tasks#how-scheduled-tasks-run) y en línea, con la tapa abierta y Desktop en ejecución
935 * Usa un inicio de sesión que funcione sin pedirte nada, como una clave que tenga tu agente SSH, para la máquina remota y para cualquier host de salto en el camino. Así Desktop puede volver a conectarse por sí solo después de una caída.
936
937 Para una tarea que deba ejecutarse mientras tu computadora está en suspensión o apagada, inicia una [sesión en la nube](#run-long-running-tasks-in-the-cloud) en su lugar.
938</Warning>
939
940* **Después de una suspensión o una pérdida de red**: recuperas la tarea en ejecución si el proceso [sigue ejecutándose](#limits-while-desktop-is-disconnected) y Desktop puede iniciar sesión sin pedirte nada. Si no puede, [envía un mensaje](#reconnect-after-sleep-or-a-network-loss).
941* **Después de cerrar Desktop, con Desktop en macOS o Linux y una cuenta de Claude**: recuperas la tarea en ejecución si Desktop puede [volver a unirse al proceso](#reopen-a-session-after-you-quit-desktop). Si no puede, la tarea se detiene. Si sigue detenida, envía un mensaje.
942* **Después de cerrar Desktop, con Desktop en Windows o un [proveedor externo](/docs/es/third-party-integrations)**: pierdes la tarea en ejecución, porque Desktop termina el proceso cuando se abre la sesión. Envía un mensaje para continuar.
943
944Cuando vuelvas y la tarea no haya terminado, busca un aviso de que Desktop no puede volver a conectarse, un error de autenticación o una solicitud en espera:
945
946* **Desktop no puede volver a conectarse**: la sesión indica por qué, y es posible que una notificación también lo indique. Es posible que Desktop [necesite que inicies sesión](#reconnect-after-sleep-or-a-network-loss).
947* **Error de autenticación**: es posible que el [token de inicio de sesión o la credencial](#limits-while-desktop-is-disconnected) haya expirado. Con una cuenta de Claude, envía un mensaje para continuar. Con un proveedor externo, consulta [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
948* **Solicitud en espera**: [respóndela](#handle-requests-that-arrive-while-you-are-away)
949* **Ninguno de estos**: envía un mensaje para continuar
950
951<a id="prepare-a-long-task" />
952
953<h5 id="prepare-a-long-task">
954 Preparar una tarea larga
955</h5>
956
957* **Actualiza primero**: actualiza Desktop antes de iniciar una tarea larga. En macOS y Windows, Desktop puede reiniciarse por sí solo para instalar una actualización que haya descargado. Ese reinicio espera mientras Claude trabaja en una tarea SSH. En macOS con una cuenta de Claude, de forma predeterminada el reinicio puede realizarse de todos modos una vez que la actualización haya esperado 72 horas.
958* **No cierres Desktop**: si Desktop se ejecuta en Windows o usa un proveedor externo, déjalo abierto mientras se ejecuta la tarea larga. Después de cerrarlo, [termina la tarea en ejecución](#reopen-a-session-after-you-quit-desktop) cuando se abre la sesión. Dejarlo abierto no protege una solicitud que [te está esperando](#handle-requests-that-arrive-while-you-are-away).
959* **Reduce las solicitudes**: elige un modo de permisos, reglas o hooks que [hagan que la tarea te espere con menos frecuencia](#handle-requests-that-arrive-while-you-are-away)
960* **Revisa el host de salto**: si tu host de salto pide un inicio de sesión, por ejemplo una notificación push a un teléfono, cambia a un inicio de sesión que funcione sin pedirte nada. De lo contrario, Desktop puede enviar otra notificación push cada vez que intenta volver a conectarse.
961* **Prueba la máquina remota**: inicia una tarea corta, cierra Desktop mientras la tarea sigue en ejecución y vuelve a abrir la sesión bastante después de cuando la tarea debería haber terminado. Si la tarea no terminó y la sesión no muestra ningún error de autenticación, revisa la máquina remota en busca de [lo que puede terminar una tarea](#limits-while-desktop-is-disconnected).
962* **Mantén los comandos fuera de la terminal de Desktop**: si la máquina remota [cierra la sesión de las terminales inactivas](#limits-while-desktop-is-disconnected), ejecuta tus propios comandos desde un inicio de sesión SSH fuera de Desktop
963
964<a id="limits-while-desktop-is-disconnected" />
965
966<h5 id="limits-while-desktop-is-disconnected">
967 Límites mientras Desktop está desconectado
968</h5>
969
970Una tarea que dejas en ejecución puede terminar cuando su inicio de sesión expira, cuando la máquina remota la termina, o cuando el programa auxiliar se detiene o se reemplaza:
971
972* **Token de inicio de sesión o credencial**: con una cuenta de Claude, la tarea se detiene con un error de autenticación cuando el token expira. Con un proveedor externo, lo mismo ocurre con una credencial que expira, como una de inicio de sesión único o de un asistente de credenciales. Consulta [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions). Con una cuenta de Claude, [mantén Desktop en ejecución y conectado](#keep-a-task-running-while-desktop-is-disconnected) para que pueda renovar el inicio de sesión.
973* **La máquina remota**: si la máquina remota se reinicia, o termina tus procesos cuando se cierra tu conexión SSH, la tarea en ejecución termina. Nada la vuelve a iniciar mientras Desktop está desconectado. Las máquinas Linux donde `KillUserProcesses` de systemd-logind es `yes` y se aplica a tu usuario terminan tus procesos de esta manera. Para mantener una tarea en ejecución allí, pide al administrador que excluya a tu usuario, por ejemplo con `KillExcludeUsers`.
974* **Terminales inactivas**: algunas máquinas remotas Linux cierran la sesión de una terminal en la que nadie escribe durante un tiempo determinado (`StopIdleSessionSec` de systemd-logind). Con Desktop en macOS o Linux, la [terminal](#run-commands-in-the-terminal) de una sesión y los comandos `!` comparten la conexión SSH de Desktop de forma predeterminada. Ese cierre de sesión termina entonces la conexión mientras Desktop está conectado, y la tarea en ejecución puede terminar con ella. Cerrar el panel de la terminal no lo evita, así que [mantén los comandos fuera de esa terminal](#prepare-a-long-task).
975* **Actualizaciones de Desktop**: si una actualización trae un nuevo programa auxiliar, Desktop reemplaza el programa auxiliar en la máquina remota en una conexión posterior, lo que puede terminar una tarea que sigue en ejecución
976* **Ausencias largas**: en una máquina remota Linux o macOS, si Desktop no se conecta durante 30 días, el programa auxiliar se detiene y termina todos los procesos de Claude Code que se ejecutan bajo él. Conéctate antes de ese plazo.
977
978Las ediciones de archivos y algunas herramientas pueden fallar mientras Desktop está desconectado. Si la tarea las necesita, mantén Desktop conectado:
979
980* **Worktrees**: en una sesión que usa un [worktree](#work-in-parallel-with-sessions), Desktop revisa cada edición de archivo antes de que Claude la haga. Mientras Desktop está desconectado, cada edición espera unos 30 segundos y luego falla. Los comandos de shell siguen ejecutándose. En una máquina remota Linux o macOS, [las ediciones pueden seguir funcionando](#worktree-edits-while-disconnected). Si no estás seguro, inicia la sesión sin un worktree.
981* **Restricciones de carpetas**: si tu organización restringe qué carpetas pueden usar las sesiones, Desktop revisa cada lectura, búsqueda y edición de archivos, con o sin worktree. Mientras Desktop está desconectado, cada una espera hasta 10 minutos y luego falla.
982* **Conectores**: los [conectores](#connect-external-tools) y otras herramientas que proporciona Desktop se ejecutan a través de Desktop, por lo que mientras está desconectado cada llamada falla después de unos 30 segundos
983* **Flujos de trabajo**: Desktop revisa cada nuevo [flujo de trabajo](/docs/es/workflows) antes de que comience, por lo que mientras Desktop está desconectado uno nuevo espera hasta 10 minutos y luego falla
984* **Servidores MCP**: los servidores MCP que Claude Code inicia en la máquina remota no se ejecutan a través de Desktop, por lo que Claude aún puede llamar a sus herramientas. Los servidores de `claude_desktop_config.json` están entre ellos solo si Desktop no usa su [cliente SSH integrado](#worktree-edits-while-disconnected). De lo contrario, y en [algunas máquinas remotas Windows](#windows-remote-machines), Claude no puede llamar a sus herramientas mientras Desktop está desconectado.
985
986<span id="worktree-edits-while-disconnected" />
987
988<Accordion title="Cuándo siguen funcionando las ediciones en un worktree">
989 En una máquina remota Linux o macOS, la revisión no pasa por Desktop, por lo que las ediciones dentro del worktree siguen funcionando mientras Desktop está desconectado. Antes de Claude Desktop v2.37337.0, esto ocurre solo en una máquina remota Linux.
990
991 Las ediciones siguen fallando en algunos casos, entre ellos estos:
992
993 * **Cliente SSH integrado**: Desktop lo usa, por ejemplo en una instalación de Microsoft Store, en una computadora Windows sin OpenSSH 9.4 o posterior de Microsoft, o de forma predeterminada en Windows con un proveedor externo
994 * **Ubicación del repositorio**: el repositorio es tu directorio home, una carpeta por encima de él o `~/.claude`
995 * **Rutas de macOS**: en una máquina remota macOS, el repositorio está bajo `/Volumes`, o un nombre de carpeta en la ruta del repositorio o del worktree tiene un `~` o un carácter no ASCII
996 * **Restricciones de carpetas**: tu organización restringe qué carpetas pueden usar las sesiones
997 * **Lanzador corporativo**: antes de Claude Desktop v2.37337.0, inicias sesión con una cuenta de Claude, y tu organización inicia Claude Code en la máquina remota a través de un [lanzador corporativo](/docs/es/corporate-launcher)
998
999 Una sesión sin worktree no tiene esa revisión, a menos que tu organización restrinja qué carpetas pueden usar las sesiones.
1000</Accordion>
1001
1002<a id="handle-requests-that-arrive-while-you-are-away" />
1003
1004<h5 id="handle-requests-that-arrive-while-you-are-away">
1005 Gestionar las solicitudes que llegan mientras no estás
1006</h5>
1007
1008Si Claude necesita tu aprobación o te hace una pregunta mientras Desktop está desconectado, Claude espera en la máquina remota. La espera no tiene un límite de tiempo propio. Cuando Desktop vuelve a unirse al proceso, te muestra la solicitud. Si Desktop inicia un proceso nuevo en su lugar, pierdes la solicitud.
1009
1010Mientras una tarea te espera, Desktop puede reiniciarse por sí solo, por ejemplo para instalar una actualización. Si Desktop se ejecuta en Windows o usa un proveedor externo, pierdes la solicitud después de ese reinicio.
1011
1012Si pierdes una solicitud, envía un mensaje para continuar.
1013
1014Para reducir la frecuencia con la que una tarea se detiene a esperarte, y para recibir noticias de ella mientras no estás, configura cualquiera de estas opciones antes de irte:
1015
1016* **Modo automático**: elige el [modo automático](#choose-a-permission-mode) si [está disponible para ti](#auto-mode-availability). Después de bloqueos repetidos, [se te vuelve a preguntar](/docs/es/permission-modes#when-auto-mode-falls-back).
1017* **Reglas de permiso**: en tu archivo de configuración de usuario en la máquina remota, `~/.claude/settings.json`, agrega [reglas allow](/docs/es/permissions#manage-permissions) para los comandos que necesita la tarea. Si tu organización [acepta reglas de permisos solo desde la configuración administrada](/docs/es/settings-reference#allowmanagedpermissionrulesonly), pide a tu administrador que las agregue a la [configuración administrada](#managed-settings) que llega a la máquina remota. Para las reglas allow en el `.claude/settings.json` de un proyecto, consulta [Project allow rules and workspace trust](/docs/es/permissions#project-allow-rules-and-workspace-trust).
1018* **Un hook que responde**: configura un [hook `PermissionRequest`](/docs/es/hooks#permissionrequest) en `~/.claude/settings.json` en la máquina remota para permitir o denegar solicitudes en tu lugar
1019* **Un hook que te avisa**: configura un [hook `Notification`](/docs/es/hooks#notification) con el matcher `permission_prompt` en el mismo archivo para enviarte un mensaje cuando haya una solicitud en espera
1020* **Un hook que te avisa cuando Claude termina**: configura un [hook `Stop`](/docs/es/hooks#stop) en el mismo archivo para enviarte un mensaje cuando Claude haya terminado de responder. No se ejecuta cuando un error de la API termina el turno. Para ese caso, configura un [hook `StopFailure`](/docs/es/hooks#stopfailure).
1021
1022Si tu organización [ejecuta solo hooks administrados](/docs/es/settings-reference#allowmanagedhooksonly), pide a tu administrador que agregue el hook a la [configuración administrada](#managed-settings) que llega a la máquina remota.
1023
1024Claude Code no aprueba automáticamente [algunas acciones](/docs/es/permission-modes#actions-no-mode-auto-approves) en ningún modo de permisos, incluido Bypass permissions. Según el modo de permisos, Claude Code deniega esa acción o te pregunta, y entonces la tarea espera tu respuesta.
1025
1026<a id="reconnect-after-sleep-or-a-network-loss" />
1027
1028<h5 id="reconnect-after-sleep-or-a-network-loss">
1029 Volver a conectarse después de una suspensión o una pérdida de red
1030</h5>
1031
1032Si Desktop no se ha vuelto a conectar cuando vuelves, envía un mensaje en la sesión. Desktop vuelve a conectarse por sí solo solo donde puede iniciar sesión sin pedirte nada, por ejemplo con una clave que tenga tu agente SSH.
1033
1034* **Contraseña recordada**: una contraseña que dejas que Desktop recuerde también funciona sin pedirte nada, pero para una ausencia larga es preferible una clave que tenga tu agente SSH. Si los inicios de sesión con esa contraseña se interrumpen o se cuelgan, Desktop puede dejar de intentar volver a conectarse y esperarte.
1035* **Cualquier otra solicitud**: si la máquina remota pide cualquier otra cosa, como un código de un solo uso, puedes recibir una notificación en tu computadora. Haz clic en la notificación, o envía un mensaje en la sesión, y Desktop muestra la solicitud.
1036
1037<Accordion title="Si un host de salto pide un inicio de sesión, la interrupción es larga, falta salida o el proceso ya no existe">
1038 - **Host de salto, las notificaciones push se detienen mientras no estás**: esto puede ocurrir con Desktop en macOS o Linux cuando nadie responde al inicio de sesión de un host de salto, por ejemplo una notificación push a un teléfono. Entonces Desktop deja de intentar volver a conectarse mientras no hay nadie en tu computadora. Cuando desbloqueas o usas la computadora, puedes recibir otra notificación push, porque Desktop puede volver a intentarlo. Después de tres intentos sin respuesta, espera hasta que reintentes o envíes un mensaje.
1039 - **Host de salto, las notificaciones push siguen llegando**: donde Desktop no puede saber que nadie responde, como con Desktop en Windows, sigue intentándolo mientras tenga un proceso al que volver a unirse, se siga ejecutando ese proceso o no. Puedes recibir otra notificación push con cada intento. Para terminar los intentos, cierra Desktop, lo que [puede costarte la tarea en ejecución](#reopen-a-session-after-you-quit-desktop).
1040 - **Interrupción larga**: Desktop reduce el ritmo a aproximadamente un intento cada cinco minutos. Para volver a conectarte antes, reintenta en la sesión o envía un mensaje, que Desktop entrega una vez que está conectado.
1041 - **Salida faltante**: mientras Desktop está desconectado, el programa auxiliar guarda la salida más reciente de Claude Code de cada sesión en un búfer de 16 MiB y descarta la salida más antigua. Después de que Desktop vuelve a conectarse, la sesión puede mostrar `Loading recent output from <host>…`. Si Desktop no puede cargar toda la salida, ves la fila `Some output produced while you were disconnected may be missing here.` La fila no significa que la tarea se haya detenido.
1042 - **Proceso inexistente**: si el proceso ya no existe cuando Desktop vuelve a conectarse, Desktop puede iniciar uno nuevo a partir del historial guardado de la conversación y decirle a Claude que continúe la tarea. Desktop no continúa la tarea por sí solo si el proceso sigue terminando, o si Desktop usa un proveedor externo. Envía un mensaje para continuar.
1043</Accordion>
1044
1045<a id="reopen-a-session-after-you-quit-desktop" />
1046
1047<h5 id="reopen-a-session-after-you-quit-desktop">
1048 Volver a abrir una sesión después de cerrar Desktop
1049</h5>
1050
1051Después de cerrar Desktop, la tarea sigue ejecutándose en la máquina remota hasta que termina, te necesita o alcanza uno de los [límites](#limits-while-desktop-is-disconnected).
1052
1053* **Desktop en macOS o Linux, con una cuenta de Claude**: inicia Desktop y abre la sesión. Recuperas la tarea en ejecución cuando Desktop puede volver a unirse al proceso. No siempre puede volver a unirse, por ejemplo después de algunas actualizaciones de Desktop o después de que tu organización cambie su configuración administrada.
1054* **En macOS o Linux, cuando Desktop no puede volver a unirse**: Desktop termina el proceso e inicia uno nuevo a partir del historial guardado de la conversación. Tu tarea en ejecución se detiene, y pierdes cualquier aprobación o pregunta que te estuviera esperando. Después de una actualización, Desktop puede entonces decirle a Claude que continúe. Si la tarea sigue detenida, envía un mensaje.
1055* **Desktop en Windows, o con un proveedor externo en cualquier plataforma**: vuelve a iniciar Desktop solo cuando esperes que la tarea haya terminado. No recuperas la tarea en ejecución, porque Desktop nunca vuelve a unirse después de cerrarse. Termina el proceso cuando se abre la sesión, lo que puede ocurrir al iniciarse Desktop. Envía un mensaje para continuar.
1056
1057Para despliegues con terceros, consulta [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
1058
1059<Warning>
1060 Mientras el proceso de Claude Code de una conversación siga en ejecución, no ejecutes [`claude --resume`](/docs/es/cli-reference#cli-flags) para ella en la máquina remota. Claude Code no te lo impide, y entonces ambos procesos escriben en la misma conversación. Si no estás seguro, agrega `--fork-session`, que continúa en una copia de la conversación, aunque ambos procesos siguen trabajando en los mismos archivos.
1061</Warning>
826 1062
827<h4 id="choose-where-ssh-session-worktrees-go">1063<h4 id="choose-where-ssh-session-worktrees-go">
828 Elegir dónde van los worktrees de las sesiones SSH1064 Elegir dónde van los worktrees de las sesiones SSH
8342. [`worktree.location`](/docs/es/settings-reference#worktree-location) en `~/.claude/settings.json` en la máquina remota10702. [`worktree.location`](/docs/es/settings-reference#worktree-location) en `~/.claude/settings.json` en la máquina remota
8353. `<project-root>/.claude/worktrees/`, el valor predeterminado10713. `<project-root>/.claude/worktrees/`, el valor predeterminado
836 1072
837Cada proyecto obtiene su propia subcarpeta en la carpeta que establezcas, por lo que con `~/worktrees` la ruta de un worktree es `~/worktrees/<project>-<id>/<worktree-name>`. Si la carpeta que estableces está dentro del proyecto, Desktop la ignora para ese proyecto y usa el valor predeterminado.1073Cada proyecto obtiene su propia subcarpeta en la carpeta que establezcas, por lo que con `~/worktrees` la ruta de un worktree es `~/worktrees/<project>-<id>/<worktree-name>`. Si la carpeta que estableces está dentro del proyecto, Desktop la ignora para ese proyecto y usa el valor predeterminado. En una [máquina remota Windows](#windows-remote-machines), Desktop siempre usa el valor predeterminado.
838 1074
839Para establecer **Worktree folder** en una conexión que agregaste antes o en una que administra tu organización, pasa el cursor sobre ella en el menú desplegable de entorno y haz clic en el icono de engranaje.1075Para establecer **Worktree folder** en una conexión que agregaste antes o en una que administra tu organización, pasa el cursor sobre ella en el menú desplegable de entorno y haz clic en el icono de engranaje.
840 1076
