Cómo usar Claude Code en el escritorio— una guía profesional

Este mes, Anthropic lanzó una vista previa de escritorio de Claude Code — una aplicación de escritorio nativa que lleva los flujos de trabajo de codificación basada en agentes de Anthropic fuera de la terminal y a un entorno gráfico, con compatibilidad integrada para ejecutar múltiples sesiones de codificación aisladas en paralelo. La versión preliminar de escritorio está diseñada para convivir junto con las versiones web y móvil de Claude Code y se centra en dos problemas prácticos para desarrolladores: ejecutar múltiples agentes de IA en el mismo repositorio sin que se pisen entre sí y facilitar el inicio de sesiones locales o en la nube desde una única interfaz gráfica.

¿Qué es Claude Code en Escritorio?

Claude Code en Escritorio es la aplicación de escritorio nativa (versión preliminar) que permite a los desarrolladores ejecutar sesiones de Claude Code de forma local o en la infraestructura en la nube segura de Anthropic usando una interfaz gráfica, en lugar de solo la CLI. Combina las capacidades centrales de codificación basada en agentes de Claude Code con las comodidades de escritorio: gestión de sesiones, integración con el entorno local y lanzamiento con un clic de sesiones web. La aplicación se posiciona explícitamente como un complemento de la CLI y la oferta web de Claude Code; incluye un entorno de ejecución (runtime) estable de Claude Code y gestiona las versiones por ti para preservar una experiencia coherente y estable.

¿Por qué importa? Históricamente, las herramientas de codificación con IA se ejecutaban o bien puramente en la terminal (desarrolladores cómodos con flujos de trabajo CLI) o bien puramente en la nube (interfaces de navegador). La app de escritorio cierra esa brecha al habilitar ejecuciones locales de baja latencia y permitirte cambiar sin fricción a sesiones (web) alojadas por Anthropic cuando necesites cómputo en la nube aislado o controles empresariales. La versión preliminar de escritorio destaca especialmente por admitir el paralelismo de múltiples sesiones: puedes ejecutar varios agentes de Claude Code independientes en el mismo repositorio simultáneamente, cada uno en su propio worktree de Git (espacio de trabajo de rama aislado) para que los agentes no entren en conflicto entre sí. Esa es la función principal que muchos equipos encontrarán inmediatamente útil.

¿Cómo se relaciona la edición de escritorio con las versiones web y CLI?

Claude Code comenzó como una herramienta de línea de comandos y más tarde se amplió a interfaces web y móviles; la vista previa de escritorio se basa en esos cimientos. La app de escritorio refleja muchas de las capacidades disponibles en la web (lanzamiento de sesiones, conexión de repositorios, progreso visible) pero se enfoca en la ergonomía del flujo de trabajo local: UX de escritorio, instalación nativa e integraciones más estrechas con repositorios Git locales mediante worktrees, de modo que las sesiones puedan ejecutarse concurrentemente sin interferir con el estado de archivos de las demás.

Consulta también Claude Code Web: Qué es y cómo usarlo

7 excelentes funciones de Claude Code en Escritorio

1) Paralelismo de múltiples sesiones

Claude Code para Escritorio admite la ejecución de múltiples sesiones independientes de Claude al mismo tiempo. Eso significa que puedes tener una sesión centrada en un arreglo de bug, otra escribiendo pruebas y una tercera generando documentación — todas ejecutándose simultáneamente en lugar de en cola en una única sesión. Este paralelismo acelera los flujos de trabajo y te permite delegar diferentes tareas en paralelo.

Por ejemplo:

Supón que tienes un proyecto llamado my-app y quieres:

• Hacer que Claude cambie la página de inicio en una ventana;
• Hacer que Claude optimice la lógica de base de datos en otra ventana.

Claude Desktop creará automáticamente para ti:

~/.claude-worktrees/my-app/homepage/
~/.claude-worktrees/my-app/database/

Dos copias independientes (sin conflicto). Es como ejecutar dos ramas de desarrollo simultáneamente, con Claude gestionando cada una por ti.

2. .worktreeinclude: Haz que Claude tenga en cuenta los archivos ignorados

