Aplicación de escritorio

• Revisar y comentar en diffs, luego monitorear el PR resultante a través de CI
• Obtener una vista previa de su aplicación en ejecución en el panel Navegador mientras Claude verifica sus propios cambios, y abrir sitios externos junto a él
• Ver a Claude ejecutar y probar su aplicación iOS en el panel iOS Simulator
• Organizar paneles para el chat, diff, navegador, terminal y editor de archivos lado a lado
• Hacer una pregunta lateral que use el contexto de la sesión sin desviarse
• Permitir que Claude verifique, envíe mensajes o archive sus otras sesiones
• Conectar herramientas externas como GitHub, Slack y Linear
• Permitir que Claude abra aplicaciones y controle su pantalla
• Ejecutar en su máquina, en la nube, o sobre SSH

​

Iniciar una sesión

• Entorno: usa el selector de entorno, el primer control de la fila, para elegir dónde se ejecuta Claude. Consulta configuración del entorno.
  • Si una sesión nueva no muestra ningún entorno debajo del cuadro del prompt, sigue los pasos del diseño anterior.
• Carpeta del proyecto: haz clic en el control de carpeta del proyecto, junto al selector de entorno, para elegir la carpeta en la que trabaja Claude.
  • Sesión en la nube: selecciona repositorios en lugar de una carpeta
  • Entorno local o SSH guardado: el entorno ya contiene sus carpetas, por lo que la fila no muestra ningún control de carpeta del proyecto. Para cambiar las carpetas, edita el entorno.
• Modo de permisos: usa el selector de modo para elegir cuánta autonomía tiene Claude. Puedes cambiar el modo de permisos durante la sesión.
• Modelo: elige un modelo en el selector de modelo, hacia el extremo derecho de la fila. Puedes cambiar el modelo durante la sesión.

​

Trabajar con código

​

Usar el cuadro de prompt

​

Aceptar un prompt sugerido

• Usar la sugerencia: presiona Tab o Flecha derecha para colocarla en el cuadro de prompt, edítala si quieres y luego presiona Enter para enviarla. Presionar Enter antes de aceptar la sugerencia no la envía.
• Escribir tu propio prompt: empieza a escribir. La sugerencia solo se muestra mientras el cuadro de prompt está vacío y no tiene archivos adjuntos.

​

Agregar archivos y contexto a los prompts

• Archivos @mention: escribe @ seguido de un nombre de archivo para agregar un archivo al contexto de la conversación.
  • En una sesión en la nube: @ puede listar archivos solo después de que envías tu primer mensaje. Si @ no lista ninguno, envía tu primer mensaje sin el archivo y luego menciona el archivo con @ en tu siguiente mensaje.
• Adjuntar archivos: adjunta imágenes, PDF y otros archivos a tu prompt desde el botón + junto al cuadro de prompt, o arrastra y suelta archivos directamente en el prompt. Esto es útil para compartir capturas de pantalla de errores, maquetas de diseño o documentos de referencia.
  • En una sesión WSL: si el menú + muestra Add image en lugar de Add files or photos, solo puedes adjuntar imágenes. Para darle a Claude cualquier otro archivo de la carpeta de la sesión, menciónalo con @.

​

Elegir un modo de permisos

​

Disponibilidad del modo automático

​

Vista previa de tu aplicación

• Interactuar con tu aplicación en ejecución directamente en el panel del navegador
• Ver a Claude verificar sus propios cambios automáticamente: toma capturas de pantalla, inspecciona el DOM, hace clic en elementos, completa formularios y corrige los problemas que encuentra
• Iniciar o detener servidores, o detenerlos todos a la vez, desde el menú Dev servers en el encabezado del panel del navegador
• Elegir si el navegador conserva las cookies después de salir de la aplicación con Keep cookies en el menú ⋮ del panel del navegador, para que no tengas que volver a iniciar sesión durante el desarrollo

​

Examinar sitios externos

• Los clasificadores de seguridad revisan las acciones de escritura de Claude en páginas externas, como hacer clic y escribir, en cada modo de permisos. Son los mismos clasificadores que usa el modo automático, y cuando marcan una acción, recibes una solicitud de permiso independientemente del modo.
• En los modos de permisos distintos de Auto y Bypass permissions, también se aplica una verificación de la lista de dominios permitidos antes de que Claude navegue a un nuevo sitio.

​

Aprobar las acciones de Claude en un sitio

​

Elegir entre el panel del navegador y la extensión de Chrome

​

Restringir la navegación externa para tu organización

​

Revisar cambios con la vista de diff

• macOS: presiona Cmd+Enter
• Windows: presiona Ctrl+Enter

​

Revisar tu código

• Haz clic en Walk through in diff para abrir la vista de diff y recorrer los hallazgos uno por uno. Un hallazgo en el diff actual aparece en su línea, donde puedes hacer clic en Fix this one o descartarlo.
• Haz clic en Apply fixes para pedirle a Claude que corrija los hallazgos que siguen abiertos.

​

Monitorear el estado del pull request

• Auto-fix: en una sesión local, Claude también atiende los nuevos comentarios de revisión que deja alguien distinto de ti. El autor del comentario tiene que ser el propietario del repositorio, un miembro de la organización, un colaborador o una GitHub App.
• Merge when ready: activa el auto-merge de GitHub para el PR. En una sesión local, Desktop solicita una fusión squash a menos que la rama base use una cola de fusión.
  • En sesiones SSH y WSL: Merge when ready está deshabilitado, así que activa auto-merge para el pull request en GitHub
  • Si el repositorio no permite auto-merge: Merge when ready no se activa, así que primero habilita auto-merge en la configuración de tu repositorio de GitHub
• Diseño anterior: una vez que la sesión tiene un pull request, haz clic en CI en su barra de estado.

​

Organizar tu espacio de trabajo

• Cuando la ventana es estrecha: los botones que no caben pasan al menú
• Para paneles sin botón: paneles como Background tasks y Plan aparecen en la lista una vez que la sesión tiene algo que mostrar en ellos

​

Ver los detalles de la sesión

​

Ocultar o mostrar el panel de detalles de la sesión

​

Ejecutar comandos en la terminal

​

Abrir y editar archivos

• Sesiones locales: puedes editar archivos dentro del directorio de trabajo de la sesión, excepto algunos de solo lectura como .mcp.json y .claude/settings.json. Para cambiar uno de ellos, ábrelo en otra aplicación.
• Sesiones en la nube, SSH y WSL: el panel de archivos es de solo lectura, así que pídele a Claude que realice las ediciones.

​

Guardar ediciones en el panel de archivos

​

Abrir archivos en otras aplicaciones

• Attach as context: agrega el archivo a tu siguiente prompt
• Open in: abre el archivo en un editor instalado como VS Code, Cursor o Zed
• Show in Finder en macOS, Show in Explorer en Windows: abre la carpeta contenedora
• Copy: un submenú que copia la Absolute path, la Relative path o el Filename del archivo

​

Cambiar modos de vista

​

Atajos de teclado

• Cmd+Option: presiona Alt
• Cmd+Ctrl: presiona Ctrl+Alt
• Cmd: presiona Ctrl

​

Verificar uso

• Diseño actual: el encabezado de la tarjeta Context en el panel de detalles de la sesión lo muestra como un porcentaje. Abre la tarjeta para ver qué está usando la ventana por categoría.
• Diseño anterior: haz clic en el anillo de uso junto al selector de modelo. Su ventana emergente muestra tu uso de la ventana de contexto.

​

Permitir que Claude use su computadora

​

Cuándo se aplica el uso de computadora

