Claude Code Desktop o terminal: cuál elegir para tu VPS

Claude Code Desktop: la respuesta corta

Claude Code Desktop existe, pero no es un programa aparte. Es la pestaña Code dentro de la app de escritorio de Claude. La app ya trae Claude Code dentro, así que no instalas Node.js ni la CLI (interfaz de línea de comandos) para usar esa pestaña. Usa el mismo motor que la terminal y gasta del mismo límite de tu plan.

La app tiene tres pestañas, y conviene no confundirlas. Chat es la conversación normal, sin acceso a archivos, parecida a claude.ai. Cowork es un agente autónomo que trabaja en segundo plano. Code es el asistente de programación, con acceso directo a tus archivos locales. Esta guía habla solo de la pestaña Code.

Para usarla necesitas un plan de pago. La guía rápida de Anthropic lo dice así: "Claude Code requires a Pro, Max, Team, or Enterprise subscription". Si al pulsar Code la app te pide mejorar el plan, tu cuenta todavía no tiene ninguno de esos planes. Si dudas sobre lo que cubre el tuyo, lo explicamos en si Claude Code viene incluido en Claude Pro y con qué límites. Y si la idea de un agente que edita tu código es nueva para ti, empieza por qué es Claude Code y cómo trabaja.

Un detalle práctico: la app no te da el comando claude en la terminal. Si también lo quieres ahí, instalas la CLI por separado.

¿En qué sistemas funciona la app de escritorio?

• macOS: un único instalador universal para Intel y Apple Silicon.
• Windows: un instalador para x64 y otro instalador separado para ARM64.
• Linux: en beta, instalado con apt desde el repositorio de Anthropic.

La versión de Linux tiene más condiciones. Solo funciona en distribuciones basadas en Debian: Ubuntu 22.04 o posterior, o Debian 12 o posterior, sobre x86_64 o arm64. En Fedora o Arch, Anthropic indica usar la CLI. La app no se actualiza sola en Linux: las actualizaciones llegan con las actualizaciones normales de paquetes del sistema. Además, inicia sesión con tu suscripción de claude.ai o con SSO (single sign-on, inicio de sesión único). No acepta directamente una API key de Claude Console. Los pasos para añadir el repositorio están en la página de Linux de la documentación de Claude Code.

Aquí está la confusión más común entre quienes tienen un VPS. La app es gráfica. Tu VPS normalmente no tiene escritorio ni pantalla, así que la app no se instala en el servidor. Se instala en tu portátil, y desde ahí se conecta al VPS por SSH. Esa conexión es la parte importante de esta guía y la vemos más abajo.

¿Gasta la app menos límite que la terminal?

No. La documentación lo dice sin rodeos: "plan usage is shared across all your Claude Code surfaces". El contexto es por sesión, pero el consumo del plan es uno solo. Un mensaje en la app y un mensaje en la terminal salen de la misma bolsa.

Lo mismo pasa con las sesiones en la nube (el entorno Cloud). Cuentan para los límites de tu plan junto con el resto de tu uso de Claude y Claude Code, y comparten los límites de frecuencia con todo lo demás de tu cuenta. No hay un cobro aparte por la máquina virtual en la nube. Si quieres entender cómo funciona eso, tenemos una guía sobre los créditos y el consumo de las sesiones en la nube de Claude Code.

Hay un gasto pequeño que mucha gente no ve. Cuando la app te sugiere el siguiente prompt, esa sugerencia sale de una petición corta en segundo plano. Esa petición cuenta para los límites de tu plan, o para tu coste de API si pagas por API. No es algo exclusivo de la app: la CLI también genera estas sugerencias con el mismo tipo de petición. El coste es bajo, porque la petición reutiliza la caché del prompt y produce pocos tokens de salida, y se omite cuando estás cerca del límite. Aun así, si quieres apagarla:

• En la app: Settings > Claude Code, y desactiva Prompt suggestions en el apartado Sessions. El cambio se aplica desde la próxima vez que empiezas o reanudas una sesión.
• En la CLI: /config y la opción Prompt suggestions, el ajuste promptSuggestionEnabled, o la variable de entorno de abajo.

export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
claude

La conclusión es simple. La app es otra puerta al mismo límite. No es una forma de esquivarlo.

¿Qué añade Claude Code Desktop frente a la CLI?

