La voce di Claude Code non funziona? Ogni errore e la sua soluzione.

1. /voice richiede che tu abbia effettuato l’accesso con un account Claude.ai. Non è disponibile con una API key, Bedrock, Vertex o Foundry.
2. Registra sulla macchina su cui gira Claude Code, quindi non funziona via SSH, in VS Code Remote o nelle sessioni cloud.
3. Dopo la chiusura del coperchio, un cambio di dispositivo o un aggiornamento, avvia una nuova sessione.

1. Unknown command: /voice o Voice mode requires a Claude.ai account

   Non hai effettuato l’accesso con Claude.ai, oppure una API key o un’impostazione del provider ha la precedenza. Esegui /login, rimuovi ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN o apiKeyHelper e riavvia Claude Code.

   Dalla documentazione di Claude Code.

2. Voice mode is disabled by your organization’s policy

   Un amministratore ha disattivato la voce. Chiedi a lui, oppure usa uno strumento di dettatura esterno a Claude Code.

   Dalla documentazione di Claude Code.

3. Microphone access is denied

   Consenti il tuo terminale (o VS Code) in Impostazioni di Sistema → Privacy e sicurezza → Microfono. Se non è nell’elenco, reimposta il suo permesso, chiudilo con ⌘Q e riaprilo.

   # Terminal: com.apple.Terminal · iTerm2: com.googlecode.iterm2
   # Ghostty: com.mitchellh.ghostty · Warp: dev.warp.Warp-Stable · VS Code: com.microsoft.VSCode
   tccutil reset Microphone com.apple.Terminal
   
   # Not sure of the bundle ID? Ask macOS:
   osascript -e 'id of app "iTerm"'

   Dalla documentazione di Claude Code.

4. No audio detected from microphone

   La registrazione ha catturato silenzio. Di solito la sessione è legata a un dispositivo o a un binario che è cambiato: avvia una nuova sessione. Tutte le cause e le soluzioni →

5. No speech detected

   L’audio è arrivato ma non sono state riconosciute parole: avvicinati, riduci il rumore, imposta la lingua in /config. Altro →

6. Voice input is failing repeatedly and has been paused

   Tre errori in dieci secondi: di solito manca il microfono (SSH, container) o il permesso è negato. Altro →

7. Voice connection failed o Voice stream error: WebSocket upgrade rejected

   La registrazione non ha raggiunto il servizio di trascrizione. Controlla la rete; con uno status 4xx, esegui di nuovo /login e verifica che non ci siano VPN o proxy di mezzo.

   Dalla documentazione di Claude Code.

8. Voice mode requires SoX for audio recording o could not find a working audio recorder in WSL

   Solo Linux e WSL. Installa SoX; su WSL anche il suo formato PulseAudio.

   sudo apt-get install sox                    # Linux
   sudo apt install sox libsox-fmt-pulse       # WSL with WSLg

   Dalla documentazione di Claude Code.

9. Tenere premuto Space scrive solo spazi

   Se gli spazi si accumulano, la voce è disattivata: esegui /voice hold. Se ne compaiono solo uno o due, la ripetizione dei tasti è disattivata nel sistema operativo: usa invece /voice tap. In modalità tap, il prompt deve essere vuoto perché il primo tocco avvii la registrazione.

   Dalla documentazione di Claude Code.

Aggiornato a ottobre 2026. Dalla documentazione di Claude Code e dalle sue issue su GitHub.

La voce di Claude Code funziona con una API key, Bedrock o Vertex?

No. La dettatura vocale richiede il login con un account Claude.ai. Copy That funziona con qualsiasi login, perché incolla semplicemente del testo in Claude Code.

La dettatura vocale di Claude Code viene elaborata in locale?

No. L’audio viene inviato in streaming ad Anthropic per la trascrizione, e il nome del progetto e il branch git vengono inviati come suggerimenti. Non consuma token e non conta nei limiti di utilizzo. Copy That trascrive sul tuo Mac con Whisper.

Posso usare la voce di Claude Code in VS Code Remote o via SSH?

No, la voce registra sulla macchina su cui gira Claude Code. Copy That incolla in qualunque terminale tu abbia davanti sul Mac, anche in uno connesso via SSH.

C’è un modo per evitare del tutto questi errori?

Usa un microfono che non sia quello del Mac. Copy That registra sul tuo iPhone o Apple Watch, trascrive sul Mac con Whisper e incolla in Claude Code, quindi dispositivi di input, coperchio e permessi del microfono sul Mac non contano più.