Dettatura vocale in Claude Code: /voice, la Dettatura del Mac o un’app in locale
La risposta breve
Claude Code ha una modalità vocale integrata, chiamata voice dictation: scrivi /voice, poi tieni premuto Spazio mentre parli, e la trascrizione viene inserita dove si trova il cursore. Serve un accesso a Claude.ai e un microfono locale, e la documentazione di Anthropic dice che l’audio viene inviato in streaming ai suoi server e non viene elaborato in locale. Anche la Dettatura del Mac funziona in un terminale. Flit, un’app di dettatura in locale per Mac, è il terzo modo: tieni premuto un tasto e parla, e le tue parole esatte arrivano nel prompt con i nomi dei file del progetto scritti bene, senza che nessun audio lasci il Mac.
Come dettare a Claude Code con /voice
- Avvia Claude Code nel terminale, con l’accesso fatto con un account Claude.ai.
- Scrivi
/voicee premi Invio per attivare la dettatura. - Tieni premuto Spazio e parla. La registrazione dura finché tieni premuto il tasto.
- Rilascia Spazio. La trascrizione viene inserita dove si trova il cursore.
- Rileggila, correggi quello che serve e premi Invio per inviare.
- Per toccare invece di tenere premuto, scrivi
/voice tap: tocca Spazio una volta con il prompt vuoto per iniziare, e tocca di nuovo per inviare.
Nella modalità a pressione continua c’è un breve riscaldamento prima che la registrazione parta, perché Claude Code riconosce un tasto tenuto premuto dalla ripetizione del tasto. Un singolo tocco di Spazio scrive comunque uno spazio.
Un prompt per un agente di programmazione è il tipo di testo in cui la voce rende bene: un paragrafo di intenzioni, non una riga di sintassi. Ci sono tre modi per farlo arrivare in Claude Code, e si differenziano soprattutto per cosa richiedono e per dove l’audio diventa testo.
Tre modi per dettare a Claude Code
| Metodo | Come si avvia | Dove viene trascritto l’audio |
|---|---|---|
/voice di Claude Code | Tieni premuto Spazio, o tocca con /voice tap | Sui server di Anthropic |
| Dettatura del Mac | La scorciatoia della Dettatura nelle impostazioni Tastiera | Sul Mac o da Apple; lo indicano le impostazioni Tastiera |
| Flit | Tieni premuto Fn o una tua scorciatoia | Sul Mac |
Cosa serve a /voice
La pagina di Anthropic sulla voice dictation elenca i requisiti.
- Un account Claude.ai. La pagina dice che il servizio di trascrizione vocale non è disponibile quando Claude Code è configurato direttamente con una chiave API di Anthropic, oppure tramite Amazon Bedrock, Google Cloud o Microsoft Foundry.
- Un microfono locale. Non funziona nelle sessioni cloud né via SSH.
- Una connessione, perché l’audio viene inviato in streaming ai server di Anthropic per la trascrizione.
- Una delle 20 lingue disponibili, impostata con
/config. Se non ne è impostata nessuna, la dettatura usa l’inglese. - Un’organizzazione che lo consente. Un amministratore può disattivare la voce tramite una policy.
Modalità a pressione continua e modalità a tocco
La modalità a pressione continua è quella predefinita: la registrazione dura finché Spazio è premuto e si ferma quando lo rilasci. La trascrizione resta nel prompt in attesa che tu la invii, a meno che non attivi l’invio automatico.
La modalità a tocco è pensata per le richieste più lunghe. Il primo tocco avvia la registrazione, e solo con il prompt vuoto; il secondo invia. La documentazione dice che la registrazione si ferma anche da sola dopo 15 secondi di silenzio o due minuti in totale.
Il tasto si può cambiare. È l’associazione voice:pushToTalk in ~/.claude/keybindings.json.
A capo e testi lunghi
Invio invia il messaggio. Per andare a capo senza inviare, la pagina di Anthropic sul terminale indica due modi che funzionano in ogni terminale: premi Control-J, oppure scrivi una barra rovesciata e poi premi Invio. Maiuscole-Invio funziona senza configurazione in alcuni terminali, e in altri dopo aver eseguito una volta /terminal-setup.
Un testo lungo incollato viene mostrato in modo diverso. Quando incolli più di 800 caratteri o più di tre righe, Claude Code li riduce a un segnaposto come [Pasted text #1 +120 lines], e invia comunque il contenuto completo. Questo conta per qualsiasi strumento di dettatura che inserisce il testo incollandolo, Flit compreso: una dettatura lunga arriva intera, ma vedi il segnaposto, non le parole.
Usare la Dettatura del Mac
La Dettatura di Apple scrive ovunque si possa scrivere, terminale compreso. Fai clic nel prompt di Claude Code e premi la tua scorciatoia della Dettatura. Non chiede nulla al tuo account Claude, e per alcune lingue e alcuni Mac funziona sul dispositivo.
Per i prompt ha due svantaggi. Si ferma dopo 30 secondi senza parlato, e non sa come si chiamano i tuoi file. Come dettare su un Mac spiega la configurazione.
Cosa dire
Dillo come lo spiegheresti a un collega: cosa non va, cosa vuoi, e come capirai che ha funzionato. Nomina ad alta voce file e funzioni. Indica il comando dei test, se c’è.
Poi rileggi la trascrizione prima di inviarla. Un nome di file capito male costa all’agente una ricerca; un «do not» capito male costa a te una modifica sbagliata.
Dettare a Claude Code con Flit
Flit lavora a livello del Mac, non di Claude Code, quindi non gli servono un account, /voice o una connessione. Tieni premuto un tasto, parla, rilascia, e il testo è nel prompt.
- Le tue parole esatte. In un terminale Flit non riformula quello che hai detto, quindi un comando resta un comando.
- I nomi dei file del tuo progetto. Flit legge i nomi nella directory di lavoro del terminale, sul Mac, quindi «upload client dot swift» arriva come
UploadClient.swift. - Simboli pronunciati per flag e percorsi, come «dash dash» e «tilde slash».
- Nessun audio lascia il Mac, e funziona con qualsiasi tipo di accesso a Claude Code, chiave API compresa.
- Lo stesso tasto nell’app desktop di Claude e nel pannello chat di un editor, dove Flit dà a ciò che dici la forma di un prompt.
- Flit è gratuito per 7 giorni con tutte le funzioni attive, poi costa $19 una volta sola, senza account e senza abbonamento.
Buono a sapersi
- In un terminale ottieni le parole esatte: lì Flit non riordina una richiesta sconclusionata in un paragrafo pulito, come fa invece in una casella di chat.
- Flit inserisce il testo incollandolo, quindi Claude Code mostra una dettatura lunga come segnaposto di testo incollato.
- Flit funziona su un Mac con Apple silicon e macOS 14 o successivo, e il suo modello vocale è un download da circa 0,5 a 2,8 GB che scegli una volta.
- Flit scrive quello che dici. Non risponde, non legge ad alta voce le risposte e non tiene una conversazione a voce con lo strumento.
- Il riconoscimento dei nomi dei file del tuo progetto e i comandi vocali di Flit funzionano per ora in inglese.
Domande frequenti
Claude Code ha una modalità vocale?
Sì. Scrivi /voice per attivare la voice dictation, poi tieni premuto Spazio mentre parli. Servono un account Claude.ai e un microfono locale.
La voice dictation di Claude Code viene elaborata in locale?
No. La documentazione di Anthropic dice che la voice dictation invia in streaming l’audio registrato ai server di Anthropic per la trascrizione e che l’audio non viene elaborato in locale.
Perché /voice non funziona in Claude Code?
Le cause documentate sono: aver fatto l’accesso con una chiave API o un provider cloud invece che con un account Claude.ai, lavorare via SSH o in una sessione cloud, non avere un microfono, oppure una policy dell’organizzazione che disattiva la voce.
La voice dictation di Claude Code consuma il mio utilizzo?
No. Anthropic dice che la trascrizione non consuma messaggi o token di Claude e non conta per i limiti mostrati in /usage.
Come vado a capo in Claude Code senza inviare?
Premi Control-J, oppure scrivi una barra rovesciata e premi Invio. Entrambi funzionano in ogni terminale. Maiuscole-Invio funziona in alcuni terminali senza configurazione.
Esiste un’app di dettatura per Claude Code che funziona offline?
Sì. Flit è un’app di dettatura in locale per Mac: tieni premuto un tasto e parla, e le tue parole arrivano nel prompt di Claude Code con i nomi dei file del progetto scritti bene. Niente viene inviato da nessuna parte. Flit è gratuito per 7 giorni con tutte le funzioni attive, poi costa $19 una volta sola, senza account e senza abbonamento.