Anthropic resume la elección en su documentación: usa Desktop cuando quieres gestionar sesiones en paralelo en una ventana, colocar paneles lado a lado o revisar los cambios de forma visual. Usa la CLI cuando necesitas scripts, automatización o prefieres trabajar en la terminal. Lo que sigue sale de su comparación de funciones, en la sección "Coming from the CLI?".

Sesiones en paralelo. En la app, cada sesión es una pestaña en la barra lateral. Abres una nueva con + New session, o con Cmd+N en macOS y Ctrl+N en Windows. En la CLI, el equivalente es abrir otra terminal.

Aislamiento con worktrees. Al empezar una sesión puedes elegir la opción worktree, que le da a esa sesión su propio worktree de Git. En la CLI es la opción --worktree. Por defecto los worktrees se guardan en <project-root>/.claude/worktrees/. Esto necesita que el proyecto sea un repositorio Git.

Revisión visual de cambios. La vista de diff te deja revisar las modificaciones archivo por archivo antes de crear un pull request. Es la razón principal por la que mucha gente prueba la app.

Vista previa de la aplicación. Claude puede arrancar un servidor de desarrollo y abrirlo en el panel Browser para comprobar sus propios cambios.

Adjuntos. En la app puedes adjuntar imágenes y PDF. La comparación marca esta función como no disponible en la CLI.

Tareas programadas. La app tiene tareas programadas. En la CLI, el equivalente es cron o un pipeline de CI. Ojo con un detalle: una tarea local solo se ejecuta mientras la app está abierta y el equipo está despierto. Si el portátil duerme, esa ejecución no ocurre. Las rutinas remotas sí se ejecutan en la nube con el equipo apagado. La documentación no describe tareas programadas que se ejecuten en un host SSH, así que para algo que debe correr cada noche en tu VPS, el cron del propio servidor sigue siendo la herramienta.

Dispatch. Dispatch es una conversación persistente que vive en la pestaña Cowork y que puede abrir sesiones de Code en tu escritorio. Requiere un plan Pro o Max. No está disponible en Team ni en Enterprise.

¿Qué sigue siendo exclusivo de la terminal?

La página de plataformas de Anthropic recomienda la CLI para "Terminal workflows, scripting, remote servers". Las diferencias concretas son estas:

• Scripts y automatización. --print, --output-format y el Agent SDK solo existen en la CLI. La documentación lo dice así: "Desktop is interactive only".
• El modo de permisos dontAsk. La app ofrece los modos Manual, Accept edits, Plan y Auto. Si quieres entender qué hace cada uno, tenemos una guía sobre los modos de permisos y el modo Auto de Claude Code.
• Agent teams. Los equipos de agentes están en la CLI y no en la app. La app tiene en su lugar flujos dinámicos para trabajo con varios agentes dentro de una misma sesión.
• Proveedores externos directos. La CLI se conecta directamente a Amazon Bedrock, Agent Platform de Google Cloud y Microsoft Foundry. La app usa por defecto la API de Anthropic. Para empresas, Anthropic documenta aparte cómo conectar la app a un gateway o a esos proveedores.

¿Comparten la misma configuración?

Sí, casi toda. La app y la CLI leen los mismos archivos. Los CLAUDE.md y CLAUDE.local.md de tu proyecto sirven para las dos. Los servidores MCP (Model Context Protocol) definidos en ~/.claude.json o en .mcp.json funcionan en las dos. Los hooks y las skills definidos en los ajustes se aplican a las dos, y los ajustes de ~/.claude/settings.json se comparten. Si no tienes clara la diferencia entre esas piezas, la explicamos en skills, MCP y archivos de reglas para agentes.

Hay una excepción. La app también carga en sus sesiones locales de Code los servidores MCP de claude_desktop_config.json, y la CLI no lee ese archivo. En macOS y en WSL puedes copiarlos a la CLI con este comando:

claude mcp add-from-claude-desktop

Las dos pueden funcionar al mismo tiempo, incluso sobre el mismo proyecto. Cada una guarda su propia lista de sesiones.

¿Cómo paso una sesión de la terminal a la app?

Dentro de la CLI, escribe /desktop. Claude guarda la sesión, la abre en la app y cierra la CLI. Este comando tiene límites claros: funciona en macOS y en Windows x64, y solo si inicias sesión con una suscripción de Claude. No funciona con una API key, ni con Bedrock, Agent Platform o Foundry. La documentación no lo menciona para Linux ni para Windows ARM64.

