Come dettare codice su Mac: guida completa per Cursor, VS Code e Claude Code

Loqua è uno strumento di digitazione vocale consapevole del contesto per Mac: rileva se sei in un IDE, in un terminale, nella descrizione di una PR o in un pannello chat, e adatta l'output di conseguenza. Funziona su Apple Silicon tramite Neural Engine, formatta per app e riconosce vocabolario tecnico senza richiedere prima il caricamento di un dizionario.

La versione onesta: dettare codice è un'abilità diversa dal dettare prosa. Nella prima ora sarai più lento. Alla seconda ora scriverai commenti più lunghi e messaggi di commit migliori, perché la forma vocale non ha la tassa dei tasti. Lo usiamo ogni giorno da mesi: questo è il setup.

Setup in 90 secondi

Cinque passaggi, nessuno sorprendente se hai già installato un'app Mac:

1. Scarica Loqua dalla homepage e trascinalo in /Applications.
2. Al primo avvio, concedi il permesso per il microfono e quello di Accessibilità. (Accessibilità è ciò che consente a Loqua di vedere l'app attiva e il testo selezionato: vedi la guida Privacy e Sicurezza di Apple per cosa significa Accessibilità in questo contesto.)
3. Apri le impostazioni di Loqua e conferma la scorciatoia push-to-talk. Il default è Fn + Space. Noi usiamo Caps Lock rimappato con Karabiner-Elements, perché si raggiunge senza lasciare la home row.
4. Apri un editor di testo qualsiasi: TextEdit, VS Code, Cursor, Notes, e posiziona il cursore in un campo di testo.
5. Tieni premuta la scorciatoia. Parla. Rilascia. Il testo appare al cursore.

Fine. Nessuna configurazione per singola app. Loqua funziona a livello di sistema su Mac.

La tua prima dettatura di codice

Apri VS Code o Cursor e posiziona il cursore dentro un file Python, nel corpo di una funzione. Di' in modo naturale:

Nota tre cose: ha riconosciuto che eri nel codice (output come commento, non come prosa); ha formattato i valori espliciti ("quindici minuti" → "15 min"; ha inferito il codice di stato standard 401); e ha stretto la seconda clausola in una direttiva strutturata. Nulla di tutto questo richiedeva configurazione: il motore di contesto multimodale ha letto l'estensione del file e il codice adiacente per decidere.

Pattern vocali che funzionano nel codice

Non devi imparare una nuova sintassi. Devi però imparare quali formulazioni producono l'output più pulito. I pattern sotto sono quelli su cui siamo convergenti dopo mesi di uso quotidiano.

• Nome + indizio di formato: di' "function name fetch user profile" per ottenere fetchUserProfile; "function name underscore fetch user profile" per ottenere fetch_user_profile. La convenzione del linguaggio nel file attivo è il default.
• Specifica di tipo descritta: di' "async function that takes a user id and returns a promise of user" per ottenere la firma completa; Loqua inferisce i tipi dal contesto.
• Prima l'intento del commento: di' "add a comment saying X" per ottenere un commento nella sintassi del file; anche dire solo X tende a produrre un commento dentro un file di codice, ma la cornice esplicita evita ambiguità.
• Messaggio di commit: dì cosa è cambiato: in un contesto di commit (pannello Source Control, terminale git commit), Loqua produce messaggi in formato convenzionale senza richiedere il prefisso.
• Descrizione PR: parti dal perché: Loqua legge il template della PR, se presente, e modella l'output intorno a quello.
• Pausa per un cambio strutturale: una pausa di mezzo secondo viene letta come interruzione di paragrafo nella prosa e come separazione logica di step nei blocchi di codice.

Sei esempi pratici

Ogni esempio sotto è reale: cosa abbiamo detto davvero e cosa ha scritto Loqua. La voce è tua; l'output è di Loqua:

Come il contesto dell'IDE modella l'output

Loqua non sa soltanto che sei in VS Code o Cursor. Conosce il tipo di file, la selezione attiva, il codice circostante e, se lo consenti, il pannello chat aperto. La stessa frase vocale produce un output diverso in base a questi segnali:

Non devi dire niente di tutto questo a Loqua. Legge l'app attiva e il testo intorno al cursore e decide. Se sceglie la forma sbagliata, ripeti la frase con una cornice esplicita, per esempio "aggiungi un commento che dice..." o "il messaggio di commit è...", e si adatta.

Per il meccanismo più profondo del contesto dello schermo dietro la preservazione degli identificatori, vedi costruire un ascoltatore che vede ciò che vedi.

Identificatori multilingue e code-switching

Una situazione reale che ci è capitata: una feature flag con nome in mandarino in un codebase, dettata a metà frase in un messaggio di commit inglese. Loqua la gestisce senza cambio di modalità: vedi la nostra guida voce + AI coding per altri pattern EN+中. La versione breve:

Risoluzione problemi

• L'identificatore esce sbagliato: ripeti la frase vocale con l'identificatore in inglese normale, per esempio "fetch user profile" invece di pronunciare ogni lettera. La NER di Loqua è addestrata su enunciati naturali, non sullo spelling lettera per lettera.
• L'output è prosa ma volevi codice: di' "aggiungi un commento che dice..." o "come codice:..." come cornice esplicita. La posizione del cursore di solito disambigua, ma una cornice aiuta.
• Convenzione linguistica sbagliata (camelCase vs snake_case): Loqua segue il default del linguaggio del file. Per sovrascriverlo, di' "camel case" o "snake case" nella frase.
• La voce non viene registrata: controlla l'icona nella barra dei menu: grigio significa permesso microfono mancante; rosso significa che sta ascoltando; verde è inattivo. Il permesso microfono è in Impostazioni di Sistema → Privacy e Sicurezza → Microfono.
• Conflitto di scorciatoia: se Fn + Space confligge con Spotlight o un'altra app, cambia la scorciatoia in Settings → Shortcut. Molti di noi usano Caps Lock rimappato con Karabiner: Caps Lock altrimenti è spazio sprecato.

Cosa usiamo davvero ogni giorno

Questa è la parte più importante delle liste di feature. Ecco com'è il nostro workflow quotidiano:

• Commenti di codice: quasi sempre voce. La forma vocale è più lunga, più esplicativa, e il team li legge di più.
• Messaggi di commit: voce con una rapida passata di editing. Il corpo è più completo perché la tassa dei tasti sparisce.
• Descrizioni PR: voce, spesso dettata mentre guardiamo ancora il diff. La struttura esce corretta perché Loqua vede il template GitHub.
• Prompt Cursor / Claude Code: voce per tutto tranne i brevissimi "fix this". Le descrizioni lunghe di refactor sono il punto in cui la voce si ripaga da sola.
• Thread engineering su Slack / Discord: voce. Più veloce, più ponderata.
• Identificatori e corpi di codice: misto. Il codice banale (CRUD, glue) è adatto alla voce; il codice algoritmico complesso di solito è più veloce da digitare perché la struttura è il lavoro.

Il conto è: circa 4× di guadagno di velocità sulla prosa dentro il codice (commenti, doc, messaggi, prompt) e più o meno parità con la tastiera sul codice puro. Aggregato su una giornata lavorativa è significativo, e il carico cognitivo scende perché smetti di cambiare contesto tra modalità pensiero e modalità digitazione.

Se vuoi l'architettura più profonda di come funziona, vedi la nostra nota sullo stack di digitazione vocale a tre modelli. Se vuoi estendere il pattern agli strumenti di AI coding nello specifico, vedi digitazione vocale per AI coding.

Un'ultima nota per i programmatori che valutano questo workflow: se cerchi sul web come dettare codice su Mac, la maggior parte dei risultati si ferma a "usa la dettatura integrata di Apple". È un buon punto di partenza, ma è solo audio: non conosce il tuo IDE, i tuoi identificatori o le tue convenzioni strutturali. La proposta di Loqua è il livello successivo: digitazione vocale per programmatori che vogliono un output già adatto alla destinazione.