SSD Nodes Learn Hosting plans →
Guías Matt ConnorPor Matt Connor · Actualizado 2026-08-25

Claude en Linux: app de escritorio y CLI

Qué funciona de forma nativa en Linux: app beta desde apt, Claude Code CLI, plugins de editor y el plan de pago que incluye cada opción.

Qué partes de Claude se ejecutan de forma nativa en Linux actualmente

Claude se ejecuta en Linux mediante cuatro superficies independientes y, en agosto de 2026, las cuatro funcionan en un equipo Ubuntu o Debian convencional. La aplicación de escritorio se instala desde el repositorio apt de Anthropic y está en fase beta. Claude Code CLI (interfaz de línea de comandos) es un binario compilado y funciona en más distribuciones que la aplicación de escritorio. La aplicación web de claude.ai sólo necesita un navegador, y la API es un endpoint HTTPS al que se llama desde código propio.

La beta de escritorio para Linux no incluye dos funciones disponibles en macOS y Windows: Computer Use, que permite a Claude controlar aplicaciones en la pantalla, y el dictado por voz. Anthropic documenta ambas como funciones todavía no disponibles en Linux. La CLI tiene su propio dictado por voz, por lo que la limitación afecta a la aplicación de escritorio, no a Claude en general.

La disponibilidad cambia. Considere esta página una descripción de las superficies disponibles y compruebe el estado actual antes de planificar en función de ellas. La última sección enumera las páginas que debe consultar.

Instalar la aplicación de escritorio de Claude en Ubuntu o Debian

Los requisitos documentados son Ubuntu 22.04 o posterior, o Debian 12 o posterior, en x86_64 (que dpkg denomina amd64) o arm64. Es posible que funcionen otras distribuciones basadas en Debian, pero no se han probado. Fedora y RHEL todavía no tienen ningún paquete, así que en esos sistemas debe usar la CLI o el navegador.

Instale la aplicación desde el repositorio apt en lugar de usar un archivo .deb descargado. La aplicación para Linux no tiene un actualizador propio, por lo que las nuevas versiones sólo llegan a través del gestor de paquetes. Registrar el repositorio permite que apt upgrade las encuentre.

sudo apt install curl gnupg
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc \
  https://downloads.claude.ai/claude-desktop/key.asc
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc

gpg --show-keys debe mostrar la huella digital 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Compárela antes de registrar el repositorio, porque una clave de firma que no ha verificado es una clave en la que confía a ciegas. Si gpg informa de que el archivo no contiene datos OpenPGP válidos, la descarga ha fallado y apt update fallará después con NO_PUBKEY BAA929FF1A7ECACE.

Registrar el repositorio consiste en escribir una línea deb en /etc/apt/sources.list.d/claude-desktop.list. Copie esa línea de la página de instalación de Linux de Anthropic, code.claude.com/docs/en/desktop-linux, exactamente como aparece allí. La dirección del repositorio es la parte de este procedimiento que tiene más probabilidades de cambiar. Escribir la línea de memoria es lo que hace que después aparezca E: Unable to locate package claude-desktop. Lea la línea antes de pegarla: arch=amd64,arm64 es la razón por la que apt no encuentra nada en otra arquitectura, y signed-by= apunta al archivo de claves que acaba de comprobar. Esto limita esa clave a este repositorio en lugar de confiar en ella para todo lo demás que apt lea.

sudo apt update && sudo apt install claude-desktop

Iníciela desde el lanzador de aplicaciones o ejecute claude-desktop en un terminal. Inicie sesión con su cuenta de claude.ai o mediante el SSO (inicio de sesión único) de su organización, si su empresa lo ha configurado. La aplicación de escritorio no acepta una clave de API de Claude Console: la autenticación mediante clave es una función de la CLI.

E: Unable to locate package claude-desktop significa que apt nunca leyó el repositorio. cat /etc/apt/sources.list.d/claude-desktop.list debe mostrar la línea deb que escribió, y dpkg --print-architecture debe mostrar amd64 o arm64, porque no se publican paquetes para otras arquitecturas. Después, las actualizaciones llegan con el resto del sistema desde sudo apt update && sudo apt upgrade.

Qué sólo está disponible en un navegador