En sentido contrario, /resume dentro de la app recupera sesiones de la CLI, pero solo en sesiones locales. No funciona en sesiones SSH, WSL ni Cloud. La consecuencia para ti: una sesión de la CLI que corre en tu VPS no se mueve a la app con ninguno de estos dos comandos. Si quieres ver cómo se guardan y se recuperan las sesiones en la terminal, lo contamos en reanudar sesiones y el historial de Claude Code.

Claude Code Desktop por SSH contra tu VPS

Al abrir una sesión en la pestaña Code eliges un entorno. La documentación nombra cuatro: Local (tu máquina y tus archivos), Cloud (sesiones en la nube que siguen aunque cierres la app), SSH (una máquina remota, como tu propio servidor) y WSL (una distribución WSL 2, solo en Windows). Uso las etiquetas en inglés porque son las que documenta Anthropic. El centro de ayuda de Claude lista español (Latinoamérica) y español (España) entre los idiomas de la interfaz, pero no he encontrado nombres en español documentados para estas opciones. Si tu app las muestra traducidas, busca el equivalente.

El entorno SSH es el que interesa a quien tiene un VPS. La app corre en tu portátil con Windows o macOS, y Claude Code corre en el servidor Linux. El equipo remoto debe ejecutar Linux o macOS. La primera vez que te conectas, la app instala Claude Code en el servidor por su cuenta. No tienes que instalar nada a mano.

Paso 1: deja la conexión lista en tu portátil

La app puede usar tu archivo ~/.ssh/config o tu agente SSH, así que conviene tener la conexión resuelta antes. Añade un bloque como este a ~/.ssh/config (en Windows, el archivo config dentro de la carpeta .ssh de tu usuario):

Host mivps
    HostName 203.0.113.10
    User deploy
    Port 22
    IdentityFile ~/.ssh/id_ed25519

Cambia la IP, el usuario y la clave por los tuyos. Después prueba la conexión desde la terminal del portátil:

ssh mivps 'uname -s && git --version'

Una conexión sana imprime Linux y una línea como git version 2.x. Git importa porque el aislamiento con worktrees necesita un repositorio Git. Si ves Permission denied (publickey)., el servidor rechazó tu clave, y la app fallará igual. Arréglalo primero con la guía del error Permission denied (publickey).

Si tu clave tiene contraseña, cárgala en el agente para no escribirla en cada conexión:

ssh-add ~/.ssh/id_ed25519
ssh-add -l

ssh-add -l debe listar la huella de tu clave. Si responde The agent has no identities., la clave no está cargada.

Paso 2: añade la conexión en la app

En el selector de entorno, la documentación indica la ruta SSH > Add SSH connection…. Los campos son estos:

• Name: el nombre que verás en la app.
• SSH host: user@hostname, o un host definido en ~/.ssh/config. Con el bloque de arriba basta con escribir mivps.
• SSH port: 22 por defecto, o el que diga tu configuración SSH.
• SSH key: opcional. Si lo dejas vacío, la app usa tu configuración SSH o tu agente SSH.
• Worktree folder: dónde se crean los worktrees en ese servidor.

Paso 3: entiende qué lee la sesión remota

Una sesión SSH lee las skills de ~/.claude/skills/ en el directorio home del servidor, no de tu portátil. También lee el archivo de ajustes gestionados del servidor. Así que tus skills locales no viajan con la conexión. Si las quieres en el VPS, tienen que estar en el VPS. El CLAUDE.md de tu proyecto ya está en el servidor, porque el proyecto vive ahí.

Una vez conectada, la sesión SSH admite modos de permisos, conectores, plugins y servidores MCP. También funcionan el terminal integrado, el panel de archivos, el autocompletado con @, la tarjeta de revisión de código y los chats laterales.

Recuerda quién ejecuta los comandos. Claude Code corre en el VPS con el usuario con el que entras por SSH, así que puede hacer todo lo que ese usuario puede hacer. No te conectes como root. Usa un usuario normal y sigue cómo ejecutar Claude Code de forma segura en un VPS y cómo endurecer SSH en tu VPS.

Si administras un equipo: el ajuste sshHostAllowlist, leído solo desde los ajustes gestionados, limita a qué hosts se puede conectar la app, y una lista vacía desactiva las sesiones SSH. Solo la app respeta ese ajuste. La CLI no lo lee, y tampoco limita los comandos ssh que Claude ejecute con la herramienta Bash.