• Si tiene un conector para un servicio, Claude usa el conector.
• Si la tarea es un comando de shell, Claude usa Bash.
• Si la tarea es trabajo en navegador y tiene Claude en Chrome configurado, Claude usa eso.
• Si la tarea es ejecutar o probar una aplicación iOS, Claude usa el panel iOS Simulator, que no usa control de pantalla.
• Si ninguno de esos se aplica, Claude usa el uso de computadora.

​

Habilitar el uso de computadora

​

Permisos de aplicación

• Denied apps: agregue aplicaciones aquí para rechazarlas sin solicitar. Claude aún puede afectar una aplicación denegada indirectamente a través de acciones en una aplicación permitida, pero no puede interactuar directamente con la aplicación denegada.
• Unhide apps when Claude finishes: cuando el uso de computadora no se ejecuta en segundo plano, Claude oculta sus otras ventanas mientras trabaja para que interactúe solo con la aplicación aprobada. Cuando Claude termina, las ventanas ocultas se restauran a menos que desactive esta configuración.

​

Gestionar sesiones

​

Trabajar en paralelo con sesiones

• Lado a lado: mantén presionado Option en macOS o Alt en Windows y haz clic en una sesión en la barra lateral, o haz clic derecho en la sesión y selecciona Open in y luego Split view
• En su propia ventana: mantén presionado Cmd en macOS o Ctrl en Windows y haz clic en una sesión, o haz clic derecho en la sesión y selecciona Open in y luego New window

​

Ejecutar una sesión en su propio worktree

• Con un proveedor externo: si la fila debajo del cuadro del prompt muestra el control de la carpeta del proyecto pero no el botón Worktree, haz clic en ese control y activa Worktree
• Como valor predeterminado para un entorno local o SSH guardado: establece Worktree cuando crees o edites el entorno
• Diseño anterior: selecciona la casilla worktree junto al nombre de la rama, encima del cuadro del prompt

• Sesiones locales: establece Worktree location en Configuración > Code o Configuración > Claude Code
• Sesiones SSH: establece Worktree folder en la conexión SSH

​

Agregar carpetas a una sesión

• Antes de que comience una sesión local: agrega las carpetas en Folders cuando crees un entorno guardado o edites uno, y luego inicia la sesión desde ese entorno guardado.
• Mientras se ejecuta una sesión local o SSH: haz clic en + junto al cuadro del prompt y selecciona Add folder. Claude trabaja directamente en esa carpeta, sin worktree.

​

Archivar una sesión

​

Conservar los cambios sin commit cuando se archiva una sesión

• Si Desktop pregunta por los cambios: selecciona Archive anyway para descartarlos, o cancela y haz commit de ellos
• Si los únicos cambios son archivos sin seguimiento: haz commit de los que quieras conservar antes de que se fusione un pull request que Claude abrió en la sesión, porque entonces Desktop puede eliminarlos sin preguntar
• En cualquier otro caso: el worktree permanece en el disco con sus cambios. Para una sesión local, Desktop elimina ambos unos 30 días después de que la sesión se archive o de la última vez que la abras, lo que ocurra más tarde. Para conservar los cambios, abre la sesión desde la pestaña Archived y selecciona Unarchive

​

Organizar y encontrar sesiones

• Diseño actual: pasa el cursor sobre un encabezado de la lista de sesiones para mostrar el icono Group and sort y luego haz clic en él. Para encontrar sesiones archivadas, selecciona View all, la última fila del menú, y luego abre la pestaña Archived.
• Diseño anterior: el icono Filter se muestra sin pasar el cursor. Haz clic en él para organizar la lista con Group by o Sort by. Para mostrar las sesiones archivadas, selecciona Status y luego Archived.

​

Verificar y liberar contexto

​

Recibir una notificación cuando termina una sesión

​

Hacer una pregunta lateral sin descarrilar la sesión

​

Ver tareas en segundo plano

​

Trabajar entre sesiones

• Recibes una tarjeta de aprobación antes de que Claude archive una sesión, excepto en el modo automático y el modo Bypass permissions, donde Claude puede archivar una sesión sin ella. Para que se te pregunte, cambia a Manual.
• Claude Code verifica cada mensaje de esta superficie contra los controles de entrada de la sesión receptora, incluso cuando la sesión receptora no tiene mensajería entre sesiones en sí misma. Si estableces crossSessionInbound en refuse en la sesión receptora, Claude Code descarta los mensajes de esta superficie. Claude Code reporta el rechazo a la aplicación de escritorio de Claude. Antes de v2.1.234, Claude Code descartaba cada mensaje de esta superficie dirigido a una sesión receptora sin mensajería entre sesiones.
• Claude Code cita cada mensaje entrante y lo atribuye a la sesión que lo envió, y Claude sigue respetando la configuración de permisos propia de la sesión receptora al actuar sobre uno.

​

Iniciar una tarea que Claude sugiere

• Start: inicia la tarea en otra sesión. De forma predeterminada, la tarea se ejecuta en el entorno de la sesión actual. Luego, la tarjeta muestra el estado de la sesión iniciada, y la barra lateral muestra la sesión iniciada debajo de la sesión actual.
• Do it here: envía la tarea a la sesión actual como un mensaje
• Options: revisa o cambia ajustes como el entorno, el modelo, el worktree y los permisos antes de hacer clic en Start
• Start all: cuando la tarjeta enumera varias tareas, inicia cada tarea en su propia sesión sin esperar a que una tarea termine antes de iniciar la siguiente

​

Ejecutar tareas de larga duración en la nube

• Diseño actual: en la fila debajo del cuadro del prompt, una vez que selecciones un entorno en la nube.
• Diseño anterior: encima del cuadro del prompt. Para agregar otro repositorio, haz clic en + junto al seleccionado.

​

Continuar en otra superficie

• Selecciona Cloud para continuar la sesión como una sesión en la nube, con tu conversación trasladada como un resumen. Antes de que confirmes, el cuadro de diálogo indica si tus archivos también se mueven y si esta sesión se archiva una vez que la de la nube esté lista. No puedes mover de esta forma una sesión que se ejecuta por SSH o en WSL.
• Selecciona un editor instalado o tu administrador de archivos para abrir allí la carpeta de la sesión en el disco.

​

Controlar qué sesiones aparecen en tus otros dispositivos

• Lo activas para esa sesión: con el interruptor Remote Control de la sesión, o escribiendo /remote-control en su cuadro del prompt.
• Se conecta al iniciarse: las sesiones nuevas se conectan automáticamente mientras Connect new sessions to Remote Control está activado en Configuración > Code o Configuración > Claude Code. Si nunca has cambiado ese ajuste, Desktop sigue remoteControlAtStartup en tu configuración de usuario o configuración administrada y, después, el valor predeterminado de tu organización.

• Una sesión: desactiva su interruptor Remote Control. En una sesión que se conectó al iniciarse, escribir /remote-control deja Remote Control activado y muestra Remote Control is already on. This session connected automatically when it started. Haz clic en Turn off en esa línea para desconectarla.
• Nuevas sesiones de Desktop en esta computadora: desactiva Connect new sessions to Remote Control en Configuración > Code o Configuración > Claude Code. Si ya aparece desactivado, actívalo y luego desactívalo para que Desktop guarde tu elección. Una vez guardado, tiene precedencia sobre remoteControlAtStartup y los valores predeterminados.
• Cualquier sesión en esta computadora, incluida la CLI: establece disableRemoteControl en true en ~/.claude/settings.json para impedir que las sesiones se conecten. Una sesión que ya estaba conectada cuando guardaste el archivo permanece conectada hasta que desactives Remote Control para ella.

