La dictée de Claude Code ne fonctionne pas : les remèdes par symptôme, et la version qui a corrigé chaque bug

Presque toutes les pannes de /voice tombent dans l'une de cinq catégories : vous êtes connecté d'une manière qui n'inclut pas la fonction, votre terminal n'a jamais obtenu l'autorisation d'accéder au micro, vous êtes quelque part sans micro local, votre couche audio Linux ou WSL n'est pas complète, ou vous faites tourner une version dont le bug est déjà corrigé plus loin.

Par la rédaction de VoiceBoardMis à jour le 28 août 2026

Commencez par la dernière, parce que c'est la moins chère à écarter. La dictée vocale est arrivée début mars 2026 et a été retouchée par 32 versions depuis, avec 56 entrées distinctes dans le journal des modifications public. Si votre installation a plus de deux semaines, mettez à jour avant de chercher quoi que ce soit :

claude update
claude doctor

Tout ce qui suit a été vérifié à la source le 27 août 2026 : la documentation d'Anthropic sur la dictée vocale, le journal des modifications public parcouru version par version, les dates de publication du registre npm, et les signalements datés sur le suivi des tickets d'Anthropic. La dernière version à ce moment-là était la 2.1.247, publiée le 26 août 2026.

Une chose à clarifier d'abord, parce qu'elle envoie les gens sur une fausse piste. Anthropic a deux fonctions différentes avec « voice » dans le nom. Le mode vocal est la conversation parlée à double sens dans les applications Claude, et sa propre page d'aide dit qu'il n'est pas compatible avec Claude Code. /voice dans Claude Code, c'est de la dictée seulement : vous parlez, le texte arrive dans l'invite, Claude répond par écrit. La plupart des vidéos « réparer la voix de Claude » qui remontent dans les résultats parlent de la première, et elles ne vous aideront en rien.

Trouvez votre symptôme

1. /voice est absent ou refuse de s'activer

/voice n'est pas disponible sur tous les comptes, et Claude Code masque les commandes que votre configuration ne peut pas utiliser au lieu de les afficher en grisé (journal des modifications 2.1.84, 25 mars 2026). Du coup, « la commande n'existe pas » et « la commande n'est pas pour vous » se ressemblent trait pour trait.

La dictée vocale exige un compte Claude.ai. Elle n'est pas disponible quand Claude Code pointe directement vers une clé API Anthropic, vers Amazon Bedrock, vers l'Agent Platform de Google Cloud ou vers Microsoft Foundry. Ce n'est pas un bug et il n'y a aucun réglage à basculer. Si vous obtenez Voice mode requires a Claude.ai account, lancez /login et connectez-vous avec le compte Claude.ai, pas avec l'identifiant d'API.

Si vous voyez Voice mode is disabled by your organization's policy, un administrateur l'a coupée pour toute l'organisation. Avant juin 2026, ce cas affichait un message générique « non disponible », ce qui explique que les vieilles réponses de forum conseillent de réinstaller ; la formulation précise est arrivée dans la 2.1.191, le 24 juin 2026.

Version plancher. La première entrée du journal mentionnant la dictée est la 2.1.69, publiée le 4 mars 2026. Rien de plus ancien n'a la fonction.

