desktop.md +32 −5
120 120
121> [!NOTE]121> [!NOTE]
122>122>
123123> En una [sesión SSH](#ssh-sessions), Claude no puede abrir tu aplicación en el panel del navegador, porque allí no tiene las herramientas del panel. Para ver la aplicación tú mismo, [reenvía su puerto a tu computadora](#reach-a-port-on-the-remote-machine).> En una [sesión SSH](#ssh-sessions), Claude no tiene las herramientas del panel del navegador, por lo que no puede abrir tu aplicación en el panel ni [verificar automáticamente](#auto-verify-changes) sus cambios. El menú **Dev servers** del panel y tus [servidores de vista previa configurados](#configure-preview-servers) tampoco están disponibles. Para ver la aplicación tú mismo, inicia su servidor en la máquina remota y luego [reenvía su puerto a tu computadora](#reach-a-port-on-the-remote-machine).
124 124
125Si el panel del navegador no está abierto después de que Claude inicia un servidor en una sesión local, haz clic en **Open** en la tarjeta del servidor en el chat.125Si el panel del navegador no está abierto después de que Claude inicia un servidor en una sesión local, haz clic en **Open** en la tarjeta del servidor en el chat.
126 126
1002* **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.1002* **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.
1003* **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](#files-and-processes-on-the-remote-machine).1003* **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](#files-and-processes-on-the-remote-machine).
1004* **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`1004* **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`
10051005* **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](https://code.claude.com/docs/es/network-config.md#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. En una máquina remota Linux, si esas solicitudes necesitan un proxy, [establécelo para las sesiones SSH](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions).* **Red**: Claude Code se ejecuta en la máquina remota y realiza sus solicitudes de red desde allí, así que la máquina necesita el [acceso a la red que requiere Claude Code](https://code.claude.com/docs/es/network-config.md#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. Si una máquina remota Linux necesita un proxy o un certificado de CA, [establécelo para las sesiones SSH](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions).
1006 1006
1007#### Comprobar la clave de host de una máquina remota1007#### Comprobar la clave de host de una máquina remota
1008 1008
1030 1030
1031Si una máquina remota Linux accede a internet a través de un proxy o necesita un certificado de CA, agrega las [variables de proxy y de CA](https://code.claude.com/docs/es/network-config.md) en `env` en el `~/.claude/settings.json` de esa máquina. Agrégalas incluso si ya las exportas en `~/.profile`, `~/.bash_profile`, `~/.zprofile` o `~/.zshrc` en esa máquina.1031Si una máquina remota Linux accede a internet a través de un proxy o necesita un certificado de CA, agrega las [variables de proxy y de CA](https://code.claude.com/docs/es/network-config.md) en `env` en el `~/.claude/settings.json` de esa máquina. Agrégalas incluso si ya las exportas en `~/.profile`, `~/.bash_profile`, `~/.zprofile` o `~/.zshrc` en esa máquina.
1032 1032
10331033En una sesión SSH, Claude Code no obtiene las variables de esos archivos, aunque `claude` en una terminal de esa máquina sí las obtenga. La sesión puede entonces quedarse colgada o mostrar **The connection from … to the API failed** o **Authentication failed**, y volver a iniciar sesión no ayuda.En una sesión SSH, Claude Code no obtiene las variables de esos archivos, aun cuando `claude` en una terminal de esa máquina sí las obtiene. La sesión puede entonces quedarse colgada, o mostrar **The connection from … to the API failed**, **Authentication failed** o **Claude Code on … couldn’t verify the API connection’s certificate**. Volver a iniciar sesión no ayuda.
1034 1034
1035**1. Agrega las variables**1035**1. Agrega las variables**
1036 1036
1948 1948
1949Para las claves de permisos, plugins y entrega que solo una fuente administrada puede establecer, consulta [Claves que solo la configuración administrada puede establecer](https://code.claude.com/docs/es/managed-settings.md#managed-only-settings).1949Para las claves de permisos, plugins y entrega que solo una fuente administrada puede establecer, consulta [Claves que solo la configuración administrada puede establecer](https://code.claude.com/docs/es/managed-settings.md#managed-only-settings).
1950 1950
1951#### Ajustes de Claude Code que se comportan de forma diferente en la pestaña Code
1952
1953En una sesión local, estas claves, entre otras, tienen un efecto diferente o ninguno visible, porque la pestaña Code reemplaza la interfaz de la terminal. Siguen aplicándose en la terminal, así que puedes dejarlas establecidas.
1954
1955| Clave | En una sesión local |
1956| - | - |
1957| `askUserQuestionTimeout` | el tiempo de espera no se aplica, por lo que una pregunta de Claude permanece abierta hasta que un usuario la responda |
1958| `awaySummaryEnabled` | la clave no tiene efecto |
1959| `bashEditDiffEnabled` | la pestaña Code no muestra la lista de archivos que cambió un comando de Bash |
1960| `companyAnnouncements` | la pestaña Code no muestra anuncios |
1961| `defaultShell` | los comandos que los usuarios escriben después de `!` se ejecutan en un shell que elige la aplicación: su shell de inicio de sesión en macOS y Linux, PowerShell en Windows |
1962| `fileSuggestion` | el selector de archivos `@` crea su propia lista de archivos y no ejecuta el comando que estableciste |
1963| `modelPicker` | el selector de modelos muestra los modelos disponibles para la cuenta de cada usuario. Para limitarlos, establece [`availableModels`](https://code.claude.com/docs/es/model-config#restrict-model-selection). |
1964| `pluginTrustMessage` | la advertencia que ven los usuarios cuando instalan un plugin no incluye el mensaje que estableciste |
1965| `prUrlTemplate` | los enlaces de pull request usan la URL propia del pull request, no la plantilla |
1966| `respectGitignore` | el selector de archivos `@` crea su propia lista de archivos y no lee esta clave |
1967| `respondToBashCommands` | Claude responde a la salida de los comandos que los usuarios ejecutan con `!`, sea cual sea el valor |
1968| `showClearContextOnPlanAccept` | los usuarios no obtienen una opción para borrar el contexto cuando aprueban un plan |
1969| `skipDangerousModePermissionPrompt` | la pestaña Code tiene su propia confirmación para el [modo Bypass permissions](#choose-a-permission-mode), y esta clave no la omite |
1970| `verbose`, `viewMode` | cada usuario elige la vista en [**Transcript view** en el menú de la sesión](#switch-view-modes) |
1971| `worktree.baseRef`, `worktree.sparsePaths`, `worktree.symlinkDirectories` | no se usan para el worktree que la pestaña Code crea para una sesión |
1972
1951### Políticas de gestión de dispositivos1973### Políticas de gestión de dispositivos
1952 1974
1953Los equipos de TI pueden gestionar la aplicación de escritorio a través de MDM en macOS, directivas de grupo en Windows o un archivo de políticas en Linux. Las políticas disponibles incluyen habilitar o deshabilitar la función Claude Code, controlar las actualizaciones automáticas en macOS y Windows, y establecer una URL de despliegue personalizada.1975Los equipos de TI pueden gestionar la aplicación de escritorio a través de MDM en macOS, directivas de grupo en Windows o un archivo de políticas en Linux. Las políticas disponibles incluyen habilitar o deshabilitar la función Claude Code, controlar las actualizaciones automáticas en macOS y Windows, y establecer una URL de despliegue personalizada.
2100* Los archivos **[CLAUDE.md](https://code.claude.com/docs/es/memory.md)** y `CLAUDE.local.md` en tu proyecto son utilizados por ambos2122* Los archivos **[CLAUDE.md](https://code.claude.com/docs/es/memory.md)** y `CLAUDE.local.md` en tu proyecto son utilizados por ambos
2101* Los **[servidores MCP](https://code.claude.com/docs/es/mcp.md)** configurados en `~/.claude.json` o `.mcp.json` funcionan en ambos2123* Los **[servidores MCP](https://code.claude.com/docs/es/mcp.md)** configurados en `~/.claude.json` o `.mcp.json` funcionan en ambos
2102* Los **[Hooks](https://code.claude.com/docs/es/hooks.md)** y **[skills](https://code.claude.com/docs/es/skills.md)** definidos en la configuración se aplican a ambos2124* Los **[Hooks](https://code.claude.com/docs/es/hooks.md)** y **[skills](https://code.claude.com/docs/es/skills.md)** definidos en la configuración se aplican a ambos
21032125* La **[Configuración](https://code.claude.com/docs/es/settings.md)** 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.* La **[Configuración](https://code.claude.com/docs/es/settings.md)** 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. Algunas claves [se comportan de manera diferente en la pestaña Code](#claude-code-settings-that-behave-differently-in-the-code-tab).
2104* **Modelos**: los mismos [modelos](https://code.claude.com/docs/es/model-config.md#available-models) 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.2126* **Modelos**: los mismos [modelos](https://code.claude.com/docs/es/model-config.md#available-models) 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.
2105 2127
2106#### Servidores MCP de la aplicación de chat de Claude Desktop2128#### Servidores MCP de la aplicación de chat de Claude Desktop
2281 2303
2282Revisa los archivos antes de enviarlos, porque pueden incluir nombres y otros detalles de tu entorno. `<host>` y `<user>` representan nombres que Desktop reemplazó. Desktop no reemplaza todos los nombres, y un nombre de host o de usuario SSH todavía puede aparecer tal como está escrito. Si envías el archivo zip a alguien, indícale qué host falló y cuándo, porque es posible que los registros no lo mencionen.2304Revisa los archivos antes de enviarlos, porque pueden incluir nombres y otros detalles de tu entorno. `<host>` y `<user>` representan nombres que Desktop reemplazó. Desktop no reemplaza todos los nombres, y un nombre de host o de usuario SSH todavía puede aparecer tal como está escrito. Si envías el archivo zip a alguien, indícale qué host falló y cuándo, porque es posible que los registros no lo mencionen.
2283 2305
22842306El archivo zip no contiene el registro del programa auxiliar que Desktop instala en la máquina remota. Para obtener también ese registro, copia `remote-server.log` desde la carpeta del programa auxiliar en [`~/.claude/remote/run/`](#files-and-processes-on-the-remote-machine), dentro del directorio home del usuario que se conectó. Revisa también ese archivo antes de enviarlo.El archivo zip no contiene el registro del programa auxiliar que Desktop instala en la máquina remota. Para obtener también ese registro, copia estos archivos desde la carpeta del programa auxiliar en [`~/.claude/remote/run/`](#files-and-processes-on-the-remote-machine), dentro del directorio home del usuario que se conectó:
2307
2308* **`remote-server.log`**: el registro de la ejecución más reciente del programa auxiliar.
2309* **`remote-server.log.old`**, si existe: el registro de la ejecución anterior. Cópialo lo antes posible, porque lo pierdes la próxima vez que Desktop se conecte y tenga que volver a iniciar el programa auxiliar.
2310
2311Revisa también esos archivos antes de enviarlos.
2285 2312
2286### La aplicación no se cierra2313### La aplicación no se cierra
2287 2314