Cómo instalar Claude Code en Linux (Ubuntu, Debian, Fedora)

Respuesta rápida: instala Claude Code en Linux en una línea

# Instalador nativo oficial (recomendado)
curl -fsSL https://claude.ai/install.sh | bash

# Comprueba la instalación
claude --version

# Arráncalo dentro de un proyecto
cd ~/mi-proyecto
claude

El instalador deja el lanzador en ~/.local/bin/claude y se actualiza solo en segundo plano. Todos los comandos de esta guía salen de la documentación oficial de instalación de Claude Code.

Requisitos

• Un Linux de 64 bits en x64 o ARM64. Con soporte oficial: Ubuntu 20.04+, Debian 10+ y Alpine Linux 3.19+. Fedora y RHEL tienen repositorio dnf oficial.
• Al menos 4 GB de RAM y conexión a internet.
• Bash o Zsh.
• Una cuenta Claude Pro, Max, Team, Enterprise o Console. El plan gratuito de claude.ai no incluye Claude Code.

Instalar con apt o dnf (repositorios oficiales)

Si prefieres que las actualizaciones lleguen con el resto del sistema, Anthropic publica repositorios firmados. A cambio, estas instalaciones no se actualizan solas: las actualizas como cualquier otro paquete.

Ubuntu y Debian (apt)

sudo apt install curl gnupg
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

# Más adelante: sudo apt update && sudo apt upgrade claude-code

Fedora y RHEL (dnf)

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

# Más adelante: sudo dnf upgrade claude-code

Los dos usan el canal stable, que suele ir una semana por detrás y se salta las versiones con fallos graves. Alpine también tiene repositorio apk, pero antes tienes que instalar bash, curl, libgcc, libstdc++ y ripgrep.

Primer arranque e inicio de sesión (también por SSH)

• Abre un terminal en la carpeta de un proyecto y escribe claude.
• Se abre el navegador con el login de Anthropic. Entra con tu cuenta de Claude.
• En un servidor o por SSH, donde no se puede abrir un navegador, pulsa c para copiar la URL de login y ábrela en cualquier otro dispositivo.
• Si tienes definida la variable de entorno ANTHROPIC_API_KEY, Claude Code te pide aprobar esa clave una vez en lugar de abrir el navegador.

Si después algo no cuadra, claude doctor muestra un informe de solo lectura de la instalación, los ajustes y el último intento de actualización.

¿Y la app de escritorio de Claude en Linux?

Anthropic ya tiene una app de escritorio de Claude para Linux en beta, para Ubuntu 22.04+ y Debian 12+ en x64 y ARM64, e incluye Claude Code. Si quieres la app gráfica oficial para una conversación de Claude a la vez, empieza por ahí.

CodeAgentSwarm resuelve otra cosa: tener varios agentes de terminal trabajando a la vez y no perderles la pista. Usa el CLI de Claude Code que acabas de instalar, lo combina con Codex y otros agentes en la misma ventana y también se distribuye como AppImage, así que funciona en Fedora y en la mayoría de distros.

Errores comunes en Linux y cómo arreglarlos

• "claude: command not found" tras instalar: ~/.local/bin todavía no está en tu PATH. Abre un terminal nuevo o añade export PATH="$HOME/.local/bin:$PATH" a tu ~/.bashrc o ~/.zshrc.
• "NO_PUBKEY BAA929FF1A7ECACE" al hacer apt update: la clave de firma no se descargó. Comprueba que tu red llega a downloads.claude.ai y repite la descarga de la clave.
• "not found" al lanzar el instalador en Alpine: Alpine no trae bash ni curl de serie. Instálalos con apk add bash curl libgcc libstdc++ ripgrep.
• La búsqueda dentro de Claude Code falla: Claude Code usa ripgrep. En distros con musl instálalo con tu gestor de paquetes y pon USE_BUILTIN_RIPGREP=0.
• Errores de permisos con npm: nunca uses sudo npm install -g. Pásate al instalador nativo, que no necesita root.

Para todo lo demás, la página oficial de problemas de instalación recoge cada error conocido con su solución.

Varias sesiones de Claude Code en Linux

Con Claude Code funcionando, el siguiente límite llega rápido: un terminal solo lleva una tarea a la vez. Le das un trabajo a Claude y esperas. Abrir más pestañas en GNOME Terminal o en tmux ayuda, hasta que pierdes la cuenta de qué sesión ha terminado, cuál espera permiso y qué ha cambiado cada una.

CodeAgentSwarm es una app de escritorio pensada justo para eso, y ya funciona en Linux como .deb (Ubuntu, Debian y derivadas) o AppImage (Fedora y la mayoría de distros), en x64 y ARM64. Pone varios terminales de Claude Code uno al lado del otro y añade notificaciones cuando un agente termina o necesita algo, historial buscable de todas las sesiones y un diff en tiempo real de lo que ha cambiado cada terminal.

Siguientes pasos: cómo usar varios terminales de Claude Code y ejecutar múltiples sesiones de Claude Code. ¿Vas a instalar Codex en la misma máquina? Mira Codex CLI en Linux.

Conclusión

En Linux, Claude Code está a un comando curl, o a un apt o dnf si prefieres que lo gestione el sistema. Ejecuta claude doctor si algo falla, y cuando un solo terminal se te quede corto, CodeAgentSwarm te deja usar varios a la vez.