​

Sesiones desde Dispatch

​

Seguir una sesión que inició Dispatch

​

Configurar Dispatch

• Planes: Dispatch requiere un plan Pro, Max o Ultra y no está disponible en los planes Team o Enterprise
• Configuración, emparejamiento y ajustes de Dispatch: consulta el artículo de ayuda de Dispatch

​

Extender Claude Code

​

Conectar herramientas externas

​

Usar skills

​

Instalar plugins

​

Configurar servidores de vista previa

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

​

Verificación automática de cambios

{
  "version": "0.0.1",
  "autoVerify": false,
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

​

Campos de configuración

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 8443,
      "url": "https://localhost:8443"
    }
  ]
}

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "url": "https://app.localhost:3000"
    }
  ]
}

​

Conflictos de puerto

• true: Claude encuentra y usa un puerto libre automáticamente. Adecuado para la mayoría de servidores de desarrollo.
• false: Claude falla con un error. Use esto cuando su servidor debe usar un puerto específico, como para devoluciones de llamada OAuth o listas de permitidos CORS.
• No establecido (predeterminado): tu servidor obtiene el siguiente puerto libre, como con true, excepto en el único caso que se describe a continuación. Antes de Claude Desktop v2.37337.0, Claude pregunta en su lugar si el servidor necesita ese puerto exacto y luego guarda tu respuesta en launch.json.

• Inicias el servidor a través de un script de npm, yarn, pnpm o bun.
• Tu puerto preferido está codificado de forma fija en ese script, o Claude no puede inspeccionar el script.
• No pasas el puerto en runtimeArgs.

​

Ejemplos

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "web",
      "runtimeExecutable": "yarn",
      "runtimeArgs": ["dev"],
      "port": 3000
    }
  ]
}

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "frontend",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "cwd": "apps/web",
      "port": 3000,
      "autoPort": true
    },
    {
      "name": "api",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "start"],
      "cwd": "server",
      "port": 8080,
      "env": { "NODE_ENV": "development" },
      "autoPort": false
    }
  ]
}

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "server",
      "program": "server.js",
      "args": ["--verbose"],
      "port": 4000
    }
  ]
}

​

Configuración del entorno

• Local: se ejecuta en su máquina con acceso directo a sus archivos
• Cloud: se ejecuta en la infraestructura administrada por Anthropic de forma predeterminada. Las sesiones continúan incluso si cierra la aplicación.
• 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, pero con una cuenta de Claude puede detenerse cuando su inicio de sesión expira.
• WSL (Windows): se ejecuta dentro de una distribución WSL 2 en su máquina, utilizando su cadena de herramientas Linux y rutas nativas

​

Crear un entorno guardado

​

Entornos que Desktop crea por ti

​

Usar, editar o eliminar un entorno guardado

• Iniciar una sesión: selecciona la entrada.
• Editar o eliminar: pasa el cursor sobre la entrada y haz clic en el ícono de engranaje. Para eliminar un entorno local o SSH, haz clic en Delete environment en Edit environment.
• Archivar entornos en la nube: consulta Archivar un entorno.

​

Variables de entorno en sesiones locales

���

Establecer variables de entorno para sesiones locales

​

Establecer variables de entorno para servidores de desarrollo

• macOS y Linux: expórtalo en tu perfil del shell
• Windows: agrégalo a tus variables de entorno de usuario o del sistema
• Cualquier plataforma: guárdalo en el editor de entorno local, si puedes abrirlo

​

Usar el editor de entorno local

• Selector debajo del cuadro del prompt: pasa el cursor sobre la entrada de tu computadora, la primera bajo Local. Si aparece un ícono de engranaje, haz clic en él. Si no aparece, el editor no está disponible, así que establece la variable para sesiones locales o servidores de desarrollo de otra forma.
• Selector encima del cuadro del prompt: pasa el cursor sobre Local y haz clic en el ícono de engranaje

​

Variable exportada ausente o incorrecta en los comandos que ejecuta Claude

​

Variables de entorno que Desktop establece por sí mismo

• API_TIMEOUT_MS: una sesión local recibe 900000, que equivale a 15 minutos. Para un tiempo de espera más largo, instala la CLI de Claude Code y úsala en lugar de Desktop. Establece la variable en tu shell y ejecuta claude en tu terminal.
• ANTHROPIC_BASE_URL: una sesión local recibe el host de la API de Anthropic cuando iniciaste sesión con una cuenta de Claude. Para usar un gateway, configura en su lugar la configuración de inferencia de terceros de Desktop.

​

Desactivar el pensamiento extendido

​

Presupuestos de pensamiento fijos

​

Sesiones locales en dispositivos administrados

​

Sesiones en la nube

• Agregar un entorno: selecciona New environment al final del menú del selector y luego la pestaña Cloud del diálogo New environment
• Editar o archivar uno de sus propios entornos: pase el cursor sobre él y haga clic en el icono de engranaje

​

Sesiones SSH

​

Requisitos de la máquina remota para las sesiones SSH

• Sistema: un procesador x86_64 o arm64. La máquina también tiene que cumplir los requisitos del sistema de Claude Code. En Linux, Claude Code necesita glibc 2.17 o posterior, o musl. Para ver cuál tiene la máquina, ejecuta ldd --version allí. En una distribución basada en musl como Alpine Linux, instala también los paquetes que necesita Claude Code.
• 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>.
• MaxSessions 1 en el servidor: para conectarte a un servidor cuyo sshd_config establece MaxSessions 1, haz una de estas cosas:
  • Tu computadora ejecuta macOS o Linux: actualiza a Claude Desktop v3.1623.0 o posterior
  • Tu computadora ejecuta Windows: asegúrate de que Desktop se conecte a través del cliente OpenSSH, porque el cliente SSH integrado de Desktop no puede conectarse a ese servidor
  • Puedes cambiar el servidor: aumenta MaxSessions, por ejemplo al valor predeterminado de OpenSSH, 10
• Inicios de sesión con MaxSessions 1: usa un inicio de sesión que funcione sin solicitudes, como una clave que tenga tu agente SSH. Desktop inicia sesión al menos dos veces cada vez que se conecta o se vuelve a conectar. Espera al menos un inicio de sesión más por cada pestaña de la terminal y por cada sesión de Desktop en la que ejecutes comandos que empiezan con !. No esperes ninguno por los comandos que ejecuta Claude.
• Códigos de un solo uso con MaxSessions 1: si cada inicio de sesión te pide algo, como con códigos de un solo uso, los comandos ! fallan. Ejecuta esos comandos en una pestaña de la terminal, que muestra la solicitud en su propio panel.
• 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. Para saber qué contiene esa carpeta, consulta Archivos y procesos en la máquina remota.
• 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
• 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. 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. En una máquina remota Linux, si esas solicitudes necesitan un proxy, establécelo para las sesiones SSH.

​

Comprobar la clave de host de una máquina remota

• Desktop pregunta Connect to <host> for the first time?, o seleccionaste Review new key: la máquina que nombra Desktop, <host>
• Desktop pregunta Connect through <jump host> for the first time?: el host de salto, que es la máquina por la que pasa tu conexión, no la máquina a la que quieres llegar
• ssh pregunta o advierte en una terminal: la máquina que nombra su mensaje, que puede no ser la que escribiste

