Claude Code voice mode: /voice listens, it doesn't talk back

By Kevin Hofmann · Updated

Claude Code's voice mode is dictation: run /voice, hold Space, speak, and your words are typed into the prompt. It doesn't read the replies out loud. Anthropic's help page says so: in Claude Code, dictation is available but voice mode isn't. To hear the replies you add a Stop hook, a free plugin, or an app like Pintail.

Checked against Claude Code's voice dictation docs on 4 November 2026.

How do I turn on voice mode in Claude Code?

Type /voice. The first time, macOS asks for microphone access for your terminal.

  • Hold mode (the default): hold Space while you talk, let go to stop.
  • Tap mode: /voice tap. Tap Space to start, tap again to send. Transcripts of three words or more are sent automatically.
  • Off: /voice off.

It stays on across sessions. To set it in ~/.claude/settings.json instead:

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

The audio goes to Anthropic's servers for transcription; it isn't processed on your Mac. It doesn't use your Claude messages or tokens. Dictation follows Claude Code's language setting and defaults to English.

Does Claude Code voice mode read replies out loud?

No. "Voice mode" means two different things at Anthropic:

Speaks to you Listens to you
Claude apps (mobile, desktop, web) voice mode Yes, a two-way conversation Yes
Claude Code /voice No Yes, dictation into the prompt

So you can talk to Claude Code, but it answers in text.

Why does Claude Code say voice mode isn't available?

The usual reasons, from the docs:

  • You're not signed in with a Claude.ai account. /voice only works with one. With an API key, an apiKeyHelper, Amazon Bedrock, Google's Agent Platform or Microsoft Foundry, you get Unknown command: /voice. Run /login.
  • No local microphone. It doesn't work over SSH, in cloud sessions, or in VS Code Remote sessions (SSH, Dev Containers, Codespaces).
  • Your organization turned it off. "Voice mode is disabled by your organization's policy."
  • The terminal has no microphone permission. System Settings → Privacy & Security → Microphone → turn on your terminal. If it isn't listed, tccutil reset Microphone com.googlecode.iterm2 (or com.apple.Terminal) and run /voice again.
  • Holding Space just types spaces. Dictation is off; run /voice hold.

How do I make Claude Code talk back?

Three ways, from free to paid:

  1. A Stop hook. Claude Code runs it when a reply finishes, and its input has the reply's text. Pipe it into the Mac's say and it talks. Here's the hook and where it breaks: it reads markdown symbols, it reads the whole reply, and two sessions talk over each other.
  2. A free plugin or app. Aloud reads a short gist with a local voice, claude-read-aloud adds a speaker button in VS Code, and VoiceMode turns it into a real two-way conversation, which is what most people mean by "voice mode".
  3. Pintail. A Mac app that speaks a short summary of each reply instead of every word, and shows which project is talking in a pill in the notch, with live captions. $15 once, 20 free read-outs, no account.

The Claude Code text to speech guide has setup and sound for each, and the comparison puts them side by side.

The full loop: talk in, listen back

/voice covers the first half. Add one of the above for the second, and you can work through a long session without reading every reply: dictate the next prompt while the last answer plays. If you'd rather dictate in every app, not just Claude Code, macOS Dictation and apps like FluidVoice do that; voice coding on a Mac compares them.

Try Pintail

20 free read-outs, then $15 once. No subscription.

Download free trial