Skip to content

Claude Desktop no Linux Mint (via claude-desktop-debian)

Guia de instalação e resolução de problemas do Claude Desktop em distribuições baseadas em Debian/Ubuntu, utilizando o projeto não-oficial aaddrick/claude-desktop-debian.

Nota: Este é um projeto não-oficial que reempacota o aplicativo Windows do Claude Desktop para Linux. Para suporte oficial, acesse anthropic.com. Para problemas específicos do pacote Linux, abra uma issue no repositório do projeto.

Instalação via repositório APT

Este método adiciona o repositório ao sistema, permitindo que o Claude Desktop seja atualizado automaticamente junto com o restante do sistema (sudo apt upgrade).

# 1. Adicionar a chave GPG
curl -fsSL https://pkg.claude-desktop-debian.dev/KEY.gpg | sudo gpg --dearmor -o /usr/share/keyrings/claude-desktop.gpg

# 2. Adicionar o repositório
echo "deb [signed-by=/usr/share/keyrings/claude-desktop.gpg arch=amd64,arm64] https://pkg.claude-desktop-debian.dev stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list

# 3. Atualizar e instalar
sudo apt update
sudo apt install claude-desktop

Após a instalação, o Claude Desktop estará disponível no menu de aplicativos e pode ser iniciado pelo terminal com claude-desktop.

Diagnóstico integrado

O pacote inclui um comando de diagnóstico que verifica problemas comuns de configuração (display server, sandbox, MCP, locks órfãos, etc.):

claude-desktop --doctor

Problema: Tela Branca ao Abrir

Sintomas

  • Claude Desktop abre mas exibe tela em branco
  • A janela aparece em todas as áreas de trabalho virtuais simultaneamente
  • Nenhuma mensagem de erro visível ao usuário

Diagnóstico

Para confirmar a causa, verifique o log do aplicativo:

tail -30 ~/.config/Claude/logs/main.log

Se o problema for este, a seguinte linha aparecerá no log:

Not main instance, returning early from app ready

Causa

O Claude Desktop é um aplicativo Electron e não lida bem com processos anteriores que ficam como zumbis em segundo plano. Quando isso ocorre, a nova instância detecta que já existe um processo rodando e encerra sua inicialização prematuramente — resultando em tela branca.

O comportamento de aparecer em todas as áreas de trabalho é um sintoma secundário da janela mal-inicializada.

O processo zumbi pode sobreviver ao pkill -f "/usr/bin/claude-desktop" porque o binário real executado pelo sistema é:

/usr/lib/claude-desktop/node_modules/electron/dist/electron

É necessário matar ambos os padrões para garantir limpeza completa.

Solução Definitiva

Criar um script wrapper que elimina todos os processos relacionados antes de iniciar o aplicativo, e configurar o atalho do menu para usá-lo.

Passo 1 — Criar o script wrapper

sudo tee /usr/local/bin/claude-desktop-safe << 'EOF'
#!/bin/bash
pkill -f "claude-desktop" 2>/dev/null
pkill -f "/usr/lib/claude-desktop/node_modules/electron/dist/electron" 2>/dev/null
sleep 2
exec /usr/bin/claude-desktop "$@"
EOF
sudo chmod +x /usr/local/bin/claude-desktop-safe

Passo 2 — Atualizar o atalho do menu

sudo sed -i 's|Exec=/usr/bin/claude-desktop|Exec=/usr/local/bin/claude-desktop-safe|' /usr/share/applications/claude-desktop.desktop

Passo 3 — Atualizar o cache de aplicativos

update-desktop-database ~/.local/share/applications/ 2>/dev/null; true

Resultado esperado no arquivo .desktop

[Desktop Entry]
Name=Claude
Exec=/usr/local/bin/claude-desktop-safe %u
Icon=claude-desktop
Type=Application
Terminal=false
Categories=Office;Utility;
MimeType=x-scheme-handler/claude;
StartupWMClass=Claude

Solução de Emergência (sem reiniciar)

Se o app já estiver com tela branca, mate os processos órfãos e reabra:

pkill -f "claude-desktop"; pkill -f "/usr/lib/claude-desktop/node_modules/electron/dist/electron"; sleep 2; claude-desktop

Observações Importantes

  • Atualizações do sistema: O apt upgrade pode sobrescrever o arquivo .desktop, fazendo o atalho voltar a apontar para /usr/bin/claude-desktop. Nesse caso, repita o Passo 2.
  • Configuração MCP: O arquivo de configuração do Model Context Protocol fica em ~/.config/Claude/claude_desktop_config.json.
  • Logs: Os logs do aplicativo ficam em ~/.config/Claude/logs/main.log.
  • Versões testadas: Claude Desktop 1.6608.2 e 1.7196.1, Linux Mint 22, x64.