Claude Desktop en Linux — el bypass nativo

La GUI es presentacion. El cerebro es el CLI. Los MCPs son las manos.

Tres pestañas nativas del GUI

El sidebar de claude-desktop-bin tiene tres modos, todos built-in:

1. Chat — conversacion normal
2. Cowork — multi-sesion con panel de Progress / Context / Working folder / Scratchpad
3. Code (icono </>) — integracion con Claude Code

Prueba de que es built-in: el binario registra URL schemes custom operon-artifact://, cowork-artifact://, cowork-file://, app:// directamente en el runtime Electron.

Launch args decodificados

--disable-features=CustomTitlebar
--enable-transparent-visuals
--no-sandbox
--enable-features=UseOzonePlatform,WaylandWindowDecorations,GlobalShortcutsPortal
--ozone-platform=wayland
--enable-wayland-ime
--wayland-text-input-version=3

• UseOzonePlatform + ozone-platform=wayland → Wayland-first, no XWayland
• WaylandWindowDecorations → CSD (client-side decorations), cero dependencia del WM para bordes
• GlobalShortcutsPortal → XDG Portal para atajos globales sin root
• wayland-text-input-version=3 → IME moderno (chino, japones, acentos)
• --no-sandbox → necesario para Wayland+Electron, no implica inseguridad del agente

Ventajas sobre builds oficiales

Como debuggear este setup

1. ¿Que app corre realmente? → ps -eo pid,comm,args | grep -iE 'claude\|electron'
2. ¿Que CLI version? → pacman -Q claude-desktop-bin + /home/x/.local/bin/claude --version
3. ¿Que MCPs estan configurados? → cat /home/x/.config/Claude/*.json o buscar en --allowedTools del proceso
4. ¿Que schemes registra? → parametros --standard-schemes / --secure-schemes del proceso Electron
5. ¿Donde vive una sesion? → /home/x/.config/Claude/local-agent-mode-sessions/<uuid>/
6. ¿Wayland o X11? → verificar --ozone-platform en launch args, echo $WAYLAND_DISPLAY
7. ¿Ventana no aparece? → Hyprland: hyprctl clients | grep -i claude

Filesystem MCP ≠ sandbox del agente

Punto importante: mcp__filesystem__list_allowed_directories devuelve solo uploads/ de la sesion, pero eso es diseño del servidor MCP filesystem, NO del entorno. El agente corre con uid del usuario y puede:

• Usar Bash sin restriccion de rutas
• mkdir /home/x/cualquier-cosa
• ls /, cat /etc/os-release, etc.
• Spawnear procesos arbitrarios

Para ampliar el scope del filesystem MCP: editar settings.json con las rutas que quieras permitir, o usar Bash.

Como extender este setup

• Añadir un MCP: editar ~/.config/Claude/claude_desktop_config.json (o settings.json segun version) con el bloque mcpServers
• MCP custom en Python/Node/Rust: cualquier binario que hable MCP stdio funciona — no necesitas permisos especiales
• Skills personales: ~/.claude/skills/<nombre>/SKILL.md con frontmatter YAML
• Hooks pre/post tool: configurables en settings.json (ver skill update-config)
• Atajos globales: via Hyprland (~/.config/hypr/hyprland.conf) apuntando a claude-desktop
• Systemd user service: si quieres autostart/restart automatico
• Inspeccionar el asar: npx @electron/asar extract /usr/lib/claude-desktop-bin/app.asar /tmp/claude-app (read-only recommended)

Errores comunes de diagnostico

1. "La app se llama Cowork" → NO. Cowork es una pestaña. El proceso es com.anthropic.claude-desktop.
2. "El agente esta sandboxeado al uploads dir" → NO. Solo el MCP filesystem. Bash tiene acceso total.
3. "Linux no es soportado" → Oficialmente no, pero claude-desktop-bin es identicamente capaz. La comunidad AUR lo mantiene al dia con upstream.
4. "No puede hacer X que hace en macOS" → Verificar primero; muchas cosas funcionan via XDG Portal. Si de verdad falta, probablemente se pueda scriptear con Bash + D-Bus.

Stack de referencia (setup validado 2026-04)

• Arch Linux rolling, kernel 6.19+
• Hyprland (Wayland)
• claude-desktop-bin 1.3109.0-3 (AUR)
• Electron 39
• Claude Code CLI modelo claude-opus-4-7
• MCPs activos: computer-use, claude-in-chrome, chrome-devtools, playwright, filesystem, plex, gmail, calendar, asana, supabase, vercel, cowork, scheduled-tasks, session-info