VoiceMode: hablar con Claude Code por voz cuando escribir es incómodo

Para quién

Ya usas Claude Code y quieres seguir la conversación con voz natural cuando las manos están ocupadas y escribir es incómodo. El texto oficial dice que la voz no pretende sustituir la escritura, sino mantener la conversación usable cuando escribir es imposible. Para quien acepta una entrada y salida de voz reales, no solo un eco de texto.

Los extractos de plataforma cubren Linux, macOS, Windows (nativo o WSL) y NixOS, Python 3.10-3.14. Las notas actuales no listan un modelo de micrófono obligatorio, requisitos de altavoz ni si un servicio de voz en la nube es forzoso. Si no puedes instalar un plugin en Claude Code, o no puedes permitir herramientas relacionadas con la voz, esta guía no te ayuda.

Primera prueba en 3 minutos

Requisitos previos: Claude Code está disponible, Python está en 3.10-3.14 y el entorno actual puede hablar y escuchar. La ruta oficial recomendada es añadir primero el mercado y luego instalar el plugin. No empieces por un comando MCP de derivación:

claude plugin marketplace add mbailey/voicemode
claude plugin install voicemode@voicemode

Tras instalar, reinicia o vuelve a abrir Claude Code una vez y confirma que el plugin aparece. En la primera prueba usa solo mcp__voicemode__converse, el que nombra el extracto. No es una consulta de solo lectura: entra en una conversación por voz, puede usar dispositivos de audio locales y entregará lo que digas al agente. Antes de empezar, confirma que puedes hablar, oír y que no te importa que el modelo procese esta conversación; luego lanza la llamada.

Señal de éxito observable: la conversación continúa en forma de voz, no que el propio comando de instalación del plugin haya devuelto éxito. Las notas actuales no dan una frase de prueba fija ni una palabra clave de registro. Si el cliente muestra una confirmación de permiso, comprueba que va a permitir mcp__voicemode__converse antes de aceptar. No llames a mcp__voicemode__service en la primera prueba: el extracto solo lo pone en la lista de permisos y no dice qué hace.

El material también tiene claude mcp add --scope user voicemode -- uvx --refresh --from voice-mode voicemode-mcp-launcher, otra ruta de instalación. La primera prueba debe seguir solo el mercado de plugins de arriba; no configures dos entradas a la vez.

Casos de uso

Caso 1: cuando escribir cerca no encaja, usa mcp__voicemode__converse para convertir una tarea de Claude Code en curso en idas y vueltas de voz. Las notas actuales solo prometen «conversación de voz natural» y no listan idioma, interrupción, reducción de ruido ni parámetros para convertir la voz en un borrador editable. El éxito se juzga por entender la respuesta y poder seguir el siguiente turno, no por una línea de registro de texto.

Caso 2: cuando hay que permitir explícitamente la capacidad de voz, la lista de permisos incluye mcp__voicemode__converse y mcp__voicemode__service. El extracto no explica la función de service, si cambia servicios locales ni cómo retroceder ante un fallo. Este caso se detiene por tanto en «permitir converse según la lista; service queda sin explicar». No inventes pasos para reiniciar un servicio o instalar un demonio del sistema.

Límites de uso

La página oficial es

https://github.com/mbailey/voicemode

No lo interpretes como «sin red, sin lecturas locales, sin frontera de privacidad»: una conversación por voz captura por defecto lo que dices. Python debe estar en 3.10-3.14. La lista de plataformas termina en Linux, macOS, Windows (nativo o WSL) y NixOS. El extracto no tiene pasos de desinstalación, apagado del micrófono o revocación de una conversación. La herramienta service no tiene uso más allá de su nombre de permiso. Existe un comando de arranque uvx de derivación, pero no debe competir con el mercado de plugins como segunda ruta principal. No se escriben cuotas, facturación ni claves de nube obligatorias.