• Otra persona administra la máquina: pídele la huella digital de su clave de host
• Tú la administras y ejecuta Linux o macOS: ejecuta ssh-keygen -lf /etc/ssh/ssh_host_<type>_key.pub en ella, en su consola o a través de una conexión en la que ya confías. Para <type>, usa el tipo de clave que Desktop o ssh muestra junto a la huella digital, en minúsculas: ed25519 para ED25519 o ssh-ed25519.

• Coinciden: confía en la clave. Selecciona Trust and connect o Trust new key en Desktop, o responde yes en la terminal.
• Difieren, o no puedes comprobarlo: no te conectes. Selecciona Cancel en Desktop, o responde no en la terminal. Si otra persona administra la máquina, dile qué huella digital se te mostró.

​

Establecer un proxy o un certificado de CA para las sesiones SSH

{
  "env": {
    "HTTPS_PROXY": "http://proxy.example.com:8080",
    "NODE_EXTRA_CA_CERTS": "/etc/ssl/certs/example-ca.pem"
  }
}

​

Usar tu configuración de SSH

• macOS y Linux: Desktop se conecta ejecutando el cliente OpenSSH de tu computadora, así que usa tu ~/.ssh/config. Conectarse a través del cliente OpenSSH requiere Claude Desktop v1.37937.0 o posterior.
• Windows: cuando Desktop se conecta a través del cliente OpenSSH, usa tu %USERPROFILE%\.ssh\config. Si usas una cuenta de Claude en lugar de un proveedor externo, conectarse a través del cliente OpenSSH requiere todo lo siguiente:
  • Claude Desktop v2.2553.0 o posterior. Para encontrar tu versión, consulta Comprobar tu versión.
  • OpenSSH de Microsoft 9.4 o posterior
  • Desktop instalado con los botones de descarga de la parte superior de esta página, porque Desktop de Microsoft Store no se conecta a través del cliente OpenSSH
  Si no puedes cumplir estos requisitos, o usas un proveedor externo, consulta Conectarse en Windows sin el cliente OpenSSH.

• Versión del cliente en macOS y Linux: ejecuta ssh -V. El cliente tiene que ser OpenSSH 7.6 o posterior.
• Versión del cliente en Windows: Desktop prueba primero el ssh de tu PATH, así que ejecuta ssh -V. El cliente es válido si la salida muestra OpenSSH_for_Windows_ y 9.4 o posterior. Si no es válido, revisa las dos carpetas que Desktop prueba a continuación: ejecuta .\ssh.exe -V en C:\Windows\System32\OpenSSH y luego en C:\Program Files\OpenSSH.
• Ningún cliente es válido en Windows: agrega la característica opcional OpenSSH Client en Windows e instala las actualizaciones pendientes de Windows, o instala la compilación más reciente de Microsoft. Luego cierra y vuelve a abrir Desktop. Para ver si Desktop encontró un cliente OpenSSH utilizable, busca en ssh.log Windows OpenSSH client: y una versión, o no usable Windows OpenSSH client.
• Entrada: en Windows, usa el cliente que pasó la comprobación de versión. Ejecuta ssh con el nombre de Host, como ssh devbox. Si falla, corrige primero la entrada.

• SSH port: un valor aquí sobrescribe el Port de la entrada
• SSH key (optional): con el cliente OpenSSH, Desktop ofrece el archivo de clave que elijas además del IdentityFile de la entrada y las claves de tu agente SSH. En Windows, elige una clave en formato OpenSSH, porque ssh no lee un archivo .ppk de PuTTY.

• Ajustes de la entrada: Desktop toma HostName, User, Port e IdentityFile. También toma ProxyCommand si hay un shell sh en tu PATH.
• SSH key (optional): deja este campo vacío para conservar el IdentityFile de la entrada, porque un archivo de clave que elijas aquí reemplaza al IdentityFile
• CertificateFile y ProxyJump: Desktop ignora CertificateFile, y la conexión falla si la entrada establece ProxyJump. Para usar cualquiera de los dos ajustes, conéctate a través del cliente OpenSSH.

Host devbox
  HostName devbox.internal.example.com
  User alice
  ProxyJump bastion.example.com

Host devbox-container
  User dev
  ProxyCommand ssh build.example.com docker exec -i devbox /usr/sbin/sshd -i

[profile corp]
region = us-east-1
credential_process = /full/path/to/your-credential-helper

Host i-*
  ProxyCommand sh -c "aws ssm start-session --profile corp --target %h --document-name AWS-StartSSHSession --parameters 'portNumber=%p'"

Host devbox
  HostName devbox.internal.example.com
  User alice
  ProxyJump bastion.example.com
  ConnectTimeout 120

ssh -G -o HostName=devbox.internal.example.com -l alice devbox

Match host *.internal.example.com !originalhost devbox

• Para llegar a un puerto en la máquina remota: reenvíalo tú mismo
• Para usar tus propias claves desde la máquina remota: configura una credencial en la propia máquina remota, por ejemplo para git push

​

Llegar a un puerto en la máquina remota

ssh -N -L 3000:localhost:3000 devbox

​

Máquinas remotas Windows

• Terminal: la terminal no se abre en una sesión cuya carpeta es una ruta de Windows, como C:/projects/app
• Sandbox: Claude Code se ejecuta allí en Windows nativo, donde ejecuta los comandos fuera del sandbox. Consulta dónde se ejecuta el sandbox.
• 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.
• 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. Antes de Claude Desktop v2.37337.0, esto ocurre en todas las máquinas remotas Windows.
• Worktrees: los worktrees van en <project-root>/.claude/worktrees/. Si eliges otra carpeta, Desktop la ignora.
• 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
• Bifurcaciones: si el shell del servidor SSH es cmd.exe o Windows PowerShell, solo puedes bifurcar una sesión en su primer mensaje
• Ejecución mientras está desconectado: una tarea sigue ejecutándose mientras Desktop está desconectado solo si el servidor SSH permite que un programa sobreviva a la conexión que lo inició. Para averiguarlo, prueba la máquina remota.
• 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 que instala Desktop no se detiene por sí solo allí.

​

Mantener una tarea en ejecución mientras Desktop está desconectado

• Después de una suspensión o una pérdida de red: recuperas la tarea en ejecución si el proceso sigue ejecutándose y Desktop puede iniciar sesión sin pedirte nada. Si no puede, envía un mensaje.
• Después de salir: la tarea sigue ejecutándose, pero la pierdes cuando la sesión vuelve a abrirse, a menos que Desktop pueda volver a unirse a su proceso. Revisa cuándo puede Desktop volver a unirse antes de salir. Si perdiste la tarea, envía un mensaje para continuar.

• 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.
• Error de autenticación: es posible que el token de inicio de sesión o la credencial 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.
• Solicitud en espera: respóndela
• Ninguno de estos: envía un mensaje para continuar

• 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 descargó. Ese reinicio espera mientras Claude trabaja en una tarea SSH. De forma predeterminada, una vez que la actualización esperó 72 horas, el reinicio puede realizarse durante la tarea si Desktop puede reincorporarse a la tarea después.
• Revisa antes de cerrar: no siempre recuperas la tarea en ejecución después de un cierre o reinicio, por ejemplo después de algunas actualizaciones de Desktop. Para ver los casos, consulta Volver a abrir una sesión después de cerrar Desktop.
• En una versión anterior, deja Desktop abierto: en Windows con Claude Desktop anterior a la v3.1623.0, no recuperas la tarea en ejecución después de que Desktop se cierra o se reinicia. Lo mismo ocurre con un proveedor externo en macOS o Linux antes de la v2.42304.0. En ambos casos, deja Desktop abierto durante la tarea. Para encontrar tu versión, consulta Comprobar tu versión.
• Reduce las solicitudes: elige un modo de permisos, reglas o hooks que hagan que la tarea te espere con menos frecuencia
• 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.
• 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.
• Mantén los comandos fuera de la terminal de Desktop: si la máquina remota cierra la sesión de las terminales inactivas, ejecuta tus propios comandos desde un inicio de sesión SSH fuera de Desktop

