Dictée 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.

​

Conditions requises

​

Activer la dictée vocale

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

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

​

Mode maintien

> 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▮

​

Mode appui pour enregistrer et envoyer

​

Modifier la langue de dictée

{
  "language": "japanese"
}

​

Relier à nouveau la touche de dictée

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

​

Dépannage

• Voice mode requires a Claude.ai account : vous êtes authentifié avec une clé API ou un fournisseur tiers. Exécutez /login pour vous connecter avec un compte Claude.ai.
• Microphone access is denied : accordez la permission du microphone à votre terminal dans les paramètres système. Sur macOS, allez à Paramètres système → Confidentialité et sécurité → Microphone et activez votre application terminal, puis exécutez /voice à nouveau. Sur Windows, allez à Paramètres → Confidentialité et sécurité → Microphone et activez l’accès au microphone pour les applications de bureau, puis exécutez /voice à nouveau. Si votre terminal n’est pas répertorié dans les paramètres macOS, consultez Terminal non répertorié dans les paramètres du microphone macOS.
• No audio recording tool found sur Linux : le module audio natif n’a pas pu se charger et aucun retour n’est installé. Installez SoX avec la commande affichée dans le message d’erreur, par exemple sudo apt-get install sox.
• Voice mode could not find a working audio recorder in WSL : WSLg achemine l’audio via PulseAudio plutôt qu’un périphérique ALSA, donc SoX a besoin que son backend PulseAudio soit installé explicitement. Exécutez sudo apt install sox libsox-fmt-pulse. L’installation de sox seul installe le backend ALSA, qui ne peut pas enregistrer sur WSL car il n’y a pas de périphérique /dev/snd.
• Voice input is failing repeatedly and has been paused : la dictée vocale a rencontré plusieurs échecs de démarrage d’affilée et a cessé de tenter de nouvelles sessions jusqu’à ce qu’une réussisse. Cela signifie généralement que le microphone ou la pile audio sur cet hôte ne peut pas capturer l’audio, par exemple un serveur sans interface graphique, un shell distant sans passage audio, ou une permission de microphone refusée. Confirmez un périphérique d’entrée fonctionnant, corrigez la cause sous-jacente à partir des entrées ci-dessus, puis déclenchez à nouveau la voix.
• Rien ne se passe en maintenant Space en mode maintien : regardez l’entrée d’invite pendant que vous maintenez. Si les espaces continuent à s’accumuler, la dictée vocale est probablement désactivée ; exécutez /voice hold pour l’activer. Si un ou deux espaces seulement apparaissent puis rien, la dictée vocale est activée mais la détection de maintien ne se déclenche pas. La détection de maintien nécessite que votre terminal envoie des événements de répétition des touches, elle ne peut donc pas détecter une touche maintenue si la répétition des touches est désactivée au niveau du système d’exploitation. Basculez vers le mode appui avec /voice tap pour éviter l’exigence de répétition des touches.
• Appuyer sur Space tape un espace au lieu d’enregistrer en mode appui : le premier appui ne commence l’enregistrement que lorsque l’entrée d’invite est vide. Effacez d’abord l’entrée, ou vérifiez que vous êtes en mode appui en exécutant /voice tap.
• No audio detected from microphone : l’enregistrement a commencé mais a capturé le silence. Confirmez que le périphérique d’entrée correct est défini comme valeur par défaut du système et que son niveau d’entrée n’est pas coupé ou proche de zéro. Sur Windows, ouvrez Paramètres → Système → Son → Entrée et sélectionnez votre microphone. Sur macOS, ouvrez Paramètres système → Son → Entrée.
• No speech detected : l’audio a atteint le service de transcription mais aucun mot n’a été reconnu. Parlez plus près du microphone, réduisez le bruit de fond et confirmez que votre langue de dictée correspond à la langue que vous parlez.
• La transcription est brouillée ou dans la mauvaise langue : la dictée utilise par défaut l’anglais. Si vous dictez dans une autre langue, définissez-la d’abord dans /config. Consultez Modifier la langue de dictée.

​

Terminal non répertorié dans les paramètres du microphone macOS

​

Voir aussi

• Personnaliser les raccourcis clavier : relier voice:pushToTalk et d’autres actions de clavier CLI
• Configurer les paramètres : référence complète pour les clés de paramètres voice, language et autres
• Mode interactif : raccourcis clavier, modes d’entrée et contrôles de session
• Commandes : référence pour /voice, /config et toutes les autres commandes