Ir al contenido
Petal

SolucionesMac7 min de lectura

El dictado no funciona en VS Code, Terminal o Claude Code

¿El dictado no funciona en VS Code o Terminal? Las apps de Electron leen el portapapeles tarde y algunas terminales ignoran teclas simuladas. Soluciones.

Publicado por Optimal Apps, el creador de Petal.

En esta página

¿El dictado no funciona en VS Code, Terminal o Claude Code? Casi siempre la causa es una de dos. Primero, las apps de Electron como VS Code, Cursor y Slack leen el portapapeles tarde, así que una app de dictado que restaura demasiado pronto tu portapapeles anterior hace que peguen el contenido anterior. Segundo, algunas terminales y apps de terminal ignoran las pulsaciones de teclas simuladas, así que una app de dictado que "escribe" el texto no logra que entre nada. La solución es darle más tiempo al pegado o cambiar la app de dictado de escribir el texto a pegarlo desde el portapapeles.

Esta guía explica las dos causas, da las soluciones para Superwhisper, VoiceInk, Wispr Flow y Aqua Voice, y luego explica cómo maneja Petal los editores de código.

El dictado no funciona en VS Code o en una terminal: lista rápida de soluciones

Síntoma Causa Solución
Se pega el texto anterior del portapapeles en VS Code o Cursor El portapapeles se restauró antes de que la app lo leyera Sube la espera de restauración o conserva la transcripción en el portapapeles
No se pega nada en una terminal La terminal ignora las pulsaciones de teclas simuladas Usa un pegado desde el portapapeles o el atajo para pegar la última transcripción
El texto se pega en el editor, pero no en la terminal integrada El foco está en el panel equivocado Haz clic en el panel de la terminal antes de dictar
El texto se pega dos veces Se ejecutaron la escritura y el pegado Desactiva la simulación de teclas para esa app
Aparece un carácter extraño o no se pega nada después de un atajo Las teclas modificadoras del atajo siguen presionadas durante Comando-V Suelta todas las teclas antes del pegado
No se pega nada en ninguna app Falta Accesibilidad Restablece Accesibilidad para la app

Causa 1: Las apps de Electron leen el portapapeles tarde

La mayoría de las apps de dictado para Mac pegan en cuatro pasos:

  1. Guardan tu portapapeles actual.
  2. Ponen la transcripción en el portapapeles.
  3. Envían Comando-V a la app activa.
  4. Restauran tu portapapeles anterior.

Las apps nativas, como TextEdit, leen el portapapeles de inmediato cuando reciben Comando-V. Las apps de Electron, como VS Code, Cursor, Slack y Discord, pueden leerlo un momento después. Si el paso 4 ocurre antes, la app pega tu portapapeles anterior. El resultado parece que "el dictado pega el texto equivocado en VS Code".

Soluciones de cada proveedor para la lectura tardía del portapapeles

Superwhisper. Su guía de pegado indica:

  1. Abre Settings > Configuration > Advanced settings y desplázate hasta Text input.
  2. Cambia Clipboard content a Replace with dictation. El valor predeterminado, Keep what I have copied, restaura tu portapapeles anterior después del pegado.
  3. Prueba. Tu contenido anterior del portapapeles desaparece después de cada dictado.

La misma página indica hacer clic en el editor y mantener el foco ahí hasta que termine el dictado, y revisar que la opción de pegado automático del modo esté en Default u On.

VoiceInk. Su guía del portapapeles indica:

  1. Abre Settings > Pasting.
  2. Deja Keep Clipboard Content activado.
  3. Sube Restore Delay. El valor predeterminado es 2 segundos y el rango va de 250 ms a 5 segundos.

Hay más detalles en VoiceInk no pega el texto.

Aqua Voice. El registro de cambios de Aqua menciona la corrección de un error de pegado en VS Code y Cursor en la v0.11.6. Actualiza a la versión más reciente.

Para la versión de este problema en Superwhisper, consulta Superwhisper pega el portapapeles anterior.

Causa 2: Las terminales ignoran la entrada simulada

Algunas apps de dictado no pegan. "Escriben" el texto con eventos de teclas simulados. Algunas apps de terminal solo aceptan pulsaciones reales o un pegado real, e ignoran lo demás.

El issue #51725 de GitHub del repositorio anthropics/claude-code es un ejemplo. Quien lo reportó usaba Aqua Voice v0.14.2 en la terminal integrada de Cursor (PowerShell) en Windows 11. El texto dictado se descartaba sin aviso en el prompt de Claude Code, mientras que funcionaba en un prompt normal de PowerShell. Su teoría, no confirmada, era que Aqua envía pulsaciones simuladas y que Claude Code solo acepta bracketed paste. La función Paste Last Transcript de Aqua, que usa el portapapeles, sí funcionaba. El issue se cerró como duplicado de un reporte relacionado sobre el pegado simulado en Windows.

La misma idea aplica en una Mac: si el texto llega como teclas escritas y la app de terminal las ignora, cambia a un pegado desde el portapapeles.

Soluciones de cada proveedor para las terminales

Aqua Voice. Dicta y luego presiona Paste Last Transcript. El registro de cambios de Aqua indica Control-Comando-V como atajo predeterminado en Mac, y puedes cambiarlo en Settings.

Wispr Flow. Presiona Control-Comando-V para pegar la última transcripción. La guía de Wispr indica que algunas terminales e IDE usan otro comando de pegado, como Control-Mayúsculas-V o pegar con clic derecho, así que revisa el comando de pegado de tu terminal.

