Claude Code Voice Dictation: Talk Instead of Typing

How to set up Claude Code voice dictation in two minutes: the /voice command, hold vs tap mode, 20 supported languages, and why it costs zero tokens.

claude codevoice dictationvoice inputaccessibilitybeginners
Updated 2026-06-12EAEvgenii ArsentevEvgenii Arsentev · MD, PhD

Reviewed for accuracy by Evgenii Arsentev, MD, PhD · 2026-06-12

Claude Code voice dictation lets you speak your prompts instead of typing them: run /voice, then hold Space while you talk and your words appear live in the prompt. It needs Claude Code v2.1.69 or later and a Claude.ai account — and transcription doesn't consume a single token of your plan.

I'm Evgeny, and here's a confession: my best prompts are spoken, not typed. When you describe a problem out loud, you naturally add the context a typed one-liner leaves out. For non-programmers this is a superpower — you were never going to out-type a developer anyway, but you can absolutely out-explain one.

How to enable voice mode in Claude Code

Run /voice once. The first time, Claude Code does a microphone check — on a Mac this triggers the system permission prompt for your terminal; click Allow. From then on, hold Space to record: your speech streams into the prompt as dimmed text, finalizes when you release, and you can keep typing around it. Voice and keyboard mix freely in the same message.

Turn it on
/voice

Toggles dictation on or off. You'll see: "Voice mode enabled (hold). Hold Space to record." The setting persists across sessions, so this is a one-time ritual.

Hold mode vs tap mode — which one should I use?

Hold is the default: push-to-talk, like a walkie-talkie. It has a brief warmup while Claude Code detects the held key, and a stray space or two may flash in the input before being cleaned up automatically. Tap mode is calmer: tap Space once to start, speak, tap again — and if you said at least three words, the prompt sends itself. Recording also stops on its own after 15 seconds of silence or two minutes total. I recommend tap mode to beginners: no warmup, no held keys, fewer surprises.

Switch to tap mode
/voice tap

Tap to start, tap to send. The other options: /voice hold returns to push-to-talk, /voice off disables dictation entirely.

Can I change the dictation key?

Two refinements once you're comfortable. If Space feels awkward, the dictation key is the voice:pushToTalk action in ~/.claude/keybindings.json — rebind it to a modifier combo like meta+k, which also skips the hold-mode warmup because recording starts on the first keypress. And in hold mode you can set "autoSubmit": true in the voice settings so releasing the key sends the prompt automatically whenever the transcript is at least three words long.

Does it understand languages other than English?

Yes — twenty languages, including Spanish, French, German, Japanese, Portuguese, Russian and Ukrainian. Dictation follows the same language setting that controls Claude's response language; if it's empty, you get English. Set it in /config or in your settings file, and one nice touch: transcription is tuned for coding vocabulary, so words like regex, OAuth, JSON and localhost come out right, and your project and branch names are added as recognition hints automatically.

Set your dictation language
{
  "language": "spanish"
}

Goes in your user settings file (or pick the language in /config). Either the language name or a code like es works. If you dictate in a language Claude Code doesn't expect, you'll get amusing garbage — set this first.

Is it private, and what does it cost?

Two honest facts. First: your audio is streamed to Anthropic's servers for transcription — nothing is processed locally. Second: it's free in the sense that matters — transcription does not consume Claude messages or tokens and doesn't count toward the limits in /usage. Dictate hour-long monologues; your plan won't notice.

!Where voice dictation won't work

It requires signing in with a Claude.ai account — API keys, Bedrock, Vertex and Foundry setups don't get it. And since it needs your local microphone, it won't work over SSH or in Claude Code on the web. If holding Space just prints spaces, run /voice hold to check it's enabled — or switch to /voice tap, which doesn't depend on key-repeat.

Does voice input work in VS Code?

Yes — the Claude Code VS Code extension supports dictation with the same Claude.ai account requirement. The one exception is remote sessions (SSH, Dev Containers, Codespaces): your microphone lives on your laptop while the extension runs on the remote machine, so they can't hear each other.

Lab: your first spoken prompt

0/5

The kicker: tomorrow morning, describe your first task to Claude by voice — sloppy, with "umm" and self-corrections, like a human. Then look at how much context you gave it compared to what you usually type. That gap is why voice prompts get better answers.

Free course

Stop reading about AI — start building with it

The free Claude Code course: your first site, tool or game — no coding. No upsells, no cross-sells — nothing to buy here.

Start free →

References

Selected peer-reviewed papers and preprints on the AI research behind this topic.

  1. [1]Poncelet et al. (2021). Comparison of Self-Supervised Speech Pre-Training Methods on Flemish Dutch. arXiv:2109.14357
  2. [2]Tao et al. (2018). End-to-end Audiovisual Speech Activity Detection with Bimodal Recurrent Neural Models. arXiv:1809.04553
  3. [3]McDermott et al. (2020). A Density Ratio Approach to Language Model Fusion in End-To-End Automatic Speech Recognition. arXiv:2002.11268
  4. [4]Chen et al. (2026). Advancing automatic speech recognition using feature fusion with self-supervised learning features: A case study on Fearless Steps Apollo corpus. arXiv:2604.22203
  5. [5]Atmaja et al. (2020). The Effect of Silence Feature in Dimensional Speech Emotion Recognition. arXiv:2003.01277
  6. [6]Lotfian et al. (2018). Curriculum Learning for Speech Emotion Recognition from Crowdsourced Labels. arXiv:1805.10339
  7. [7]Shen et al. (2018). Reinforcement Learning Based Speech Enhancement for Robust Speech Recognition. arXiv:1811.04224
EAEvgenii Arsentev

Author

Evgenii Arsentev

MD, PhD · AI transformation executive

Reading is the blue pill

Want to actually build this?

Guides explain. The free course transforms — personalized, gamified, and built to get you shipping fast.

Start the free course →