Programación por voz con Claude Code: dicta tus prompts

Resumen rápido: Claude Code funciona en la terminal y espera prompts detallados en lenguaje natural. Escribir esos prompts con teclado es lento. El dictado por voz te permite dar a Claude Code un contexto más rico en una fracción del tiempo, lo que resulta en mejor output y menos iteraciones.

El problema de los prompts en Claude Code

Claude Code es una de las herramientas de codificación con IA más potentes disponibles. Puede leer toda tu base de código, editar múltiples archivos, ejecutar tests y realizar tareas complejas de varios pasos. Pero hay un problema: su calidad es directamente proporcional a la calidad de tus prompts.

Y Claude Code se ejecuta en la terminal, donde escribir prompts largos y detallados es particularmente tedioso. No hay editor de texto enriquecido, no hay forma fácil de volver atrás y editar la mitad de un párrafo, no hay autocompletado para lenguaje natural. Solo tú, un cursor parpadeante y la tentación de ser breve.

Así que los desarrolladores escriben prompts como:

> fix the auth bug

Cuando lo que deberían escribir es:

> The authentication middleware in src/middleware/auth.ts is returning 401
> for users with valid refresh tokens when their access token has expired.
> The issue is in the verifyToken function around line 45 - it checks the
> access token expiry but doesn't fall through to check the refresh token.
> Fix this by adding refresh token validation before returning 401, and
> add a test case for this scenario in auth.test.ts.

El segundo prompt le ahorra a Claude Code tener que adivinar. Produce la corrección correcta al primer intento. Pero ¿quién quiere escribir todo eso en una terminal?

La solución: voz + Claude Code

Este es el flujo de trabajo: mantienes Claude Code ejecutándose en tu terminal como siempre. Cuando necesitas darle instrucciones, en lugar de escribir, pulsas tu atajo de voz, hablas de forma natural durante 15-30 segundos, y tu prompt detallado aparece en la terminal listo para enviar.

Configuración: Murmur + Claude Code

1. Instala Murmur si aún no lo has hecho
2. Abre tu terminal (PowerShell, Windows Terminal, CMD o cualquier emulador de terminal)
3. Inicia Claude Code como lo harías normalmente
4. Cuando Claude Code esté esperando input, pulsa Ctrl+Space (el atajo por defecto de Murmur)
5. Di tu prompt de forma natural
6. Murmur transcribe e inserta el texto en la posición de tu cursor
7. Pulsa Enter para enviar el prompt a Claude Code

Eso es todo. Murmur usa transcripción impulsada por IA que maneja correctamente términos técnicos, rutas de archivos y nombres de comandos.

Ejemplos reales: dictado vs escritura

Aquí tienes prompts reales de mi flujo de trabajo diario, comparando lo que habría escrito con teclado versus lo que realmente dije usando la voz.

Ejemplo 1: Corrección de bug

Lo que habría escrito:

fix the login redirect issue

Lo que dije (transcrito por Murmur):

The login page redirects to /dashboard after successful authentication
but it should redirect to the URL the user originally tried to access.
The return URL is stored in the query parameter called 'next' on the
login page URL. Update the login handler in pages/login.tsx to read
this parameter and redirect there after auth, falling back to /dashboard
if no next parameter exists. Also make sure to validate the next URL
to prevent open redirect attacks.

Tiempo para escribir la primera versión: 5 segundos. Tiempo para decir la segunda versión: 18 segundos. Tiempo ahorrado en iteraciones porque Claude Code acertó al primer intento: varios minutos.

Ejemplo 2: Nueva funcionalidad

Lo que habría escrito:

add rate limiting to the API

Lo que dije:

Add rate limiting to the Express API. Use the express-rate-limit package.
Apply a global limit of 100 requests per minute per IP address. For the
authentication endpoints in routes/auth.ts, apply a stricter limit of
10 requests per minute to prevent brute force attacks. Store the rate
limit counters in Redis using our existing Redis client from lib/redis.ts.
Return a 429 status with a JSON error message that includes a retryAfter
field in seconds. Add the rate limiter as middleware in app.ts before
the route handlers.

Ejemplo 3: Refactoring

Lo que habría escrito:

refactor the user service to use the repository pattern

Lo que dije:

Refactor the UserService in services/user.ts to use the repository
pattern. Create a UserRepository interface in repositories/types.ts
with methods for findById, findByEmail, create, update, and delete.
Implement it in repositories/prisma/user.ts using our existing Prisma
client. Update UserService to accept the repository through constructor
injection instead of importing Prisma directly. This will make the
service testable without a database. Update the dependency injection
setup in di/container.ts to wire everything together. Do not change
any of the controller code, just the service layer.

Consejos para dictar prompts técnicos con claridad

Nombra archivos y rutas explícitamente

Claude Code tiene acceso a la estructura de tu proyecto, pero las rutas específicas eliminan la ambigüedad.

Di: "Actualiza el middleware de autenticación en src/middleware/auth.ts" en lugar de "actualiza el middleware de auth."

Di: "El esquema de Prisma en prisma/schema.prisma" en lugar de "el esquema de la base de datos."

Describe la arquitectura

Cuando pidas cambios en múltiples archivos, describe la arquitectura en lenguaje natural:

"Quiero añadir una capa de caché. Crea una interfaz CacheService, impleméntala con Redis, inyéctala en el UserService y ProductService, y añade invalidación de caché en las operaciones de escritura."

Nunca escribirías todo eso con teclado. Pero decirlo toma diez segundos.

Usa restricciones con "no"

Indica explícitamente lo que Claude Code debe evitar. Esto es fácil cuando hablas pero tedioso cuando escribes:

"Refactoriza el manejo de errores pero no cambies el formato de respuesta de error porque el frontend depende de la estructura actual. Tampoco elimines ninguno de los códigos de error existentes, solo añade los nuevos."

Referencia patrones de tu base de código

Claude Code puede leer tu código, así que referencia patrones existentes:

"Crea un nuevo endpoint de API para pedidos siguiendo exactamente el mismo patrón que el endpoint de productos en routes/products.ts. La misma cadena de middleware, el mismo manejo de errores, el mismo formato de respuesta. Solo cambia products por orders y usa el OrderService."

Piensa en voz alta

A diferencia de escribir, la voz te permite razonar sobre un problema en tiempo real:

"Bueno, el problema es que esta conexión WebSocket se cae después de 30 segundos de inactividad. Creo que necesitamos un mecanismo de heartbeat. Déjame pensar... sí, añade un sistema de ping/pong donde el servidor envíe un ping cada 15 segundos y el cliente responda con un pong. Si el servidor no recibe un pong en 5 segundos, cierra la conexión y deja que la lógica de auto-reconexión del cliente se encargue. La lógica de reconexión ya está en lib/websocket.ts así que solo necesitamos el ping del lado del servidor."

Claude Code es excelente extrayendo la intención accionable de este tipo de razonamiento natural.

Por qué la voz da más contexto a los agentes de IA

Hay una razón psicológica por la que la voz produce mejores prompts: hablar tiene menos fricción que escribir.

Cuando escribes con teclado, cada palabra tiene un costo. Inconscientemente te autocensuras, eliminando detalles que parecen "demasiado largos para escribir". El resultado son prompts escuetos y ambiguos.

Cuando hablas, las palabras fluyen a más de 150 palabras por minuto (frente a 60-80 para la mayoría de los que escriben con teclado). El costo por palabra baja drásticamente. Incluyes contexto que habrías eliminado. Mencionas casos extremos que habrías omitido. Explicas el "por qué" junto con el "qué".

Esto importa enormemente para los agentes de IA. Claude Code puede manejar un prompt de 500 palabras tan fácilmente como uno de 10 palabras. Pero el prompt de 500 palabras le da suficiente contexto para acertar en la implementación al primer intento, mientras que el de 10 palabras lo obliga a adivinar.

La ecuación es simple: La voz elimina el costo del contexto. Más contexto significa mejor output de la IA. Mejor output significa menos iteraciones. Menos iteraciones significa desarrollo más rápido.

Problemas comunes del dictado por voz en terminal

Prompts largos y saltos de línea

Algunas terminales manejan el texto pegado de forma diferente. Si ves problemas con los saltos de línea, prueba a usar una terminal que maneje bien el pegado multilínea (Windows Terminal funciona muy bien).

Caracteres especiales en código

Si necesitas incluir código específico en tu prompt, a menudo es mejor escribir solo ese fragmento y dictar el resto. Por ejemplo, escribe el patrón regex, luego dicta la explicación de lo que debería hacer.

Ruido de fondo en la terminal

Si estás en un entorno ruidoso, la cancelación de ruido de Murmur (impulsada por el procesamiento de ChatGPT) maneja la mayoría del ruido ambiental. Pero un micrófono direccional o unos auriculares dan los mejores resultados.

Una sesión típica de voz + Claude Code

Así es como se ve una sesión real de 30 minutos:

1. Dices: "Mira los fallos de tests en el módulo de usuarios. Los tests en tests/user.test.ts están fallando en el flujo de creación de usuario. ¿Puedes identificar qué cambió recientemente que los rompió?"
2. Claude Code investiga, identifica el problema
3. Dices: "Bien, corrige esos fallos de tests. El mock para el servicio de email necesita actualizarse para que coincida con la nueva interfaz de EmailService que cambiamos la semana pasada. También actualiza cualquier otro archivo de test que use mocks del EmailService."
4. Claude Code corrige los tests en múltiples archivos
5. Dices: "Ejecuta la suite completa de tests y dime si algo más está fallando."
6. Todos los tests pasan
7. Dices: "Perfecto. Ahora crea un commit con un mensaje descriptivo que resuma las correcciones de tests."

Cuatro prompts por voz. Cinco minutos hablando en total. Una sesión completa de debugging y corrección que habría tomado mucho más con prompts escritos.

Conclusión

Claude Code es más potente cuando le das prompts detallados y ricos en contexto. El dictado por voz con Murmur elimina la fricción entre tus pensamientos y la terminal, permitiéndote hablar de la misma forma en que explicarías un problema a un compañero senior.

El resultado no es solo una entrada más rápida. Son prompts fundamentalmente mejores, que llevan a mejor código, menos iteraciones y un flujo de codificación con IA más efectivo.

Si usas Claude Code regularmente, prueba a añadir voz a tu flujo de trabajo en terminal. Empieza con una sesión. Notarás la diferencia inmediatamente.