Auto mode está disponible para todos los usuarios en la API de Anthropic y requiere Claude Opus 4.6 o posterior, Sonnet 4.6 o posterior, o un modelo Fable. Los administradores de la organización pueden desactivar auto mode con la clave disableAutoMode en configuración administrada.

En implementaciones empresariales que enrutan Desktop a Google Cloud's Agent Platform, auto mode también está disponible de forma predeterminada; consulte Auto mode en Bedrock, Agent Platform o Foundry para los modelos compatibles.

Las sesiones en la nube admiten Accept edits, Plan y Auto. Accept edits corresponde al modo default: las sesiones en la nube aceptan automáticamente ediciones de archivos, por lo que el selector muestra Accept edits en lugar de Manual. Bypass permissions no está disponible en sesiones en la nube, incluidas las sesiones en un entorno autohospedado.

Los administradores empresariales pueden restringir qué modos de permisos están disponibles. Consulte configuración empresarial para obtener detalles.

Vista previa de su aplicación

Claude puede iniciar un servidor de desarrollo y abrirlo en el panel del navegador para verificar sus cambios. Esto funciona tanto para aplicaciones web frontend como para servidores backend: Claude puede probar puntos finales de API, ver registros del servidor e iterar sobre problemas que encuentra. En la mayoría de los casos, Claude inicia el servidor automáticamente después de editar archivos del proyecto. También puede pedirle a Claude que haga una vista previa en cualquier momento. De forma predeterminada, Claude verifica automáticamente cambios después de cada edición.

El panel del navegador también puede abrir archivos HTML estáticos, PDF, imágenes y videos de su proyecto. Haga clic en una ruta HTML, PDF, imagen o video en el chat para abrirla allí.

Desde el panel del navegador, puede:

• Interactuar con su 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 problemas que encuentra
• Iniciar o detener servidores desde el menú desplegable de servidores en la barra de herramientas de la sesión
• Persistir cookies y almacenamiento local en reinicios del servidor seleccionando Persist sessions en el menú desplegable, para que no tenga que volver a iniciar sesión durante el desarrollo
• Editar la configuración del servidor o detener todos los servidores a la vez

Claude crea la configuración inicial del servidor basada en su proyecto. Si su aplicación usa un comando de desarrollo personalizado, edite .claude/launch.json para que coincida con su configuración. Consulte Configurar servidores de vista previa para la referencia completa.

Para borrar datos de sesión guardados, o para desactivar el navegador por completo, use los controles deslizantes en Configuración → Claude Code.

Examinar sitios externos

El panel del navegador es un navegador con pestañas, por lo que puede abrir documentación, rastreadores de problemas o cualquier otro sitio junto a su aplicación en ejecución. Para abrir el navegador, presione Cmd+Shift+B en macOS o Ctrl+Shift+B en Windows, o selecciónelo del menú Views. Cuando hace clic en un enlace externo en el chat, un selector ofrece Open in app para usar el panel del navegador u Default browser para usar el suyo propio; Cmd-clic en macOS o Ctrl-clic en Windows abre un enlace en su navegador del sistema directamente. Puede iniciar sesión en sitios en el panel, incluidos flujos de inicio de sesión emergentes como Google OAuth.

Claude puede leer e interactuar con páginas externas usando las mismas herramientas que usa para verificar su aplicación, con dos verificaciones de seguridad adicionales:

• 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. Estos son los mismos clasificadores que auto mode usa, y cuando marcan una acción, obtiene un aviso de permisos independientemente del modo.
• En modos de permisos distintos de Auto y Bypass permissions, una verificación de lista de permitidos de dominio también se aplica antes de que Claude navegue a un nuevo sitio.

Aprobar las acciones de Claude en un sitio

La primera vez que Claude actúa en un sitio externo, aparece una tarjeta de permisos y Claude espera su elección: Allow once, Always allow o Deny. Allow once aprueba la acción sin guardar nada. Always allow guarda la aprobación para ese sitio en su dispositivo, y puede revocarla en Configuración. Cada sitio necesita su propia aprobación, incluidos los subdominios. Sus servidores de desarrollo local y archivos de proyecto no necesitan aprobación, por lo que auto-verify sigue funcionando sin avisos.

Incluso en un sitio aprobado, Claude no comprará artículos, creará cuentas ni omitirá CAPTCHAs sin su entrada. Navegar en el panel del navegador usa el mismo modelo de seguridad que la extensión Claude en Chrome. Consulte Usar Claude en Chrome de forma segura para saber cómo Claude maneja sitios sensibles y acciones riesgosas.

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

El panel del navegador usa un perfil de navegador limpio, separado de su navegador personal, sin ninguno de sus inicios de sesión guardados o historial. Úselo para construir y probar su aplicación y para sitios que no necesitan su identidad. Cuando desee que Claude actúe como usted en sus sesiones iniciadas, use la extensión Claude en Chrome en su lugar, que comparte el estado de inicio de sesión de su navegador.

Restringir la navegación externa para su organización

El navegador sigue los mismos controles de lista de permitidos y lista de bloqueos de sitios que la extensión Claude en Chrome. Si su organización ya configuró esas listas para la extensión, el navegador las respeta automáticamente. Los administradores también pueden desactivar las herramientas de Claude en páginas externas con la configuración administrada browserExternalPageTools. Con las herramientas desactivadas, los usuarios aún pueden navegar a sitios externos; las herramientas de Claude no pueden leerlos ni actuar sobre ellos.

Para desactivar la navegación externa por completo, establezca la configuración administrada disableBrowserExternalNavigation en true. Esto bloquea toda la navegación externa en el navegador, incluidos los sitios en la lista de permitidos de su organización; los servidores de desarrollo localhost y las vistas previas de archivos siguen funcionando. Use browserExternalPageTools para permitir que los usuarios sigan navegando por sitios externos sin las herramientas de Claude, y disableBrowserExternalNavigation para bloquear sitios externos tanto para usuarios como para Claude.

Revisar cambios con vista de diferencias

Después de que Claude realiza cambios en su código, la vista de diferencias le permite revisar modificaciones archivo por archivo antes de crear una solicitud de extracción.

Cuando Claude cambia archivos, aparece un indicador de estadísticas de diferencias que muestra el número de líneas agregadas y eliminadas, como +12 -1. Haga clic en este indicador para abrir el visor de diferencias, que muestra una lista de archivos a la izquierda y los cambios para cada archivo a la derecha.