Si vous lisez un vieux fil où /voice renvoie Unknown skill: voice : c'était le déploiement, pas votre machine. Pendant tout mars 2026, la commande était derrière un drapeau de fonctionnalité, si bien que des gens sur la bonne version et le bon abonnement obtenaient quand même l'erreur, pendant que la bannière de démarrage les invitait gaiement à lancer une commande qui ne répondait pas (#33580, 12 mars 2026 ; #33914, 13 mars 2026). Ce n'est pas une chose que l'on répare en modifiant des réglages, et ce n'est pas une chose que vous devriez encore rencontrer aujourd'hui.

2. L'autorisation micro, y compris quand votre terminal n'est pas dans la liste

/voice lance une vérification du micro la première fois que vous l'activez. Sous macOS, c'est le moment où votre terminal est censé demander l'autorisation.

macOS : Réglages Système, puis Confidentialité et sécurité, puis Microphone, puis activez votre application de terminal et relancez /voice.

Windows : Paramètres, puis Confidentialité et sécurité, puis Microphone, puis activez l'accès au micro pour les applications de bureau et relancez /voice.

Quand votre terminal ne figure pas du tout dans la liste macOS, il n'y a aucun interrupteur à activer, et voici la solution documentée par Anthropic : réinitialiser l'état de l'autorisation pour que la prochaine exécution déclenche une nouvelle demande.

tccutil reset Microphone com.apple.Terminal      # le Terminal intégré
tccutil reset Microphone com.googlecode.iterm2   # iTerm2
osascript -e 'id of app "Ghostty"'               # autre terminal : récupérer son identifiant de bundle

Quittez ensuite le terminal avec Cmd+Q, et pas seulement en fermant la fenêtre, parce que macOS ne redemandera rien à un processus déjà en cours. Rouvrez-le et lancez /voice.

Un avertissement de la documentation qui mérite d'être répété : lancer tccutil reset Microphone sans identifiant de bundle retire l'accès au micro à toutes les applications de la machine, Zoom et Slack compris. Ne faites pas ça pendant un appel.

Le piège dont personne ne parle. Si vous lancez Claude Code dans une application enveloppe ou un multiplexeur plutôt que dans un terminal ordinaire, cette enveloppe n'a peut-être jamais déclaré le droit d'accès au micro, auquel cas elle n'apparaît pas dans la liste de confidentialité et ne peut pas y être ajoutée. Deux exemples sont documentés : un signalement contre le terminal Solo (soloterm/solo#114, 30 mars 2026) note que macOS n'offre aucun bouton « plus » pour les applications non signées ou sans droit déclaré, et un autre contre Superset (superset-sh/superset#5026, 1er juin 2026) rapporte qu'aucun des deux modes ne fonctionne. Le contournement est le même dans les deux cas : lancez Claude Code dans Terminal.app, iTerm2 ou un autre terminal signé et regardez si la dictée revient. Si oui, le problème n'a jamais été Claude Code.

3. Maintenir la barre d'espace ne fait rien

Le mode maintien détecte une touche tenue en guettant les événements rapides de répétition de touche envoyés par votre terminal. Ce mécanisme a deux façons d'échouer, et vous les distinguez en regardant la ligne de saisie pendant que vous maintenez.

Les espaces s'accumulent. La dictée est désactivée. Lancez /voice hold.

Un ou deux espaces apparaissent, puis plus rien. La dictée est active, mais la répétition de touche n'atteint pas Claude Code. Certains terminaux n'envoient pas d'événements de répétition, et la répétition peut être coupée au niveau du système. Ne luttez pas, changez de mode :

/voice tap

Le mode tape fonctionne par bascule : une tape pour démarrer, vous parlez, une tape pour arrêter. Il n'a pas de temps de chauffe et ne dépend pas de la répétition de touche. Notez que la première tape ne lance l'enregistrement que si l'invite est vide : si vous avez déjà tapé quelque chose, taper sur l'espace tape simplement un espace.

Perdre vos premiers mots, c'est le même mécanisme vu de l'autre côté. Le mode maintien a un court temps de chauffe, le pied de page affiche keep holding… avant listening…, et la plainte est publique depuis la semaine du lancement : un développeur sur Hacker News l'a mesuré à environ 500 ms et a signalé que ses premiers mots étaient coupés (13 mars 2026). Deux issues. Passer en mode tape, ou réaffecter la touche à une combinaison avec modificateur, qui démarre l'enregistrement dès la première pression, sans aucune chauffe :

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

Cela va dans ~/.claude/keybindings.json. Évitez d'affecter une simple lettre en mode maintien, parce que la lettre s'écrit dans votre invite pendant la chauffe. Verr. Maj. ne peut pas être affectée du tout : les terminaux ne la transmettent pas, et depuis la 2.1.122 vous avez au moins une erreur qui le dit, au lieu du silence.

Dans l'extension VS Code, l'espace n'est peut-être tout simplement pas le déclencheur. Le champ de discussion est une vue web, et un signalement ouvert indique que l'espace n'y fait rien alors qu'un clic sur l'icône du micro fonctionne normalement (#85309, 9 août 2026). Même signalement : taper /voice comme message de discussion dans l'extension répond /voice isn't available in this environment. Cliquez sur l'icône.

4. Il enregistre et rien ne revient

Trois messages différents, trois causes différentes. Lisez la formulation exacte avant de changer quoi que ce soit.

No audio detected from microphone. L'enregistrement a démarré et n'a capté que du silence. Vérifiez que le bon périphérique est bien celui par défaut du système et que son niveau n'est pas proche de zéro : Paramètres, Système, Son, Entrée sous Windows ; Réglages Système, Son, Entrée sous macOS. Une cause fréquente sous macOS est que l'entrée par défaut a changé après le démarrage de la session, ce qui est traité en section 7.

Voice connection failed. L'enregistrement n'a jamais atteint le service de transcription. Vérifiez le réseau. Notez que ce message a été trompeur : avant la 2.1.200, publiée le 3 juillet 2026, un micro silencieux signalait un échec de connexion, ce qui envoyait les gens déboguer un réseau qui allait très bien.

Voice stream error: WebSocket upgrade rejected with HTTP <status>. Un serveur a refusé la connexion, ce n'est donc pas une panne générale. Un code dans les 400 signifie en général une session expirée, ou un proxy ou un service anti-robot qui répond à la place du service de transcription. Lancez /login, et regardez du côté du VPN ou du proxy d'entreprise sur le chemin.

No speech detected. L'audio est arrivé, aucun mot n'a été reconnu. Parlez plus près, réduisez le bruit de fond, et vérifiez que votre langue de dictée correspond à ce que vous parlez.

Ce dernier cas a une histoire tenace. Un signalement ouvert le 25 mars 2026, avec une reproduction complète, micro fonctionnel, autorisations accordées, bon périphérique par défaut, testé dans Terminal.app comme dans un terminal JetBrains, est toujours ouvert et a recueilli plusieurs confirmations sous macOS en quelques jours. Si vous avez parcouru tout ce qui figure sur cette page et que vous obtenez toujours No speech detected pendant que le vumètre bouge, vous êtes probablement dans ce signalement plutôt que dans une erreur de configuration. Ajoutez-y votre version et votre plateforme au lieu de réinstaller une quatrième fois.

Les échecs répétés mettent la dictée en pause. Trois échecs de capture en 10 secondes et Claude Code cesse d'essayer jusqu'à ce que 10 secondes se soient écoulées depuis le premier : Voice input is failing repeatedly and has been paused. C'est un symptôme, pas la maladie. Réglez la cause et redéclenchez la dictée.

5. Linux, WSL, conteneurs et machines sans écran

L'enregistrement passe par un module natif. Quand il ne peut pas se charger, Claude Code se rabat sur arecord d'ALSA utils ou sur rec de SoX, et si ni l'un ni l'autre n'est là, /voice affiche la commande d'installation correspondant à votre gestionnaire de paquets.

Voice mode requires SoX for audio recording. Installez-le, par exemple sudo apt-get install sox.

Voice mode requires a microphone, but SoX could not open an audio capture device. SoX est installé et l'hôte n'a aucun périphérique de capture : un serveur sans écran, ou un conteneur sans audio transmis. Aucune installation n'y changera rien. Avant la 2.1.195 (26 juin 2026), ce cas vous demandait à tort d'installer un SoX qui était déjà là, d'où le nombre de fils Linux qui finissent dans la confusion.

WSL : Voice mode could not find a working audio recorder in WSL. WSLg fait passer l'audio par PulseAudio, et sox tout court tire la couche ALSA, qui n'a pas de /dev/snd où enregistrer.

sudo apt install sox libsox-fmt-pulse

Il vous faut aussi WSLg lui-même, qui vient avec WSL2 installé depuis le Microsoft Store. Sous WSL1, il n'y a aucun moyen d'y arriver ; lancez Claude Code dans Windows natif.

Des transcriptions qui reviennent vides après quelques dictées sous Linux peuvent venir de processus d'enregistrement qui s'empilent. Un signalement ouvert décrit des captures échouées puis relancées qui laissent des processus rec en vie, lesquels gardent des connexions clientes PulseAudio ouvertes jusqu'à ce que la couche audio se dégrade et que la transcription ne renvoie plus rien (#83905, 4 août 2026, dans un devcontainer Debian sur WSLg). Ça vaut le coup d'œil :

ps -eo pid,ppid,etime,cmd | grep '[r]ec -q'

S'il y en a une pile plusieurs minutes après que vous avez cessé de parler, tuez-les et redémarrez la session.

6. La transcription est dans la mauvaise langue

La dictée utilise le même réglage language que celui qui détermine la langue des réponses de Claude, et si ce réglage est vide, il retombe sur l'anglais. Parlez français à un décodeur réglé sur l'anglais et vous n'obtenez pas une erreur, vous obtenez un charabia plausible.

{ "language": "fr" }

Définissez-le dans /config ou dans votre fichier de réglages, par code BCP 47 ou par nom de langue. Vingt langues sont prises en charge, et le français en fait partie : allemand, anglais, coréen, danois, espagnol, français, grec, hindi, indonésien, italien, japonais, néerlandais, norvégien, polonais, portugais, russe, suédois, tchèque, turc, ukrainien. Tout le reste retombe sur l'anglais, avec un avertissement au moment où vous activez la dictée.

Dans l'extension VS Code, un language vide se rabat sur le réglage accessibility.voice.speechLanguage de VS Code avant de retomber sur l'anglais.

Deux choses que cela ne règle pas. La soumission automatique en mode tape compte les mots, et pour le japonais, le chinois et le thaï cela n'a commencé à fonctionner qu'en 2.1.195. Et mélanger les langues dans une même phrase a son signalement ouvert : les termes techniques anglais glissés dans une autre langue sont traduits ou perdus, parce que le décodeur est réglé sur une seule langue à la fois (#83881, 4 août 2026). Pour un développeur francophone, qui dit rarement trois phrases sans « commit », « merge » ou « build », c'est le défaut le plus gênant de cette page.

7. Ça marchait hier

Trois causes, dans l'ordre où il vaut la peine de les vérifier.

Vous avez mis à jour. Cherchez votre symptôme dans le tableau ci-dessous. Chaque date est la date de publication npm de la version concernée. Une ligne y concerne les francophones plus que les autres, celle des caractères non ASCII : un projet rangé dans un dossier nommé « Résumés » ou une branche appelée « correctif-été » suffisait à faire échouer la connexion avant la 2.1.160, si bien qu'une installation restée à mai 2026 est la première chose à regarder.

Votre Mac s'est endormi. Un signalement ouvert décrit une dictée définitivement morte après une mise en veille suivie d'un réveil, que /voice désactivée puis réactivée n'y change rien, et que le seul remède est de redémarrer complètement Claude Code ; l'auteur l'a rattaché au descripteur audio natif mis en cache pour toute la durée du processus et jamais resondé après que macOS a démonté la couche audio (#89635, 25 août 2026, sur 2.1.245). Tant que ce n'est pas corrigé, traitez « j'ai rabattu l'écran » comme « redémarrer le CLI ».

Vos périphériques audio ont changé. Même forme de problème, autre déclencheur. Un autre signalement ouvert dit que le périphérique d'entrée est résolu une fois et jamais réacquis, si bien que changer la valeur par défaut du système en cours de session continue d'enregistrer sur l'ancien périphérique, et que connecter ou déconnecter des AirPods peut bloquer complètement la capture jusqu'au redémarrage (#88890, 22 août 2026, sur 2.1.239). Si vous vivez en écouteurs Bluetooth, c'est celui-là que vous rencontrez.

8. Là où ça ne marchera jamais, quoi que vous changiez

Épargnez-vous la soirée. La dictée vocale envoie l'audio en flux vers les serveurs d'Anthropic, et le micro doit être sur la machine qui exécute le processus. Elle est donc indisponible dans les cas suivants :

• Sessions SSH et Claude Code sur le web. Le micro est sur votre portable, le processus non.
• VS Code Remote, ce qui recouvre Remote SSH, les Dev Containers et Codespaces, pour la même raison.
• Toute configuration authentifiée par clé API, Bedrock, l'Agent Platform de Google Cloud ou Microsoft Foundry. Si votre employeur a mis Claude Code derrière l'un de ces accès pour des raisons de conformité, /voice n'est pas un argument que vous gagnerez.
• WSL1.
• Les sessions d'arrière-plan et de répartition d'agents, au moins sous macOS. Un signalement avec journaux CoreAudio montre la dictée qui échoue 100 % du temps depuis la ligne de répartition claude agents, avec No audio detected from microphone, parce que le processus qui ouvre le micro est rattaché à launchd et que macOS ne parvient pas à désigner un processus responsable à qui accorder l'autorisation (#86217, 12 août 2026).

Pour tous ces cas, la réponse est la même : dictez dans le terminal depuis le système d'exploitation, avec un outil qui écrit dans la fenêtre active, quelle qu'elle soit. C'est la section « quand la réparation ne suffit pas », plus bas.

9. Votre application de dictée n'écrit plus dans Claude Code

C'est une panne différente qui donne la même sensation, et elle attrape des gens qui n'ont jamais utilisé /voice. Claude Code lit le clavier en mode brut, et les outils de dictée insèrent du texte en simulant des frappes ou un collage. Ces deux mécanismes sont entrés en collision plus d'une fois.

Le gros épisode fut une régression dans la 2.1.83 (25 mars 2026) : le collage simulé n'arrivait plus dans l'invite alors que le collage manuel fonctionnait toujours, confirmé sous Windows comme sous macOS par plus d'une douzaine de personnes dans un même fil, avec plusieurs outils de dictée touchés (#38620). Les signalants l'ont vu refonctionner autour des 2.1.116 à 2.1.119, fin avril, certains seulement après une réinstallation et un redémarrage de la machine. Sous Linux, il y a eu un cas parallèle où les espaces venant des claviers virtuels étaient avalés, et le texte dicté arrivait sous la forme HelloWorldTest (#43429, 4 avril 2026).

Ce qu'il faut essayer aujourd'hui, dans l'ordre :

1. Mettre à jour Claude Code, puis redémarrer la machine. Deux personnes de ce fil n'ont récupéré leur dictée qu'après une réinstallation complète et un redémarrage, pas avec la seule mise à jour.
2. Utiliser une insertion par collage plutôt qu'une frappe simulée. Si votre outil vous laisse le choix, prenez-le. VoiceInk, par exemple, documente le passage de la méthode de collage de Default à AppleScript et l'augmentation du Restore Delay quand le texte n'arrive pas dans une application.
3. Essayer un autre raccourci de collage. Les terminaux ne s'accordent pas là-dessus, et les pages d'aide de Wispr Flow indiquent qu'il se rabat sur Maj+Inser dans les terminaux d'IDE Windows quand Ctrl+V n'est pas fiable.
4. Envoyer les longues dictées d'un bloc et les relire avant d'appuyer sur Entrée. Wispr Flow découpe les longues dictées en morceaux précisément pour qu'une invite complète arrive proprement dans Claude Code et Codex, et documente que ce découpage est réservé au Mac, et qu'il faut laisser une dictée finir de se coller avant d'en commencer une autre. Il existe aussi un signalement ouvert décrivant une dictée d'environ 4 000 caractères arrivée dans l'interface du terminal avec les morceaux remis dans le désordre, coupés en plein mot, et soumise sans le moindre avertissement (#82339, 29 juillet 2026). Les longs monologues dans un terminal méritent une relecture de toute façon.
5. Vous attendre à ce que le collage se replie. Tout ce qui dépasse quelques lignes s'affiche en [Pasted text #1 +N lines] au lieu de vos mots, ce qui ressemble à un échec et n'en est pas un. Appuyez sur Ctrl+G pour ouvrir l'invite dans votre éditeur si vous voulez la lire avant d'envoyer.

Quand la réparation ne suffit pas

À un moment, la réponse honnête cesse d'être un réglage. /voice est une bonne fonction gratuite et elle est soudée à une seule fenêtre : elle marche dans l'invite de Claude Code et nulle part ailleurs, elle exige une connexion Claude.ai, elle disparaît exactement dans les déploiements qu'utilisent les grandes entreprises, et elle dépend de la transmission par votre terminal des événements de répétition de touche. Pendant ce temps, un terminal en mode brut est une cible hostile pour tout ce qui veut y écrire du texte depuis l'extérieur. Les deux moitiés de ce constat sont sur cette page.

La sortie, dans les deux cas, c'est une couche de dictée qui vit dans le système d'exploitation : vous maintenez un raccourci, vous parlez, et le texte fini arrive dans ce qui a le focus, que ce soit Claude Code, un message de commit git, un onglet de navigateur ou Slack. Elle se moque de l'application où vous êtes, il n'y a donc rien à configurer par outil et rien à retenir.

Wispr Flow est celui vers lequel nous orientons les développeurs en premier, et la raison est étroite : c'est le seul outil dont la documentation décrit le traitement de ce cas précis, en découpant les longues dictées en morceaux pour qu'une invite de plusieurs milliers de mots arrive intacte dans Claude Code au lieu d'être tronquée. Au quotidien, il fait bien la chose ingrate : mots parasites effacés, ponctuation posée, la phrase que vous avez recommencée rendue comme la phrase que vous vouliez dire, dans le terminal comme dans le panneau de discussion. Le français fait partie des sept langues que l'éditeur dit avoir portées au niveau de qualité de l'anglais, ce qui n'est pas le cas partout dans cette catégorie. Le palier gratuit, c'est 2 000 mots par semaine sur ordinateur, Pro coûte $15 par mois ou $12 par mois en facturation annuelle. Les petites lignes, parce qu'elles éliminent d'emblée une partie des lecteurs : c'est un service cloud, la prise en charge de Windows se limite au x64, donc les portables ARM sont exclus, les machines virtuelles et le bureau à distance ne sont pas pris en charge, et il n'existe aucune version Linux. Prix vérifiés le 27 août 2026.

Si l'audio ne doit pas quitter votre machine, ou si vous voulez simplement payer une fois. VoiceInk fait tourner des modèles locaux sur les Mac Apple Silicon, il est open source, et il coûte $29, $49 ou $69 une seule fois selon le nombre de Mac, mises à jour à vie comprises. C'est le chemin payant le plus court, sur Mac, vers une dictée qui n'envoie jamais d'audio nulle part, et $29 une fois contre $144 par an d'abonnement, c'est amorti en une dizaine de semaines. Nous entrons davantage dans le détail dans notre tour d'horizon Mac.

Sous Linux, où Wispr Flow ne va pas, Voicy livre des paquets .deb, .rpm et AppImage et écrit dans les terminaux et les éditeurs. La reconnaissance passe par l'infrastructure de Groq, donc l'audio quitte bel et bien votre machine ; la politique de l'éditeur est la suppression après traitement et l'absence d'entraînement, ce qui est une politique et pas la même chose qu'un traitement local. 30 minutes gratuites, puis $8.49 par mois ou $260 pour une licence à vie.

Et les options gratuites méritent une réponse franche plutôt qu'une note de bas de page. Handy est gratuit, sous licence MIT, tourne sous Windows, macOS et Linux, et transcrit entièrement sur votre propre machine ; pour un développeur que le choix d'une taille de modèle ne rebute pas, c'est le meilleur choix à coût nul de cette page, et un développeur sur Hacker News a raconté s'en être servi avec bonheur pendant une longue période, avant même que Claude Code ait la dictée. Superwhisper a ajouté le 26 août 2026 un palier gratuit permanent qui couvre la dictée dans n'importe quelle application avec un usage illimité des modèles Whisper. Et si vous passez la journée dans VS Code plutôt que dans un terminal, la dictée intégrée y reconnaît la parole sur votre appareil, ne coûte rien, et vient du même éditeur que l'éditeur de code.

Si vous êtes venu réparer une fonction cassée et que vous vous demandez maintenant quoi installer à la place, notre guide plus large compare les options intégrées de Claude Code, Cursor, VS Code et du terminal, en précisant ce qui reste sur votre machine.

Écrit à partir de la documentation d'Anthropic sur la dictée vocale, du journal des modifications de Claude Code parcouru version par version (56 entrées sur la dictée réparties sur 32 versions), des dates de publication npm de chaque version citée ici, et des signalements datés du suivi des tickets public d'Anthropic. Nous n'avons pas reproduit ces bugs sur nos propres machines et ne prétendons pas l'avoir fait ; chacun est attribué au signalement ou à l'entrée de journal dont il vient. Les signalements d'un suivi public décrivent ce que des utilisateurs ont observé, ce qui n'est pas la même chose qu'un défaut confirmé. Cette page vieillit vite, nous la revérifions donc chaque trimestre.