SoluçõesMac7 min de leitura
Ditado não funciona no VS Code, Terminal ou Claude Code
Ditado não funciona no VS Code ou no Terminal? Apps Electron leem o clipboard tarde, e alguns terminais ignoram teclas simuladas. Veja as soluções.
Publicado pela Optimal Apps, criadora do Petal.
Nesta página
O ditado não funciona no VS Code, no Terminal ou no Claude Code? Quase sempre a causa é uma destas duas. Primeiro, apps Electron como o VS Code, o Cursor e o Slack leem o clipboard tarde, então um app de ditado que restaura o clipboard antigo cedo demais faz esses apps colarem o conteúdo antigo. Segundo, alguns terminais e apps de terminal ignoram pressionamentos de tecla simulados, então um app de ditado que "digita" o texto não consegue inserir nada. A solução é dar mais tempo para a colagem, ou fazer o app de ditado trocar a digitação por uma colagem pelo clipboard.
Este guia explica as duas causas, mostra as soluções para o Superwhisper, o VoiceInk, o Wispr Flow e o Aqua Voice, e depois explica como o Petal lida com editores de código.
Ditado não funciona no VS Code ou em um terminal: checklist de solução rápida
| O que você vê | Causa | Solução |
|---|---|---|
| O texto antigo do clipboard é colado no VS Code ou no Cursor | O clipboard foi restaurado antes de o app ler | Aumente o atraso de restauração, ou deixe a transcrição no clipboard |
| Nada é colado em um terminal | O terminal ignora pressionamentos de tecla simulados | Use uma colagem pelo clipboard, ou o atalho de "colar a última transcrição" do app |
| O texto é colado no editor, não no terminal integrado | O foco está no painel errado | Clique no painel do terminal antes de ditar |
| O texto é colado duas vezes | A digitação e a colagem rodaram juntas | Desative o "simulate keypresses" para esse app |
| Um caractere estranho, ou nenhuma colagem, depois de um atalho | As teclas modificadoras ainda estavam pressionadas no Command-V | Solte todas as teclas antes da colagem |
| Nada é colado em nenhum lugar | Falta a Acessibilidade | Redefina a Acessibilidade do app |
Causa 1: Apps Electron leem o clipboard tarde
A maioria dos apps de ditado para Mac cola em quatro etapas:
- Guarda o clipboard atual.
- Coloca a transcrição no clipboard.
- Envia Command-V para o app em primeiro plano.
- Devolve o clipboard antigo.
Apps nativos, como o TextEdit, leem o clipboard na hora em que recebem o Command-V. Apps Electron, como o VS Code, o Cursor, o Slack e o Discord, podem ler um instante depois. Se a etapa 4 acontece antes, o app cola o seu clipboard antigo. O resultado parece "o ditado cola o texto errado no VS Code".
Soluções dos fabricantes para a leitura tardia do clipboard
Superwhisper. O guia de colagem dele diz:
- Abra Settings > Configuration > Advanced settings e role até Text input.
- Mude o Clipboard content para Replace with dictation. O padrão, Keep what I have copied, restaura o clipboard antigo depois da colagem.
- Teste. O conteúdo anterior do clipboard some depois de cada ditado.
A mesma página diz para clicar no editor e manter o foco nele até o ditado terminar, e para conferir se a opção de colagem automática do modo está em Default ou On.
VoiceInk. O guia de clipboard dele diz:
- Abra Settings > Pasting.
- Mantenha o Keep Clipboard Content ativado.
- Aumente o Restore Delay. O padrão é 2 segundos, e o intervalo vai de 250 ms a 5 segundos.
Mais detalhes em VoiceInk não cola o texto.
Aqua Voice. O changelog do Aqua lista uma correção para um bug de colagem no VS Code e no Cursor na v0.11.6. Atualize para a versão mais recente.
Para a versão desse problema no Superwhisper, veja Superwhisper cola o clipboard antigo.
Causa 2: Terminais ignoram entradas simuladas
Alguns apps de ditado não colam. Eles "digitam" o texto com eventos de tecla simulados. Alguns apps de terminal só aceitam pressionamentos de tecla reais ou uma colagem real, e ignoram o resto.
A issue #51725 no repositório anthropics/claude-code no GitHub é um exemplo. Quem relatou usava o Aqua Voice v0.14.2 no terminal integrado do Cursor (PowerShell) no Windows 11. O texto ditado sumia sem aviso no prompt do Claude Code, mas funcionava em um prompt comum do PowerShell. A teoria de quem relatou, sem confirmação, era que o Aqua envia pressionamentos de tecla simulados e o Claude Code só aceita bracketed paste. O Paste Last Transcript do Aqua, que usa o clipboard, funcionou. A issue foi fechada como duplicada de um relato parecido sobre colagem simulada no Windows.
A mesma ideia vale no Mac: se o texto chega como teclas digitadas e o app de terminal ignora essas teclas, troque para uma colagem pelo clipboard.
Soluções dos fabricantes para terminais
Aqua Voice. Dite e depois pressione Paste Last Transcript. O changelog do Aqua informa Control-Command-V como padrão no Mac, e você pode mudar o atalho nos ajustes.
Wispr Flow. Pressione Control-Command-V para colar a última transcrição. O guia do Wispr observa que alguns terminais e IDEs usam outro comando de colar, como Control-Shift-V ou colar com o botão direito, então confira o comando de colar do seu terminal.
Superwhisper. Para terminais que bloqueiam a colagem, o guia dele sugere ativar o Simulate keypresses em Text input. Isso digita o resultado com um teclado virtual. O recurso é experimental, só suporta o layout US QWERTY e pode causar uma colagem dupla em apps que colam normalmente. Então ative esse recurso só quando a colagem falhar.
VoiceInk. Mude Settings > Pasting > Paste Method para AppleScript se a colagem padrão não faz nada.
Causa 3: Foco e teclas modificadoras
Dois problemas pequenos parecem uma colagem quebrada:
- Foco. No VS Code, o editor, o terminal integrado e o painel de chat são campos separados. Clique no painel que você quer antes de ditar e não clique em outro lugar até o texto chegar.
- Modificadores pressionados. Se o atalho de ditado usa Option ou Control e você ainda segura a tecla quando o app envia o Command-V, o app recebe Option-Command-V ou Control-Command-V. Esse é outro atalho. Solte todas as teclas antes de a transcrição ficar pronta.
Causa 4: Acessibilidade
Se nada é colado em nenhum app, o app de ditado não tem acesso à Acessibilidade. Resolva isso primeiro: permissão de Acessibilidade não funciona depois de atualizar um app.
Como o Petal lida com o VS Code, terminais e agentes de código
O Petal para Mac é um app de ditado grátis e de código aberto que roda os modelos de fala no seu Mac. A etapa de colar dele foi feita pensando em apps Electron e terminais. Segundo o código do app:
- Um atraso de restauração de 700 ms. O Petal coloca a transcrição no clipboard, envia Command-V e restaura o clipboard antigo 700 ms depois. O comentário no código explica o motivo: "Electron apps such as VS Code read the clipboard some time after Command-V, so an early restore pastes the old content."
- Não sobrescreve uma cópia nova. Se você copia algo durante esses 700 ms, o Petal mantém a sua nova cópia.
- Uma colagem real, não teclas digitadas. O Petal envia Command-V, então os apps de terminal que aceitam colagem recebem o texto como uma colagem.
- Espera você soltar os modificadores. O Petal espera até 400 ms para você soltar teclas como Option e Control antes de enviar o Command-V.
- Chave Restore Clipboard. Se um app ainda cola o conteúdo antigo, desative o Restore Clipboard em Settings > Recording. Então a transcrição fica no clipboard.
Use o Router para editores de código
Em Settings > Router, você pode adicionar uma rota para cada app ou site. Cada rota pode ter o próprio estilo:
- As Said cola as palavras exatamente como você falou, sem limpeza. Use esse estilo em um terminal, onde uma reescrita pode mudar um comando.
- AI Prompt "writes a prompt for an AI agent", ou seja, escreve um prompt para um agente de IA. Use esse estilo no Claude Code, no Codex ou em um painel de chat do seu editor.
- Custom deixa você escrever as suas próprias instruções, por exemplo "mantenha os termos de código e os nomes de arquivo exatamente como falados".
A limpeza pode rodar no seu Mac com o Petal W1 ou com a Apple Intelligence, ou com um modelo na nuvem e a sua própria chave. Leia mais em limpeza do ditado por app no Mac.
Envie sem uma segunda tecla
Em Settings > General, o Send Now deixa você pressionar Control-X e depois Control-S enquanto grava. O Petal para, cola e pressiona Return. Em um terminal, isso executa o prompt. Se uma colagem falhar, defina no mesmo painel um atalho Paste Last Transcription para colar de novo a sua transcrição mais recente.
Se você usa o Aqua Voice e ele falha em terminais, leia também Aqua Voice não funciona.
Perguntas
Por que o ditado cola o texto antigo do clipboard no VS Code?
A maioria dos apps de ditado coloca a transcrição no clipboard, envia Command-V e depois restaura o clipboard antigo. O VS Code e outros apps Electron podem ler o clipboard depois dessa restauração, então colam o conteúdo antigo. Aumente o atraso de restauração do app, ou deixe a transcrição ficar no clipboard.
Por que o texto ditado não aparece no Claude Code?
A issue #51725 no GitHub relata que o texto do Aqua Voice sumia sem aviso no Claude Code no Windows. Quem relatou achava que o Aqua enviava pressionamentos de tecla simulados que o Claude Code não aceitava, enquanto a colagem pelo clipboard funcionava. Use um método baseado em colar, como o Paste Last Transcript.
O ditado da Apple funciona no Terminal do Mac?
O ditado da Apple digita no campo em foco na maioria dos apps, incluindo o Terminal, mas o resultado varia nos apps de terminal. Se o texto não aparece, dite em outro app e cole, ou use um app de ditado que cola com Command-V.
Posso usar um estilo de ditado diferente no meu editor de código?
O Router do Petal deixa cada app usar a própria limpeza. Você pode configurar o terminal ou o editor como As Said, para o Petal colar exatamente o que você falou, ou usar o preset AI Prompt para agentes de código.