Teclado no desktop remoto não funciona: correções

Você está no meio do diagnóstico de um problema e, de repente, o teclado remoto digita os caracteres errados, teclas especiais não são enviadas, ou modificadores como AltGr e Cmd se comportam de forma incorreta — e nada do que você faz na sua máquina local altera isso. Se você pesquisou por 'remote desktop keyboard not working', este guia explica por que o mapeamento de teclado quebra em sessões remotas e como corrigir, passo a passo.

Como o mapeamento de teclado falha em sessões remotas

Problemas de teclado em desktop remoto geralmente não são falhas místicas; resultam de incompatibilidades entre três elementos: o hardware e o sistema operacional do teclado local, o layout de teclado e a pilha de entrada do host remoto, e o protocolo remoto ou cliente que traduz os eventos de tecla. No processo, você pode perder o mapeamento de teclas especiais (AltGr, Menu, Fn), dead keys (teclas mortas para acentos), ou o comportamento de modificadores (Command/Windows), ou a sessão pode enviar o scancode errado por completo.

Conceitos a ter em mente:

• Scancodes vs keycodes vs caracteres — Uma pressão física gera um scancode. O SO do host mapeia scancodes para keycodes e então para caracteres de acordo com o layout de teclado ativo. Protocolos remotos podem enviar scancodes, keycodes ou caracteres Unicode; incompatibilidades causam caracteres errados.
• Layout vs locale — 'US QWERTY' vs 'UK QWERTY' vs 'French AZERTY' são mapeamentos diferentes. Ter layouts distintos no cliente e no host causa troca de símbolos e pontuação.
• Modificadores e dead keys — AltGr, Compose e dead keys (para acentos) são tratados no nível do layout/IME e frequentemente quebram se a sessão remota não preservar o IME ou o locale remotos.

Verificações rápidas e reproduzíveis (comece por aqui)

Antes de aprofundar, execute algumas verificações reproduzíveis para localizar se o problema é no cliente, no host ou relacionado ao protocolo. São verificações simples, rápidas e economizam tempo.

1. Confirme o básico: Ambas as máquinas estão com o mesmo nome de layout de teclado? No Windows verifique Settings → Time & Language → Language → Preferred languages. No macOS verifique System Settings → Keyboard → Input Sources. No Linux verifique o layout local com setxkbmap -query ou pelas configurações do ambiente de desktop.
2. Tente o Teclado na Tela (OSK): Abra o OSK no host remoto (Windows: start → osk.exe; macOS: Show Keyboard Viewer; Linux: onboard). Se o OSK digita corretamente, o problema está entre o teclado físico e a camada de tradução de entrada remota.
3. Teste outro cliente: Conecte com um cliente remoto diferente (por exemplo, se você está usando TeamViewer tente uma sessão VNC ou RDP) para ver se o problema é específico de um protocolo ou implementação do cliente.
4. Verifique quando ocorre: O mapeamento falha apenas em prompts elevados/UAC, apenas na tela de login ou apenas após desbloquear o protetor de tela? Esses casos de borda muitas vezes refletem problemas de privilégios ou isolamento de sessão.

Causas e correções específicas por plataforma

Os problemas de teclado se manifestam de formas diferentes dependendo do par de SO (cliente ↔ host). Abaixo estão os padrões comuns e correções práticas.

Host Windows

