Claude en Linux: aplicación de escritorio y CLI

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

Claude se ejecuta en Linux en 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. La CLI de Claude Code (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 en claude.ai sólo necesita un navegador, y la API es un endpoint HTTPS al que se accede desde código propio.

A la beta de escritorio para Linux le faltan dos funciones disponibles en macOS y Windows: Computer Use, con la que Claude controla las aplicaciones que aparecen en pantalla, y el dictado por voz. Anthropic indica que ninguna de las dos está disponible todavía en Linux. La CLI tiene su propio dictado por voz, por lo que la limitación afecta a la aplicación de escritorio y no a Claude en general.

La disponibilidad cambia, así que considere esta página una descripción de las superficies disponibles y compruebe el estado actual antes de basar sus planes en ella. 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, por lo que en esas distribuciones debe usar la CLI o el navegador.

Instálela desde el repositorio de apt en lugar de usar un archivo .deb descargado. La aplicación para Linux no tiene su propio actualizador, por lo que las versiones nuevas sólo llegan a través del gestor de paquetes. Registrar el repositorio es lo que 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 debería mostrar la huella digital 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Compárela antes de registrar el repositorio, porque una clave de firma que no haya comprobado 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 más probablemente cambie. Si escribe la línea de memoria, es posible que después se encuentre con 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 ninguna otra arquitectura, y signed-by= apunta al archivo de keyring 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 basada en claves 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 debería mostrar la línea deb que escribió, y dpkg --print-architecture debería mostrar amd64 o arm64, porque no se publican paquetes para otras arquitecturas. A partir de ese momento, las actualizaciones llegan con el resto del sistema desde sudo apt update && sudo apt upgrade.

Lo que sólo existe 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 sin un paquete disponible. El navegador también ofrece Claude Code en la web, donde la sesión se ejecuta en la nube de Anthropic en lugar de hacerlo en su máquina y siempre utiliza 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 requiere software instalado en ella, es decir, 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 trabajará sobre ese directorio. Esa es la diferencia. El resto 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.
• Se ejecuta sin una sesión interactiva: claude -p "read the nginx error log and summarise it" muestra una respuesta y termina. Esto es lo que se usa desde un trabajo de cron o una canalización.
• Conecta servidores MCP (model context protocol) mediante claude mcp add. Esto proporciona al modelo herramientas que van más allá del sistema de archivos.
• Se ejecuta aunque no haya ningún escritorio gráfico. Esto ocurre en cualquier VPS (virtual private server) que alquile.

Este último punto explica por qué una guía de servidores debe tratar 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 esta 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, para escribir claude en el terminal integrado todavía necesita instalar la versión independiente. Los editores basados en VS Code instalan la misma extensión desde el registro Open VSX, y también existe un complemento para JetBrains.

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

No si usas la instalación recomendada. 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 debería mostrar un número de versión como 2.1.211 (Claude Code). Si algo no parece correcto, ejecuta 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 solo es relevante para la vía de npm. Desde la versión de paquete 2.1.198, 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 incluye el mismo binario nativo como dependencia específica de la plataforma y lo enlaza en su ubicación correspondiente.

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

No ejecutes 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, las actualizaciones automáticas en segundo plano dejan de funcionar y claude doctor muestra las correcciones disponibles.

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

¿Debe instalarlo por usuario o en 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 aplica a todo el sistema. Un único 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 en la que inicia sesión con su propia cuenta, que es lo habitual en la mayoría de los VPS. Elija la instalación mediante paquetes en un servidor compartido o en una imagen de máquina, cuando quiera una única versión para todos y prefiera actualizarla según su propio 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 sólo detiene 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 se prefiere que el binario no cambie mientras el trabajo está en curso.

Iniciar sesión mediante SSH y mantener la sesión activa

La primera vez que se 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, el trabajo en curso también se detiene.

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

tmux new -s claude
claude

Sepárese de la sesión con Ctrl-b y después d. Más tarde, vuelva 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 cuando aparezca el indicador Paste code here if prompted. El terminal mostrará Login successful.

Para una sesión que debe iniciarse sin supervisión, 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. La ubicación donde guardarlo y la forma de 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 presentan otro problema. La instalación necesita aproximadamente 512 MB de memoria libre, y el requisito de hardware documentado para ejecutarlo es de 4 GB de RAM o más. Por eso, 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. Swap es espacio de disco que el kernel usa como memoria de desbordamiento. Es mucho más lento que la RAM, pero basta para completar una instalación.

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

swapon habilita el archivo sólo para 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 restringir 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 guarda 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 sin cifrar en el directorio personal, y cualquier proceso que se ejecute con su usuario puede leerlo. Si establece CLAUDE_CONFIG_DIR, el archivo se guarda en ese directorio.

De esto se derivan dos consecuencias. Una copia de seguridad de /home contiene una sesión iniciada activa, por lo que copiarla en 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 sistema en el que inició sesión incluye esas credenciales en todas las instancias clonadas a partir de ella. Ejecute /logout antes de crear una instantánea.

La precedencia de credenciales suele causar problemas cuando se dispone de una suscripción y de una API key al mismo tiempo. Si ANTHROPIC_API_KEY está definida en el shell, Claude Code la usa cuando usted la aprueba. La suscripción queda sin utilizar y la clave se factura 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 iniciadas 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: la sesión dejará de avanzar y no podrá 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. El plan gratuito de claude.ai no incluye acceso a Claude Code. Por tanto, 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 y tiene una facturación diferente. Una cuenta de Console factura por token según lo que se envía realmente. Esto resulta adecuado para un servicio que está desarrollando, en lugar de para escribir comandos en un terminal. Configurar ANTHROPIC_API_KEY mueve la CLI a ese modelo de facturación. Es una decisión explícita, no una alternativa automática.

Los precios y los límites de los planes cambian con demasiada frecuencia para repetirlos aquí. Estas dos páginas muestran 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 sitúa el punto de equilibrio.

Los errores de instalación que realmente verá

bash: claude: command not found inmediatamente 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 ejecute source ~/.bashrc. Instalar sólo 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 de musl instalados y la detección los interpreta de forma incorrecta. Ejecute ldd --version 2>&1 | head -1: una salida con el nombre GNU libc o GLIBC indica que usa glibc y recibió el binario incorrecto. 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 de ~/.local/bin/claude a ~/.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 obsoleta situada antes en su PATH hace que un error ya corregido parezca seguir presente.

Dónde comprobar el estado actual

• Estado, requisitos y comandos de instalación de Linux Desktop: code.claude.com/docs/en/desktop-linux
• Distribuciones compatibles y todos los métodos de instalación de la CLI: code.claude.com/docs/en/setup
• Plataformas que tienen una aplicación descargable: claude.com/download
• Contenido y precio de cada plan: claude.com/pricing

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 inicio de sesión compartido entre las de pago y una decisión sobre si la CLI pertenece a su usuario o a toda la máquina.

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, y Fedora y RHEL no tienen ningún paquete. En esas distribuciones, use la CLI o claude.ai en un navegador.

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

No si usa la instalación recomendada. curl -fsSL https://claude.ai/install.sh | bash descarga un binario compilado que no usa Node.js en tiempo de 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 el mismo binario nativo se incluye como dependencia específica de la plataforma. No lo instale con sudo npm install -g, porque deja archivos propiedad de root en el prefijo de npm y rompe las actualizaciones posteriores.

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

Ejecute claude para que muestre 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 petición, 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 las sesiones que comienzan sin ningún usuario presente, ejecute claude setup-token y establezca el token mostrado como CLAUDE_CODE_OAUTH_TOKEN donde sea necesario.

¿Dónde almacena Claude Code mi inicio de 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 llavero, 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 máquina contiene un inicio de sesión operativo. 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 el inicio de sesión de suscripción almacenado una vez que la aprueba, y /status muestra cuál está activa.

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

Sí. Un plan Pro, Max, Team o Enterprise permite iniciar 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 según el número de tokens desde una cuenta de Console, que es un producto distinto de una suscripción.