• 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. Con una cuenta de Claude, mantén Desktop en ejecución y conectado para que pueda renovar el inicio de sesión.
• 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.
• 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 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.
• 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
• 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.

• Worktrees: en una sesión que usa un worktree, Desktop comprueba cada edición de archivo antes de que Claude la realice. Mientras Desktop está desconectado, cada edición espera unos 30 segundos y luego falla. Los comandos del shell siguen ejecutándose. En una máquina remota Linux o macOS, las ediciones pueden seguir funcionando. Si no estás seguro, inicia la sesión sin un worktree.
• 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.
• Conectores: los conectores 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
• Flujos de trabajo: Desktop revisa cada nuevo flujo de trabajo antes de que comience, por lo que mientras Desktop está desconectado uno nuevo espera hasta 10 minutos y luego falla
• 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. De lo contrario, y en algunas máquinas remotas Windows, Claude no puede llamar a sus herramientas mientras Desktop está desconectado.

• Modo automático: elige el modo automático si está disponible para ti. Después de bloqueos repetidos, se te vuelve a preguntar.
• Reglas de permiso: en tu archivo de configuración de usuario en la máquina remota, ~/.claude/settings.json, agrega reglas allow para los comandos que necesita la tarea. Si tu organización acepta reglas de permisos solo desde la configuración administrada, pide a tu administrador que las agregue a la configuración administrada 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.
• Un hook que responde: configura un hook PermissionRequest en ~/.claude/settings.json en la máquina remota para permitir o denegar solicitudes en tu lugar
• Un hook que te avisa: configura un hook Notification con el matcher permission_prompt en el mismo archivo para enviarte un mensaje cuando haya una solicitud en espera
• Un hook que te avisa cuando Claude termina: configura un hook 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.

• 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.
• 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.

• Desktop en Windows, tarea iniciada en una versión anterior a la v3.1623.0: no recuperas la tarea, aunque Desktop se haya actualizado desde entonces. Vuelve a iniciar Desktop solo cuando esperes que la tarea haya terminado, porque la sesión puede abrirse cuando Desktop se inicia, y la tarea se detiene cuando la sesión se abre. Si no sabes en qué versión iniciaste la tarea, espera también hasta que esperes que haya terminado.
• Proveedor externo en macOS o Linux, tarea iniciada en una versión anterior a la v2.42304.0: no recuperas la tarea. Vuelve a iniciar Desktop solo cuando esperes que la tarea haya terminado.
• Cualquier otra tarea: inicia Desktop y abre la sesión, y la tarea continúa si Desktop se reincorpora. No siempre puede reincorporarse, por ejemplo después de algunas actualizaciones de Desktop, así que actualiza antes de una tarea larga.

​

Elegir dónde van los worktrees de las sesiones SSH

1. Worktree folder en la conexión SSH
2. worktree.location en ~/.claude/settings.json en la máquina remota
3. <project-root>/.claude/worktrees/, el valor predeterminado

​

Archivos y procesos en la máquina remota

• Programa auxiliar: uno o más procesos server por cada computadora que se conecta
• Claude Code: los procesos que el programa auxiliar inicia para las sesiones del usuario, cada uno desde un archivo con el nombre de su versión, como 2.1.295-…

​

Conexiones que se cierran antes del inicio de sesión

drop connection #0 from [203.0.113.7]:51234 on [192.0.2.10]:22 penalty: connections without attempting authentication

• Una línea filter que indica un modo entre corchetes, como filter = sshd[mode=aggressive]: usa ese modo.
• Solo la línea filter de serie, con [mode=%(mode)s]: usa la línea mode, o normal si no hay ninguna.

fail2ban-regex -o ip lines.log "sshd[mode=aggressive]"

• mode: establécelo en normal dondequiera que tu jail lo defina, en una línea mode o entre los corchetes de una línea como filter = sshd[mode=aggressive]. Renuncias a todos los conteos que solo hacen los otros modos, por ejemplo de clientes que se conectan y se van sin intentar iniciar sesión.
• ignoreip: establécelo con las direcciones desde las que se conectan las personas, por ejemplo ignoreip = 203.0.113.7. fail2ban no cuenta entonces nada de esas direcciones, incluidos los inicios de sesión fallidos.

​

Usar servidores MCP configurados en la máquina remota

​

Abrir una sesión SSH desde un enlace

claude://code/new?ssh_host=dev%40build.example.com&ssh_port=2222&ssh_folder=/srv/payments&q=Investigate%20the%20failed%20deploy

• Una conexión que ya tienes: si el host, el usuario y el puerto coinciden con una de tus conexiones, Desktop te pregunta si quieres usarla y te muestra el nombre y el host de la conexión, y la carpeta si el enlace indica una.
• Una conexión nueva: de lo contrario, Desktop abre el diálogo para agregar una conexión SSH. Cuando agregas la conexión, Desktop te pregunta si quieres conectarte antes de guardar nada y te muestra el host del enlace, y el puerto y la carpeta si el enlace los indica.

• Antes de confirmar: revisa el host y la carpeta.
• Antes de enviar: revisa el prompt y el entorno seleccionado.

• Cerraste sesión: inicia sesión y luego vuelve a abrir el enlace.
• Hay otro diálogo abierto: ciérralo y luego vuelve a abrir el enlace.
• El enlace no es válido: Desktop muestra un mensaje que indica qué corregir y no completa el prompt.
• Desktop es anterior a v2.110.0: las versiones anteriores ignoran los parámetros SSH y abren la página de nueva sesión solo con el prompt.
• Las sesiones SSH están desactivadas: si tu administrador establece la lista de permitidos en una matriz vacía, Desktop rechaza los enlaces SSH.

​

Crear una conexión SSH a partir de un comando

{
  "sshHostCommands": [
    {
      "id": "devbox",
      "name": "Dev box",
      "command": "acme-dev create",
      "startDirectory": "~/project"
    }
  ]
}

• Programa: escribe su nombre, o su ruta completa desde /, sin espacios. Desktop busca un nombre simple en el PATH que exporta tu shell de inicio de sesión. Las rutas relativas como ./acme-dev, las rutas que comienzan con ~ y los alias y funciones del shell no funcionan.
• Argumentos: separa los argumentos simples con espacios. El comando solo puede contener espacios, letras ASCII, dígitos y los caracteres +,-./:=@_~, y ninguna palabra puede comenzar con ~.
• Scripts: si el comando necesita algo más, como comillas, pipes, variables o una URL con ? o &, colócalo en un script. Haz que el script sea ejecutable, comiénzalo con una línea #! y establece command en su ruta completa, como /Users/you/bin/make-devbox. En macOS, mantén el script fuera de las carpetas Documentos, Escritorio y Descargas, donde macOS puede bloquearlo.
• Entrada: el programa no recibe entrada ni terminal, así que no puede pedirte nada allí. Si tu herramienta te hace iniciar sesión a través de un navegador o un prompt, inicia sesión primero desde una terminal, y de nuevo cada vez que ese inicio de sesión caduque.
• Entorno: el programa se ejecuta en tu directorio home con las variables que exporta tu shell de inicio de sesión. Desktop las lee al iniciarse, como lo hace para un ProxyCommand, así que cierra y vuelve a abrir Desktop después de cambiarlas.
• Límite de tiempo: Desktop detiene un programa que sigue en ejecución después de 10 minutos. El mensaje de progreso de Desktop no muestra la salida del programa. Para detener el programa antes, selecciona Cancel junto a ese mensaje.