Problemas comuns: caracteres trocados (por exemplo, @ vs "), AltGr não funcionando, teclas especiais do Windows ignoradas.

• Configurações do RDP: Nos clientes Microsoft Remote Desktop, verifique Local Resources → Keyboard → Apply Windows key combinations e experimente alternar entre 'Only on the remote computer' e 'On this computer'. O RDP tende a encaminhar combinações de teclas do Windows melhor do que algumas ferramentas comerciais.
• Incompatibilidade de layout do teclado: Certifique‑se de que o usuário da sessão remota tem o mesmo layout instalado e selecionado. Para ambientes de servidor, verifique a entrada padrão do sistema na tela de logon: HKEY_USERS\.DEFAULT\Keyboard Layout\Preload.
• UAC e aplicativos elevados: Se as teclas funcionam em apps normais mas não em janelas elevadas, execute o agente remoto com os mesmos privilégios do processo alvo. Alguns clientes oferecem 'Run as administrator' para o serviço/agente. Se estiver usando TeamViewer/AnyDesk, habilite 'Interact with desktop' e 'Send key combinations' nas configurações.

Cliente ou host macOS

Problemas comuns: Command/Option trocados com Ctrl/Alt, emoji ou caracteres especiais não enviados, mapeamento incorreto em teclados não‑Apple.

• Mapeamento de modificadores: O macOS usa Command e Option onde o Windows usa Ctrl e Alt. Verifique as opções de mapeamento de teclado do cliente. Ao conectar de macOS para Windows, muitos clientes têm um toggle 'Use Command as Ctrl'.
• Touch Bar e teclas Fn: As teclas do Touch Bar e o comportamento do Fn são locais ao Mac, a menos que o cliente as encaminhe especificamente; espere diferenças.
• Sessões macOS remotas: A Apple restringe alguns inputs virtuais por razões de segurança; certas teclas (controles de mídia, Touch ID) não podem ser encaminhadas para outra sessão macOS logada.

Linux/X11 e Wayland

Problemas comuns: caracteres não‑ASCII, dead keys, compatibilidade de clientes com Wayland.

• Ferramentas X11: Use xev para observar eventos de tecla e confirmar se o scancode que chega ao X corresponde ao esperado. Para testes no console, experimente showkey -k em um terminal virtual.
• Limitações do Wayland: Alguns protocolos e clientes remotos (servidores VNC mais antigos, certas implementações RDP) não se integram bem com compositores Wayland; a captura do teclado pode ser restrita. Se possível, volte para uma sessão X11 ou use uma solução remota compatível com Wayland.
• Setxkbmap: Para alternar rapidamente layouts no host remoto use setxkbmap us ou setxkbmap fr e teste as alterações.

Protocolos e configurações de cliente que comumente quebram o mapeamento

Diferentes ferramentas remotas lidam com entrada de formas distintas. Eis o que verificar para classes populares de clientes.

• RDP (Microsoft Remote Desktop): RDP costuma ser o mais preciso para Windows→Windows porque usa tradução de scancode otimizada para layouts Windows. Verifique a opção do cliente 'Use local keyboard layout on remote session' e a política de grupo do servidor para configurações de teclado. O RDP também suporta entrada Unicode via área de transferência para colar texto e evitar problemas de mapeamento.
• VNC (RealVNC/TigerVNC): O VNC frequentemente envia keycodes brutos do cliente; incompatibilidades são comuns quando cliente e servidor esperam conjuntos de keycodes diferentes. Tente habilitar 'Send special keys directly to the server' ou alterar as configurações de keymap do servidor VNC.
• TeamViewer / AnyDesk: Ambos são bons para NAT traversal e conexões rápidas, mas historicamente já tiveram problemas em casos de borda — teclas modificadoras, AltGr e layouts multilíngues. Se encontrar um problema, teste o cliente mais recente (TeamViewer 15.x ou AnyDesk 7.x são linhas principais recentes) e procure opções 'send key combinations'. Reconheça quando concorrentes são melhores: se você precisa de mapeamento de teclas do Windows impecável e opera dentro de um datacenter Windows, o RDP frequentemente será mais confiável que TeamViewer ou AnyDesk.
• Tenvo (open source): Tenvo busca encaminhamento e configuração de entrada transparentes; verifique as configurações de Input do cliente e considere atualizar para a build mais recente se uma opção de layout estiver faltando. Para downloads diretos e atualizações veja /download e para opções de hospedagem veja /pricing.

Resolução avançada: logs, ferramentas e correções

Se correções rápidas não ajudarem, colete evidências e aplique verificações mais avançadas.

Capturar e comparar eventos de tecla

• No Linux/X11: execute xev no host, pressione teclas no cliente e verifique os eventos KeyPress e os valores keysym. Exemplo:

  $ xev
  KeyPress event, serial 34, synthetic NO, window 0x3e00001,
      root 0x1a2, subw 0x0, time 1234567, (85,101), root:(900,300),
      state 0x0, keycode 38 (keysym 0x61, a), same_screen YES

• No Windows: use o PowerToys Keyboard Manager da Microsoft ou uma pequena ferramenta de keylogger/debug (apenas para testes — evite registrar entradas sensíveis) para observar os virtual key codes (VK) e os scan codes.
• Registre os nomes exatos dos layouts: p.ex., 'English (United States) - US QWERTY' ou 'French - AZERTY'. O nome exato ajuda colegas a reproduzirem os problemas.

Registro e correções de baixo nível no Windows

Se uma tecla de hardware estiver permanentemente remapeada ou dead keys estiverem erradas, verifique o scancode map em:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Keyboard Layout\Scancode Map

Editar o registro é arriscado; exporte a chave primeiro. Para testes temporários prefira o PowerToys ou remapear com o Microsoft Keyboard Layout Creator. Se um agente remoto não estiver executando com privilégios de sessão interativa, ele não receberá certos eventos de tecla de baixo nível — execute o agente como um serviço com os direitos apropriados.

Problemas com IME e troca de idioma

Usuários internacionais frequentemente veem a troca de IME falhar dentro de sessões remotas. Se você depende de um método de entrada complexo (Japanese IME, Chinese Pinyin), confirme que o IME está instalado e habilitado no host remoto e considere usar cola via área de transferência para entradas complexas como solução temporária.

Prevenção e melhores práticas

Depois de corrigir o problema imediato, tome medidas para reduzir a recorrência.

• Padronize layouts: Quando possível, mantenha os layouts de teclado do cliente e do host alinhados. Para servidores multiusuário, documente um layout padrão como 'US QWERTY' para evitar surpresas.
• Mantenha os clientes atualizados: Muitos bugs de teclado são do lado do cliente e são corrigidos em releases de manutenção. Use as versões estáveis mais recentes (muitas aplicações comerciais estão nas famílias 7.x ou 15.x; atualizações do Tenvo estão em /download).
• Prefira o protocolo adequado ao seu caso: Se você opera principalmente Windows→Windows em uma LAN, use RDP para o mapeamento mais limpo. Se precisar de NAT traversal ou conveniência cross‑platform, Tenvo, TeamViewer ou AnyDesk podem ser melhores, mas espere casos de borda ocasionais de mapeamento.
• Documente passos de reprodução: Para sua equipe, mantenha um checklist curto com passos de reprodução (SO e versão do cliente, SO e versão do remoto, nomes dos layouts de teclado, teclas exatas que se comportam mal) para que você possa abrir relatórios de bug úteis rapidamente.

Como reportar o problema (o que incluir em um relatório de bug)

Se precisar abrir um bug com o fornecedor do cliente remoto ou com o TI interno, inclua o seguinte para tornar o relatório acionável:

1. SO do cliente e do servidor (p.ex., Windows 11 22H2, macOS Ventura 13.5, Ubuntu 24.04) e versões dos apps cliente/servidor (p.ex., TeamViewer 15.52.5, AnyDesk 7.0.9).
2. Nomes exatos dos layouts de teclado em ambos os lados (a string das configurações do SO).
3. Passos de reprodução pequenos e precisos — p.ex., 'Connect from macOS -> Windows 10; press AltGr+E to type €; remote types @ instead.'
4. Logs e capturas: anexe logs do cliente (frequentemente disponíveis em Help → Logs no cliente) e uma captura do OSK remoto mostrando o que aparece quando você digita.
5. Traço de baixo nível se possível: saída do xev ou trace de keycodes do Windows destacando a incompatibilidade.

Para Tenvo, inclua logs do cliente e do servidor e a configuração exata usada. Se quiser hospedar sua própria solução remota e controlar versões, veja nosso guia self‑hosted em /self-hosted-remote-desktop-guide e, para opções de NAT traversal, confira /remote-desktop-without-port-forwarding.

Quando um concorrente é a ferramenta certa

Nenhum protocolo remoto é perfeito para todo cenário. Se você precisa de fidelidade de teclado quase perfeita em um datacenter Windows ou para trabalho de desenvolvimento intensivo em teclado, a integração nativa do RDP frequentemente supera clientes sobrepostos. Por outro lado, se sua prioridade é suporte cross‑platform rápido ou NAT traversal, Tenvo e ferramentas como TeamViewer e AnyDesk oferecem maior conveniência ao custo de problemas ocasionais de mapeamento em casos de borda.

Seja realista quanto às compensações: use a ferramenta que se ajusta ao ambiente e tenha um fallback (RDP, SSH + encaminhamento X local, ou uma solução KVM remota) para necessidades de alta precisão.

Resumo e próximos passos

A maioria dos problemas 'remote desktop keyboard not working' resumem‑se a incompatibilidade de layout, diferenças de tradução do protocolo ou isolamento de privilégios/sessão. Comece com verificações diretas (OSK, nomes de layout, cliente alternativo), depois capture eventos de baixo nível (xev, showkey, PowerToys) se o problema persistir. Use edições de registro/scancode apenas como último recurso e documente tudo para relatórios de bug.

Se você quer uma opção open‑source que permita inspecionar e ajustar o comportamento, experimente Tenvo e obtenha as builds de cliente mais recentes em /download. Para opções de hospedagem e considerações de custo, veja /pricing. Se sua infraestrutura requer fidelidade garantida das teclas do Windows, considere usar RDP nessas conexões e use ferramentas cross‑platform quando precisar de NAT traversal ou suporte remoto simples.

Ainda travado? Colete as strings de versão do SO do cliente/servidor, os nomes exatos dos layouts, um caso de reprodução curto e a saída do xev ou do PowerToys, então abra um ticket com seu fornecedor ou equipe de TI — evidências detalhadas levam a uma correção muito mais rápido.

Pronto para testar um cliente que você pode inspecionar e configurar? Baixe Tenvo e teste o roteamento do seu teclado em /download.