La voz de Claude Code no funciona: soluciones por síntoma y la versión en la que se arregló cada fallo

Casi todos los fallos de /voice caen en uno de cinco cajones: has iniciado sesión de una forma que no incluye la función, tu terminal nunca recibió permiso para el micrófono, estás en un sitio sin micrófono local, a tu backend de audio de Linux o WSL le falta una pieza, o estás con una versión que tiene un fallo que otra posterior ya arregló.

Por la redacción de VoiceBoardActualizado el 28 de agosto de 2026

Empieza por lo último, porque es lo más barato de descartar. El dictado por voz salió a principios de marzo de 2026 y desde entonces lo han tocado 32 versiones, con 56 entradas distintas en el registro de cambios público. Si tu instalación tiene más de un par de semanas, actualiza antes de depurar nada:

claude update
claude doctor

Todo lo de abajo se comprobó en la fuente el 27 de agosto de 2026: la documentación de dictado por voz de Anthropic, el registro de cambios público recorrido versión a versión, las fechas de publicación del registro de npm y los informes fechados del rastreador de incidencias de Anthropic. La versión más reciente en ese momento era la 2.1.247, publicada el 26 de agosto de 2026.

Una aclaración previa, porque manda a mucha gente por el camino equivocado. Anthropic tiene dos funciones distintas con «voz» en el nombre. El modo de voz es la conversación hablada de ida y vuelta en las apps de Claude, y su propia página de ayuda dice que no es compatible con Claude Code. /voice en Claude Code es solo dictado: tú hablas, el texto aterriza en el prompt y Claude responde por escrito. Casi todos los vídeos de «arreglar la voz de Claude» que salen en las búsquedas van del primero y no te van a servir de nada.

Localiza tu síntoma

1. /voice no aparece o se niega a activarse

/voice no está disponible en todas las cuentas, y Claude Code esconde los comandos que tu configuración no puede usar en lugar de mostrarlos en gris (registro de cambios 2.1.84, 25 de marzo de 2026). Así que «el comando no existe» y «el comando no es para ti» se ven exactamente igual.

El dictado por voz exige una cuenta de Claude.ai. No está disponible cuando Claude Code apunta directamente a una clave de API de Anthropic, a Amazon Bedrock, a Agent Platform de Google Cloud o a Microsoft Foundry. No es un fallo y no hay ninguna casilla que marcar. Si te sale Voice mode requires a Claude.ai account, ejecuta /login e inicia sesión con la cuenta de Claude.ai, no con la credencial de API.

Si ves Voice mode is disabled by your organization's policy, un administrador lo apagó para toda la organización. Antes de junio de 2026 este caso mostraba un mensaje genérico de «no disponible», que es la razón por la que las respuestas antiguas de los foros mandan a reinstalar; la redacción concreta llegó en la 2.1.191, el 24 de junio de 2026.

Versión mínima. La primera entrada del registro de cambios que menciona la voz es la 2.1.69, publicada el 4 de marzo de 2026. Nada anterior tiene la función.

