Saltar al contenido principal
Interfaz de Claude Code en escritorio

Claude Code en escritorio (Vista previa)

La aplicación de escritorio de Claude proporciona una interfaz nativa para ejecutar múltiples sesiones de Claude Code en tu máquina local e integración perfecta con Claude Code en la web.

Instalación

Descarga la aplicación de escritorio de Claude para tu plataforma: Para Windows ARM64, descarga aquí.
Las sesiones locales no están disponibles en Windows ARM64.

Características

Claude Code en escritorio proporciona:
  • Sesiones locales paralelas con git worktrees: Ejecuta múltiples sesiones de Claude Code simultáneamente en el mismo repositorio, cada una con su propio git worktree aislado
  • Incluye archivos listados en tu .gitignore en tus worktrees: Copia automáticamente archivos en tu .gitignore, como .env, a nuevos worktrees usando .worktreeinclude
  • Lanza Claude Code en la web: Inicia sesiones en la nube segura directamente desde la aplicación de escritorio

Usando Git worktrees

Claude Code en escritorio permite ejecutar múltiples sesiones de Claude Code en el mismo repositorio usando Git worktrees. Cada sesión obtiene su propio worktree aislado, permitiendo que Claude trabaje en diferentes tareas sin conflictos. La ubicación predeterminada para worktrees es ~/.claude-worktrees pero esto se puede configurar en tus ajustes en la aplicación de escritorio de Claude.
Si inicias una sesión local en una carpeta que no tiene Git inicializado, la aplicación de escritorio no creará un nuevo worktree.

Copiando archivos ignorados con .gitignore

Cuando Claude Code crea un worktree, los archivos ignorados a través de .gitignore no están disponibles automáticamente. Incluir un archivo .worktreeinclude resuelve esto especificando qué archivos ignorados deben copiarse a nuevos worktrees. Crea un archivo .worktreeinclude en la raíz de tu repositorio:
.env
.env.local
.env.*
**/.claude/settings.local.json
El archivo utiliza patrones de estilo .gitignore. Cuando se crea un worktree, los archivos que coinciden con estos patrones y que también están en tu .gitignore se copiarán desde tu repositorio principal al worktree.
Solo se copian los archivos que coinciden tanto con .worktreeinclude COMO están listados en .gitignore. Esto previene duplicar accidentalmente archivos rastreados.

Lanza Claude Code en la web

Desde la aplicación de escritorio, puedes iniciar sesiones de Claude Code que se ejecutan en la infraestructura en la nube segura de Anthropic. Para iniciar una sesión web desde el escritorio, selecciona un entorno remoto al crear una nueva sesión. Para más detalles, consulta Claude Code en la web.

Versión agrupada de Claude Code

Claude Code en escritorio incluye una versión agrupada y estable de Claude Code para garantizar una experiencia consistente para todos los usuarios de escritorio. La versión agrupada es requerida y se descarga en el primer lanzamiento incluso si existe una versión de Claude Code en la computadora. El escritorio gestiona automáticamente las actualizaciones de versión y limpia las versiones antiguas.
La versión agrupada de Claude Code en Desktop puede diferir de la última versión de CLI. Desktop prioriza la estabilidad mientras que CLI puede tener características más nuevas.

Configuración del entorno

Para entornos locales, Claude Code en escritorio extrae automáticamente tu variable de entorno $PATH de la configuración de tu shell. Esto permite que las sesiones locales accedan a herramientas de desarrollo como yarn, npm, node y otros comandos disponibles en tu terminal sin configuración adicional.

Variables de entorno personalizadas

Selecciona el entorno “Local”, luego a la derecha, selecciona el botón de ajustes. Esto abrirá un diálogo donde puedes actualizar variables de entorno locales. Esto es útil para establecer variables específicas del proyecto o claves API que tus flujos de trabajo de desarrollo requieren. Los valores de variables de entorno están enmascarados en la interfaz por razones de seguridad.
Las variables de entorno deben especificarse como pares clave-valor, en formato .env. Por ejemplo:
API_KEY=your_api_key
DEBUG=true

# Valores multilínea - envuelve entre comillas
CERT="---BEGIN CERT---
MIIE...
---END CERT---"

Configuración empresarial

Las organizaciones pueden desactivar el uso local de Claude Code en la aplicación de escritorio con la opción de política empresarial isClaudeCodeForDesktopEnabled enterprise policy option. Además, Claude Code en la web se puede desactivar en tu configuración de administrador.

Recursos relacionados