~/conhecimento/compartilhar-area-de-transferencia-linux-mint-debian-via-ssh

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 yes dentro de um bloco genérico Host *, 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
  1. No Linux Mint, tire um print ou copie qualquer imagem para a área de transferência (Ctrl+C).
  2. 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
  1. Inicie o Claude Code normalmente no servidor Debian.
  2. Com a imagem copiada no Mint, pressione Ctrl+V dentro do prompt do Claude Code. (Importante: use Ctrl+V e não Ctrl+Shift+V, pois o atalho com Shift é interceptado pelo emulador de terminal apenas para texto).
  3. 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.

Precisa disso implementado na sua empresa?

Eu faço o trabalho para você, com segurança e documentação.

>_ SOLICITAR ORÇAMENTO