A veces tu proyecto tiene archivos como .env o .local, que normalmente están ignorados por .gitignore y no se copiarán al directorio de trabajo de Claude. Los archivos listados en .gitignore no se copian automáticamente en nuevos worktrees. Claude ofrece un mecanismo nuevo: puedes crear un archivo .worktreeinclude en el directorio raíz del proyecto para indicarle qué archivos deben copiarse — una lista al estilo .gitignore que especifica qué archivos ignorados deben copiarse en los worktrees recién creados (por ejemplo, archivos .env locales o configuraciones específicas del desarrollador). Solo se copian los archivos que aparecen tanto en .worktreeinclude como en .gitignore, lo que evita duplicar accidentalmente archivos bajo seguimiento. Esto es fundamental para preservar archivos de secretos o de entorno por sesión sin añadirlos a Git.

Por ejemplo:

.env
.env.local

.env.production

**/.claude/settings.local.json

Esto significa: Cuando Claude cree el directorio de trabajo, estos archivos también se copiarán.

Nota:

• Solo se copiarán los archivos que existan tanto en .gitignore como en .worktreeinclude;
• Evita copiar accidentalmente archivos importantes bajo seguimiento.

3) Lanzar y sincronizar con sesiones web/en la nube

La app de escritorio puede actuar como lanzador de sesiones web/en la nube, es decir, puedes iniciar sesiones de Claude Code basadas en la nube desde la interfaz de escritorio y supervisarlas o guiarlas localmente. Este modo híbrido es útil si quieres la conveniencia de controles locales con el modelo de escalado o permisos de ejecuciones alojadas en la nube.

Nota:

• Cuando se ejecute en la nube, las tareas de Claude se ejecutarán en el servidor de seguridad de Anthropic.
• El cambio entre entornos local y en la nube es transparente.
• Para crear una sesión, simplemente selecciona "entorno remoto".

4) Lanzar y sincronizar con sesiones web/en la nube

La app de escritorio puede actuar como lanzador de sesiones web/en la nube — lo que significa que puedes iniciar sesiones de Claude Code basadas en la nube desde la interfaz de escritorio y supervisarlas o guiarlas localmente. Este modo híbrido es útil si quieres la conveniencia de controles locales con el modelo de escalado o permisos de ejecuciones alojadas en la nube (local para tareas rápidas, nube para tareas arriesgadas o intensivas en recursos).

5) Versión incluida y configuración para empresas

La versión de escritorio incluye un entorno de ejecución estable de Claude Code que se descarga en el primer inicio y se gestiona automáticamente. Los administradores empresariales pueden deshabilitar el uso local de Claude Code si es necesario (política empresarial isClaudeCodeForDesktopEnabled). Los instaladores de escritorio admiten formatos comunes de despliegue empresarial (MSIX para Windows, PKG para macOS) y los administradores pueden controlar las actualizaciones y el acceso a extensiones. Estos controles están diseñados para facilitar la adopción en equipos grandes.

Nota:

• La aplicación se descargará automáticamente al abrirla por primera vez;
• La aplicación de escritorio gestiona automáticamente las actualizaciones de versión;
• Limpia automáticamente versiones antiguas para mantener el sistema ordenado;
• Incluso si tienes la versión CLI instalada en tu equipo, seguirá usando su propia versión (para mayor estabilidad).
• La versión de escritorio prioriza la estabilidad y la compatibilidad; la CLI (versión de línea de comandos) puede actualizarse más rápido, pero es posible que las nuevas funciones no se sincronicen inmediatamente con la versión de escritorio.

6) Variables de entorno personalizadas

Claude Desktop te permite definir variables igual que en archivos .env.

Estas variables solo tienen efecto dentro de la sesión de Claude, lo que las hace ideales para la configuración del proyecto.

Por ejemplo:

API_KEY=abcd123
DEBUG=true
CERT="-----BEGIN CERT-----
MIIE...
-----END CERT-----"

7) Integración con herramientas y entornos locales

