Dettatura di Claude Code: parli invece di scrivere, e la trascrizione non ti consuma i limiti

Cos'è e perché conta

Scrivi a Claude Code dieci volte all'ora, e ogni volta tagli. Il contesto che avevi in testa diventa una riga, perché scrivere tutto è lento. Poi Claude fa la cosa sbagliata e ti tocca rispiegare.

La dettatura è già dentro Claude Code. La accendi con /voice, parli, e le parole compaiono nel prompt mentre le dici. Puoi mischiare: una frase la dici, il nome di un file lo scrivi.

E nella documentazione di Anthropic c'è scritto chiaro: la trascrizione non consuma messaggi né token e non conta nei limiti di /usage. Il prompt che mandi consuma come sempre, come se l'avessi scritto. È per chi passa la giornata in Claude Code e vuole dare più contesto con meno fatica.

1. Cosa ti serve, e dove va la tua voce

Prima di provarla, controlla queste tre cose:

• Un account Claude.ai con cui hai fatto l'accesso in Claude Code. Con una chiave API di Anthropic, Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry la dettatura non c'è.
• Un microfono sul computer dove gira Claude Code. Nelle sessioni cloud e in SSH non funziona.
• Su Windows dentro WSL serve WSLg; senza, usa Claude Code direttamente su Windows.

Da sapere prima: l'audio non resta sul tuo computer. Va ai server di Anthropic, che lo trascrivono; non viene elaborato in locale. Come trattano i dati è spiegato nella documentazione di Claude Code.

2. Accendila con /voice e scegli come parlare

Nella chat di Claude Code scrivi:

/voice

Parte un controllo del microfono; su Mac, la prima volta, il sistema chiede il permesso per il terminale: dagli l'ok. Poi leggi Voice mode enabled (hold) e, in fondo, Dictation language: en. Quell'en è l'inglese: lo cambi al punto 3.

Due modi: tieni premuto o tocca

• Tieni premuto (hold), il modo di partenza: tieni premuto lo spazio, parli, lasci. Dopo un breve riscaldamento in basso compare listening… e registra. Quando lasci, il testo entra nel prompt e aspetta il tuo Invio.
• Tocca (tap): a prompt vuoto tocchi lo spazio e parte, lo ritocchi e si ferma, senza riscaldamento. Se il testo ha almeno tre parole lo invia da solo, così un tocco per sbaglio non manda una parola a caso. Si ferma anche dopo 15 secondi di silenzio o 2 minuti in tutto.

Per scegliere il modo o spegnerla (la scelta resta anche nelle sessioni dopo):

/voice hold

/voice tap

/voice off

Oppure in ~/.claude/settings.json (se ha già altre impostazioni, aggiungi solo il blocco voice, con la virgola). Questo è l'hold che invia da solo quando lasci il tasto, se il testo ha almeno tre parole. Senza autoSubmit, che vale solo in hold, aspetta il tuo Invio. Per il tap, scrivi "tap" al posto di "hold".

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

Il mio consiglio: hold senza invio automatico, finché non ti fidi della trascrizione.

3. Mettila in italiano, e sappi cosa cambia

Di base la dettatura capisce l'inglese: se parli italiano senza cambiare niente, esce un testo storpiato. L'italiano è tra le lingue supportate. Lo imposti da /config, oppure in ~/.claude/settings.json:

{
  "language": "italian"
}

Va bene anche il codice "it". Se scrivi una lingua che non è nella lista, /voice ti avvisa e per la dettatura torna all'inglese.

Attenzione: è la stessa impostazione che decide la lingua delle risposte. Da lì Claude ti risponde in italiano, e in italiano escono anche i titoli automatici delle sessioni.

4. Parla, scrivi, butta via

Le parole compaiono mentre parli, sbiadite finché la trascrizione non è finita. Il testo entra dove sta il cursore: scrivi metà frase, tieni premuto lo spazio e dici il resto. Tieni premuto di nuovo per aggiungere un altro pezzo.

È fatta per chi programma: riconosce parole come regex, OAuth, JSON e localhost, e usa da sola il nome del progetto e del branch git come suggerimento. Il mio modo: il ragionamento lo dico, i percorsi esatti dei file li scrivo.

Hai sbagliato frase? Esc

Premi Esc o Ctrl+C mentre registri, o mentre la frase è ancora in elaborazione: il microfono si spegne, la trascrizione viene buttata e il prompt torna com'era prima. In quel momento Esc non interrompe Claude e Ctrl+C non ti fa uscire da Claude Code.

5. Cambia il tasto, se lo spazio ti dà fastidio

In hold lo spazio ha il riscaldamento, e dove fa altro (nel visualizzatore della conversazione, in vim fuori da INSERT) non detta. Una combinazione come Option+K su Mac, Alt+K altrove, parte al primo tocco e funziona anche lì. Si cambia in ~/.claude/keybindings.json:

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

meta è Option su Mac e Alt altrove. Il tasto nuovo sostituisce lo spazio, per hold e tap, e Claude Code legge il file senza riavvio. In hold non usare una lettera da sola come v: durante il riscaldamento finisce nel prompt.

6. Tre frasi da dettare subito

Parlando dai più contesto di quanto ne scriveresti. Apri Claude Code nel tuo progetto, accendi la dettatura e di' una di queste, con le tue parti al posto di quelle tra [ ].

Prima di cambiare qualsiasi cosa, leggi il progetto e spiegami come funziona [il pagamento dell'abbonamento]: da quale file parte, dove passa e dove potrebbe rompersi. Poi fammi tre domande su quello che non ti è chiaro.

C'è un bug: quando [un utente nuovo si registra e torna indietro dalla schermata di benvenuto], [l'app resta bianca]. Mi aspettavo [di tornare alla home]. Trova la causa, spiegamela in due frasi e proponi la correzione più piccola. Non toccare il codice finché non ti dico ok.

Per oggi abbiamo finito. Riassumi cosa abbiamo cambiato in questa sessione, cosa resta aperto e cosa faresti domani per primo, e scrivilo in [NOTE.md] in cinque righe al massimo.

Gli errori più comuni

• Dettare in italiano senza aver impostato la lingua: il testo esce storpiato, perché di base la dettatura è in inglese.
• Unknown command: /voice. Non hai fatto l'accesso con un account Claude.ai, oppure qualcosa gli passa davanti: ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, un apiKeyHelper o un altro provider. Toglilo, riavvia Claude Code e fai /login.
• Microphone access is denied su Mac: Impostazioni di Sistema → Privacy e sicurezza → Microfono, attiva il terminale e rilancia /voice. Se non è nella lista: tccutil reset Microphone com.apple.Terminal (iTerm2: com.googlecode.iterm2), poi chiudi il terminale con Cmd+Q e riaprilo. Mai senza identificativo: toglie il microfono a tutte le app.
• Provarla in SSH o in una sessione cloud: il microfono deve stare sul computer dove gira Claude Code.
• Tenere premuto lo spazio e vedere solo spazi. Se si accumulano, la dettatura è spenta: /voice hold. Se ne compaiono uno o due e basta, la ripetizione dei tasti è disattivata: /voice tap.

Checklist

• Ho fatto l'accesso a Claude Code con un account Claude.ai, non con una chiave API
• /voice risponde Voice mode enabled e il terminale ha il permesso del microfono
• Ho scelto hold o tap, e so se il prompt parte da solo
• Ho impostato l'italiano, e so che ora Claude mi risponde in italiano
• Ho buttato via una frase con Esc e il prompt è tornato com'era
• Ho dettato una delle tre frasi nel mio progetto

Domande frequenti