Cómo hacerlo

Dictado por voz para codificación con IA: hablar prompts a Cursor y Claude Code sin teclear

El vibe coding va más rápido cuando puedes describir el cambio en vez de teclearlo. Seis ejemplos prácticos, los patrones de prompt a los que hemos llegado y cómo manejar identificadores multilingües.

TL;DR

Si estás buscando cómo hacer prompts por voz en Cursor — o cómo lograr un buen dictado en Claude Code sin deletrear cada identificador — esta es la guía práctica. El dictado por voz para codificación con IA funciona porque los prompts son sobre todo prosa: contexto, intención, restricciones y expectativas de prueba. Loqua añade contexto multimodal de pantalla, formato estructurado de prompts, manejo de vocabulario técnico y mezcla EN+chino a mitad de frase. El flujo de vibe coding por voz que más rinde: prompts largos en Cursor, depuración en Claude Code, specs de refactorización y descripciones de tests. Los prompts cortos tipo "arregla esto" muchas veces no son más rápidos por voz; la ganancia está en las instrucciones densas.

Loqua es una herramienta de dictado por voz consciente del contexto para Mac que ve en qué estás trabajando y da forma a la salida en consecuencia. Para la codificación con IA en concreto, eso significa que puede detectar el panel de chat de Cursor, la terminal de Claude Code, el cuadro de prompt de ChatGPT, y producir prompts en la estructura que esas herramientas manejan mejor.

Esto no es un argumentario de listicle de productividad. Usamos la voz para nuestra propia codificación con IA a diario y reducimos el tiempo de escritura de prompts aproximadamente a la mitad en instrucciones largas, que es donde la ganancia es mayor. Los prompts cortos ("arregla esto") quedan igualados. Los prompts largos y estructurados (specs de refactorización, cambios multiarchivo, narración de depuración) son donde la voz se rentabiliza.

Por qué la voz encaja con la codificación con IA

La forma de un prompt de codificación con IA es distinta de la forma del código. Un buen prompt tiene: un bloque de contexto (dónde estoy, qué veo, qué acabo de probar), un bloque de instrucción (qué quiero que se haga) y restricciones (no cambies X, conserva Y, debe pasar los tests Z). Eso es prosa, no sintaxis — y la prosa es donde la voz brilla.

Piensas más rápido de lo que tecleas — fácilmente 2× más rápido para prosa. El cuello de botella no es tu modelo mental; es el peaje de las teclas. Para prompts que explican una situación compleja a un LLM, esa diferencia importa. Loqua añade tres cosas sobre el dictado básico: ve el estado de tu IDE (así los bloques de contexto se escriben solos), formatea los prompts estructuralmente (system + user, o lista de pasos con viñetas) y maneja vocabulario técnico sin que tú deletrees identificadores.

Configuración para codificación con IA

Esta sección asume que Loqua está instalado (mira nuestra guía de configuración para dictar código en Mac). La única configuración específica para codificación con IA es conceder el permiso de Accesibilidad a Loqua, que le permite leer la selección y el texto adyacente de la app activa. La Accesibilidad de macOS está documentada en developer.apple.com; es la misma API que usan los lectores de pantalla y las herramientas de automatización.

Tres hábitos que conviene construir:

  • Selecciona antes de dictar. Si quieres que el prompt actúe sobre un bloque concreto, selecciónalo primero. Loqua pasa la selección como contexto.
  • Abre el panel de chat inline. En Cursor, que el panel de chat esté visible le dice a Loqua que estás haciendo un prompt, no editando.
  • Pausa para los saltos estructurales. Una pausa de medio segundo se lee como salto de párrafo en tu prompt — útil para separar contexto de instrucción.

Estructura de prompt que funciona

Tras meses de hacer prompts por voz, hemos llegado a tres estructuras que producen el comportamiento más limpio del LLM. Loqua lee cómo encuadras el inicio de una frase y da forma a la salida en consecuencia.

Encuadre que dices primeroForma de la salida
"Refactor this so..."Refactorización: [objetivo]. Restricciones: [implícitas de la selección]. Salida: [código].
"Debug this — when I X, Y happens but I expected Z"Reporte narrativo de bug con pasos, esperado, real.
"Write a spec for..."Spec estructurada: Objetivo / Inputs / Outputs / Casos límite / Tests.
"Add a test that..."Descripción del test + criterios de aceptación.
"Explain why this code..."Prosa simple, registro técnico.