Al ejecutar sesiones locales, la app de escritorio extrae tu $PATH de la shell para que los procesos de la sesión puedan usar el mismo node, npm, yarn, Python u otras herramientas de CLI que utilizas. También proporciona una interfaz para añadir variables de entorno personalizadas (en formato .env), con valores enmascarados por seguridad. Esto hace que ejecutar pruebas o compilaciones dentro de una sesión basada en agentes sea más fluido, porque el agente puede invocar la misma cadena de herramientas que tu terminal.

¿Cómo instalo Claude Code en Escritorio?

Esta sección recorre el proceso de instalación con la menor fricción posible. Las instrucciones a continuación son las actuales para la versión preliminar de escritorio y te señalan los instaladores canónicos.

Prerrequisitos y configuración de la cuenta

1. Cuenta y espacio de trabajo de Anthropic: Claude Code se integra con el Claude Console. Necesitarás completar un flujo de OAuth en el Claude Console y tener facturación activa o acceso de vista previa de investigación según lo requiera el modelo de espacios de trabajo de Anthropic. Claude Code usa un espacio de trabajo interno en la consola para rastrear el uso; no puedes crear claves de API para ese espacio de trabajo — está gestionado para el uso de Claude Code.
2. Git y preparación del repositorio: Asegúrate de tener Git instalado y de que el proyecto en el que quieres operar sea un repositorio Git (o inicializa Git). La app de escritorio espera repos válidos para funciones como worktrees; si abres una carpeta sin Git inicializado, no se creará un worktree.
3. Específicos del sistema operativo: Las instalaciones en macOS y Linux son generalmente binarios nativos; se recomienda a los usuarios de Windows usar WSL para una compatibilidad completa de comandos en muchos flujos de trabajo. Algunas guías de la comunidad cubren configuraciones avanzadas de Windows/WSL si te encuentras con problemas de PATH o de distribución.

Instalación paso a paso (corta)

1. Abre la página de descargas de Claude y elige el instalador correcto para tu plataforma.
2. Ejecuta el instalador (PKG en macOS, MSIX o EXE en Windows). Para flotas empresariales, usa los paquetes MSIX/PKG provistos para despliegue centralizado.
3. Inicia la app de Claude Desktop e inicia sesión con tu cuenta de Anthropic/Claude. Tus conversaciones y preferencias se sincronizan entre escritorio, web y móvil.
4. En el primer inicio, la app descargará un entorno de ejecución de Claude Code incluido. Permite que esa descarga se complete; es necesaria y garantiza que se use una versión estable y gestionada.

Comprobaciones posteriores a la instalación

• Abre Settings > Environments y confirma que la app de escritorio ha extraído tu $PATH de la shell.
• Elige si quieres habilitar sesiones locales (si tu máquina y política lo permiten) o si tu flujo de trabajo creará sesiones web en su lugar.

Método de instalación opcional que debería elegir

• Instalador nativo (recomendado): Usa el instalador nativo del sistema operativo para la experiencia más simple e integrada.
• Homebrew (macOS): Conveniente para usuarios de macOS que gestionan apps con Homebrew.
• Instaladores vía NPM o scripts: Útiles para configuraciones más automatizadas o por script (CI o aprovisionamiento), o para distribuciones Linux donde se prefiera un simple script de instalación.

Instalación: macOS, Linux, WSL (flujo recomendado)

1. Descarga el instalador de la vista previa de escritorio desde la página de descargas de Claude Code (la documentación dentro del producto proporciona el enlace del instalador).
2. Ejecuta el instalador y abre la app de escritorio de Claude.
3. Completa el inicio de sesión OAuth mediante el flujo del Claude Console integrado en la app.
4. Configura la ubicación por defecto de los worktrees y las preferencias de ejecución local/remota en los ajustes de la app de escritorio.
5. Abre una carpeta de proyecto o clona un repo desde la interfaz para empezar.

Abre una terminal y, si confías en la fuente, ejecuta el script de instalación provisto por Anthropic (esta es la opción de conveniencia recomendada típicamente). Ejemplo (parafraseado):

# macOS / Linux / WSL (example convenience installer)
curl -fsSL https://claude.ai/install.sh | bash

Como alternativa, si prefieres Homebrew en macOS:

brew install --cask claude-code

Instalación: Windows

WSL：

1. Instala WSL (Ubuntu es común) y configura un entorno WSL limpio. Resuelve problemas de PATH e interoperabilidad para que la integración de WSL de la app de escritorio pueda acceder a la distribución.
2. Instala Git y cualquier runtime de lenguaje en WSL que Claude pueda necesitar para ejecuciones locales (node, python, etc.).
3. Instala o ejecuta la app de escritorio en Windows, apunta a tu directorio de proyecto en WSL (o lanza la app de escritorio dentro de WSL si se admite) y sigue el mismo flujo de OAuth.

Ejemplo de PowerShell (parafraseado):

# PowerShell (example convenience installer)
irm https://claude.ai/install.ps1 | iex

Ejemplo de CMD (parafraseado):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

¿Cómo uso Claude Code en Escritorio en la práctica diaria?

¿Cuáles son los patrones recomendados para crear sesiones?

Tareas cortas e independientes vs refactorizaciones de larga duración

• Para tareas cortas y acotadas (arreglo de bug, cambio en un solo archivo, refactorización pequeña), crea una sesión por tarea y deja que Claude produzca un commit enfocado. Revisa y fusiona rápidamente.
• Para esfuerzos de larga duración (refactorizaciones grandes, desarrollo de funcionalidades), considera crear una sesión que haga puntos de control con frecuencia y use los controles de progreso de la interfaz de escritorio para guiar o pausar el trabajo. Mantén las sesiones en ramas de feature para evitar fusiones accidentales.

Mantén un CLAUDE.md o una plantilla de prompts en tu repo para estandarizar cómo se deben diseñar los prompts de las sesiones (contexto, pruebas a ejecutar, reglas de estilo). Esta práctica reduce la variabilidad y ayuda a que Claude produzca resultados consistentes entre sesiones. Muchos equipos guardan prompts estándar o directrices en metadatos del repositorio para asegurar un comportamiento predecible del agente.

Iniciar y nombrar una sesión

1. Abre la app de escritorio y selecciona o clona un repositorio.
2. Haz clic en “New Session” (o equivalente) y ponle a la sesión un nombre descriptivo (p. ej., bugfix/cs-142 o add-tests-login). Nombrarlas te ayuda a distinguir sesiones simultáneas en la interfaz.
3. Elige modo de ejecución local o remoto, selecciona una rama objetivo (o permite que el agente cree una rama en un nuevo worktree) e inicia la sesión. La app crea automáticamente un worktree de Git dedicado para la sesión.

Guiar al agente: prompts y tareas

• Usa prompts claros y acotados. Ejemplo: “Encuentra la prueba unitaria que falla para AuthService y crea una corrección que preserve la API pública existente; ejecuta las pruebas e informa los resultados.”
• Para tareas incrementales, pide a Claude que genere primero un plan (una lista de verificación corta) y luego solicita los cambios de código específicos paso a paso. El progreso incremental reduce el riesgo de alucinaciones y hace que los diffs sean más fáciles de revisar. Anthropic recomienda este enfoque en sus mejores prácticas.

Ver el progreso e interactuar

La interfaz de escritorio muestra registros de acciones y diffs a medida que el agente trabaja. Puedes pausar una sesión, cambiar instrucciones o cancelar un trabajo en ejecución. Cuando el agente propone ediciones, la interfaz muestra diffs de archivos y una explicación de lo que cambió. Aprueba, edita o rechaza los diffs propuestos antes del commit.

Flujos de commit, ramas y PR

Una vez que apruebes los cambios, la app de escritorio puede hacer commit en la rama del worktree de la sesión. Desde ahí puedes hacer push a origin y abrir un pull request desde la interfaz (si has autorizado el acceso a GitHub). La rama de cada sesión permanece aislada hasta que fusiones, lo que facilita la revisión humana.

¿Cómo funcionan realmente el aislamiento en Git y el paralelismo de múltiples sesiones?

Worktrees de Git: el mecanismo de aislamiento