Para comentar en líneas específicas, haga clic en cualquier línea en la diferencia para abrir un cuadro de comentarios. Escriba su comentario y presione Enter para agregar el comentario. Después de agregar comentarios a varias líneas, envíe todos los comentarios a la vez:

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

Claude lee sus comentarios y realiza los cambios solicitados, que aparecen como una nueva diferencia que puede revisar.

Revisar su código

En la vista de diferencias, haga clic en Review code en la barra de herramientas superior derecha para pedirle a Claude que evalúe los cambios antes de confirmar. Claude examina las diferencias actuales y deja comentarios directamente en la vista de diferencias. Puede responder a cualquier comentario o pedirle a Claude que revise.

La revisión se enfoca en problemas de alta señal: errores de compilación, errores de lógica definitivos, vulnerabilidades de seguridad y errores obvios. No marca estilo, formato, problemas preexistentes o nada que un linter detectaría.

Monitorear el estado de la solicitud de extracción

Después de abrir una solicitud de extracción, aparece una barra de estado de CI en la sesión. Claude Code usa la CLI de GitHub para sondear resultados de verificación y mostrar fallas.

• Auto-fix: cuando está habilitado, Claude intenta automáticamente corregir verificaciones de CI fallidas leyendo la salida de falla e iterando.
• Auto-merge: cuando está habilitado, Claude fusiona el PR una vez que todas las verificaciones pasan. El método de fusión es squash. Habilite auto-merge en su configuración de repositorio de GitHub primero; sin esto, Claude no puede fusionar el PR.

Use los controles deslizantes Auto-fix y Auto-merge en la barra de estado de CI para habilitar cualquiera de las opciones. Claude Code también envía una notificación de escritorio cuando CI finaliza. Para archivar la sesión automáticamente una vez que el PR se fusiona o cierra, active auto-archive en Configuración → Claude Code.

Organizar su espacio de trabajo

La pestaña Code está construida alrededor de paneles que puede organizar en cualquier diseño: chat, diff, navegador, terminal, archivo, plan, tareas y subagente, junto con el iOS Simulator en macOS. Arrastre un panel por su encabezado para reposicionarlo, o arrastre un borde de panel para redimensionarlo. Presione Cmd+\ en macOS o Ctrl+\ en Windows para cerrar el panel enfocado. Abra paneles adicionales desde el menú Views en la barra de herramientas de la sesión.

Para trabajar en múltiples pantallas, extraiga un panel como el diff o terminal en su propia ventana, y acóplelo de nuevo cuando haya terminado. Claude continúa trabajando en la ventana principal.

Ejecutar comandos en la terminal

