Official documentation
Voice dictation (Claude Code documentation)
Anthropic, Anthropic, 2026
Read the originalRead on October 16, 2026
- What it is
- Anthropic's documentation for speaking prompts in the Claude Code command line, with requirements, modes, languages and troubleshooting.
- How much weight it carries
- First-party documentation for the vendor's own product. It changes with releases, so details are dated by the access date.
Facts taken from this source
- Claude Code's voice dictation supports 20 languages, listed in its documentation from Czech to Ukrainian.
“Supported dictation languages Language Code Czech cs Danish da Dutch nl English en French fr German de Greek el Hindi hi Indonesian id Italian it Japanese ja Korean ko Norwegian no Polish pl Portuguese pt Russian ru Spanish es Swedish sv Turkish tr Ukrainian uk” (Change the dictation language)
- Claude Code's dictation uses the same language setting as Claude's response language, and defaults to English if that setting is empty.
“Voice dictation uses the same language setting that controls Claude’s response language. If that setting is empty, dictation defaults to English.” (Change the dictation language)
- If an API key or a third-party provider is set up, it takes precedence over a claude.ai sign-in, so Claude Code's docs say to remove it and restart before /voice can work.
“it takes precedence over a claude.ai sign-in, so remove it and restart Claude Code” (Troubleshooting)
- Claude Code's voice dictation streams the recorded audio to Anthropic's servers for transcription, and the audio is not processed on the computer.
“Audio is not processed locally.” (Requirements)
- In Claude Code, pressing Esc or Ctrl+C cancels a dictation, discards the transcript and restores the prompt to what it held before recording.
“Press Esc or Ctrl+C to cancel a dictation instead of finalizing it.” (Cancel a recording)
- Claude Code's hold-to-talk mode works by detecting key-repeat events from the terminal, so it needs the terminal to send them.
“Hold detection requires your terminal to send key-repeat events” (Hold to record)
- When you run /voice in Claude Code, dictation turns on in hold mode, and you hold the Space key to record.
“Voice mode enabled (hold). Hold space to record. Dictation language: en (/config to change).” (Enable voice dictation)
- Some keyboard keys are not delivered to terminal applications, so Claude Code's dictation key cannot be set to them.
“Some keys are not delivered to terminal applications” (Rebind the dictation key)
- Claude Code's troubleshooting says that when it reports that microphone access is denied, you should go to the Microphone setting on a Mac, enable your terminal app, and run /voice again.
“On macOS, go to System Settings → Privacy & Security → Microphone and enable your terminal app, then run /voice again.” (Troubleshooting, Microphone access is denied)
- Claude Code's speech-to-text service is available only when you sign in with a Claude.ai account, not with an API key or a cloud provider.
“the speech-to-text service is only available when you authenticate with one” (Requirements)
- Claude Code voice dictation needs a local microphone and does not work in cloud sessions or SSH sessions.
“voice dictation does not work in cloud sessions or SSH sessions” (Requirements)
- Claude Code pauses voice dictation after three failures within 10 seconds, and the pause lasts until 10 seconds have passed since the first failure.
“voice dictation hit three failures within 10 seconds. Claude Code pauses dictation until 10 seconds have passed since the first of those failures” (Troubleshooting)
- Claude Code adds the current project name and git branch name to the recognition as hints, without you doing anything.
“your current project name and git branch name are added as recognition hints automatically.” (Enable voice dictation)
- Claude Code's docs say that after you reset a terminal's microphone permission, you must quit the terminal with Cmd+Q, because macOS does not prompt a process that is already running.
“macOS won't re-prompt a process that is already running. Quit the terminal app with Cmd+Q, not just close its windows, then open it again.” (Terminal not listed in macOS Microphone settings, step 2)
- Claude Code's voice dictation is turned on by running /voice in the CLI.
“Run /voice to enable dictation.” (Enable voice dictation)
- In tap mode, Claude Code dictation stops recording automatically after 15 seconds of silence or two minutes in total.
“Recording also stops automatically after 15 seconds of silence or two minutes total.” (Tap to record and send)
- Claude Code's docs say hold-to-talk depends on key-repeat events from the terminal, and recommend switching to tap mode with /voice tap when that is not available.
“Switch to tap mode with /voice tap to avoid the key-repeat requirement” (Troubleshooting)
- In Claude Code's tap mode, a transcript is submitted automatically only when it is at least three words long, and shorter transcripts are inserted but not sent.
“Claude Code inserts the transcript and submits the prompt automatically when the transcript is at least three words long.” (Tap to record and send)
- On a Mac, turning on Claude Code's voice dictation triggers the macOS microphone permission prompt for your terminal if that permission has never been granted.
“On macOS, this triggers the system microphone permission prompt for your terminal if it has never been granted.” (Enable voice dictation)
- Claude Code's docs say that if your terminal app does not appear under the macOS Microphone settings, there is no toggle you can enable, so the permission state has to be reset.
“If your terminal app does not appear under System Settings → Privacy & Security → Microphone, there is no toggle you can enable.” (Terminal not listed in macOS Microphone settings)
- Claude Code voice transcription does not use Claude messages or tokens, and does not count toward the limits shown in the usage view.
“Transcription does not consume Claude messages or tokens and does not count toward the limits shown in” (Requirements)
- Claude Code's voice transcription is tuned for coding vocabulary in both hold and tap modes.
“Transcription is tuned for coding vocabulary in both modes.” (Enable voice dictation)
- Claude Code's voice dictation stops recording automatically after two minutes in total.
“Recording also stops automatically after 15 seconds of silence or two minutes total.” (Tap to record and send)
- Claude Code's docs say /voice is available only while a claude.ai account is your active sign-in, so an unknown /voice command usually means you are not signed in with one.
“/voice is available only while a claude.ai account is your active sign-in” (Troubleshooting)
- Claude Code's voice dictation uses a built-in native audio module to record on Windows, as it does on macOS and Linux.
“Audio recording uses a built-in native module on macOS, Linux, and Windows.” (Requirements, voice dictation page)
- The Claude Code VS Code extension's voice dictation is not available in VS Code Remote sessions, including SSH, Dev Containers and Codespaces.
“It is not available in VS Code Remote sessions, including SSH, Dev Containers, and Codespaces” (Requirements)
Pages that rest on this source
- Dictation in ChatGPT and Claude: Speaking Your PromptsGuide
- Voice Input for Claude Code, Cursor and AI Coding ToolsGuide
- What languages does Claude dictation support?Question
- Why is Claude Code voice dictation not working?Question
- Dictation for Work: Doctors, Lawyers, Writers, StudentsTopic
- Voice Typing in Google Docs, Word and Every Other AppTopic
- Speech to Text Privacy: Where Your Voice GoesTopic
- Dictation in Mac Apps: Word, Pages, Notes, Mail, TerminalGuide
- Voice Coding: How to Program by VoiceGuide
- Can you use speech to text for confidential documents?Question
- Does voice typing save your audio recordings?Question
- How do you dictate in Terminal on a Mac?Question
- How do you use Mac dictation with Claude Code?Question
- What is the best dictation tool for Claude Code?Question
- Which AI dictation apps work on Windows?Question
- How to Dictate Into Any App: Built-in vs System-WideGuide
- Why is Claude dictation not working?Question
- Why is dictation not working in Gemini, Grok or Codex?Question
- Why is my microphone not working for dictation?Question
- How do you dictate in Claude?Question