• Una línea: host o user@host, escrito como para ssh_host en un enlace SSH. Para indicar un puerto, usa la forma JSON.
• Un objeto JSON: sshHost y, opcionalmente, un sshPort numérico y un startDirectory que reemplaza el de la entrada, como {"sshHost": "dev@devbox-1234.example.com", "sshPort": 2222}

acme-dev create < /dev/null > host.txt

#!/bin/bash
out=$(mktemp) || exit
trap 'rm -f "$out"' EXIT
acme-dev create > "$out" || exit
tail -n 1 "$out"

• Clave del host: con la comprobación de claves de host predeterminada de OpenSSH, revisa la huella digital de la clave y luego elige si quieres conectarte. Para omitir la pregunta, haz que tu comando agregue la clave a ~/.ssh/known_hosts antes de imprimir el host, usando una clave que tu herramienta obtuvo al crear la máquina. Para un puerto distinto de 22, esa línea comienza con [host]:port. Si tu herramienta reutiliza nombres de host, elimina también la línea de la clave anterior.
• Carpeta: elige si confías en la carpeta que abres allí

• Tú, tu comando u otro programa agregaron la nueva clave a known_hosts o eliminaron la línea de la clave anterior, como hace tu comando si agrega claves de host
• Las máquinas de tu herramienta comparten una clave de host
• Las máquinas de tu herramienta comparten una autoridad de certificación en la que confía known_hosts
• Tú o tu administrador establecieron KnownHostsCommand o VerifyHostKeyDNS yes, de modo que SSH acepta claves de fuera de known_hosts

• Sesiones en máquinas anteriores: continúalas desde la barra lateral, porque el selector muestra la máquina actual de Dev box y no las anteriores. Desktop puede conectarse a sus máquinas por sí solo, por ejemplo cuando Desktop se inicia, así que deja de usar una máquina cuando termines con ella.
• Un host reemplazado antes de Claude Desktop v4.4212.0: esas versiones muestran Replace Dev box’s host y dejan de conectarse al host reemplazado. Para continuar una sesión en ese host, abre la sesión, selecciona Add SSH connection y guarda la conexión que completa Desktop. Actualiza Desktop antes de reemplazar otro host.
• Sesiones nuevas en dos máquinas: agrega una segunda entrada a sshHostCommands
• Un host nuevo que aún no responde: deja abierta la página de nueva sesión hasta 10 minutos mientras sigue intentando conectarse. Si el host sigue sin responder, selecciona Create another Dev box en el mensaje de la página.
• Otra máquina poco después: después de varias ejecuciones del comando en una hora, confirma cada ejecución adicional en el diálogo que abre Desktop, que muestra el comando

1. Busca las sesiones de la máquina en la barra lateral. El panel de detalles de una sesión muestra el host en el que se ejecuta.
2. Archiva cada sesión y déjala archivada.
3. Si no has creado otra máquina a partir de la misma entrada de sshHostCommands desde que creaste esta, crea una o elimina la entrada también. Hasta entonces, la máquina es la conexión guardada de la entrada, y Desktop puede conectarse a ella cuando abres la página de nueva sesión con esa conexión seleccionada.
4. Elimina en la app cualquier otra conexión SSH a la máquina, o elimina su entrada de sshConfigs.
5. Cierra y vuelve a abrir Desktop, lo que cierra su conexión a la máquina y termina sus intentos de llegar a ella.
6. Elimina la máquina con tu herramienta.

{
  "sshHostCommands": [
    {
      "id": "acme-devbox",
      "name": "Dev box",
      "command": "/usr/local/bin/acme-dev create"
    }
  ],
  "strictPluginOnlyCustomization": ["hooks"]
}

• Dónde poner la clave: si tu política MDM para Claude Code ya establece una clave de política, colócala allí. De lo contrario, colócala en el archivo de configuración administrada. De forma predeterminada, una política así tiene prioridad sobre el archivo, y Desktop ignora entonces las entradas del archivo. Establécela en la computadora incluso donde se aplique la configuración administrada por el servidor: Desktop ignora la clave allí, así como en la configuración de proyecto y local.
• El id: si la entrada de sshHostCommands de un usuario tiene tu id, solo funciona la tuya. Si cualquier otra conexión SSH lo tiene, como una en los sshConfigs de un usuario, tu entrada aparece en gris. Elige un id que sea poco probable que los usuarios elijan.
• El programa: indica su ruta completa, porque Desktop busca un nombre simple en el propio PATH de cada usuario. El programa se ejecuta como el usuario, con las variables que exporta su shell de inicio de sesión.
• Las entradas propias de los usuarios: Desktop trata la entrada de un usuario como un hook, porque ambos ejecutan un programa en la computadora. Para permitir solo tus entradas, establece strictPluginOnlyCustomization en ["hooks"], o agrega "hooks" a su lista. También bloqueas los hooks de Claude Code de la configuración de usuario, de proyecto y local, sin forma de conservarlos. Si en cambio estableces esa clave o allowManagedHooksOnly en true, bloqueas más cosas, como se indica en la entrada de cada clave.
• Todas las entradas: para desactivar también tus entradas, establece disableAllHooks en la configuración administrada. Si estableces disableDesktopLocalSessions, o una sshHostAllowlist que no permite ningún host, el selector no muestra ningún elemento Create ni Create another.
• Dónde cuentan los bloqueos: para estas entradas, Desktop lee allowManagedHooksOnly, strictPluginOnlyCustomization y disableAllHooks de la configuración administrada por el servidor y del propio archivo o política de la computadora, y aplica el resultado más estricto. Todas las entradas permanecen en gris hasta que Desktop haya consultado claude.ai para obtener la configuración administrada por el servidor, incluso si tu organización no tiene ninguna.
• Hosts permitidos: si estableces sshHostAllowlist, asegúrate de que un patrón coincida con cada nombre de host que imprime tu herramienta, y omite user@ del patrón. Desktop comprueba el nombre impreso solo después de que se ejecuta el comando, así que una máquina que la lista rechaza ya existe, y el usuario tiene que eliminarla con tu herramienta. En cada conexión, el HostName resuelto también tiene que coincidir.

• El archivo: ~/.claude/settings.json tiene JSON no válido o un valor que el esquema rechaza, escribiste mal la clave o la pusiste en la configuración de un proyecto. Corrige el archivo.
• Plataforma y cuenta: usas Windows, o un proveedor externo en lugar de una cuenta de Claude. Agrega tú mismo cada host como una conexión SSH.
• La configuración de tu organización: tu administrador desactivó las sesiones locales o las sesiones SSH. Pregúntale si puedes usar comandos.
• No hay programa ssh: Desktop no pudo iniciar el cliente OpenSSH en tu computadora. Instálalo, o pide a tu administrador que lo permita, y luego reinicia Desktop.

• Un error en la entrada: corrige el campo o el comando que indica el mensaje. Si el id está en uso, dale otro a la entrada.
• Un archivo de configuración dañado: mientras tu propio archivo de configuración esté dañado, las entradas de tu administrador pueden aparecer en gris, con un mensaje que indica el archivo. Corrige el archivo.
• Un host nuevo: Create another aparece en gris durante un minuto después de que Desktop guarda un host. Selecciónalo pasado ese minuto. Antes de Claude Desktop v4.4212.0, Replace Dev box’s host aparece en gris durante 10 minutos.
• Los hooks están desactivados o restringidos: tus propias entradas solo funcionan donde pueden ejecutarse tus propios hooks. Elimina disableAllHooks de tu configuración, o consulta a tu administrador.
• La configuración todavía se está cargando: todas las entradas aparecen en gris hasta que Desktop haya cargado la configuración administrada por el servidor de tu organización, normalmente unos segundos después del inicio. Si las entradas siguen en gris, revisa tu conexión a claude.ai.

