La dictée de Claude Code : tu parles au lieu d'écrire, et la transcription ne mange pas tes limites

Ce que c'est et pourquoi ça compte

Tu écris à Claude Code dix fois par heure, et à chaque fois tu coupes. Le contexte que tu avais en tête devient une ligne, parce que tout taper prend du temps. Puis Claude fait la mauvaise chose et il faut tout réexpliquer.

La dictée est déjà dans Claude Code. Tu l'actives avec /voice, tu parles, et les mots apparaissent dans le prompt pendant que tu les dis. Tu peux mélanger : une phrase à l'oral, un nom de fichier au clavier.

Et la documentation d'Anthropic le dit clairement : la transcription ne consomme ni messages ni tokens et ne compte pas dans les limites de /usage. Le prompt que tu envoies consomme comme d'habitude, comme si tu l'avais tapé. C'est pour ceux qui passent la journée dans Claude Code et veulent donner plus de contexte avec moins d'effort.

1. Ce qu'il te faut, et où va ta voix

Avant de l'essayer, vérifie ces trois choses :

• Un compte Claude.ai avec lequel tu es connecté dans Claude Code. Avec une clé API Anthropic, Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, la dictée n'est pas disponible.
• Un micro sur l'ordinateur où tourne Claude Code. Ça ne marche pas dans les sessions cloud ni en SSH.
• Sous Windows dans WSL, il te faut WSLg ; sinon, lance Claude Code directement sous Windows.

À savoir avant : l'audio ne reste pas sur ton ordinateur. Il part vers les serveurs d'Anthropic, qui le transcrivent ; rien n'est traité en local. La documentation de Claude Code explique comment ils traitent les données.

2. Active-la avec /voice et choisis comment parler

Dans le chat de Claude Code, tape :

/voice

Un test du micro se lance ; sur Mac, la première fois, le système demande l'autorisation pour ton terminal : accepte. Ensuite tu lis Voice mode enabled (hold) et, à la fin, Dictation language: en. Ce en, c'est l'anglais : tu le changes à l'étape 3.

Deux modes : maintenir ou toucher

• Maintenir (hold), le mode par défaut : tu maintiens la barre d'espace, tu parles, tu relâches. Après un court temps de chauffe, en bas s'affiche listening… et ça enregistre. Quand tu relâches, le texte entre dans le prompt et attend ton Entrée.
• Toucher (tap) : avec le prompt vide, tu touches la barre d'espace et ça démarre, tu la retouches et ça s'arrête, sans temps de chauffe. Si le texte fait au moins trois mots, il part tout seul, pour qu'un toucher par erreur n'envoie pas un mot isolé. Ça s'arrête aussi après 15 secondes de silence ou 2 minutes au total.

Pour choisir le mode ou la couper (le choix reste aussi pour les sessions suivantes) :

/voice hold

/voice tap

/voice off

Ou dans ~/.claude/settings.json (s'il a déjà d'autres réglages, ajoute seulement le bloc voice, avec la virgule). C'est le mode maintenir qui envoie tout seul quand tu relâches, si le texte fait au moins trois mots. Sans autoSubmit, qui ne vaut qu'en hold, il attend ton Entrée. Pour toucher, écris "tap" à la place de "hold".

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

Mon conseil : le mode maintenir sans envoi automatique, tant que tu ne fais pas confiance à la transcription.

3. Mets-la dans ta langue, et sache ce qui change

Par défaut la dictée comprend l'anglais : si tu parles français sans rien changer, tu obtiens un texte déformé. Le français fait partie des langues prises en charge. Tu le règles dans /config, ou dans ~/.claude/settings.json :

{
  "language": "french"
}

Le code "fr" marche aussi. Si tu écris une langue qui n'est pas dans la liste, /voice te prévient et repasse à l'anglais pour la dictée.

Attention : c'est le même réglage qui décide de la langue des réponses. Dès lors Claude te répond en français, et les titres automatiques des sessions sortent aussi en français.

4. Parle, tape, jette

Les mots apparaissent pendant que tu parles, estompés jusqu'à ce que la transcription soit finie. Le texte entre là où est le curseur : tu tapes la moitié d'une phrase, tu maintiens la barre d'espace et tu dis le reste. Maintiens à nouveau pour ajouter un morceau.

