montfort.dev
← notas

· #claude #fedora #linux

Instalar Claude Desktop en Fedora Linux (GNOME) usando el paquete `.deb`

Por ahora, Claude Desktop para Linux solo se publica como .deb para Debian/Ubuntu. Estos son los pasos que seguí para instalarlo en Fedora (GNOME): extraer el paquete, verificar dependencias, moverlo a /opt, crear un wrapper e integrarlo en el menú de aplicaciones.

Este documento describe cómo instalar Claude Desktop en Fedora Linux con GNOME, partiendo del paquete .deb oficial para Debian/Ubuntu.
El método funciona porque Claude Desktop es una aplicación Electron con dependencias estándar presentes en Fedora.

Descargar el paquete .deb

El repositorio APT de Claude Desktop contiene el archivo .deb.

Primero descargamos la lista de archivos desde el archivo Packages:

curl -O https://downloads.claude.ai/claude-desktop/apt/stable/dists/stable/main/binary-amd64/Packages

Obtenemos la ruta y versión actualizada desde el archivo Packages:

grep -A 10 "Package: claude-desktop" Packages | grep Filename

Selecciona la versión más reciente y copia la ruta del archivo .deb. Por ejemplo:

Filename: pool/main/c/claude-desktop/claude-desktop_1.17377.0_amd64.deb

Construye la URL completa como aquí:

https://downloads.claude.ai/claude-desktop/apt/stable/pool/main/c/claude-desktop/claude-desktop_1.17377.0_amd64.deb

Descargar:

curl -O https://downloads.claude.ai/claude-desktop/apt/stable/pool/main/c/claude-desktop/claude-desktop_1.17377.0_amd64.deb

Instalar alien

Aunque intentamos convertir el .deb a .rpm, Fedora rechaza el paquete porque alien genera un .rpm con conflictos en /usr/bin y /usr/lib.
Aun así, instalar alien es útil para inspeccionar el paquete — y, sobre todo, arrastra como dependencia el paquete dpkg, que provee la herramienta dpkg-deb que usamos en el siguiente paso (Fedora no la trae de fábrica). Por eso no conviene saltarse este paso.

sudo dnf install alien

Extraer el contenido del .deb

Usa el nombre del .deb que de verdad descargaste — la versión de abajo (1.17377.0) es solo un ejemplo:

dpkg-deb -x claude-desktop_1.17377.0_amd64.deb deb_extract/

El binario principal queda en:

deb_extract/usr/lib/claude-desktop/claude-desktop

Verificar dependencias con ldd

ldd deb_extract/usr/lib/claude-desktop/claude-desktop

Todas las dependencias reportadas por ldd están disponibles en Fedora.

Instalar dependencias necesarias en Fedora

Si tu sistema no las tiene, instala todas las equivalentes:

sudo dnf install gtk3 libnotify nss libdrm mesa-libgbm libxcb libsecret libXtst libuuid alsa-lib xdg-desktop-portal xdg-desktop-portal-gnome

En nuestro caso, todas ya estaban instaladas.

Ejecutar Claude Desktop directamente

./deb_extract/usr/lib/claude-desktop/claude-desktop

Si abre, ya está funcionando correctamente.

Mover Claude Desktop a /opt

sudo mv deb_extract /opt/claude-desktop

⚠️ ¿Actualizas desde una versión anterior? Si /opt/claude-desktop ya existe, mv no la reemplaza: mueve deb_extract dentro de la carpeta existente (terminarías con /opt/claude-desktop/deb_extract/usr/lib/...) y el wrapper seguirá ejecutando el binario viejo. Elimina primero la instalación anterior:

sudo rm -rf /opt/claude-desktop
sudo mv deb_extract /opt/claude-desktop

Crear un wrapper en /usr/local/bin

⚠️ Importante:
El ejecutable debe llamarse claude-desktop, no claude, para evitar conflictos con el CLI de Claude que algunos usuarios ya tienen instalado.

Crear wrapper:

sudo nano /usr/local/bin/claude-desktop

Contenido:

#!/bin/bash
/opt/claude-desktop/usr/lib/claude-desktop/claude-desktop "$@"

Hacerlo ejecutable:

sudo chmod +x /usr/local/bin/claude-desktop

Ahora puedes ejecutar:

claude-desktop

Integración con GNOME (archivo .desktop)

Crear archivo:

nano ~/.local/share/applications/claude-desktop.desktop

Contenido:

[Desktop Entry]
Name=Claude Desktop
Exec=/usr/local/bin/claude-desktop
Icon=/opt/claude-desktop/usr/share/icons/hicolor/256x256/apps/claude-desktop.png
Type=Application
Categories=Utility;

Actualizar índice:

update-desktop-database ~/.local/share/applications/

Claude Desktop aparecerá en el menú de aplicaciones de GNOME.

Resultado final

Claude Desktop queda instalado en Fedora:

  • Sin usar .rpm
  • Sin conflictos con el sistema
  • Con integración parcial en GNOME (el inicio de sesión con Google requiere el login por código — ver la nota de abajo)
  • Con wrapper seguro que evita colisiones con el CLI de Claude

Nota sobre la integración con GNOME: no es completa. Claude Desktop no registra un manejador de esquema de URL (deep link) en GNOME, así que el inicio de sesión con Google —que termina abriendo una URL de retorno para devolver el control a la app— nunca regresa a Claude Desktop y el login se queda colgado. Para iniciar sesión con Google, usa la opción por código («Usar un código»): la app muestra un código, lo autorizas en el navegador y no hace falta ninguna URL de retorno.

Automatizarlo con un script

Una vez que entiendes el proceso, puedes hacerlo todo —elegir la última versión, verificar la descarga, reemplazar cualquier instalación previa y dejar listo el lanzador— con un solo script:

curl -O https://montfort.dev/claude-desktop-fedora.sh
chmod +x claude-desktop-fedora.sh
./claude-desktop-fedora.sh            # instalar o actualizar a la última

No lo ejecutes con sudo: el script llama a sudo solo en los pasos que lo necesitan, para que la entrada .desktop quede en tu carpeta personal y no en la de root. Opciones útiles:

  • --version 1.18286.0 — instala una versión específica en vez de la última
  • --force — reinstala aunque ya estés al día
  • --dry-run — muestra qué haría, sin tocar nada
  • --no-deps — omite la instalación de dependencias

Lee la versión directamente del índice APT, elige la más reciente con sort -V, verifica el .deb contra su SHA256 y —lo más importante— elimina cualquier /opt/claude-desktop previo antes de mover el nuevo, evitando el problema de anidamiento descrito arriba.

Más notas y ensayos aparecen en el feed — rss.xml es el contrato.