Dettatura vocale

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

Requisiti

​

Abilita la dettatura vocale

/voice
Voice mode enabled (hold). Hold Space to record. Dictation language: en (/config to change).

{
  "voice": {
    "enabled": true,
    "mode": "tap"
  }
}

​

Pressione prolungata per registrare

> refactor the auth middleware to ▮
  # hold Space, speak "use the new token validation helper"
> refactor the auth middleware to use the new token validation helper▮

​

Tocco per registrare e inviare

​

Cambia la lingua della dettatura

{
  "language": "japanese"
}

​

Riassegna il tasto di dettatura

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

​

Risoluzione dei problemi

• Voice mode requires a Claude.ai account: sei autenticato con una chiave API o un provider di terze parti. Esegui /login per accedere con un account Claude.ai.
• Microphone access is denied: concedi l’autorizzazione del microfono al tuo terminale nelle impostazioni di sistema. Su macOS, vai a Impostazioni di sistema → Privacy e sicurezza → Microfono e abilita la tua app terminale, quindi esegui /voice di nuovo. Su Windows, vai a Impostazioni → Privacy e sicurezza → Microfono e attiva l’accesso al microfono per le app desktop, quindi esegui /voice di nuovo. Se il tuo terminale non è elencato nelle impostazioni macOS, consulta Terminale non elencato nelle impostazioni del microfono di macOS.
• No audio recording tool found su Linux: il modulo audio nativo non ha potuto caricarsi e nessun fallback è installato. Installa SoX con il comando mostrato nel messaggio di errore, ad esempio sudo apt-get install sox.
• Voice mode could not find a working audio recorder in WSL: WSLg instrada l’audio attraverso PulseAudio piuttosto che un dispositivo ALSA, quindi SoX ha bisogno che il suo backend PulseAudio sia installato esplicitamente. Esegui sudo apt install sox libsox-fmt-pulse. L’installazione di sox da sola estrae il backend ALSA, che non può registrare su WSL perché non c’è alcun dispositivo /dev/snd.
• Voice input is failing repeatedly and has been paused: la dettatura vocale ha riscontrato diversi errori di avvio di seguito e ha smesso di tentare nuove sessioni fino a quando una non avrà successo. Questo di solito significa che il microfono o lo stack audio su questo host non può catturare l’audio, ad esempio un server headless, una shell remota senza passthrough audio, o un’autorizzazione del microfono negata. Conferma un dispositivo di input funzionante, correggi la causa sottostante dalle voci precedenti, quindi attiva di nuovo la voce.
• Nulla accade quando tieni premuto Space in modalità pressione prolungata: osserva l’input del prompt mentre tieni premuto. Se gli spazi continuano ad accumularsi, la dettatura vocale è probabilmente disattivata; esegui /voice hold per abilitarla. Se appare solo uno o due spazi e poi nulla, la dettatura vocale è attiva ma il rilevamento della pressione prolungata non si attiva. Il rilevamento della pressione prolungata richiede che il tuo terminale invii eventi di ripetizione dei tasti, quindi non può rilevare un tasto premuto se la ripetizione dei tasti è disabilitata a livello del sistema operativo. Passa a modalità tocco con /voice tap per evitare il requisito di ripetizione dei tasti.
• Toccare Space digita uno spazio invece di registrare in modalità tocco: il primo tocco avvia la registrazione solo quando l’input del prompt è vuoto. Cancella prima l’input, oppure verifica di essere in modalità tocco eseguendo /voice tap.
• No audio detected from microphone: la registrazione è iniziata ma ha catturato il silenzio. Conferma che il dispositivo di input corretto è impostato come predefinito di sistema e che il suo livello di input non è disattivato o vicino a zero. Su Windows, apri Impostazioni → Sistema → Suono → Input e seleziona il tuo microfono. Su macOS, apri Impostazioni di sistema → Suono → Input.
• No speech detected: l’audio ha raggiunto il servizio di trascrizione ma nessuna parola è stata riconosciuta. Parla più vicino al microfono, riduci il rumore di fondo e conferma che la tua lingua di dettatura corrisponda alla lingua che stai parlando.
• La trascrizione è distorta o in una lingua sbagliata: la dettatura predefinita è l’inglese. Se stai dettando in un’altra lingua, impostala prima in /config. Consulta Cambia la lingua della dettatura.

​

Terminale non elencato nelle impostazioni del microfono di macOS

​

Vedi anche

• Personalizza scorciatoie da tastiera: riassegna voice:pushToTalk e altre azioni da tastiera della CLI
• Configura impostazioni: riferimento completo per voice, language e altre chiavi di impostazioni
• Modalità interattiva: scorciatoie da tastiera, modalità di input e controlli di sessione
• Comandi: riferimento per /voice, /config e tutti gli altri comandi