¿Qué ganas frente a tmux, y qué no?

Muchos lectores ya trabajan con Claude Code en el VPS dentro de tmux, como contamos en Claude Code en un VPS con tmux. La app por SSH no sustituye ese flujo en todo.

Lo que ganas es la parte visual. Tienes la vista de diff para revisar cambios archivo por archivo, el panel de archivos y varias sesiones en paralelo en la barra lateral, cada una en su worktree sobre el servidor. Tampoco tienes que instalar ni actualizar la CLI en el VPS a mano, porque la app la instala en la primera conexión.

Lo que no está claro es lo más importante para trabajos largos. La documentación estándar de la app no dice qué pasa con una sesión SSH si tu portátil se duerme o pierde la conexión. He buscado en la sección de sesiones SSH y en toda la página términos como disconnect, reconnect, sleep y resume, y no hay ninguna frase sobre ello. Anthropic sí documenta la reconexión para su versión de la app con proveedores externos (Claude Desktop on 3P), pero es otra variante del producto, y esa página no describe la app estándar. Así que no des por hecho que la sesión sobrevive.

tmux sí resuelve eso, por una razón concreta: el proceso de tmux vive en el servidor, no en tu portátil. Si cierras la tapa, la sesión sigue en el VPS y la recuperas al volver.

ssh mivps
tmux new -s claude
claude

Sales sin cerrar nada con Ctrl+b y luego d. Al volver, tmux attach -t claude te devuelve a la misma sesión. Para una tarea que debe durar horas, este sigue siendo el camino seguro. Si lo que quieres es seguir desde el teléfono, mira cómo usar Claude Code desde el móvil.

Dos límites más de las sesiones SSH en la app. /resume no recupera sesiones de la CLI en ellas. Y no puedes mover una sesión SSH a la nube. Las sesiones Cloud sí siguen aunque cierres la app o apagues el equipo, pero corren en la infraestructura de Anthropic, no en tu VPS.

Cómo elegir entre la app y la terminal

• Elige la app si revisas muchos cambios y quieres verlos como diff, o si llevas varias tareas a la vez en worktrees.
• Elige la terminal si necesitas --print, el Agent SDK, dontAsk, agent teams o un proveedor como Bedrock.
• Elige tmux en el VPS para trabajos largos que deben sobrevivir a un portátil dormido.
• Combina las dos sin miedo: comparten configuración y límite, y pueden funcionar a la vez sobre el mismo proyecto.

FAQ

¿Claude Code tiene una aplicación de escritorio?

Sí. Es la pestaña Code dentro de la app de escritorio de Claude, disponible para macOS, Windows x64 y ARM64, y Linux en beta con apt. La app incluye Claude Code, así que no necesitas instalar Node.js ni la CLI para usarla. Requiere un plan Pro, Max, Team o Enterprise.

¿La app de escritorio de Claude Code consume menos límite que la terminal?

No. Anthropic indica que el uso del plan se comparte entre todas las formas de usar Claude Code, así que la app y la terminal gastan del mismo límite. Las sesiones en la nube también cuentan para ese límite. Las sugerencias del siguiente prompt usan una petición corta en segundo plano que también cuenta, y puedes desactivarlas en Settings > Claude Code > Prompt suggestions.

¿Puedo usar Claude Code Desktop con mi VPS Linux?

Sí, con el entorno SSH. La app se instala en tu portátil con Windows o macOS y se conecta al servidor, que debe ejecutar Linux o macOS. En la primera conexión instala Claude Code en el servidor de forma automática. Puede usar tu ~/.ssh/config o tu agente SSH para la clave, y lee las skills y los ajustes gestionados del propio servidor.

¿La sesión SSH sigue viva si cierro el portátil?

La documentación estándar de la app no lo dice, así que no conviene contar con ello. Para trabajos largos en un VPS, ejecuta Claude Code dentro de tmux en el servidor. El proceso de tmux vive en el VPS, por lo que la sesión sigue aunque tu portátil se duerma, y la recuperas con tmux attach.

¿Puedo instalar la app de escritorio en Fedora o Arch?

No. La app de Linux está en beta y solo admite distribuciones basadas en Debian: Ubuntu 22.04 o posterior, o Debian 12 o posterior, en x86_64 o arm64. En Fedora, Arch y otras distribuciones, Anthropic indica usar la CLI, que funciona en más sistemas.