Si estás leyendo un hilo antiguo donde /voice devuelve Unknown skill: voice: eso era el despliegue, no tu máquina. Durante marzo de 2026 el comando estuvo detrás de un interruptor de función, así que quien tenía la versión correcta y el plan correcto seguía recibiendo el error, mientras el cartel de arranque le invitaba alegremente a ejecutar un comando que no respondía (#33580, 12 de marzo de 2026; #33914, 13 de marzo de 2026). No es algo que se arregle editando ajustes, y no es algo con lo que debieras seguir topándote hoy.

2. Permiso del micrófono, incluido el terminal que no aparece en la lista

/voice hace una comprobación de micrófono la primera vez que lo activas. En macOS ese es el momento en el que tu terminal debería pedir permiso.

macOS: Ajustes del Sistema, luego Privacidad y seguridad, luego Micrófono, luego activa tu app de terminal y ejecuta /voice otra vez.

Windows: Configuración, luego Privacidad y seguridad, luego Micrófono, luego activa el acceso al micrófono para las aplicaciones de escritorio y ejecuta /voice otra vez.

Cuando tu terminal no está en la lista de macOS, no hay ningún interruptor que activar, y este es el arreglo que documenta Anthropic: reiniciar el estado del permiso para que la próxima ejecución dispare una petición nueva.

tccutil reset Microphone com.apple.Terminal      # Terminal integrado
tccutil reset Microphone com.googlecode.iterm2   # iTerm2
osascript -e 'id of app "Ghostty"'               # cualquier otro terminal: obtener su bundle id

Después sal del terminal con Cmd+Q, no cierres solo la ventana, porque macOS no vuelve a preguntar a un proceso que ya está en marcha. Ábrelo de nuevo y ejecuta /voice.

Un aviso que merece repetirse de la documentación: ejecutar tccutil reset Microphone sin un bundle id revoca el acceso al micrófono de todas las apps de la máquina, Zoom y Slack incluidos. No hagas eso en mitad de una llamada.

La trampa de la que no escribe nadie. Si ejecutas Claude Code dentro de una app envoltorio de terminal o de un multiplexor en vez de en un terminal normal, puede que ese envoltorio nunca haya declarado el permiso de micrófono, en cuyo caso no aparece en la lista de privacidad y no se puede añadir. Hay dos ejemplos documentados: un informe contra el terminal Solo (soloterm/solo#114, 30 de marzo de 2026) señala que macOS no ofrece botón de añadir para apps sin firmar o sin el permiso declarado, y otro contra Superset (superset-sh/superset#5026, 1 de junio de 2026) informa de que no funciona ninguno de los dos modos. El apaño es el mismo en ambos: ejecuta Claude Code en Terminal.app, en iTerm2 o en otro terminal firmado y mira si la voz vuelve. Si vuelve, el problema nunca fue Claude Code.

3. Mantener pulsado el espacio no hace nada

El modo de mantener pulsado detecta la tecla sostenida vigilando los eventos rápidos de repetición de tecla que manda tu terminal. Ese mecanismo falla de dos maneras, y las distingues mirando la línea de entrada mientras mantienes pulsado.

Se van acumulando espacios. La voz está apagada. Ejecuta /voice hold.

Aparecen uno o dos espacios y luego nada. La voz está encendida, pero la repetición de tecla no llega a Claude Code. Hay terminales que no envían eventos de repetición, y la repetición de tecla se puede desactivar en el propio sistema operativo. No pelees con eso, cambia de modo:

/voice tap

El modo toque funciona como interruptor: tocas una vez para empezar, hablas y tocas otra vez para parar. No tiene calentamiento y no depende de la repetición de tecla. Ten en cuenta que el primer toque solo inicia la grabación si el prompt está vacío, así que si ya has escrito algo, tocar el espacio escribe un espacio y ya.

Perder las primeras palabras es el mismo mecanismo visto por el otro lado. El modo de mantener pulsado tiene un breve calentamiento, el pie de página dice keep holding… antes de listening…, y la queja es pública desde la semana del lanzamiento: un desarrollador en Hacker News lo midió en unos 500 ms y contó que le cortaba las primeras palabras (13 de marzo de 2026). Hay dos salidas. Usar el modo toque, o reasignar la tecla a una combinación con modificador, que empieza a grabar en la primera pulsación sin calentamiento ninguno:

{
  "bindings": [
    { "context": "Chat", "bindings": { "meta+k": "voice:pushToTalk" } }
  ]
}

Eso va en ~/.claude/keybindings.json. Evita asignar una letra suelta en el modo de mantener pulsado, porque la letra se escribe en tu prompt durante el calentamiento. Bloq Mayús no se puede asignar en absoluto: los terminales no la entregan, y desde la 2.1.122 al menos recibes un error que lo dice en vez de silencio.

En la extensión de VS Code puede que el espacio sencillamente no sea el disparador. La entrada del chat es una webview, y hay un informe abierto que dice que allí el espacio no hace nada mientras que pulsar el icono del micrófono funciona con normalidad (#85309, 9 de agosto de 2026). En el mismo informe: escribir /voice como mensaje de chat dentro de la extensión responde /voice isn't available in this environment. Pulsa el icono.

4. Graba y no vuelve nada

Tres mensajes distintos, tres causas distintas. Lee la redacción exacta antes de cambiar nada.

No audio detected from microphone. La grabación arrancó y capturó silencio. Comprueba que el dispositivo correcto es el predeterminado del sistema y que su nivel no está casi a cero: Configuración, Sistema, Sonido, Entrada en Windows; Ajustes del Sistema, Sonido, Entrada en macOS. Una causa frecuente en macOS es que la entrada predeterminada cambió después de empezar la sesión, y eso está en la sección 7.

Voice connection failed. La grabación nunca llegó al servicio de transcripción. Revisa la red. Ojo, porque este mensaje engañaba: antes de la 2.1.200, publicada el 3 de julio de 2026, un micrófono mudo informaba de un fallo de conexión, mandando a la gente a depurar una red que estaba perfectamente.

Voice stream error: WebSocket upgrade rejected with HTTP <status>. Un servidor rechazó la conexión, así que no es una caída del servicio. Un estado en el rango 400 suele significar una sesión caducada, o un proxy o un servicio antibots respondiendo en lugar del servicio de transcripción. Ejecuta /login y mira cualquier VPN o proxy corporativo que haya por el camino.

No speech detected. El audio llegó, no se reconoció ninguna palabra. Habla más cerca, quita ruido de fondo y comprueba que tu idioma de dictado coincide con el que estás hablando.

Este último tiene una historia tozuda. Un informe abierto el 25 de marzo de 2026 con una reproducción completa, micrófono funcionando, permisos concedidos, dispositivo predeterminado correcto, tanto en Terminal.app como en un terminal de JetBrains, sigue abierto y recogió varias confirmaciones en macOS en cuestión de días. Si has recorrido todo lo de esta página y sigues recibiendo No speech detected mientras el medidor de nivel se mueve, probablemente estés en ese informe y no en un error de configuración. Añade ahí tu versión y tu plataforma en lugar de reinstalar por cuarta vez.

Los fallos repetidos pausan el dictado. Tres fallos de captura en 10 segundos y Claude Code deja de intentarlo hasta que hayan pasado 10 segundos desde el primero: Voice input is failing repeatedly and has been paused. Eso es un síntoma, no la enfermedad. Arregla la causa de fondo y vuelve a activar la voz.

5. Linux, WSL, contenedores y equipos sin periféricos

La grabación usa un módulo nativo. Cuando no consigue cargarlo, Claude Code recurre a arecord de ALSA utils o a rec de SoX, y si no hay ninguno de los dos, /voice imprime el comando de instalación para tu gestor de paquetes.

Voice mode requires SoX for audio recording. Instálalo, por ejemplo con sudo apt-get install sox.

Voice mode requires a microphone, but SoX could not open an audio capture device. SoX está instalado y el anfitrión no tiene dispositivo de captura: un servidor sin periféricos, o un contenedor al que no se le pasó audio. Por mucho que instales, no cambia nada. Antes de la 2.1.195 (26 de junio de 2026) este caso te pedía por error instalar un SoX que ya estaba ahí, que es la razón de que tantos hilos de Linux acaben en confusión.

WSL: Voice mode could not find a working audio recorder in WSL. WSLg encamina el audio por PulseAudio, y el sox a secas arrastra el backend de ALSA, que no tiene ningún /dev/snd del que grabar.

sudo apt install sox libsox-fmt-pulse

También necesitas WSLg, que viene con el WSL2 instalado desde la Microsoft Store. En WSL1 no hay manera de que esto funcione; ejecuta Claude Code en Windows nativo.

Las transcripciones que vuelven vacías después de unos cuantos dictados en Linux pueden ser procesos de grabación acumulándose. Un informe abierto describe capturas fallidas y reintentadas que dejan procesos rec vivos, que mantienen abiertas conexiones de cliente de PulseAudio hasta que la pila de audio se degrada y la transcripción no devuelve nada (#83905, 4 de agosto de 2026, en un devcontainer de Debian sobre WSLg). Merece un vistazo:

ps -eo pid,ppid,etime,cmd | grep '[r]ec -q'

Si hay una pila de ellos ahí sentados minutos después de que dejaras de hablar, mátalos y reinicia la sesión.

6. La transcripción sale en el idioma equivocado

El dictado usa el mismo ajuste language que controla el idioma de respuesta de Claude, y si ese ajuste está vacío, el valor por defecto es el inglés. Habla en español a un decodificador puesto en inglés y no recibes un error: recibes un disparate verosímil.

{ "language": "es" }

Configúralo en /config o en tu archivo de ajustes, con el código BCP 47 o con el nombre del idioma. Hay veinte idiomas soportados: alemán, checo, coreano, danés, español, francés, griego, hindi, indonesio, inglés, italiano, japonés, neerlandés, noruego, polaco, portugués, ruso, sueco, turco y ucraniano. Cualquier otro vuelve al inglés con un aviso cuando activas la voz.

En la extensión de VS Code, un language vacío recurre al ajuste propio de VS Code accessibility.voice.speechLanguage antes que al inglés.

Dos cosas que esto no arregla. El envío automático en modo toque cuenta palabras, y para el japonés, el chino y el tailandés eso no empezó a funcionar hasta la 2.1.195. Y mezclar idiomas en una misma frase tiene un informe abierto detrás: los términos técnicos en inglés dentro de otro idioma se traducen o se pierden, porque el decodificador está fijado a un idioma cada vez (#83881, 4 de agosto de 2026). Si escribes código y hablas español, este es el caso que te va a tocar a diario: nombres de funciones, banderas de línea de comandos y nombres de bibliotecas dictados en medio de una frase en español.

7. Ayer funcionaba

Tres causas, en el orden en el que conviene mirarlas.

Has actualizado. Busca tu síntoma en la tabla de abajo. Cada fecha es la de publicación en npm de esa versión.

Tu Mac se ha suspendido. Hay un informe abierto que dice que la voz muere para siempre tras un ciclo de suspensión y despertar, que apagar y encender /voice no ayuda y que la única cura es reiniciar Claude Code del todo; quien lo reportó lo rastreó hasta el manejador de audio nativo, que se guarda en caché durante toda la vida del proceso y nunca se vuelve a comprobar después de que macOS desmonte la capa de audio (#89635, 25 de agosto de 2026, en la 2.1.245). Hasta que se arregle, trata «he cerrado la tapa» como «reiniciar la CLI».

Han cambiado tus dispositivos de audio. Mismo tipo de problema, otro disparador. Otro informe abierto dice que el dispositivo de entrada se resuelve una vez y no se vuelve a adquirir, así que cambiar el predeterminado del sistema a mitad de sesión sigue grabando del dispositivo antiguo, y conectar o desconectar unos AirPods puede atascar la captura por completo hasta que reinicies (#88890, 22 de agosto de 2026, en la 2.1.239). Si vives con auriculares Bluetooth, este es el tuyo.

8. Dónde no va a funcionar nunca, cambies lo que cambies

Ahórrate la tarde. El dictado por voz manda audio en streaming a los servidores de Anthropic, y el micrófono tiene que estar en la máquina donde corre el proceso, así que no está disponible en:

• Sesiones SSH y Claude Code en la web. El micrófono está en tu portátil; el proceso, no.
• VS Code Remote, lo que incluye Remote SSH, Dev Containers y Codespaces, por lo mismo.
• Cualquier montaje autenticado con clave de API, Bedrock, Agent Platform de Google Cloud o Microsoft Foundry. Si tu empresa puso Claude Code detrás de uno de esos por cumplimiento normativo, /voice no es una discusión que puedas ganar.
• WSL1.
• Sesiones en segundo plano y de despacho de agentes, al menos en macOS. Un informe con registros de CoreAudio muestra el dictado fallando el 100 por cien de las veces desde la línea de despacho claude agents con No audio detected from microphone, porque el proceso que abre el micrófono queda reasignado a launchd y macOS no consigue determinar un proceso responsable al que concederle el permiso (#86217, 12 de agosto de 2026).

Para todos estos casos la respuesta es la misma: dicta en el terminal desde el sistema operativo, con una herramienta que escriba en la ventana que tenga el foco. De eso va la sección «cuando el arreglo no sirve», más abajo.

9. Tu app de dictado ha dejado de escribir en Claude Code

Este es otro fallo con la misma sensación, y pilla a gente que nunca ha usado /voice. Claude Code lee el teclado en modo raw, es decir, directo y sin procesar por el sistema, y las herramientas de dictado insertan texto simulando pulsaciones o un pegado. Esas dos cosas han chocado más de una vez.

El choque gordo fue una regresión en la 2.1.83 (25 de marzo de 2026): el pegado simulado dejó de aterrizar en el prompt mientras el pegado manual seguía funcionando, confirmado tanto en Windows como en macOS por más de una docena de personas en un mismo hilo, con varias herramientas de dictado afectadas (#38620). Quienes lo reportaron lo vieron volver a funcionar hacia la 2.1.116 o la 2.1.119, a finales de abril, algunos solo tras reinstalar y reiniciar la máquina. En Linux hubo un caso paralelo en el que se tragaba los espacios de los teclados virtuales, así que el texto dictado llegaba como HolaMundoPrueba (#43429, 4 de abril de 2026).

Qué probar hoy, por orden:

1. Actualiza Claude Code y luego reinicia la máquina. Dos personas de aquel hilo solo recuperaron el dictado tras una reinstalación completa y un reinicio, no con la actualización sola.
2. Usa un método de inserción basado en pegado en vez de escritura simulada. Si tu herramienta te deja elegir, elige. VoiceInk, por ejemplo, documenta cómo cambiar el Paste Method de Default a AppleScript y subir el Restore Delay cuando el texto no aterriza en una app.
3. Prueba otro atajo de pegado. Los terminales no se ponen de acuerdo en esto, y las páginas de ayuda de Wispr Flow dicen que recurre a Mayús+Insert en los terminales de los IDE de Windows cuando Ctrl+V no es fiable.
4. Manda los dictados largos de una pieza y léelos antes de pulsar Intro. Wispr Flow parte los dictados largos en trozos precisamente para que un prompt completo llegue limpio a Claude Code y a Codex, y documenta que ese troceado es solo para Mac y que conviene dejar que un dictado termine de pegarse antes de empezar el siguiente. Hay además un informe abierto que describe un dictado de unos 4,000 caracteres llegando a la interfaz del terminal con los trozos recompuestos en desorden, partidos a mitad de palabra y enviados sin aviso ninguno (#82339, 29 de julio de 2026). Los monólogos largos contra un terminal merecen una relectura en cualquier caso.
5. Cuenta con que el pegado se colapse. Cualquier cosa de más de unas pocas líneas se muestra como [Pasted text #1 +N lines] en lugar de tus palabras, lo que parece un fallo y no lo es. Pulsa Ctrl+G para abrir el prompt en tu editor si quieres leerlo antes de enviarlo.

Cuando el arreglo no sirve

En algún momento la respuesta honesta deja de ser un ajuste. /voice es una buena función gratuita y está soldada a una sola ventana: funciona en el prompt de Claude Code y en ningún otro sitio, necesita una sesión de Claude.ai, desaparece justo en los despliegues que usan las empresas grandes y depende de que tu terminal reenvíe los eventos de repetición de tecla. Mientras tanto, un terminal en modo raw es un blanco hostil para cualquier cosa que le escriba texto desde fuera. Las dos mitades están en esta página.

La salida de ambas es una capa de dictado que viva en el sistema operativo: mantienes pulsado un atajo, hablas, y el texto ya terminado aterriza en lo que tenga el foco, sea Claude Code, un mensaje de commit de git, una pestaña del navegador o Slack. Le da igual en qué app estés, así que no hay nada que configurar herramienta por herramienta ni nada que recordar.

Wispr Flow es la que recomendamos primero a quien programa, y la razón es concreta: es la única herramienta que hemos encontrado cuya propia documentación describe cómo maneja este caso exacto, partiendo los dictados largos en trozos para que un prompt de varios miles de palabras llegue entero a Claude Code en lugar de truncado. En el día a día hace bien lo poco vistoso: fuera muletillas, puntuación colocada, la frase que empezaste dos veces convertida en la frase que querías decir, lo mismo en el terminal que en el panel de chat. El nivel gratuito son 2,000 palabras por semana en escritorio; Pro cuesta $15 al mes o $12 al mes pagando el año. La letra pequeña, porque descalifica de entrada a parte de los lectores: es un servicio en la nube, el soporte de Windows es solo x64 y los portátiles ARM se quedan fuera, las máquinas virtuales y el escritorio remoto no están soportados, y no hay versión para Linux. Precios comprobados el 27 de agosto de 2026.

Si el audio no puede salir de tu máquina, o sencillamente prefieres pagar una vez. VoiceInk ejecuta modelos locales en los Mac con Apple Silicon, es de código abierto y cuesta $29, $49 o $69 de una sola vez según cuántos Mac, con actualizaciones de por vida. Es el camino de pago más corto en un Mac hacia un dictado que no manda audio a ninguna parte, y $29 una vez frente a $144 al año de suscripción se amortizan en unas diez semanas. Profundizamos en ello en nuestro repaso de Mac.

En Linux, donde Wispr Flow no llega, Voicy publica paquetes .deb, .rpm y AppImage, y escribe en terminales y editores. El reconocimiento pasa por la infraestructura de Groq, así que el audio sí sale de tu máquina; la política del fabricante es borrado tras el procesamiento y nada de entrenamiento, que es una política y no lo mismo que el procesamiento local. 30 minutos gratis, y luego $8.49 al mes o $260 por una licencia vitalicia.

Y las opciones gratuitas merecen una respuesta directa y no una nota al pie. Handy es gratuita, con licencia MIT, corre en Windows, macOS y Linux, y transcribe entera en tu propia máquina; para alguien que programa y no le importa elegir un tamaño de modelo, es la opción más fuerte a coste cero de esta página, y un desarrollador en Hacker News contó que la usó felizmente durante un buen tiempo antes de que Claude Code tuviera voz siquiera. Superwhisper añadió el 26 de agosto de 2026 un nivel gratuito permanente que cubre el dictado en cualquier app con uso ilimitado de los modelos Whisper. Y si te pasas el día dentro de VS Code y no en un terminal, el dictado integrado de allí reconoce el habla en tu dispositivo, no cuesta nada y viene del mismo fabricante que el editor.

Si llegaste aquí para arreglar una función rota y ahora te preguntas qué instalar en su lugar, nuestra guía más amplia compara las opciones integradas de Claude Code, Cursor, VS Code y el terminal, incluido qué se queda en tu máquina.

Escrito a partir de la documentación de dictado por voz de Anthropic, del registro de cambios de Claude Code recorrido versión a versión (56 entradas sobre voz repartidas en 32 versiones), de las fechas de publicación en npm de cada versión nombrada aquí y de los informes fechados del rastreador de incidencias público de Anthropic. No hemos reproducido estos fallos en nuestras propias máquinas y no pretendemos haberlo hecho; cada uno está atribuido al informe o a la entrada del registro de cambios de donde sale. Los informes de un rastreador público describen lo que observaron unos usuarios, que no es lo mismo que un defecto confirmado. Esta página envejece deprisa, así que la revisamos cada trimestre.