Seis ejemplos prácticos

Dices (Cursor, con una función seleccionada)
"refactor this to use the new auth client and remove the legacy fallback that's not used anywhere else"
Loqua escribe (en el chat de Cursor)
Refactor the selected function to use the new AuthClient. Remove the legacy fallback path — confirmed unused elsewhere in the codebase. Preserve the public function signature.
Dices (depurando en Claude Code)
"when I call the search endpoint with an empty query I get a 500 instead of an empty array I expected the empty case to be handled gracefully"
Loqua escribe (en la terminal de Claude Code)
Debug: search endpoint returns 500 on empty query.

Steps:
1. POST /search with body { "query": "" }
2. Server responds 500 (expected: 200 with empty array)

Hypothesis: the empty-string path skips the early-return and hits the indexer with an invalid query.

Fix: add an early return for empty queries.
Dices (escribiendo una spec para una función nueva)
"spec for a saved searches feature users can save a search and reload it later it should sync across devices and be queryable by name"
Loqua escribe (en Cursor, doc de planificación)
## Spec: Saved Searches

**Goal:** users save a search query and reload it later.

**Inputs:** search query (string), user id, optional name (string, defaults to first N chars of query).

**Behavior:**
- Persist to user's saved-searches collection.
- Sync across devices via existing user-data sync.
- Queryable by name (case-insensitive substring match).

**Edge cases:** duplicate names → suffix with index; deleted user → cascade delete.
Dices (pidiendo un test)
"add a test that verifies the rate limiter blocks the eleventh request in a one minute window and returns a 429 with a retry after header"
Loqua escribe (en Claude Code)
Add a test for the rate limiter:
- Send 10 requests in a 60-second window — all succeed.
- 11th request should return 429.
- Response must include a Retry-After header with seconds-remaining value.
- Use existing test fixtures for time control.
Dices (petición de refactorización multiarchivo)
"break the user controller into separate files for auth profile and preferences keep the existing public API and update the router"
Loqua escribe (en el chat de Cursor)
Refactor: split userController.ts into three modules — authController, profileController, preferencesController. Keep the public API surface unchanged. Update the router to import from the new locations. No behavior changes; this is a structural refactor only.
Dices (pivote a mitad de tarea)
"actually before we refactor add a regression test that covers the current behavior of the merge function so we can detect drift later"
Loqua escribe (en Claude Code)
Before refactoring: add a regression test covering the current behavior of the merge function. The test should snapshot the existing outputs so we can detect any drift introduced by the refactor.

Dejar que Loqua vea el contexto del archivo

Cuando dices "refactor this" sin selección, Loqua envía solo la instrucción. Cuando tienes texto seleccionado, Loqua incluye un breve bloque de contexto describiendo qué se seleccionó — nombre del archivo, líneas, identificadores cercanos — antes de la instrucción. No necesitas dictar el contexto; la capa multimodal lo lee.

Esto importa para las herramientas de IA que se benefician de contexto explícito (Claude Code especialmente se beneficia de rutas de archivo y números de línea). El stack omni-modal de Loqua es lo que hace que esto funcione — mira la nota más profunda sobre voz se encuentra con visión: dictado omni-modal si quieres la intuición a nivel de investigación.

EN+中 a mitad de frase

Muchas discusiones de nuestro equipo de ingeniería suceden en mandarín con términos técnicos en inglés mezclados. Hacer prompts por voz a herramientas de IA en este registro es una actividad diaria. Loqua maneja el code-switching sin un interruptor de modo:

Dices (en el chat de Cursor)
"那个 cache invalidation 的逻辑要重构 现在 race condition 太多了 边界 case 经常漏"
Loqua escribe (como prompt de Cursor)
那个 cache invalidation 的逻辑要重构 —— 现在 race condition 太多了,边界 case 经常漏。请帮我重新设计 invalidation 策略:列出 race-condition 风险点,给出建议的同步原语方案,覆盖典型边界 case。

Reutilización entre herramientas

La misma frase de voz, dictada en distintas herramientas de IA, produce prompts apropiadamente distintos. No reformulamos — Loqua lo hace:

HerramientaForma de prompt que produce Loqua
Cursor (panel de chat)Instrucción conversacional con contexto de archivo implícito
Claude Code (terminal)Instrucción estructurada con rutas de archivo explícitas y un plan breve
ChatGPT (web)Prompt con formato Markdown y secciones
Aider (terminal)Instrucción directa de edición de archivo con rutas objetivo