La versión de escritorio de Anthropic usa worktrees de Git para crear copias por sesión del árbol de trabajo de un repositorio vinculadas a ramas separadas. Los worktrees son más ligeros que los clones completos — comparten la misma metainformación .git cuando corresponde, pero proporcionan directorios de trabajo independientes para que las ediciones concurrentes no entren en conflicto ni se filtren entre sesiones. La app de escritorio coloca estos worktrees creados automáticamente en un directorio configurable (por defecto ~/.claude-worktrees). Este diseño habilita la concurrencia segura para operaciones con agentes.

Por qué worktrees en lugar de clones

Los worktrees son más rápidos de crear y más fáciles de correlacionar con el mismo historial subyacente de Git, a la vez que proporcionan la separación de sistema de archivos necesaria para evitar la contaminación entre sesiones. Para la mayoría de los flujos de trabajo esto es preferible a múltiples clones completos; sin embargo, si necesitas entornos de ejecución totalmente aislados con dependencias diferentes, aún podría ser deseable un clon separado o un contenedor.

Coordinación y manejo de conflictos

Como cada sesión trabaja en una rama/worktree aislados, los conflictos se minimizan. Si dos sesiones cambian de forma independiente el mismo código y ambas se fusionan posteriormente en la misma rama objetivo, se aplicará el manejo normal de conflictos de Git — que es el punto correcto para la revisión y resolución humanas. El modelo de Anthropic expone intencionalmente los commits como PRs revisables, manteniendo a las personas en el ciclo de fusión.

Pasos comunes de solución de problemas y limitaciones

Si una sesión no se inicia o se cuelga

• Confirma que los tokens de acceso al repositorio sean válidos y que no estén sujetos a límites de tasa.
• Verifica el espacio en disco local y los permisos para el directorio de worktrees (p. ej., ~/.claude-worktrees).
• Revisa los registros de la app de escritorio en busca de mensajes de error; la app suele exponer una vista de diagnóstico o un archivo de logs.

Si las sesiones se contaminan entre sí

• Confirma que la app de escritorio esté creando worktrees separados (inspecciona el directorio ~/.claude-worktrees o la ubicación de worktrees configurada en las preferencias de la app).
• Si ves estado compartido, asegúrate de estar usando la vista previa de escritorio más reciente o consulta la documentación de Anthropic — esta versión aborda específicamente el aislamiento entre sesiones.

Si los archivos ignorados no están disponibles para las sesiones

Añade los nombres de archivo a tu configuración .worktreeinclude (o al equivalente en la interfaz de escritorio) para que la app copie de forma segura los archivos ignorados necesarios (p. ej., .env) en cada worktree. Evita almacenar secretos en, o exponerlos desde, los worktrees sin una gestión adecuada de secretos.

Conclusión

La vista previa de escritorio de Claude Code representa una evolución significativa en cómo las herramientas de codificación basada en agentes encajan en los flujos de trabajo de los desarrolladores: mantiene la velocidad y expresividad de los agentes de IA mientras resuelve varios problemas prácticos de coordinación que enfrentan los desarrolladores cuando múltiples agentes deben operar sobre la misma base de código. Ya sea que lo adoptes para la productividad de un solo desarrollador o para coordinar múltiples tareas de agentes en un equipo, comprender los worktrees de Git, .worktreeinclude y la distinción entre sesiones locales y web hará que tu primera semana con la vista previa de escritorio sea mucho más productiva.

¿Listo para usar la CLI de Claude Code? consulta la guía de API para obtener instrucciones detalladas.

Los desarrolladores pueden acceder a la Claude Opus 4.5 API etc. a través de CometAPI; la última versión del modelo siempre se actualiza con el sitio oficial. Para comenzar, explora las capacidades del modelo en el Playground y consulta la guía de API para obtener instrucciones detalladas. Antes de acceder, asegúrate de haber iniciado sesión en CometAPI y obtenido la clave de API. CometAPI ofrece un precio muy inferior al oficial para ayudarte a integrar.

¿Listo para empezar?→ Prueba gratuita de Claude opus 4.5 ¡

Si quieres conocer más consejos, guías y noticias sobre IA síguenos en VK, X y Discord!