Compartilhar Área de Transferência: Linux Mint → Debian via SSH
publicado em 20/11/2026 às 07:08 atualizado em 20/11/2026 às 07:10
Compartilhar Área de Transferência: Linux Mint → Debian via SSH
Este guia descreve como configurar o encaminhamento confiável de X11 (Trusted X11 Forwarding) para copiar textos ou imagens (Ctrl+C / print de tela) no Linux Mint e colar diretamente no terminal de um servidor Debian via SSH — ideal para enviar imagens ao Claude Code.
A configuração também automatiza o parâmetro -Y no arquivo ~/.ssh/config, evitando que você precise digitá-lo manualmente a cada conexão.
Como funciona
O Claude Code no Linux utiliza o utilitário xclip para ler imagens da área de transferência. Com o encaminhamento X11 confiável ativo, o xclip executado no servidor Debian consulta diretamente a área de transferência da sua sessão no Linux Mint através do túnel SSH.
1. Configuração no Servidor Debian
Execute os comandos abaixo conectado ao seu servidor Debian.
1.1. Instalar xclip e xauth
O xclip faz a leitura da área de transferência e o xauth gerencia a autenticação do túnel X11.
sudo apt update && sudo apt install xclip xauth -y
Verificação:
which xclip xauth
Resultado esperado: Ambos os caminhos (/usr/bin/xclip e /usr/bin/xauth) devem ser exibidos.
1.2. Habilitar o X11 Forwarding no servidor SSH
Verifique se o encaminhamento X11 está ativo na configuração do daemon SSH:
sudo sshd -T | grep x11forwarding
Se o retorno for x11forwarding no (ou vazio), edite o arquivo de configuração:
sudo nano /etc/ssh/sshd_config
Localize a linha X11Forwarding (ou adicione-a ao final do arquivo) e garanta que ela esteja assim, sem o # na frente:
X11Forwarding yes
Salve o arquivo (Ctrl+O, Enter, Ctrl+X) e recarregue o serviço SSH:
sudo systemctl reload ssh
Verificação:
sudo sshd -T | grep x11forwarding
Resultado esperado: x11forwarding yes.
2. Automatizar o ssh -Y no Linux Mint
Para não precisar digitar ssh -Y usuario@ip toda vez, configure um perfil no arquivo ~/.ssh/config da sua máquina com Linux Mint.
2.1. Editar o arquivo ~/.ssh/config
No terminal do Linux Mint, abra (ou crie) o arquivo:
nano ~/.ssh/config
Adicione o bloco abaixo, substituindo meu-debian, o IP e o nome de usuário pelos dados do seu servidor:
Host meu-debian
HostName 192.168.1.50
User seu-usuario
ForwardX11 yes
ForwardX11Trusted yes
Nota de segurança: Evite colocar
ForwardX11Trusted yesdentro de um bloco genéricoHost *, pois isso exporia sua área de transferência a qualquer servidor externo em que você fizer SSH. Aplique apenas aos hosts confiáveis.
Salve e feche o editor (Ctrl+O, Enter, Ctrl+X).
2.2. Ajustar as permissões do arquivo
O cliente SSH exige permissões restritas no arquivo de configuração para aceitá-lo:
chmod 600 ~/.ssh/config
Verificação:
ls -l ~/.ssh/config
Resultado esperado: As permissões no início da linha devem ser -rw-------.
3. Testando e Usando no Claude Code
3.1. Conectar sem precisar do -Y
No terminal do Linux Mint, conecte usando apenas o apelido configurado:
ssh meu-debian
3.2. Validar o túnel X11
Já dentro do terminal do Debian, verifique se a variável DISPLAY foi preenchida automaticamente:
echo $DISPLAY
Resultado esperado: Algo semelhante a localhost:10.0.
3.3. Validar a leitura de imagens
- No Linux Mint, tire um print ou copie qualquer imagem para a área de transferência (
Ctrl+C). - No terminal do Debian, execute:
xclip -selection clipboard -t TARGETS -o
Resultado esperado: A lista exibida deve conter image/png (ou image/jpeg).
3.4. Colar no Claude Code
- Inicie o Claude Code normalmente no servidor Debian.
- Com a imagem copiada no Mint, pressione
Ctrl+Vdentro do prompt do Claude Code. (Importante: useCtrl+Ve nãoCtrl+Shift+V, pois o atalho com Shift é interceptado pelo emulador de terminal apenas para texto). - O Claude Code deverá inserir a referência
[Image #1]no campo de entrada.
4. Solução de Problemas Comuns
| Problema | Causa Provável | Solução |
|---|---|---|
Bad owner or permissions on ~/.ssh/config |
Permissões abertas demais no arquivo de config do Mint. | Rode chmod 600 ~/.ssh/config no Linux Mint. |
echo $DISPLAY retorna vazio |
xauth não instalado no Debian ou X11Forwarding desativado no sshd_config. |
Repita o Passo 1, recarregue o SSH (sudo systemctl reload ssh) e reconecte. |
xclip retorna erro de acesso / não lê imagem |
Apenas ForwardX11 yes (equivalente a -X) está ativo, sem o modo confiável. |
Confirme que ForwardX11Trusted yes está presente no ~/.ssh/config do Mint. |
| Lentidão ao colar imagens | Servidor Debian em nuvem/VPS com latência alta. | O túnel X11 transfere dados sem compressão otimizada para imagens pesadas; prefira imagens menores ou adicione Compression yes no bloco do host no ~/.ssh/config. |