claude.ai funciona en cualquier navegador actual y en cualquier distribución, por lo que es la opción para Fedora, RHEL, Arch, openSUSE y cualquier otra distribución que no tenga un paquete. El navegador también ofrece Claude Code en la web. La sesión se ejecuta en la nube de Anthropic en lugar de hacerlo en su máquina y siempre usa las credenciales de su suscripción.

Es importante entender la limitación del navegador. Una sesión en la nube no puede leer los archivos de su propio servidor ni ejecutar comandos en él. Cualquier operación que acceda a su máquina necesita software instalado en esa máquina. Eso significa usar la CLI o la aplicación de escritorio.

Lo que ofrece la CLI y no ofrece la aplicación web

Inicie claude en un directorio y funcionará sobre ese directorio. Esa es la diferencia. Todo lo demás se deriva de ella.

  • Lee y edita los archivos del directorio de trabajo y muestra cada cambio antes de aplicarlo.
  • Ejecuta los comandos de shell que usted aprueba. Así puede compilar un proyecto, ejecutar una suite de pruebas, leer un registro o inspeccionar un servicio directamente en el servidor.
  • Funciona sin una sesión interactiva: claude -p "read the nginx error log and summarise it" imprime una respuesta y termina. Esto es lo que se usa desde un trabajo de cron o una canalización. Usted decide el formato de esa respuesta, porque un estilo de salida modifica el prompt del sistema que precede a cada respuesta y puede mantener concisa una ejecución programada, mientras una sesión interactiva ofrece explicaciones.
  • Conecta servidores MCP (model context protocol) mediante claude mcp add. Esto proporciona al modelo herramientas que van más allá del sistema de archivos.
  • Funciona donde no existe ningún escritorio gráfico. Eso incluye cualquier VPS (virtual private server) que alquile.

Este último punto explica por qué una guía para servidores presta atención a la CLI. Un servidor alquilado tiene SSH (secure shell) y nada más. Por tanto, el terminal es la única interfaz disponible para trabajar con él. Ejecutarlo de esa forma tiene sus propias reglas. Ejecutar Claude Code en un VPS dentro de tmux las explica en detalle, y Usar Claude para las tareas habituales de administración de sistemas cubre los trabajos que merece la pena delegarle.

Las integraciones con editores se sitúan entre ambas opciones. La extensión de VS Code requiere VS Code 1.94.0 o posterior y proporciona un panel gráfico dentro del editor, con revisión de diferencias y del plan. Incluye una copia privada de la CLI para ese panel y no coloca claude en su PATH. Por tanto, escribir claude en el terminal integrado sigue requiriendo la instalación independiente. Los editores basados en VS Code instalan la misma extensión desde el registro Open VSX. También existe un complemento para JetBrains.

¿Necesita Node.js para ejecutar Claude Code en Linux?

No con el método de instalación recomendado. El instalador nativo descarga un binario compilado, y ese binario no se ejecuta en Node.js.

curl -fsSL https://claude.ai/install.sh | bash
claude --version

claude --version debe mostrar un número de versión como 2.1.211 (Claude Code). Si algo parece incorrecto, ejecute claude doctor. Este comando muestra diagnósticos de solo lectura sobre la instalación y los archivos de configuración, sin iniciar una sesión.

Node.js sólo es relevante con el método de npm. A partir de la versión 2.1.198 del paquete, el paquete de npm requiere Node.js 22 o posterior. En una versión anterior de Node.js, npm muestra una advertencia EBADENGINE en lugar de fallar, porque el paquete incorpora el mismo binario nativo como dependencia específica de cada plataforma y lo enlaza en la ubicación correspondiente.

npm install -g @anthropic-ai/claude-code

No ejecute ese comando con sudo. La documentación desaconseja sudo npm install -g porque deja archivos propiedad de root en el prefijo global de npm. Como consecuencia, la siguiente instalación o actualización sin privilegios falla por problemas de permisos. Cuando el directorio global de npm no permite escritura, la actualización automática en segundo plano deja de funcionar y claude doctor muestra las correcciones disponibles.