Elle est pensée pour ceux qui codent : elle reconnaît des mots comme regex, OAuth, JSON et localhost, et utilise toute seule le nom de ton projet et de ta branche git comme indice. Ma façon : le raisonnement, je le dis ; les chemins exacts des fichiers, je les tape.

Phrase ratée ? Échap

Appuie sur Échap ou Ctrl+C pendant l'enregistrement, ou pendant que la phrase est encore en traitement : le micro se coupe, la transcription est jetée et le prompt revient comme avant. Sur cet appui, Échap n'interrompt pas Claude et Ctrl+C ne te fait pas quitter Claude Code.

5. Change la touche, si la barre d'espace te gêne

En mode maintenir, la barre d'espace a le temps de chauffe, et là où elle fait autre chose (dans la vue de la conversation, dans vim hors INSERT) elle ne dicte pas. Une combinaison comme Option+K sur Mac, Alt+K ailleurs, démarre au premier appui et marche là aussi. Ça se change dans ~/.claude/keybindings.json :

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

meta, c'est Option sur Mac et Alt ailleurs. La nouvelle touche remplace la barre d'espace, pour maintenir et toucher, et Claude Code relit le fichier sans redémarrage. En mode maintenir, n'utilise pas une lettre seule comme v : pendant le temps de chauffe, elle finit dans le prompt.

6. Trois phrases à dicter tout de suite

En parlant, tu donnes plus de contexte que tu n'en taperais. Ouvre Claude Code dans ton projet, active la dictée et dis l'une de ces phrases, avec tes éléments à la place des parties entre [ ].

Avant de changer quoi que ce soit, lis le projet et explique-moi comment fonctionne [le paiement de l'abonnement] : de quel fichier il part, par où il passe et où il pourrait casser. Ensuite pose-moi trois questions sur ce qui n'est pas clair pour toi.

Il y a un bug : quand [un nouvel utilisateur s'inscrit et revient en arrière depuis l'écran de bienvenue], [l'app reste blanche]. Je m'attendais à [revenir à l'accueil]. Trouve la cause, explique-la-moi en deux phrases et propose la correction la plus petite. Ne touche pas au code tant que je ne dis pas ok.

On a fini pour aujourd'hui. Résume ce qu'on a changé dans cette session, ce qui reste ouvert et ce que tu ferais en premier demain, et écris-le dans [NOTES.md] en cinq lignes maximum.

Les erreurs les plus courantes

• Dicter en français sans avoir réglé la langue : le texte sort déformé, parce que la dictée est en anglais par défaut.
• Unknown command: /voice. Tu n'es pas connecté avec un compte Claude.ai, ou quelque chose passe devant : ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, un apiKeyHelper ou un autre fournisseur. Enlève-le, redémarre Claude Code et lance /login.
• Microphone access is denied sur Mac : Réglages Système → Confidentialité et sécurité → Microphone, active ton terminal et relance /voice. S'il n'est pas dans la liste : tccutil reset Microphone com.apple.Terminal (iTerm2 : com.googlecode.iterm2), puis quitte le terminal avec Cmd+Q et rouvre-le. Jamais sans l'identifiant : ça retire le micro à toutes les apps.
• L'essayer en SSH ou dans une session cloud : le micro doit être sur l'ordinateur où tourne Claude Code.
• Maintenir la barre d'espace et ne voir que des espaces. S'ils s'accumulent, la dictée est coupée : /voice hold. S'il en apparaît un ou deux et c'est tout, la répétition des touches est désactivée : /voice tap.

Check-list

• Je suis connecté à Claude Code avec un compte Claude.ai, pas avec une clé API
• /voice répond Voice mode enabled et le terminal a l'autorisation du micro
• J'ai choisi maintenir ou toucher, et je sais si le prompt part tout seul
• J'ai réglé le français, et je sais que Claude me répond maintenant en français
• J'ai jeté une phrase avec Échap et le prompt est revenu comme avant
• J'ai dicté l'une des trois phrases dans mon projet

Questions fréquentes