​

Pre-configurar conexiones SSH para su equipo

• Lo que ven los usuarios: las conexiones definidas de esta forma aparecen automáticamente en el selector de entorno de cada usuario.
• Lo que pueden cambiar los usuarios: los usuarios pueden seleccionar una conexión administrada y establecer su propia Worktree folder para ella. No pueden editar sus demás campos ni eliminarla en la aplicación.

{
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "user@dev.example.com",
      "sshPort": 22,
      "sshIdentityFile": "~/.ssh/id_ed25519"
    }
  ]
}

​

Restringir a qué hosts SSH pueden conectarse los usuarios

{
  "sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"]
}

SSH host "bastion.example.com" is not allowed by your organization's managed settings. It is a jump host on the way to "devbox".

​

Desactivar las sesiones locales y distribuir conexiones SSH

{
  "disableDesktopLocalSessions": true,
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "dev.example.com"
    }
  ],
  "sshHostAllowlist": ["dev.example.com"]
}

• La CLI: ninguna de las claves impide que un desarrollador ejecute la CLI de Claude Code en su propia computadora
• Cowork: ninguna de las claves se aplica a las sesiones de Cowork ni a las tareas programadas de Cowork
• Sesiones en la nube: ninguna de las claves cambia si las sesiones en la nube están disponibles. Para desactivarlas, usa el ajuste Cloud sessions en Admin console controls.

• Nombres de host: asegúrate de que un patrón en sshHostAllowlist coincida con el nombre de host de cada entrada de sshConfigs, sin user@, o los desarrolladores no podrán conectarse a ella. Agrega también un patrón que coincida con cada jump host que Desktop comprueba en el camino hacia ella. Para saber cómo Desktop hace coincidir un nombre de host, consulta Restringir a qué hosts SSH pueden conectarse los usuarios.
• Versión: disableDesktopLocalSessions requiere Claude Desktop v1.37937.0 o posterior
• Permisos del archivo: asegúrate de que la cuenta de cada desarrollador en la computadora pueda leer el archivo de configuración administrada. Desktop no aplica las claves de un archivo que la cuenta no puede leer, y Claude Code también se inicia sin ellas.

​

Configuración empresarial

​

Controles de consola de administración

• Desktop: controla si los usuarios de tu organización pueden acceder a Claude Code en la aplicación de escritorio
• Cloud sessions: habilita o deshabilita las sesiones en la nube para tu organización
• Remote Control: habilita o deshabilita Remote Control para tu organización

​

Configuración administrada

• Sesiones locales en esta máquina: se aplica un archivo de configuración administrada desplegado en disco. La configuración administrada enviada de forma remota a través de la consola de administración también llega a estas sesiones en la API de Anthropic cuando la sesión se autentica con un inicio de sesión elegible, siguiendo la misma precedencia de configuración que la CLI de la terminal.
• Sesiones en la nube: reciben configuración administrada por servidor; los archivos desplegados en dispositivos no llegan a ellas, porque se ejecutan en máquinas virtuales administradas por Anthropic. Las sesiones enrutadas a un entorno autohospedado también leen el archivo de configuración administrada en la imagen del ejecutor. Cómo Claude Code combina fuentes administradas indica cuándo se aplica ese archivo.
• Sesiones SSH: la sesión lee el archivo de configuración administrada desde el host remoto. Desktop mismo lee sshConfigs, sshHostAllowlist, disableSshSavedPasswords y disableDesktopLocalSessions en la máquina local. Si entregas más de una fuente administrada, los lee desde una sola de forma predeterminada.
• Sesiones de Cowork: en una sesión de Cowork en esta máquina, Claude Code nunca obtiene la configuración de la consola de administración, incluso cuando el usuario inicia sesión con una cuenta de Team o Enterprise, y lee la política desplegada en la máquina a menos que tu configuración de Claude Desktop establezca requireCoworkFullVmSandbox. Las sesiones remotas de Cowork no reciben ninguna de las dos. Consulta dónde y cuándo se aplica una política para saber qué archivos de dispositivo llegan a Cowork, y reglas de permisos de MCP para saber cómo se aplican las reglas de Bash y WebFetch a las herramientas de Cowork.

​

Políticas de gestión de dispositivos

• macOS: configura a través del dominio de preferencias com.anthropic.claudefordesktop usando herramientas como Jamf o Kandji
• Windows: configura a través del registro en SOFTWARE\Policies\Claude
• Linux: configura a través de un archivo propiedad de root en /etc/claude-desktop/managed-settings.json, que contiene las claves de políticas como un objeto JSON. Desktop rechaza el archivo si alguien que no sea root puede escribir en él o en su carpeta. Es un archivo distinto del archivo de configuración administrada de Claude Code.

​

Restringir el inicio de sesión a tu organización

