¿La voz de Claude Code no funciona? Cada error y su solución.

1. /voice requiere que hayas iniciado sesión con una cuenta de Claude.ai. No está disponible con una clave de API, Bedrock, Vertex ni Foundry.
2. Graba en la máquina donde se ejecuta Claude Code, así que no funciona por SSH, en VS Code Remote ni en sesiones en la nube.
3. Después de cerrar la tapa, cambiar de dispositivo o actualizar, inicia una sesión nueva.

1. Unknown command: /voice o Voice mode requires a Claude.ai account

   No has iniciado sesión con Claude.ai, o una clave de API o un ajuste de proveedor tiene prioridad. Ejecuta /login, quita ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN o apiKeyHelper, y reinicia Claude Code.

   Según la documentación de Claude Code.

2. Voice mode is disabled by your organization’s policy

   Un administrador desactivó la voz. Pregúntale o usa una herramienta de dictado fuera de Claude Code.

   Según la documentación de Claude Code.

3. Microphone access is denied

   Permite tu terminal (o VS Code) en Ajustes del Sistema → Privacidad y seguridad → Micrófono. Si no aparece en la lista, restablece su permiso, ciérrala con ⌘Q y vuelve a abrirla.

   # Terminal: com.apple.Terminal · iTerm2: com.googlecode.iterm2
   # Ghostty: com.mitchellh.ghostty · Warp: dev.warp.Warp-Stable · VS Code: com.microsoft.VSCode
   tccutil reset Microphone com.apple.Terminal
   
   # Not sure of the bundle ID? Ask macOS:
   osascript -e 'id of app "iTerm"'

   Según la documentación de Claude Code.

4. No audio detected from microphone

   La grabación captó silencio. Normalmente la sesión está atada a un dispositivo o binario que cambió: inicia una sesión nueva. Todas las causas y soluciones →

5. No speech detected

   El audio llegó, pero no se reconoció ninguna palabra: acércate, reduce el ruido, configura tu idioma en /config. Más →

6. Voice input is failing repeatedly and has been paused

   Tres fallos en diez segundos: normalmente no hay micrófono (SSH, contenedor) o el permiso está denegado. Más →

7. Voice connection failed o Voice stream error: WebSocket upgrade rejected

   La grabación no llegó al servicio de transcripción. Revisa tu red; con un estado 4xx, vuelve a ejecutar /login y comprueba si hay una VPN o un proxy por medio.

   Según la documentación de Claude Code.

8. Voice mode requires SoX for audio recording o could not find a working audio recorder in WSL

   Solo Linux y WSL. Instala SoX; en WSL, también su formato PulseAudio.

   sudo apt-get install sox                    # Linux
   sudo apt install sox libsox-fmt-pulse       # WSL with WSLg

   Según la documentación de Claude Code.

9. Mantener pulsado Space solo escribe espacios

   Si se acumulan espacios, la voz está desactivada: ejecuta /voice hold. Si solo aparecen uno o dos, la repetición de teclas está desactivada en tu sistema operativo: usa /voice tap. En el modo tap, el prompt debe estar vacío para que el primer toque empiece a grabar.

   Según la documentación de Claude Code.

A octubre de 2026. Según la documentación de Claude Code y sus issues de GitHub.

¿La voz de Claude Code funciona con una clave de API, Bedrock o Vertex?

No. El dictado por voz necesita iniciar sesión con una cuenta de Claude.ai. Copy That funciona con cualquier inicio de sesión, porque solo pega texto en Claude Code.

¿El dictado por voz de Claude Code se procesa en local?

No. El audio se envía en streaming a Anthropic para transcribirlo, y el nombre de tu proyecto y tu rama de git se envían como pistas. No consume tokens ni cuenta para los límites de uso. Copy That transcribe en tu Mac con Whisper.

¿Puedo usar la voz de Claude Code en VS Code Remote o por SSH?

No, la voz graba en la máquina donde se ejecuta Claude Code. Copy That pega en la terminal que tengas delante en tu Mac, incluida una conectada por SSH.

¿Hay alguna forma de evitar estos errores por completo?

Usa un micrófono que no sea el del Mac. Copy That graba en tu iPhone o Apple Watch, transcribe en tu Mac con Whisper y pega en Claude Code, así que los dispositivos de entrada, la tapa y los permisos de micrófono del Mac dan igual.