Dictado de Claude Code: hablas en vez de escribir, y la transcripción no te gasta los límites

Qué es y por qué importa

Le escribes a Claude Code diez veces por hora, y cada vez recortas. El contexto que tenías en la cabeza se queda en una línea, porque escribirlo todo es lento. Luego Claude hace lo que no era y te toca explicarlo otra vez.

El dictado ya está dentro de Claude Code. Lo activas con /voice, hablas, y las palabras aparecen en el prompt mientras las dices. Puedes mezclar: una frase la dices, el nombre de un archivo lo escribes.

Y la documentación de Anthropic lo dice claro: la transcripción no consume mensajes ni tokens y no cuenta en los límites de /usage. El prompt que envías consume como siempre, como si lo hubieras escrito. Es para quien pasa el día en Claude Code y quiere dar más contexto con menos esfuerzo.

1. Qué necesitas y adónde va tu voz

Antes de probarlo, comprueba estas tres cosas:

• Una cuenta de Claude.ai con la que hayas iniciado sesión en Claude Code. Con una clave de API de Anthropic, Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry el dictado no está disponible.
• Un micrófono en el ordenador donde corre Claude Code. En las sesiones en la nube y por SSH no funciona.
• En Windows dentro de WSL necesitas WSLg; sin él, usa Claude Code directamente en Windows.

Que lo sepas antes: el audio no se queda en tu ordenador. Va a los servidores de Anthropic, que lo transcriben; no se procesa en local. Cómo tratan los datos lo explica la documentación de Claude Code.

2. Actívalo con /voice y elige cómo hablar

En el chat de Claude Code escribe:

/voice

Se hace una prueba del micrófono; en Mac, la primera vez, el sistema pide permiso para tu terminal: acéptalo. Luego lees Voice mode enabled (hold) y, al final, Dictation language: en. Ese en es inglés: lo cambias en el paso 3.

Dos modos: mantener o tocar

• Mantener (hold), el modo por defecto: mantienes el espacio, hablas, sueltas. Tras un breve calentamiento abajo aparece listening… y graba. Cuando sueltas, el texto entra en el prompt y espera tu Intro.
• Tocar (tap): con el prompt vacío tocas el espacio y empieza, lo vuelves a tocar y se para, sin calentamiento. Si el texto tiene al menos tres palabras lo envía solo, así un toque por error no manda una palabra suelta. También se para tras 15 segundos de silencio o 2 minutos en total.

Para elegir el modo o apagarlo (la elección se queda también para las siguientes sesiones):

/voice hold

/voice tap

/voice off

O en ~/.claude/settings.json (si ya tiene otros ajustes, añade solo el bloque voice, con la coma). Esto es hold con envío automático al soltar la tecla, si el texto tiene al menos tres palabras. Sin autoSubmit, que solo vale en hold, espera tu Intro. Para tap, escribe "tap" en lugar de "hold".

{
  "voice": {
    "enabled": true,
    "mode": "hold",
    "autoSubmit": true
  }
}

Mi consejo: hold sin envío automático, hasta que te fíes de la transcripción.

3. Ponlo en tu idioma y sabe qué cambia

Por defecto el dictado entiende inglés: si hablas español sin cambiar nada, sale un texto destrozado. El español está entre los idiomas compatibles. Lo pones desde /config, o en ~/.claude/settings.json:

{
  "language": "spanish"
}

También vale el código "es". Si escribes un idioma que no está en la lista, /voice te avisa y para el dictado vuelve al inglés.

Ojo: es el mismo ajuste que decide el idioma de las respuestas. Desde ahí Claude te responde en español, y también los títulos automáticos de las sesiones salen en español.

4. Habla, escribe, descarta

Las palabras aparecen mientras hablas, atenuadas hasta que la transcripción está terminada. El texto entra donde está el cursor: escribes media frase, mantienes el espacio y dices el resto. Mantén otra vez para añadir otro trozo.

Está pensada para quien programa: reconoce palabras como regex, OAuth, JSON y localhost, y usa sola el nombre de tu proyecto y de la rama de git como pista. Mi forma: el razonamiento lo digo, las rutas exactas de los archivos las escribo.

¿Te has equivocado de frase? Esc

Pulsa Esc o Ctrl+C mientras grabas, o mientras la frase aún se procesa: el micrófono se apaga, la transcripción se descarta y el prompt vuelve a como estaba. En esa pulsación, Esc no interrumpe a Claude y Ctrl+C no te saca de Claude Code.

5. Cambia la tecla, si el espacio te molesta

En hold el espacio tiene el calentamiento, y donde hace otra cosa (en el visor de la conversación, en vim fuera de INSERT) no dicta. Una combinación como Option+K en Mac, Alt+K en los demás, empieza a la primera pulsación y funciona también ahí. Se cambia en ~/.claude/keybindings.json:

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

meta es Option en Mac y Alt en los demás. La tecla nueva sustituye al espacio, para hold y tap, y Claude Code lee el archivo sin reiniciar. En hold no uses una letra suelta como la v: durante el calentamiento acaba en el prompt.

6. Tres frases para dictar ya

Hablando das más contexto del que escribirías. Abre Claude Code en tu proyecto, activa el dictado y di una de estas, con lo tuyo en lugar de las partes entre [ ].

Antes de cambiar nada, lee el proyecto y explícame cómo funciona [el pago de la suscripción]: desde qué archivo empieza, por dónde pasa y dónde podría romperse. Luego hazme tres preguntas sobre lo que no te quede claro.

Hay un bug: cuando [un usuario nuevo se registra y vuelve atrás desde la pantalla de bienvenida], [la app se queda en blanco]. Esperaba [volver a la pantalla de inicio]. Encuentra la causa, explícamela en dos frases y propón la corrección más pequeña. No toques el código hasta que te diga ok.

Por hoy hemos terminado. Resume qué hemos cambiado en esta sesión, qué queda abierto y qué harías mañana lo primero, y escríbelo en [NOTAS.md] en cinco líneas como mucho.

Errores comunes

• Dictar en español sin haber puesto el idioma: el texto sale destrozado, porque por defecto el dictado es en inglés.
• Unknown command: /voice. No has iniciado sesión con una cuenta de Claude.ai, o algo tiene prioridad: ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, un apiKeyHelper u otro proveedor. Quítalo, reinicia Claude Code y haz /login.
• Microphone access is denied en Mac: Ajustes del Sistema → Privacidad y seguridad → Micrófono, activa tu terminal y vuelve a lanzar /voice. Si no está en la lista: tccutil reset Microphone com.apple.Terminal (iTerm2: com.googlecode.iterm2), luego cierra el terminal con Cmd+Q y vuelve a abrirlo. Nunca sin el identificador: le quita el micrófono a todas las apps.
• Probarlo por SSH o en una sesión en la nube: el micrófono tiene que estar en el ordenador donde corre Claude Code.
• Mantener el espacio y ver solo espacios. Si se acumulan, el dictado está apagado: /voice hold. Si aparecen uno o dos y nada más, la repetición de teclas está desactivada: /voice tap.

Lista de comprobación

• He iniciado sesión en Claude Code con una cuenta de Claude.ai, no con una clave de API
• /voice responde Voice mode enabled y el terminal tiene permiso de micrófono
• He elegido hold o tap, y sé si el prompt se envía solo
• He puesto el español, y sé que ahora Claude me responde en español
• He descartado una frase con Esc y el prompt ha vuelto a como estaba
• He dictado una de las tres frases en mi proyecto

Preguntas frecuentes