{
  "forceLoginOrgUUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

​

Requisitos de acceso a la red

anthropic.com
*.anthropic.com
claude.ai
*.claude.ai
claude.com
*.claude.com
claude.app
*.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

anthropic.com
api.anthropic.com
a-api.anthropic.com
a-cdn.anthropic.com
s-cdn.anthropic.com
assets-proxy.anthropic.com
claude.ai
a.claude.ai
assets.claude.ai
downloads.claude.ai
*.livepreview.claude.ai
claude.com
platform.claude.com
sso.claude.com
*.livepreview.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

​

Autenticación y SSO

​

Manejo de datos

​

Despliegue

• macOS: distribúyelo a través de MDM como Jamf o Kandji usando el instalador .dmg
• Windows: despliégalo a través del paquete MSIX. Consulta Deploy Claude Desktop for Windows para ver opciones de despliegue empresarial, incluida la instalación silenciosa

​

¿Vienes de la CLI?

claude --desktop --resume <session-id>

1. Cierra la sesión en la terminal.
2. En el cuadro del prompt de Desktop, escribe /resume. Desktop enumera las sesiones que iniciaste desde la CLI en esta computadora. Busca por título, carpeta o rama, y obtén una vista previa de dónde quedó cada una.
3. Selecciona la sesión. Continuará en la aplicación con su conversación completa y contexto.

​

Equivalentes de banderas de CLI

​

Configuración compartida

• Los archivos CLAUDE.md y CLAUDE.local.md en tu proyecto son utilizados por ambos
• Los servidores MCP configurados en ~/.claude.json o .mcp.json funcionan en ambos
• Los Hooks y skills definidos en la configuración se aplican a ambos
• La Configuración en ~/.claude.json y ~/.claude/settings.json se comparte. Las reglas de permisos, herramientas permitidas y otros ajustes en settings.json se aplican a sesiones de Desktop.
• Modelos: los mismos modelos están disponibles en ambos. En Desktop, selecciona el modelo en el selector de modelo de la fila debajo del cuadro del prompt. Puedes cambiar el modelo durante la sesión desde el mismo selector.

​

Servidores MCP de la aplicación de chat de Claude Desktop

​

Comparación de características

​

Lo que no está disponible en Desktop

• Proveedores de terceros: Desktop se conecta a la API de Anthropic de forma predeterminada. Para enrutar Desktop a través de un gateway, o para ejecutar la pestaña Code en Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry o un gateway LLM autohospedado, sigue los enlaces en la fila Proveedores de terceros.
• Linux (beta): Computer Use aún no está disponible en la aplicación de escritorio para Linux. Consulta Claude Desktop en Linux.
• Sugerencias de código en línea: Desktop no ofrece completados de código de estilo autocompletado. Funciona a través de prompts conversacionales y cambios de código explícitos, y puede sugerir tu próximo prompt después de que Claude responde.
• Equipos de agentes: los equipos coordinados, donde Claude como líder del equipo asigna tareas a compañeros de equipo desde una lista de tareas compartida, están disponibles en la CLI, no en Desktop. Para trabajo multiagente dentro de una sesión, usa flujos de trabajo dinámicos, que se ejecutan en Desktop; Claude también puede enviar mensajes y gestionar tus otras sesiones directamente.
• Comandos de diálogo de terminal: los comandos integrados que abren un panel interactivo en la terminal se comportan de manera diferente en la pestaña Code. Edita los archivos de configuración directamente para gestionar reglas de permisos y configuración, o ejecuta los comandos desde la CLI independiente.
  • Los comandos sin forma de argumento, como /permissions, responden con isn't available in this environment.
  • /config abre Configuración > Code o Configuración > Claude Code.

​

Solución de problemas

​

Verificar su versión

• macOS: haga clic en Claude en la barra de menú, luego About Claude
• Windows: haz clic en Help, luego en About Claude

​

Versión de Claude Code en la pestaña Code

​

Verificar qué diseño tienes

• Desktop anterior a v2.37337.0: actualiza para obtener el diseño actual. Selecciona Claude > Check for Updates… en macOS o Help > Check for Updates… en Windows.
• Proveedor externo con sesiones en tu computadora: el diseño actual requiere Claude Desktop v3.1623.0 o posterior, así que verifica tu versión. Para actualizar, selecciona Claude > Check for Updates… en macOS o Help > Check for Updates… en Windows. Si tu organización desactiva las actualizaciones automáticas, Check for Updates… está oculto, así que pide a tu administrador la v3.1623.0 o posterior.
• Proveedor externo con sesiones en la infraestructura de tu organización: el diseño actual requiere Claude Desktop v4.29.0 o posterior, así que verifica tu versión. Si tienes una versión anterior, pide a tu administrador la v4.29.0 o posterior. Si no sabes dónde se ejecutan tus sesiones, pregunta a tu administrador.

​

Errores 403 o de autenticación en la pestaña Code

1. Cierre sesión e inicie sesión nuevamente desde el menú de la aplicación. Esta es la solución más común.
2. Verifica que tengas una suscripción de pago activa: Pro, Max, Ultra, Team o Enterprise.
3. Si la CLI funciona pero Desktop no, cierre completamente la aplicación de escritorio, no solo cierre la ventana, luego reabrala e inicie sesión nuevamente.
4. Verifique su conexión a Internet y configuración de proxy.

​

Pantalla en blanco o atascada al iniciar

1. Reinicie la aplicación.
2. Verifique si hay actualizaciones pendientes. En macOS y Windows la aplicación se actualiza automáticamente al iniciar; en Linux, actualice a través de apt como se describe en Claude Desktop en Linux.
3. En una red administrada, confirme que su firewall permite los hosts de CDN en requisitos de acceso a la red.
4. En Windows, verifique Event Viewer para registros de bloqueo bajo Windows Logs → Application.

​

“Failed to load session”

​

La sesión no encuentra herramientas instaladas

​

Errores de Git y Git LFS

​

Los MCP servers no funcionan en Windows

​

SSH host key verification failed

• SSH host key verification failed o Host denied (verification failed) en View details de una tarjeta Couldn't connect to <host>
• Connection failed: Host key changed or not trusted junto al cuadro del prompt o después de Test connection
• <host>'s host key is not trusted o <host>'s host key has changed en una sesión desconectada

• Estás en Windows y Desktop dice Connection failed: Host key changed or not trusted: primero descarta que falte el cliente OpenSSH
• Desktop te indica que configures UserKnownHostsFile: en ~/.ssh/config, configúralo como ~/.ssh/known_hosts y luego verifica la clave desde una terminal
• Ves un botón Review new key: selecciónalo y compara la huella digital que muestra Desktop con la de la propia máquina. Si coinciden, selecciona Trust new key para reemplazar la clave guardada. De lo contrario, selecciona Cancel.
• No ves ningún botón Review new key, Desktop muestra Couldn't show the new key, o Desktop vuelve a rechazar la clave después de Trust new key: verifica la clave desde una terminal

​

Verificar la clave de host desde una terminal

• ssh pregunta si quieres continuar con la conexión: compara la huella digital que muestra con la de esa máquina. Responde yes solo si coinciden.
• ssh advierte que la clave de host cambió: compara la huella digital de la advertencia con la de esa máquina. Solo si coinciden, elimina la línea que indica Offending <type> key in <file>:<line> y vuelve a ejecutar ssh. Si ssh vuelve a advertir sobre otra línea, compara, elimina y vuelve a ejecutar como antes.
• ssh rechaza una clave que no conoce, sin preguntar: obtén la línea de known_hosts de esa máquina de quien la administra, no a través de la conexión que estás verificando. Agrega la línea a tu archivo known_hosts, con el nombre del mensaje de ssh como nombre de host, y vuelve a ejecutar ssh.
• ssh continúa con el inicio de sesión sin preguntarte por la clave de host: todavía no escribas ninguna contraseña. Verifica las claves en las que ssh ya confía.

• Un jump host no tiene una línea Server host key:: ejecuta también ssh -v -S none <jump host> y compara esa huella digital de la misma manera.
• Una huella digital no coincide, o no puedes verificarla: no vuelvas a conectarte. Elimina la clave guardada: debajo de Host '<name>' is known, la línea Found key in <file>:<line> nombra el archivo que la contiene. Ejecuta ssh-keygen -R "<name>" -f <file>. Si guardas claves de host en más de un archivo, elimina la clave de cada uno. Si no puedes modificar un archivo, avísale a quien administra tu computadora.
• Todas las huellas digitales coinciden: reintenta en Desktop. Si Desktop vuelve a rechazar la clave, consulta Obtener los registros de Desktop para un problema de SSH.

​

Clave de host SSH rechazada en Windows sin un cliente OpenSSH

​

La conexión SSH falla después de iniciar sesión

​

Obtener los registros de Desktop para un problema de SSH

• macOS: Show Logs in Finder
• Windows: Show Logs in File Explorer
• Linux: Show Logs in File Manager

​

La aplicación no se cierra

• macOS: presione Cmd+Q. Si la aplicación no responde, use Force Quit con Cmd+Option+Esc, seleccione Claude y haga clic en Force Quit.
• Windows: use Task Manager con Ctrl+Shift+Esc para finalizar el proceso de Claude.

​

Problemas específicos de Windows

• PATH no actualizado después de instalar: abra una nueva ventana de terminal. Las actualizaciones de PATH solo se aplican a nuevas sesiones de terminal.
• Error de instalación concurrente: si ve un error sobre otra instalación en progreso pero no la hay, intente ejecutar el instalador como Administrador.

​

“Branch doesn’t exist yet” al abrir en CLI

git fetch origin <branch-name>
git checkout <branch-name>

​

¿Aún atascado?

• Abra Help → Get Support en la aplicación de escritorio, o visite el centro de soporte de Claude directamente
• Para problemas que también se reproducen en la CLI independiente claude, busque o presente un error en GitHub Issues