Escribes una vez con tu voz; Loqua reconforma según el destino.

Puntos a tener en cuenta

  • No dictes código letra por letra. La voz es para la parte en prosa del prompt; deja que el LLM produzca el código. Intentar dictar código carácter a carácter desvirtúa el sentido.
  • La selección importa. Si quieres que Loqua incluya el código seleccionado como contexto, selecciónalo antes de dictar. De lo contrario envía solo la instrucción.
  • Las pausas largas terminan el dictado. Un silencio de 1,5 segundos se lee como fin de enunciado. Si estás pensando a mitad de frase, usa una muletilla — Loqua elimina las muletillas de la salida pero las usa para mantener la grabación abierta.
  • El estado del panel de chat de Cursor importa. Si el panel no está visible, Loqua puede tratar tu dictado como una edición de código en vez de un prompt. Abre primero el panel.
  • No dictes identificadores a ciegas. Si tienes un nombre de librería personalizado que no es común, añádelo al Diccionario personal en Ajustes o pronúncialo como una sola palabra.

El efecto agregado: el tiempo de escritura de prompts se reduce aproximadamente a la mitad en instrucciones largas, y los prompts en sí son mejores porque la forma hablada anima a explicar la intención en vez de simplemente nombrar el cambio. Esa parte importa más que la velocidad bruta. Para más sobre el patrón más amplio de codificación con IA por voz — flujos de prompt por voz en Cursor, dictado en Claude Code y cómo mantener las manos lejos del teclado durante sesiones largas — mira las guías complementarias enlazadas arriba.

Para una visión más larga sobre por qué la voz encaja con el trabajo con IA, mira por qué tu teclado es la herramienta equivocada para pensar con IA.

Preguntas frecuentes

¿Loqua funciona con el panel de chat de Cursor?
Sí. Loqua detecta cuándo está abierto el panel de chat de Cursor y trata tu dictado como un prompt en lugar de una edición de código. El código seleccionado (si lo hay) se incluye como contexto. Abre primero el panel de chat; de lo contrario, Loqua puede tratar el dictado como una edición de archivo de código.
¿Loqua funciona con Claude Code?
Sí. Claude Code se ejecuta en una terminal y Loqua trata su prompt como un contexto de instrucción estructurada — la salida incluye rutas de archivo explícitas y un plan breve cuando es apropiado. Las narraciones largas de refactorización y la redacción de specs son donde esto brilla.
¿Puedo dictar código carácter por carácter?
Técnicamente sí, pero no deberías. La voz es para la parte en prosa del prompt — la explicación, el objetivo, las restricciones. Deja que el LLM produzca el código. Intentar dictar código letra por letra desvirtúa el propósito.
¿Cómo sabe Loqua si es un prompt o una edición de código?
Lee la app activa, el estado del foco y las señales visibles de la UI. Que el panel de chat de Cursor esté abierto es una señal de prompt. La terminal de Claude Code es una señal de prompt. Un cursor en el cuerpo de una función de un archivo Python es una señal de edición de código.
¿Qué pasa con ChatGPT o Claude.ai en el navegador?
Loqua funciona en cualquier campo de texto — incluidos los cuadros de prompt del navegador. Da forma a la salida como un prompt amigable con Markdown con secciones cuando el destino es una IA de chat.
¿Loqua enviará mis prompts a un servicio en la nube?
Las capas de reconocimiento de voz y contexto multimodal de Loqua se ejecutan on-device. El texto que se teclea en Cursor o Claude Code es lo que esas herramientas envían a sus proveedores (Anthropic, OpenAI, etc.) — ese es su comportamiento de red, no el de Loqua. Mira nuestra nota sobre privacidad para ver qué envía y qué no envía Loqua.

Prueba Loqua hoy

Gratis para empezar. Nativa de Mac. Hecha por investigadores de algoritmos que la usan a diario.

Download for Mac

Más del Blog de Loqua

cómo hacerlo
Cómo dictar código en Mac: una guía completa para Cursor, VS Code y Claude Code
productividad
Voz para pensar con IA: por qué tu teclado es la herramienta equivocada
ingeniería
Aprendizaje por refuerzo en dictado por voz: GRPO, DPO y destilación on-policy en nuestro stack de voz
comparativa
Loqua vs Typeless: una alternativa a Typeless nativa de Mac para contexto, código y profundidad