Anthropic también publica repositorios de paquetes firmados para Debian, Fedora, RHEL y Alpine. Por eso, sudo apt install claude-code funciona de forma similar al paquete de escritorio y utiliza su propia clave de firma en https://downloads.claude.ai/keys/claude-code.asc.

¿Debe instalarlo por usuario o para todo el sistema?

El instalador nativo realiza una instalación por usuario. Coloca un lanzador en ~/.local/bin/claude como enlace simbólico a ~/.local/share/claude/versions/, no necesita root y se actualiza en segundo plano. Cada usuario de la máquina obtiene una copia independiente con una versión independiente.

La instalación mediante un gestor de paquetes se realiza para todo el sistema. Un solo binario sirve a todos los usuarios, necesita root y no se actualiza automáticamente mediante Claude Code. Se actualiza con sudo apt update && sudo apt upgrade claude-code, el mismo comando que ya ejecuta para el resto del sistema.

Elija la instalación por usuario en una máquina a la que accede con su propia cuenta, como ocurre en la mayoría de los trabajos con VPS. Elija la instalación mediante paquetes en un servidor compartido o en una imagen de máquina, si quiere una versión única para todos los usuarios y que se actualice según su calendario. En una instalación nativa, dos opciones de ~/.claude/settings.json determinan cómo se comportan las actualizaciones:

{
  "autoUpdatesChannel": "stable",
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

El canal stable sigue una versión con aproximadamente una semana de antigüedad y omite las versiones con regresiones importantes. DISABLE_AUTOUPDATER detiene sólo la comprobación en segundo plano, por lo que claude update sigue funcionando y usted conserva el control sobre cuándo se instala una versión nueva. Esto es importante en un servidor donde se ejecuta un trabajo largo sin supervisión y no quiere que el binario cambie durante su ejecución.

Inicie sesión por SSH y mantenga activa la sesión

La primera vez que ejecuta la CLI en un servidor alquilado aparecen dos problemas específicos de Linux. El flujo de inicio de sesión requiere un navegador, pero el servidor no tiene ninguno. Si la conexión SSH se interrumpe, también se interrumpe el trabajo que estaba ejecutando.

tmux resuelve el segundo problema. Una sesión de tmux pertenece al servidor de tmux en la máquina remota, no a la conexión. Por tanto, si el enlace se interrumpe, el proceso sigue ejecutándose.

tmux new -s claude
claude

Desconéctese con Ctrl-b y después d. Vuelva más tarde con tmux attach -t claude.

El inicio de sesión es el primer problema. Ejecute claude para mostrar una URL de autorización. Abra esa URL en el navegador de su propio equipo. Después de iniciar sesión, el navegador muestra un código de inicio de sesión en lugar de redirigir de vuelta, porque el navegador de su portátil no puede acceder al servidor de callback que Claude Code inició en la dirección de loopback de la máquina remota. Pegue ese código en el terminal, en el prompt Paste code here if prompted. El terminal muestra Login successful.

Si la sesión debe iniciarse sin que nadie la supervise, claude setup-token abre la misma autorización en el navegador y muestra un token OAuth válido durante un año en el terminal. No guarda el token en ningún sitio. Cópielo y configúrelo donde lo necesite.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Ese token requiere un plan de pago y sólo puede realizar solicitudes a modelos. Trátelo como una contraseña con una vigencia de un año. Dónde guardarlo y cómo impedir que un agente lo lea es el tema de mantener los secretos fuera del alcance de los agentes de IA.

Los servidores pequeños tienen otro problema. La instalación requiere aproximadamente 512 MB de memoria libre. El requisito de hardware documentado para ejecutarlo es de 4 GB de RAM o más. Por tanto, en una instancia de 1 GB, el killer de falta de memoria del kernel termina la instalación:

Setting up Claude Code...
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

Añada swap y vuelva a ejecutar el instalador. La swap es espacio de disco que el kernel usa como memoria de desbordamiento. Es mucho más lenta que la RAM, pero basta para terminar una instalación.

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

swapon activa el archivo sólo durante este arranque. Añada una línea para /swapfile a /etc/fstab si quiere que vuelva a estar disponible después de reiniciar. El tema de qué más debe proteger antes de permitir que un agente ejecute comandos en un servidor activo es ejecutar Claude Code de forma segura en un VPS.

Dónde se almacenan las credenciales de Claude en Linux

En Linux, /login escribe la credencial en ~/.claude/.credentials.json con el modo de archivo 0600. macOS almacena la misma credencial en el Keychain cifrado, por lo que un hábito adquirido en un Mac no se aplica aquí: en Linux, el token es un archivo de texto sin cifrar en el directorio personal, y cualquier proceso que se ejecute con su usuario puede leerlo. Definir CLAUDE_CONFIG_DIR mueve el archivo a ese directorio.

Esto tiene dos consecuencias. Una copia de seguridad de /home contiene una sesión activa, por lo que copiarla a una máquina compartida entrega su cuenta a cualquier otra persona que pueda leerla. Además, una imagen de máquina creada a partir de un equipo en el que inició sesión incluye esa sesión en todas las instancias clonadas a partir de ella. Ejecute /logout antes de crear una instantánea.

La precedencia de credenciales causa problemas a quienes tienen una suscripción y una clave de API al mismo tiempo. Cuando ANTHROPIC_API_KEY está definida en el shell, Claude Code la usa después de que usted la aprueba. La suscripción queda sin utilizar mientras la clave genera cargos por token. /status muestra qué credencial está activa, y unset ANTHROPIC_API_KEY le devuelve al inicio de sesión de la suscripción.

Las sesiones caducan. Durante los tres días anteriores a la caducidad, la línea de inicio muestra Your login expires in 3 days, y esa advertencia nunca bloquea una petición. Después de la caducidad, todas las peticiones fallan con Login expired · Please run /login. Téngalo en cuenta antes de dejar una sesión desatendida durante un fin de semana, porque esa sesión deja de avanzar y no puede recuperarse por sí sola.

¿Una sola suscripción de Claude cubre todas las opciones?

Un plan de pago cubre todas las interfaces con el mismo inicio de sesión. Una cuenta Pro, Max, Team o Enterprise permite iniciar sesión en claude.ai desde un navegador, en la aplicación de escritorio, en la CLI y en la extensión de VS Code. En todos los casos se utiliza la misma suscripción. También se comparte el mismo límite de uso entre todas ellas. Por tanto, una ejecución larga de la CLI en el servidor consume parte de lo que queda disponible para la aplicación de escritorio. Cuando alguna interfaz deja de aceptar solicitudes, debe determinar qué ventana de límite se ha alcanzado y qué hacer al respecto. El plan gratuito de claude.ai no incluye acceso a Claude Code. Por eso, la CLI y las funciones de Claude Code de la aplicación de escritorio requieren un plan de pago o una cuenta de Claude Console.

La API es un producto distinto, con una facturación diferente. Una cuenta de Console factura por token según lo que envía realmente. Esto resulta adecuado para un servicio que está desarrollando, no para escribir comandos en un terminal. Configurar ANTHROPIC_API_KEY cambia la CLI a ese modelo de facturación. Es una decisión explícita, no un mecanismo alternativo automático.

Los precios y los límites de los planes cambian con demasiada frecuencia para repetirlos aquí. Dos páginas mantienen las cifras actuales: cuánto cuesta realmente Claude Code y qué plan de Claude necesita. Si está comparando la facturación por token con un plan mensual, la API frente a una suscripción explica dónde se encuentra el punto de equilibrio.

Los errores de instalación que realmente verá

bash: claude: command not found justo después de una instalación correcta. El binario está en ~/.local/bin/claude y ese directorio no está incluido en la ruta de búsqueda de su shell. Confírmelo con echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin", que no muestra nada cuando falta la entrada. Corríjalo para bash con echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc y, después, ejecute source ~/.bashrc. Instalar únicamente la extensión de VS Code nunca crea ese archivo, porque la extensión mantiene su copia de la CLI dentro del directorio de la extensión.

Error loading shared library libstdc++.so.6. El instalador seleccionó la compilación para musl en un sistema con glibc. Esto ocurre cuando hay paquetes de compilación cruzada para musl y la detección los interpreta incorrectamente. Ejecute ldd --version 2>&1 | head -1: los nombres de salida GNU libc o GLIBC indican que usa glibc y recibió el binario equivocado. Elimine la instalación y vuelva a ejecutar el instalador. En Alpine y otros sistemas con musl, la corrección es la opuesta: apk add libgcc libstdc++ ripgrep.

Dos copias de claude en el mismo equipo. which -a claude muestra todas las coincidencias de su PATH. Una instalación nativa es un enlace simbólico desde ~/.local/bin/claude hacia ~/.local/share/claude/versions/, una instalación local heredada de npm se encuentra en ~/.claude/local/ y npm -g ls @anthropic-ai/claude-code muestra una instalación global de npm. Elimine las copias que no quiera, porque una copia antigua situada antes en su PATH hace que un error ya corregido parezca seguir presente.

Dónde consultar el estado actual

Todos los números de versión y las fechas de esta guía corresponden a una instantánea de agosto de 2026. Lo que se mantiene es la estructura: cuatro superficies, un único inicio de sesión para las opciones de pago y una decisión sobre si la CLI pertenece a tu usuario o a todo el equipo.

FAQ

¿Existe una aplicación de escritorio de Claude para Linux?

Sí. En agosto de 2026 está en fase beta y admite Ubuntu 22.04 o posterior y Debian 12 o posterior en amd64 o arm64. Instálela con sudo apt install claude-desktop después de añadir el repositorio apt de Anthropic y su clave de firma, para que las nuevas versiones lleguen con las actualizaciones normales del sistema. La versión para Linux tiene las mismas pestañas que la aplicación para macOS, incluida la pestaña Claude Code. Computer Use y el dictado por voz todavía no están disponibles en la versión para Linux. Fedora y RHEL no tienen ningún paquete, por lo que en esas distribuciones debe usar la CLI o claude.ai en un navegador.

¿Necesito Node.js para ejecutar Claude Code en Linux?

No para la instalación recomendada. curl -fsSL https://claude.ai/install.sh | bash descarga un binario compilado que no usa Node.js durante la ejecución. Node.js sólo es necesario si instala el paquete npm, que requiere Node.js 22 o posterior a partir de la versión 2.1.198. Con una versión anterior de Node.js, npm muestra una advertencia EBADENGINE y la instalación termina igualmente, porque se incorpora el mismo binario nativo como dependencia específica de la plataforma. No lo instale con sudo npm install -g, porque deja archivos propiedad de root en su prefijo de npm e impide las actualizaciones posteriores.

¿Cómo inicio sesión en Claude Code mediante SSH?

Ejecute claude. El comando muestra una URL de autorización. Abra esa URL en el navegador de su propio equipo, no en el servidor. Después de iniciar sesión, el navegador muestra un código de inicio de sesión en lugar de redirigir la página, porque no puede acceder al listener de callback que Claude Code inició en la dirección de loopback de la máquina remota. Pegue ese código en el indicador Paste code here if prompted. Para sesiones que se inician sin nadie presente, ejecute claude setup-token y establezca el token mostrado como CLAUDE_CODE_OAUTH_TOKEN donde sea necesario.

¿Dónde guarda Claude Code mi sesión en Linux?

En ~/.claude/.credentials.json con el modo de archivo 0600, o en CLAUDE_CONFIG_DIR cuando establece esa variable. En Linux no interviene ningún keychain, a diferencia de macOS, por lo que cualquier proceso que se ejecute con su usuario puede leer el archivo. Por tanto, una copia de seguridad /home o una imagen de la máquina contiene una sesión válida: ejecute /logout antes de crear una instantánea o copiar un sistema. Si ANTHROPIC_API_KEY también está establecida en su entorno, tiene prioridad sobre la sesión de suscripción almacenada una vez que la aprueba, y /status muestra cuál está activa.

¿Mi suscripción Claude Pro también cubre la CLI y la aplicación web?

Sí. Un plan Pro, Max, Team o Enterprise inicia sesión en claude.ai, la aplicación de escritorio, la CLI y la extensión de VS Code con una sola cuenta. El plan gratuito de claude.ai no incluye Claude Code, por lo que la CLI del terminal requiere un plan de pago o una cuenta de Claude Console. La API se factura por separado, por token, desde una cuenta de Console, que es un producto distinto de una suscripción.

#claude#linux#claude-code#cli#desktop