La terminal integrada le permite ejecutar comandos junto a su sesión sin cambiar a otra aplicación. Ábrala desde el menú Views o presione Ctrl+` en macOS o Windows. La terminal se abre en el directorio de trabajo de su 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, haga clic en + en el encabezado del panel de terminal o haga clic con el botón derecho en una carpeta en el chat para elegir Open in terminal. La terminal está disponible solo en sesiones locales.

Abrir y editar archivos

Haga clic en una ruta de archivo en el chat o visor de diferencias para abrirlo en el panel de archivos. Las rutas HTML, PDF, imagen y vídeo se abren en el panel de navegador en su lugar. Realice ediciones puntuales y haga clic en Save para escribirlas de vuelta. Si el archivo cambió en el disco desde que lo abrió, el panel le advierte y le permite anular o descartar. Haga clic en Discard para revertir sus ediciones, o haga clic en la ruta en el encabezado del panel para copiar la ruta absoluta.

El panel de archivos está disponible en sesiones locales y SSH. Para sesiones remotas, pídale a Claude que realice el cambio.

Abrir archivos en otras aplicaciones

Haga clic con el botón derecho en cualquier ruta de archivo en el chat, visor de diferencias o panel de archivos para abrir un menú contextual:

• Attach as context: agregue el archivo a su siguiente solicitud
• Open in: abra el archivo en un editor instalado como VS Code, Cursor o Zed
• Show in Finder en macOS, Show in Explorer en Windows: abra la carpeta contenedora
• Copy path: copie la ruta absoluta a su portapapeles

Cambiar modos de vista

Los modos de vista controlan cuánto detalle aparece en la transcripción del chat. Cambie de modo desde el menú desplegable Transcript view junto al botón de envío, o presione Ctrl+O en macOS o Windows para ciclar a través de ellos. El modo Thinking aparece en el menú desplegable solo después de que Claude ha producido pensamiento en la sesión que está viendo.

Use Thinking para seguir el razonamiento de Claude con llamadas de herramientas aún contraídas. Use Verbose cuando depure por qué Claude tomó una acción particular. Las versiones de Claude Desktop anteriores a 1.46388.1 también enumeran un modo Summary, y una sesión aún configurada en Summary se abre en Normal una vez que actualiza.

Atajos de teclado

Presione Cmd+/ en macOS o Ctrl+/ en Windows para ver todos los atajos disponibles en la pestaña Code. En Windows, use Ctrl en lugar de Cmd para los atajos a continuación. El ciclismo de sesiones, el alternador de terminal y el alternador de modo de vista usan Ctrl en todas las plataformas.

Estos atajos se aplican solo a la pestaña Code. Los atajos de modo interactivo basados en terminal, como Shift+Tab para ciclar modos, no se aplican en Desktop.

Verificar uso

Haga clic en el anillo de uso junto al selector de modelo para ver su uso actual de la ventana de contexto y su uso del plan para el período. El uso de contexto es por sesión; el uso del plan se comparte en todas sus superficies de Claude Code.

Permitir que Claude use su computadora

El uso de computadora permite que Claude abra sus aplicaciones, controle su pantalla y trabaje directamente en su máquina de la manera que lo haría. Pídale a Claude que interactúe con una herramienta de escritorio que no tiene CLI, o automatice algo que solo funciona a través de una GUI. Para ejecutar y probar aplicaciones iOS, Desktop abre el panel dedicado iOS Simulator en lugar de controlar su pantalla; el panel funciona sin habilitar el uso de computadora.

El uso de computadora está deshabilitado de forma predeterminada. Habilítelo en Configuración antes de que Claude pueda controlar su pantalla. En macOS, también necesita otorgar permisos de Accesibilidad y Grabación de pantalla.

En macOS, el uso de computadora también puede ejecutarse en segundo plano: Claude trabaja en las aplicaciones que ha aprobado mientras usted continúa trabajando.

Cuándo se aplica el uso de computadora

Claude tiene varias formas de interactuar con una aplicación o servicio, y el uso de computadora es la más amplia y lenta. Intenta la herramienta más precisa primero:

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

Los niveles de acceso por aplicación refuerzan esto: los navegadores están limitados a solo lectura, y las terminales e IDE a solo clic, dirigiendo a Claude hacia la herramienta dedicada incluso cuando el uso de computadora está activo. El control de pantalla se reserva para cosas que nada más puede alcanzar, como aplicaciones nativas, paneles de control de hardware, o herramientas propietarias sin una API.

Habilitar el uso de computadora

El uso de computadora está deshabilitado de forma predeterminada. Si le pide a Claude que haga algo que lo necesita mientras está deshabilitado, Claude le dice que podría hacer la tarea si habilita el uso de computadora en Configuración.

Permisos de aplicación

La primera vez que Claude necesita usar una aplicación, aparece un aviso en su sesión. Haga clic en Allow for this session o Deny. Las aprobaciones duran para la sesión actual, o 30 minutos en sesiones generadas por Dispatch.

El aviso también muestra qué nivel de control obtiene Claude para esa aplicación. Estos niveles se fijan por categoría de aplicación y no se pueden cambiar:

Las aplicaciones con amplio alcance como terminales, Finder o File Explorer y Configuración del Sistema o Settings muestran una advertencia adicional en el aviso para que sepa qué aprobación les otorga.

Puede configurar dos configuraciones en Configuración > General (bajo Aplicación de escritorio):

• 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

Cada sesión es una conversación independiente con su propio contexto y cambios. Puede ejecutar múltiples sesiones en paralelo, ramificar chats laterales, permitir que Claude verifique y envíe mensajes a sus otras sesiones, enviar trabajo a la nube o permitir que Dispatch inicie sesiones para usted desde su teléfono.

Trabajar en paralelo con sesiones

Haga clic en + New session en la barra lateral, o presione Cmd+N en macOS o Ctrl+N en Windows, para trabajar en múltiples tareas en paralelo. Presione Ctrl+Tab y Ctrl+Shift+Tab para ciclar a través de sesiones en la barra lateral. Para repositorios de Git, seleccione la opción worktree junto al nombre de la rama para dar a la sesión su propia copia aislada de su proyecto usando Git worktrees, por lo que los cambios en una sesión no afectan otras sesiones hasta que los confirme.

Para ver dos sesiones a la vez, mantenga presionado Cmd en macOS o Ctrl en Windows y haga clic en una sesión en la barra lateral. La sesión se abre en un segundo panel junto al que ya tiene abierto. Mientras la división está activa, hacer clic en otra sesión de la barra lateral reemplaza el panel que tenga el foco. Presione Cmd+\ en macOS o Ctrl+\ en Windows para cerrar el panel enfocado y volver a una única sesión.

Los worktrees se almacenan en <project-root>/.claude/worktrees/ de forma predeterminada. Puede cambiar esto a un directorio personalizado en Configuración → Claude Code bajo "Worktree location". También puede establecer un prefijo de rama que se antepone a cada nombre de rama de worktree, lo que es útil para mantener las ramas creadas por Claude organizadas. Para eliminar un worktree cuando haya terminado, pase el cursor sobre la sesión en la barra lateral y haga clic en el icono de archivo. Para que las sesiones se archiven automáticamente cuando su solicitud de extracción se fusiona o cierra, active Auto-archive after PR merge or close en Configuración → Claude Code. Auto-archive solo se aplica a sesiones locales que han terminado de ejecutarse.

Para incluir archivos ignorados por git como .env en nuevos worktrees, cree un archivo .worktreeinclude en la raíz de su proyecto.

Use los controles en la parte superior de la barra lateral para filtrar sesiones por estado, proyecto o entorno, y para agrupar sesiones por proyecto. Para renombrar una sesión, haga clic en el título de la sesión en la barra de herramientas en la parte superior de la sesión activa.

Para verificar el uso del contexto, consulte Verificar uso. Cuando el contexto se llena, Claude resume automáticamente la conversación y continúa trabajando. También puede escribir /compact para activar la compresión antes y liberar espacio de contexto. Consulte la ventana de contexto para obtener detalles sobre cómo funciona la compresión.

La aplicación de escritorio envía una notificación del sistema operativo cuando una sesión de Code termina una tarea y usted no está viendo actualmente esa sesión. Para sesiones que pertenecen a un proyecto, obtiene las notificaciones del proyecto en su lugar.

Hacer una pregunta lateral sin descarrilar la sesión

Un chat lateral le permite hacer una pregunta a Claude que usa el contexto de su sesión pero no agrega nada de vuelta a la conversación principal. Úselo cuando desee entender un fragmento de código, verificar una suposición o explorar una idea sin dirigir la sesión fuera de curso.

Presione Cmd+; en macOS o Ctrl+; en Windows para abrir un chat lateral, o escriba /btw en el cuadro de solicitud. El chat lateral puede leer todo en el hilo principal hasta ese punto. Cuando haya terminado, cierre el chat lateral y continúe la sesión principal donde la dejó.

Los chats laterales están disponibles en sesiones locales, SSH y WSL. La aplicación de escritorio no guarda chats laterales en disco, por lo que no puede volver a uno después de cerrar la aplicación.

Ver tareas en segundo plano

El panel de tareas muestra el trabajo en segundo plano que se ejecuta dentro de la sesión actual: subagentes, comandos de shell en segundo plano y flujos de trabajo dinámicos. Ábralo desde el menú Views o arrástrelo a su diseño.

Haga clic en cualquier entrada para ver su salida en el panel de subagente o detenerla. Para ver qué están haciendo otras sesiones, use la barra lateral, o pida a Claude que las verifique por usted.

Trabajar entre sesiones

Claude puede enumerar sus otras sesiones de la pestaña Code, leer qué ha estado haciendo cada una y enviar mensajes entre ellas. Pregunte en lenguaje natural: "¿qué sesión tocó la refactorización de autenticación?", "¿a qué conclusión llegó la sesión de API?" o "dígale a la sesión de pagos que el esquema cambió". También puede pedir a Claude que renombre o archive una sesión. Claude archiva una sesión de la misma manera que lo hace el icono de archivo de la barra lateral, así que pídale que limpie sesiones cuyas solicitudes de extracción se han fusionado.

A través de esta superficie, Claude ve solo las sesiones que la aplicación de escritorio ejecuta por sí misma: sesiones locales, SSH y WSL en la pestaña Code. Claude no ve sesiones en la nube, o sesiones que inició desde la CLI del terminal o la extensión de VS Code, incluso en worktrees del mismo proyecto, así que con nueve worktrees de terminal abiertos y dos sesiones de escritorio, Claude respondiendo en una de ellas reporta la otra sesión de escritorio. Claude nunca enumera la sesión desde la que está preguntando. De forma predeterminada, ve las 20 sesiones más activas recientemente y omite sesiones archivadas a menos que las solicite. La mensajería entre sesiones permite por separado que Claude envíe mensajes a sus otras sesiones de Claude Code, incluidas sesiones de terminal.

Cuando Claude envía un mensaje a otra sesión a través de esta superficie, Claude Code lo muestra allí como una tarjeta etiquetada con el título de la sesión que envía y un enlace de vuelta, para que siempre pueda saber de dónde vino un mensaje. Si la sesión receptora está en medio de una tarea, Claude Code retiene el mensaje y Claude lo lee una vez que el trabajo actual termina. El Claude receptor puede responder, y Claude Code entrega la respuesta de vuelta a través de esta superficie. Claude no puede entregar a una sesión archivada y le dice cuándo un mensaje no se entrega.

Claude Code aplica cuatro comportamientos de seguridad entre sesiones:

• Antes de archivar cualquier sesión, Claude le pregunta primero. Usted ve la tarjeta de aprobación en cada modo de permiso, incluidos los permisos Auto y Bypass.
• A través de esta superficie, Claude no puede enviar mensajes entre sesiones desde una sesión que nadie está viendo, como una ejecución de tarea programada, y no puede entregar mensajes en una.
• 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 establece 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 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 aún sigue la configuración de permisos propia de la sesión receptora al actuar en uno.

Claude también puede sugerir nuevas sesiones. Cuando nota algo que vale la pena arreglar que está fuera del alcance de la tarea actual, ofrece el trabajo como una tarjeta de tarea en el chat. Haga clic en la tarjeta para comenzar ese trabajo en una nueva sesión con su propio worktree; Claude continúa su sesión actual sin interrupciones.

Ejecutar tareas de larga duración en la nube

Para refactorizaciones grandes, suites de pruebas, migraciones u otras tareas de larga duración, seleccione Cloud en lugar de Local al iniciar una sesión. Las sesiones en la nube se ejecutan en la infraestructura administrada por Anthropic de forma predeterminada y continúan incluso si cierra la aplicación o apaga su computadora. Regrese en cualquier momento para ver el progreso o dirigir a Claude en una dirección diferente. También puede monitorear sesiones en la nube desde claude.ai/code o la aplicación móvil de Claude.

Las sesiones en la nube también admiten múltiples repositorios. Después de seleccionar un entorno en la nube, haga clic en el botón + junto al repositorio seleccionado para agregar repositorios adicionales a la sesión. Cada repositorio obtiene su propio selector de rama. Esto es útil para tareas que abarcan múltiples bases de código, como actualizar una biblioteca compartida y sus consumidores.

Consulte Usar Claude Code en la nube para obtener más información sobre cómo funcionan las sesiones en la nube. Cuando un cuerpo de trabajo necesita muchas sesiones en la nube, seleccione Projects en la barra lateral para crear un proyecto, donde Claude inicia y rastrea las sesiones para usted desde una conversación.

Continuar en otra superficie

El menú Continue in, accesible desde el icono de VS Code en la esquina inferior derecha de la barra de herramientas de la sesión, le permite mover su sesión a otra superficie:

• Claude Code on the Web: envía su sesión local para continuar ejecutándose en la nube. Desktop empuja su rama, genera un resumen de la conversación y crea una nueva sesión en la nube con el contexto completo. Luego puede elegir archivar la sesión local o mantenerla. Esto requiere un árbol de trabajo limpio y no está disponible para sesiones SSH.
• Your IDE: abre su proyecto en un IDE compatible en el directorio de trabajo actual.

Sesiones desde Dispatch

Dispatch es una conversación persistente con Claude que vive en la pestaña Cowork. Usted envía un mensaje a Dispatch con una tarea, y decide cómo manejarla.

Una tarea puede terminar como una sesión de Code de dos formas: usted solicita una directamente, como "abra una sesión de Claude Code y corrija el error de inicio de sesión", o Dispatch decide que la tarea es trabajo de desarrollo e inicia una por su cuenta. Las tareas que típicamente se enrutan a Code incluyen corregir errores, actualizar dependencias, ejecutar pruebas o abrir solicitudes de extracción. La investigación, edición de documentos y trabajo con hojas de cálculo permanecen en Cowork.

De cualquier forma, la sesión de Code aparece en la barra lateral de la pestaña Code con una insignia Dispatch. Obtiene una notificación push en su teléfono cuando termina o necesita su aprobación.

Si tiene uso de computadora habilitado, las sesiones de Code generadas por Dispatch también pueden usarlo. Las aprobaciones de aplicaciones en esas sesiones expiran después de 30 minutos y vuelven a solicitar, en lugar de durar la sesión completa como las sesiones de Code regulares.

Para configuración, emparejamiento y configuración de Dispatch, consulte el artículo de ayuda de Dispatch. Dispatch requiere un plan Pro o Max y no está disponible en planes Team o Enterprise.

Dispatch es una de varias formas de trabajar con Claude cuando está lejos de su terminal. Para una comparación con las otras opciones, consulte Plataformas e integraciones.

Extender Claude Code

Conecte servicios externos, agregue flujos de trabajo reutilizables, personalice el comportamiento de Claude y configure servidores de vista previa. Para administrar conectores, skills y plugins en un solo lugar, haga clic en Customize en la barra lateral. La pestaña Cowork en la aplicación de escritorio obtiene sus skills, plugins y conectores de esta configuración de Customize, que se sincroniza a través de su cuenta de claude.ai, no desde el directorio ~/.claude de la CLI.

Claude Code también carga los skills y plugins habilitados para su cuenta de claude.ai en sesiones de terminal donde inicia sesión con la misma cuenta. Consulte Skills sincronizados desde claude.ai y Plugins sincronizados desde claude.ai.

Conectar herramientas externas

Para sesiones locales y SSH, haga clic en el botón + junto al cuadro de solicitud y seleccione Connectors para agregar integraciones como Google Calendar, Slack, GitHub, Linear, Notion y más. Puede agregar conectores antes o durante una sesión. El botón + no está disponible en sesiones en la nube o WSL, pero routines configuran conectores en el momento de la creación de la rutina.

Para administrar o desconectar conectores, vaya a Configuración → Connectors en la aplicación de escritorio, o seleccione Manage connectors desde el menú Connectors en el cuadro de solicitud.

Una vez conectado, Claude puede leer su calendario, enviar mensajes, crear problemas e interactuar con sus herramientas directamente. Puede preguntarle a Claude qué conectores están configurados en su sesión.

Los conectores son MCP servers con un flujo de configuración gráfico. Úselos para integración rápida con servicios compatibles. Para integraciones no listadas en Connectors, agregue MCP servers manualmente a través de archivos de configuración. También puede crear conectores personalizados.

Usar skills

Skills extienden lo que Claude puede hacer. Claude los carga automáticamente cuando son relevantes, o puede invocar uno directamente: escriba / en el cuadro de solicitud o haga clic en el botón + y seleccione Slash commands para ver lo que está disponible. Esto incluye comandos integrados, sus skills personalizados, skills del proyecto desde su base de código y skills de cualquier plugin instalado. Seleccione uno y aparecerá resaltado en el campo de entrada. Escriba su tarea después de él y envíe como de costumbre.

Puede enviar un comando mientras Claude está trabajando, igual que cualquier otro mensaje, y la sesión vuelve a estar inactiva una vez que se completa el turno. Antes de v2.1.206, un comando enviado a mitad de turno podría dejar la sesión mostrándose como en ejecución y los mensajes que envió después no se entregaban.

Las sesiones locales cargan sus skills personales desde ~/.claude/skills/. Una sesión SSH lee ~/.claude/skills/ desde el directorio de inicio del host remoto, no desde su máquina.

Las sesiones locales y en la nube también cargan los skills habilitados para su cuenta de claude.ai. Las sesiones en la nube los cargan en lugar de ~/.claude/skills/, como describe Skills en sesiones de Cowork y en la nube.

Instalar plugins

Plugins son paquetes reutilizables que agregan skills, agentes, hooks, MCP servers y configuraciones LSP a Claude Code. Puede instalar plugins desde la aplicación de escritorio sin usar la terminal.

Para sesiones locales y SSH, haga clic en el botón + junto al cuadro de solicitud y seleccione Plugins para ver sus plugins instalados y sus skills. Para agregar un plugin, seleccione Add plugin del submenú para abrir el navegador de plugins, que muestra plugins disponibles desde sus marketplaces configurados incluyendo el marketplace oficial de Anthropic. Seleccione Manage plugins para habilitar, deshabilitar o desinstalar plugins.

Puede limitar plugins a su cuenta de usuario, un proyecto específico o solo locales. Si su organización gestiona plugins centralmente, esos plugins están disponibles en sesiones de escritorio de la misma manera que en la CLI.

El navegador de plugins no está disponible en sesiones en la nube, y los plugins que instale desde la aplicación de escritorio no están disponibles para sesiones en la nube. Para usar un plugin en una sesión en la nube, declare el plugin en el archivo .claude/settings.json del repositorio bajo enabledPlugins para que Claude Code lo instale al iniciar la sesión, o habilítelo para su cuenta de claude.ai para que Claude Code lo cargue como un plugin sincronizado. Los plugins no están disponibles en sesiones WSL. Para la referencia completa de plugins incluyendo crear sus propios plugins, consulte plugins.

Configurar servidores de vista previa

Claude detecta automáticamente su configuración de servidor de desarrollo y almacena la configuración en .claude/launch.json en la raíz de la carpeta que seleccionó al iniciar la sesión. Preview usa esta carpeta como su directorio de trabajo, por lo que si seleccionó una carpeta principal, las subcarpetas con sus propios servidores de desarrollo no se detectarán automáticamente. Para trabajar con el servidor de una subcarpeta, inicie una sesión en esa carpeta directamente o agregue una configuración manualmente.

Para personalizar cómo se inicia su servidor, por ejemplo para usar yarn dev en lugar de npm run dev o para cambiar el puerto, edite el archivo manualmente o haga clic en Edit configuration en el menú desplegable del servidor para abrirlo en su editor de código. El archivo admite JSON con comentarios.

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

Puede definir múltiples configuraciones para ejecutar diferentes servidores desde el mismo proyecto, como un frontend y una API. Consulte los ejemplos a continuación.

Verificación automática de cambios

Cuando autoVerify está habilitado, Claude verifica automáticamente cambios de código después de editar archivos. Toma capturas de pantalla, verifica errores y confirma que los cambios funcionan antes de completar su respuesta.

Auto-verify está habilitado de forma predeterminada. Desactívelo por proyecto agregando "autoVerify": false a .claude/launch.json, o alterne desde el menú desplegable del servidor.

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

Cuando está deshabilitado, las herramientas de vista previa aún están disponibles y puede pedirle a Claude que verifique en cualquier momento. Auto-verify lo hace automático después de cada edición.

Campos de configuración

Cada entrada en el array configurations acepta los siguientes campos:

{
  "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"
    }
  ]
}

{
"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
}
]
}

El entorno que elige al iniciar una sesión determina dónde Claude se ejecuta y cómo se conecta:

• 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 se conecta a través de SSH, como sus propios servidores, máquinas virtuales en la nube o contenedores de desarrollo
• WSL (Windows): se ejecuta dentro de una distribución WSL 2 en su máquina, utilizando su cadena de herramientas Linux y rutas nativas

Sesiones locales

La aplicación de escritorio no siempre hereda su entorno de shell completo. En macOS, cuando inicia la aplicación desde el Dock o Finder, lee su perfil de shell, como ~/.zshrc o ~/.bashrc, para extraer PATH y un conjunto fijo de variables de Claude Code, pero otras variables que exporta allí no se recogen. En Windows, la aplicación hereda variables de entorno de usuario y sistema pero no lee perfiles de PowerShell.

Para establecer variables de entorno para sesiones locales y servidores de desarrollo en cualquier plataforma, abra el menú desplegable de entorno en el cuadro de solicitud, pase el cursor sobre Local y haga clic en el icono de engranaje para abrir el editor de entorno local. Las variables que guarda aquí se almacenan cifradas en su máquina y se aplican a cada sesión local y servidor de vista previa que inicia. También puede agregar variables a la clave env en su archivo ~/.claude/settings.json, aunque estas llegan solo a sesiones de Claude y no a servidores de desarrollo. Consulte variables de entorno para la lista completa de variables compatibles.

Extended thinking está habilitado de forma predeterminada, lo que mejora el rendimiento en tareas de razonamiento complejo pero usa tokens adicionales. En la API de Anthropic, establezca MAX_THINKING_TOKENS en 0 en el editor de entorno local para desactivar el pensamiento; esto no tiene efecto en modelos Fable, que siempre usan extended thinking. Con el pensamiento desactivado en la API de Anthropic, Claude Code envía esfuerzo high en lugar de un nivel superior a modelos que sabe que no aceptan esa combinación, como Opus 5.

En modelos con razonamiento adaptativo, los valores de MAX_THINKING_TOKENS distintos de 0 se ignoran porque el razonamiento adaptativo controla la profundidad del pensamiento en su lugar. En Opus 4.6 y Sonnet 4.6, establezca CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING en 1 para usar un presupuesto de pensamiento fijo; los modelos Fable, Sonnet 5 y Opus 4.7 y posteriores siempre usan razonamiento adaptativo y no tienen modo de presupuesto fijo.

Sesiones locales en dispositivos administrados

Su administrador puede desactivar sesiones locales con la configuración administrada disableDesktopLocalSessions. Cuando lo haya hecho, Local permanece en el menú desplegable de entorno pero está atenuado y no se puede seleccionar, con una información sobre herramientas que dice que su organización lo desactivó, y en Windows la entrada WSL, cuya disponibilidad en dispositivos administrados está gobernada por separado, está atenuada de la misma manera. Las nuevas sesiones se establecen de forma predeterminada en la primera conexión SSH si una está configurada, y Desktop muestra un mensaje de que las sesiones locales no están disponibles en este dispositivo si intenta continuar una existente. Elija un entorno SSH o cloud en su lugar, o póngase en contacto con su equipo de TI.

Sesiones en la nube

Las sesiones en la nube continúan en segundo plano incluso si cierra la aplicación. El uso cuenta hacia los límites de su plan de suscripción sin cargos de computación separados.

Puede crear entornos en la nube personalizados con diferentes niveles de acceso a la red y variables de entorno. Cuando inicia una sesión en la nube, abra el menú desplegable de entorno en el cuadro de solicitud para administrarlos:

• Agregar un entorno: seleccione Add cloud environment
• Editar o archivar uno de sus propios entornos: pase el cursor sobre él y haga clic en el icono de engranaje

Consulte Configure cloud environments para obtener detalles sobre la configuración del acceso a la red y variables de entorno.

Sesiones SSH

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

Para agregar una conexión SSH, haga clic en el menú desplegable de entorno antes de iniciar una sesión y seleccione + Add SSH connection. El diálogo solicita:

• Name: una etiqueta amigable para esta conexión
• SSH Host: user@hostname o un host definido en ~/.ssh/config
• SSH Port: por defecto es 22 si se deja vacío, o usa el puerto de su configuración SSH
• Identity File: ruta a su clave privada, como ~/.ssh/id_rsa. Déjelo vacío para usar la clave predeterminada o su configuración SSH.

Una vez agregada, la conexión aparece en el menú desplegable de entorno. Selecciónela para iniciar una sesión en esa máquina. Claude se ejecuta en la máquina remota con acceso a sus archivos y herramientas.

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

Pre-configurar conexiones SSH para su equipo

Los administradores pueden distribuir conexiones SSH a los miembros del equipo agregando sshConfigs a un archivo de configuración administrada. Las conexiones definidas de esta manera aparecen en el menú desplegable de entorno de cada usuario automáticamente y se muestran como administradas, por lo que los usuarios pueden seleccionarlas pero no pueden editarlas ni eliminarlas en la aplicación.

El siguiente ejemplo pre-configura una única conexión:

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

Cada entrada requiere id, name y sshHost. Los campos sshPort e sshIdentityFile son opcionales. Los usuarios también pueden agregar sshConfigs a su propio ~/.claude/settings.json, que es donde se almacenan las conexiones agregadas a través del diálogo.

Restringir a qué hosts SSH pueden conectarse los usuarios

Los administradores pueden limitar las sesiones SSH de Desktop a un conjunto aprobado de hosts agregando sshHostAllowlist a un archivo de configuración administrada. Cuando se establece, los usuarios solo pueden conectarse a hosts cuyo nombre de host resuelto coincida con uno de los patrones. Establézcalo en una matriz vacía para deshabilitar completamente las sesiones SSH.

El siguiente ejemplo permite conexiones a cualquier host bajo devboxes.example.com y a un único host bastión nombrado:

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

Los patrones no distinguen entre mayúsculas y minúsculas. * coincide con cualquier host, y *.example.com coincide con example.com y cualquier subdominio. Cualquier otra cosa es una coincidencia exacta. La verificación se ejecuta contra el nombre de host después de la resolución de ~/.ssh/config a través de ssh -G, por lo que se permiten entradas de alias Host y ProxyCommand/ProxyJump siempre que el HostName resuelto coincida.

sshHostAllowlist se lee solo desde la configuración administrada; los valores en la configuración de usuario o proyecto se ignoran. Solo la aplicación Claude Desktop honra esta configuración; la CLI de Claude Code y las extensiones IDE no la leen, y no restringe los comandos ssh ejecutados a través de la herramienta Bash. Rige a qué hosts se conecta la aplicación Desktop, no la salida de red, por lo que emparéjelo con los controles de red de su organización o de confianza cero si necesita un límite duro.

Configuración empresarial

Las organizaciones en planes Team o Enterprise pueden gestionar el comportamiento de la aplicación de escritorio a través de controles de consola de administración, archivos de configuración administrados y políticas de gestión de dispositivos.

Controles de consola de administración

Estas configuraciones se configuran a través de la consola de configuración de administración:

• Code in the desktop: controle si los usuarios en su organización pueden acceder a Claude Code en la aplicación de escritorio
• Code in the web: habilite o deshabilite sesiones en la nube para su organización
• Remote Control: habilite o deshabilite Remote Control para su organización
• Disable Bypass permissions mode: evite que los usuarios en su organización habiliten el modo bypass permissions

Configuración administrada

La configuración administrada anula la configuración del proyecto y usuario y se aplica a las sesiones de Claude Code en Desktop. Puede establecer estas claves en el archivo de configuración administrada de su organización o enviarlas de forma remota a través de la consola de administración.

Qué configuración administrada llega a una sesión de Desktop depende de dónde se ejecute esa sesión. Las restricciones de modelo como availableModels se aplican en las sesiones de Claude Code de Desktop de la misma manera que en la CLI de terminal; consulte cobertura de superficie.

• Sesiones locales en esta máquina: se aplica un archivo de configuración administrada implementado 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 o clave elegible, siguiendo la misma precedencia de configuración que la CLI de terminal.
• Sesiones en la nube: reciben configuración administrada por servidor; los archivos implementados 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 y disableDesktopLocalSessions desde la configuración administrada de la máquina local.
• Sesiones Cowork: en una sesión de Cowork en esta máquina, Claude Code nunca obtiene configuraciones de consola de administración, incluso cuando el usuario inicia sesión con una cuenta de Team o Enterprise, y lee la política implementada en la máquina a menos que su configuración de Claude Desktop establezca requireCoworkFullVmSandbox. Las sesiones remotas de Cowork no reciben ninguna. Consulte 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.

En sesiones locales y SSH, la aplicación de escritorio entrega los conectores de claude.ai conectados de cada usuario a Claude Code directamente. Ninguna configuración de MCP o managed-mcp.json llega a esos conectores, cualquiera que sea la fuente de configuración o ubicación de archivo que utilice. Para bloquear las herramientas de un conector en estas sesiones, use los controles de herramientas de conector de su organización. Cómo los conectores llegan a Claude Code muestra qué configuración rige los conectores en cada tipo de sesión.

permissions.disableBypassPermissionsMode y disableAutoMode también funcionan en configuración de usuario y proyecto, pero colocarlos en configuración administrada evita que los usuarios los anulen.

Para las claves de permiso, plugin y entrega que solo una fuente administrada puede establecer, consulte Claves que solo la configuración administrada puede establecer.

Políticas de gestión de dispositivos

Los equipos de TI pueden gestionar la aplicación de escritorio a través de MDM en macOS o política de grupo en Windows. Las políticas disponibles incluyen habilitar o deshabilitar la función Claude Code, controlar actualizaciones automáticas y establecer una URL de implementación personalizada.

• macOS: configure a través del dominio de preferencia com.anthropic.claudefordesktop usando herramientas como Jamf o Kandji
• Windows: configure a través del registro en SOFTWARE\Policies\Claude

Requisitos de acceso a la red

Desktop carga su código de aplicación y contenido de usuario desde hosts de CDN de Anthropic.

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

El tráfico es HTTPS en el puerto 443 a menos que configure un puerto personalizado para OTLP, una puerta de enlace LLM o un servidor MCP.

Para servidores proxy, autoridades de certificados personalizadas, mTLS y los dominios que necesita la CLI independiente, consulte configuración de red.

Para reducir el número de caracteres comodín de firewall, permita estos hosts de Anthropic en su lugar. Ciertos subdominios se generan dinámicamente y deben permanecer como caracteres comodín.

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
a-cdn.claude.ai
assets.claude.ai
downloads.claude.ai
*.livepreview.claude.ai
claude.com
platform.claude.com
*.livepreview.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

Si su organización tiene restricción de IP habilitada para Claude, enrute bridge.claudeusercontent.com a través de la misma salida de proxy que claude.ai y api.anthropic.com. Si no puede enrutarlo de esa manera, agregue la dirección de salida que su proxy usa para ese host a la lista de permitidos de IP de su organización, pero solo cuando esa dirección esté dedicada a su organización: un rango de salida de proxy compartido también admite a otros clientes del proveedor de proxy.

Anthropic verifica las conexiones a ese host contra la lista de permitidos de IP de su organización usando la dirección desde la que llegan. Si su proxy envía tráfico para él a través de una dirección que no está en esa lista de permitidos, Claude en Chrome y otras características que se conectan a través del puente dejan de funcionar mientras el resto de la aplicación sigue funcionando.

Un artefacto que carga una fuente tipográfica desde Google Fonts también solicita fonts.googleapis.com y fonts.gstatic.com. Ambos hosts son opcionales. Si los bloquea, los artefactos se renderizan en fuentes tipográficas alternativas. Bloquee con un rechazo rápido en lugar de una caída silenciosa para que la solicitud de fuente falle inmediatamente en lugar de retrasar el primer renderizado de la página.

Los artefactos también pueden cargar bibliotecas de JavaScript, como React o un paquete de gráficos, desde cdnjs.cloudflare.com, cdn.jsdelivr.net, cdn.tailwindcss.com y code.jquery.com, y desde ningún otro host externo. Si bloquea esos hosts, las partes de un artefacto que dependen de una biblioteca no funcionan, y a diferencia de una fuente bloqueada, una biblioteca bloqueada no tiene alternativa. Bloquee con un rechazo rápido aquí también, para que una solicitud de biblioteca bloqueada falle de inmediato en lugar de colgarse hasta que se agote el tiempo de espera.

Autenticación y SSO

Las organizaciones empresariales pueden requerir SSO para todos los usuarios. Consulte autenticación para obtener detalles a nivel de plan y Configurar SSO para la configuración de SAML; la configuración de OIDC se cubre en la Guía del administrador empresarial de Claude.

Manejo de datos

Claude Code procesa su código localmente en sesiones locales, o en sesiones en la nube en infraestructura administrada por Anthropic, a menos que su organización las enrute a un entorno autohospedado. Las sesiones en la nube, incluyendo en un entorno autohospedado, envían conversaciones y contexto de código a la API de Anthropic para procesamiento; las sesiones locales y SSH las envían a cualquiera que sea el proveedor de modelo que configure su implementación, la API de Anthropic de forma predeterminada. Consulte manejo de datos para obtener detalles sobre retención de datos, privacidad y cumplimiento.

Implementación

Desktop se puede distribuir a través de herramientas de implementación empresarial:

• macOS: distribuya a través de MDM como Jamf o Kandji usando el instalador .dmg
• Windows: implemente a través del paquete MSIX. Consulte Deploy Claude Desktop for Windows para opciones de implementación empresarial incluyendo instalación silenciosa

Para los dominios a permitir en su firewall, consulte requisitos de acceso a la red arriba. Para configuración de proxy, autoridades de certificados personalizadas y puertas de enlace LLM, consulte configuración de red.

Para la referencia completa de configuración empresarial, consulte la guía de configuración empresarial.

¿Viene de la CLI?

Si ya usa la CLI de Claude Code, Desktop ejecuta el mismo motor subyacente con una interfaz gráfica. Puede ejecutar ambos simultáneamente en la misma máquina, incluso en el mismo proyecto. Cada uno mantiene su propia lista de sesiones, y puede traer una sesión de CLI a Desktop. Comparten configuración y memoria del proyecto a través de archivos CLAUDE.md.

Para mover una sesión de CLI a Desktop, ejecute /desktop en la terminal. Claude guarda su sesión y la abre en la aplicación de escritorio, luego sale de la CLI. Este comando está disponible en macOS y Windows x64 cuando inicia sesión con una suscripción de Claude. No está disponible con autenticación de clave API ni en Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry.

Para retomar una sesión de CLI desde dentro de Desktop, escriba /resume en el cuadro de solicitud. Desktop enumera las sesiones que inició desde la CLI, y puede buscarlas por título, carpeta o rama y obtener una vista previa de dónde dejó cada una. Seleccione una sesión y continuará en la aplicación con su conversación completa y contexto.

Equivalentes de banderas de CLI

Esta tabla muestra el equivalente de la aplicación de escritorio para banderas de CLI comunes. Las banderas no listadas no tienen equivalente de escritorio porque están diseñadas para scripting o automatización.

Configuración compartida

Desktop y CLI leen los mismos archivos de configuración, por lo que su configuración se transfiere:

• Los archivos CLAUDE.md y CLAUDE.local.md en su proyecto son utilizados por ambos
• Los MCP servers configurados en ~/.claude.json o .mcp.json funcionan en ambos
• Los Hooks y skills definidos en 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 otras configuraciones en settings.json se aplican a sesiones de Desktop.
• Modelos: los mismos modelos están disponibles en ambos. En Desktop, seleccione el modelo del menú desplegable junto al botón de envío. Puede cambiar el modelo durante la sesión desde el mismo menú desplegable.

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

La aplicación Desktop carga MCP servers de claude_desktop_config.json en sesiones de la pestaña Code local, junto con servidores de ~/.claude.json y .mcp.json. Un servidor definido en claude_desktop_config.json está disponible tanto en la superficie de chat de Desktop como en sesiones de la pestaña Code local.

Si define el mismo nombre de servidor en claude_desktop_config.json y en ~/.claude.json o .mcp.json, la pestaña Code en sesiones locales se conecta una vez y usa la definición de claude_desktop_config.json.

La aplicación también reentrega servidores stdio de ~/.claude.json a la CLI integrada en sesiones locales. Cuando el nivel superior de ~/.claude.json (alcance de usuario) y .mcp.json definen el mismo nombre de servidor stdio, la pestaña Code usa la definición de ~/.claude.json, apartándose de la jerarquía de alcance de la CLI.

Comparación de características

Esta tabla compara capacidades principales entre la CLI y Desktop. Para una lista completa de banderas de CLI, consulte la referencia de CLI.

Lo que no está disponible en Desktop

Las siguientes características no están disponibles en Desktop, excepto donde se indique:

• Proveedores de terceros: Desktop se conecta a la API de Anthropic de forma predeterminada. Para enrutar Desktop a través de una puerta de enlace, o para ejecutar la pestaña Code en Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o una puerta de enlace LLM autohospedada, siga los enlaces en la fila Proveedores de terceros.
• Linux (beta): Computer Use aún no está disponible en la aplicación de escritorio Linux. Consulte Claude Desktop en Linux.
• Sugerencias de código en línea: Desktop no proporciona sugerencias de estilo autocompletado. Funciona a través de solicitudes conversacionales y cambios de código explícitos.
• Equipos de agentes: 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, use flujos de trabajo dinámicos, que se ejecutan en Desktop; Claude también puede enviar mensajes y gestionar sus otras sesiones directamente.
• Comandos de diálogo de terminal: comandos integrados que abren un panel interactivo en la terminal se comportan de manera diferente en la pestaña Code. Edite archivos de configuración directamente para gestionar reglas de permisos y configuración, o ejecute 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 → Claude Code. El texto después del comando se ignora, por lo que /config theme=dark no establece el tema.

Solución de problemas

Las secciones a continuación cubren problemas específicos de la aplicación de escritorio. Para errores de API en tiempo de ejecución que aparecen en el chat como API Error: 500, 529 Overloaded, 429 o Prompt is too long, consulte la referencia de errores. Esos errores y sus soluciones son los mismos en la CLI, escritorio y web.

Verificar su versión

Para ver qué versión de la aplicación de escritorio está ejecutando:

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

Haga clic en el número de versión para copiarlo a su portapapeles.

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

Si ve Error 403: Forbidden u otros fallos de autenticación al usar 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. Verifique que tenga una suscripción de pago activa: Pro, Max, 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

Si la aplicación se abre pero muestra una pantalla en blanco o sin respuesta:

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"

Si ve Failed to load session, la carpeta seleccionada puede no existir más, un repositorio de Git puede requerir Git LFS que no está instalado, o los permisos de archivo pueden impedir el acceso. Intente seleccionar una carpeta diferente o reinicie la aplicación.

La sesión no encuentra herramientas instaladas

Si Claude no puede encontrar herramientas como npm, node u otros comandos de CLI, verifique que las herramientas funcionen en su terminal regular, verifique que su perfil de shell configure correctamente PATH y reinicie la aplicación de escritorio para recargar variables de entorno.

Errores de Git y Git LFS

Las sesiones que se ejecutan en su propio worktree necesitan Git. Si ve "Git is required," instale Git, o Git para Windows en Windows, e intente nuevamente. En Windows, las versiones de Claude Desktop anteriores a 1.49585.0 solicitaban Git antes de iniciar cualquier sesión local; si ve ese mensaje y no está usando worktrees, actualice la aplicación.

Si ve "Git LFS is required by this repository but is not installed," instale Git LFS desde git-lfs.com, ejecute git lfs install y reinicie la aplicación.

Los MCP servers no funcionan en Windows

Si los controles deslizantes de MCP server no responden o los servidores no se conectan en Windows, verifique que el servidor esté configurado correctamente en su configuración, reinicie la aplicación, verifique que el proceso del servidor se esté ejecutando en Task Manager y revise los registros del servidor para errores de conexión.

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

Las sesiones en la nube pueden crear ramas que no existen en su máquina local. Haga clic en el nombre de la rama en la barra de herramientas de la sesión para copiarlo, luego obténgalo localmente:

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

Al presentar un problema, incluya la versión de su aplicación de escritorio, su sistema operativo, el mensaje de error exacto y registros relevantes. En macOS, verifique Console.app. En Windows, verifique Event Viewer → Windows Logs → Application. Revise extractos de registros antes de publicarlos en un problema público; pueden incluir rutas de archivo y otros detalles de su entorno.