Superwhisper. Para las terminales que bloquean el pegado, su guía sugiere activar Simulate keypresses en Text input. Esa opción escribe el resultado con un teclado virtual. Es experimental, solo es compatible con QWERTY de EE. UU. y puede pegar dos veces en las apps que pegan normalmente. Por eso, actívala solo cuando falle el pegado.

VoiceInk. Cambia Settings > Pasting > Paste Method a AppleScript si el pegado predeterminado no hace nada.

Causa 3: El foco y las teclas modificadoras

Dos problemas pequeños parecen un pegado roto:

  • El foco. En VS Code, el editor, la terminal integrada y el panel de chat son campos separados. Haz clic en el panel que quieres antes de dictar y no hagas clic en otro lugar hasta que llegue el texto.
  • Teclas modificadoras presionadas. Si tu atajo de dictado usa Opción o Control y todavía lo mantienes presionado cuando la app envía Comando-V, la app recibe Opción-Comando-V o Control-Comando-V. Ese es otro atajo. Suelta todas las teclas antes de que la transcripción esté lista.

Causa 4: Accesibilidad

Si no se pega nada en ninguna app, la app de dictado no tiene acceso de Accesibilidad. Soluciona eso primero: El permiso de Accesibilidad no funciona después de actualizar una app.

Cómo maneja Petal VS Code, las terminales y los agentes de programación

Petal para macOS es una app de dictado gratis y de código abierto que ejecuta los modelos de voz en tu Mac. Su paso de pegado se diseñó pensando en las apps de Electron y en las terminales. Según el código de la app:

  • Una espera de restauración de 700 ms. Petal pone la transcripción en el portapapeles, envía Comando-V y restaura tu portapapeles anterior 700 ms después. El comentario del código explica la razón: "Electron apps such as VS Code read the clipboard some time after Command-V, so an early restore pastes the old content."
  • No sobrescribe una copia nueva. Si copias algo durante esos 700 ms, Petal conserva tu nueva copia.
  • Un pegado real, no teclas escritas. Petal envía Comando-V, así que las apps de terminal que aceptan un pegado reciben el texto como un pegado.
  • Espera a que sueltes las teclas modificadoras. Petal espera hasta 400 ms a que sueltes teclas como Opción y Control antes de enviar Comando-V.
  • Interruptor Restore Clipboard. Si una app sigue pegando el contenido anterior, desactiva Restore Clipboard en Settings > Recording. Así, la transcripción se queda en el portapapeles.

Usa el Router para los editores de código

En Settings > Router, puedes agregar una ruta para cada app o sitio web. Cada ruta puede tener su propio estilo:

  • As Said pega las palabras exactamente como las dijiste, sin limpieza. Úsalo en una terminal, donde una reescritura puede cambiar un comando.
  • AI Prompt "writes a prompt for an AI agent". Úsalo para Claude Code, Codex o un panel de chat en tu editor.
  • Custom te deja escribir tus propias instrucciones, por ejemplo "mantén los términos de código y los nombres de archivo exactamente como los digo".

La limpieza puede ejecutarse en tu Mac con Petal W1 o Apple Intelligence, o con un modelo en la nube y tu propia clave. Lee más en Limpieza del dictado por app en Mac.

Envía sin una segunda tecla

En Settings > General, Send Now te permite presionar Control-X y luego Control-S mientras grabas. Petal se detiene, pega y presiona Retorno. En una terminal, eso ejecuta el prompt. Si alguna vez falla un pegado, define un atajo Paste Last Transcription en el mismo panel para volver a pegar tu transcripción más reciente.

Si usas Aqua Voice y falla en las terminales, lee también Aqua Voice no funciona.

Preguntas

¿Por qué el dictado pega el texto anterior del portapapeles en VS Code?

La mayoría de las apps de dictado ponen la transcripción en el portapapeles, envían Comando-V y luego restauran tu portapapeles anterior. VS Code y otras apps de Electron pueden leer el portapapeles después de esa restauración, así que pegan el contenido anterior. Sube la espera de restauración de la app o deja que conserve la transcripción en el portapapeles.

¿Por qué el texto dictado no aparece en Claude Code?

El issue #51725 de GitHub informa que Claude Code en Windows descartaba sin aviso el texto de Aqua Voice. Quien lo reportó pensaba que Aqua enviaba pulsaciones de teclas simuladas que Claude Code no aceptaba, mientras que el pegado desde el portapapeles sí funcionaba. Usa un método basado en el pegado, como Paste Last Transcript.

¿El Dictado de Apple funciona en Terminal en Mac?

El Dictado de Apple escribe en el campo que tiene el foco en la mayoría de las apps, incluida Terminal, pero los resultados en las apps de terminal varían. Si el texto no aparece, dicta en otra app y pega el texto, o usa una app de dictado que pegue con Comando-V.

¿Puedo usar otro estilo de dictado para mi editor de código?

El Router de Petal permite que cada app tenga su propia limpieza. Puedes configurar tu terminal o tu editor con As Said, para que Petal pegue exactamente lo que dijiste, o con el preset AI Prompt para agentes de programación.

SolucionesMac

Spokenly no funciona en Mac: cómo solucionarlo

¿Spokenly no funciona en Mac? Revisa los permisos de Micrófono y Accesibilidad, el atajo, los modelos locales, el modo Local-only y los problemas al pegar.