Aplicación de escritorio de Claude Code: Guía de instalación y primer uso

Objetivos de aprendizaje

Al final de este tutorial, podrás:

• Descargar e instalar la aplicación de escritorio de Claude Code en tu sistema operativo
• Iniciar sesión con tu cuenta de Claude y abrir la pestaña Code
• Iniciar tu primera sesión de programación con IA en la aplicación de escritorio
• Revisar y aceptar los cambios que propone Claude
• Solucionar problemas comunes de instalación

Tiempo necesario: 10–15 minutos

Dificultad: Principiante

¿Qué versión cubre esta guía? Esta guía cubre únicamente la aplicación de escritorio de Claude Code, la aplicación gráfica que descargas e instalas como un programa normal. No cubre el CLI de terminal ni la versión web. Si quieres trabajar en la terminal, ve directamente a la Guía de Claude Code CLI para principiantes.

Requisitos previos

Antes de empezar, asegúrate de tener:

¿Qué es la aplicación de escritorio de Claude Code?

La aplicación de escritorio de Claude Code es la versión de aplicación de escritorio del agente de codificación IA de Anthropic. A diferencia del CLI (herramienta de línea de comandos), ofrece una interfaz gráfica: una barra lateral para ejecutar varias sesiones en paralelo, un diseño de arrastrar y soltar con terminal y editor de archivos integrados, una vista de diff para revisar cambios y vista previa de la aplicación en vivo. No se necesita terminal.

Importante: el plan gratuito de Claude.ai no incluye Claude Code. Necesitas una suscripción de pago (Pro desde $20/mes, Max desde $100/mes, Team o Enterprise).

Descargar e instalar

La aplicación de escritorio incluye Claude Code integrado. No necesitas instalar Node.js ni el CLI por separado: la descarga siguiente es todo lo que necesitas.

Iniciar sesión y abrir la pestaña Code

Al iniciar la aplicación de escritorio por primera vez, verás una pantalla de inicio de sesión:

1. 1Haz clic en Iniciar sesión y entra con tu cuenta de Claude (tu suscripción Pro, Max, Team o Enterprise). Se abre una ventana del navegador para completar el inicio de sesión y luego vuelve a la aplicación.
2. 2La aplicación tiene tres pestañas en la parte superior:

• Chat — conversación general sin acceso a archivos, similar a claude.ai
• Cowork — un agente de fondo autónomo que trabaja en tareas en una máquina virtual en sandbox mientras haces otras cosas
• Code — un asistente de codificación interactivo con acceso directo a tus archivos locales. Esta es la pestaña que usa este tutorial.

1. 1Haz clic en la pestaña Code.

• Si te pide actualizar, tu cuenta no incluye Claude Code: suscríbete a un plan de pago primero.
• Si te pide iniciar sesión en línea, completa el inicio de sesión y reinicia la aplicación.

1. 1Cuando se abra la pestaña Code, la aplicación de escritorio está lista.

Tu primera sesión de codificación

Paso 1: Elige un entorno y una carpeta

En la pestaña Code, selecciona Local para que Claude se ejecute en tu máquina usando tus archivos directamente. Luego haz clic en Seleccionar carpeta y elige el directorio de tu proyecto.

Consejo: empieza con un proyecto pequeño que conozcas bien. Es la forma más rápida de ver lo que Claude Code puede hacer.

También puedes elegir otros entornos:

• Cloud — ejecuta la sesión en la nube; sigue ejecutándose aunque cierres la aplicación
• SSH — se conecta a una máquina remota, como un servidor, una VM en la nube o un contenedor de desarrollo
• WSL (solo Windows) — ejecuta la sesión dentro de una distribución Linux WSL 2

Para este tutorial, Local es todo lo que necesitas.

Paso 2: Elige un modelo

Junto al botón de enviar hay un menú desplegable de modelos. Selecciona el modelo que quieras usar. Puedes cambiarlo más tarde desde el mismo menú en cualquier momento.

Paso 3: Dile a Claude qué hacer

Escribe lo que quieres que Claude haga, por ejemplo:

Añade pruebas para la función principal

Otros ejemplos que puedes probar:

• Encuentra un comentario TODO y arréglalo — encuentra código sin terminar y lo corrige
• Crea un CLAUDE.md con instrucciones para este repositorio — escribe un archivo de guía del proyecto
• Explica qué hace este proyecto — resume el proyecto

Una sesión es una conversación con Claude sobre tu código. Cada sesión realiza un seguimiento de su propio contexto y cambios, por lo que puedes trabajar en varias tareas sin que interfieran entre sí.

Paso 4: Revisa y acepta los cambios

Por defecto, la pestaña Code comienza en modo manual, donde Claude propone cambios y espera tu aprobación antes de aplicarlos. Verás:

1. 1Una vista de diff que muestra exactamente qué cambiará en cada archivo
2. 2Botones Aceptar / Rechazar para aprobar o rechazar cada cambio
3. 3Actualizaciones en tiempo real mientras Claude trabaja en tu solicitud

Tus archivos no se modifican hasta que haces clic en Aceptar. Si rechazas un cambio, Claude pregunta cómo prefieres proceder de otra forma.

Paso 5: Prueba funciones más útiles

• Interrumpe y dirige — haz clic en el botón de detener para interrumpir a Claude, o escribe una corrección y pulsa Enter sin detener la acción en curso
• Dale a Claude más contexto — escribe @nombre-de-archivo en el cuadro de entrada para traer un archivo a la conversación, o arrastra y suelta archivos directamente en el cuadro
• Abre la terminal — pulsa Ctrl + \` (acento grave) para abrir una terminal integrada junto a tu sesión
• Cambia los modos de permisos — usa el selector de modo para alternar entre Manual (preguntar antes de cada cambio), Aceptar ediciones (autoaceptar ediciones de archivos para iterar más rápido) y Plan (proponer un enfoque sin editar nada)
• Vista previa de tu aplicación — cuando ejecutas tu servidor de desarrollo, tu aplicación se abre en el panel del navegador donde Claude puede verla y probar los endpoints

Solución de problemas

Cómo desinstalar

Siguientes pasos

• Lee la guía de CLI: la aplicación de escritorio y el CLI comparten el mismo motor y configuración (archivos CLAUDE.md, servidores MCP, habilidades). Aprende la versión de terminal en la Guía de Claude Code CLI para principiantes
• Usa habilidades para tareas repetitivas: escribe / o haz clic en el botón + para explorar comandos integrados y habilidades personalizadas
• Ejecuta sesiones en paralelo: abre la barra lateral para trabajar en varias tareas a la vez, cada una en su propio worktree de Git
• Pon a Claude en un horario: configura tareas programadas para una revisión de código diaria, una auditoría de dependencias semanal o un resumen matutino
• Conecta herramientas externas: haz clic en el botón + junto al cuadro de entrada y selecciona Plugins para añadir habilidades, agentes y servidores MCP