Short answer: Claude Code has its own voice dictation. Run /voice, then hold Space to talk (or switch to tap mode). It needs a claude.ai account, a local microphone, and it sends audio to Anthropic's servers for transcription. It only works inside Claude Code. For dictating anywhere else on your Mac, use Apple's Dictation or a separate dictation app.
Claude Code already has voice input, so you may not need Mac dictation at all. Run /voice inside Claude Code, hold Space while you talk, and your speech is transcribed straight into the prompt. That's what Anthropic's documentation describes, and it's the first thing to try if your goal is Mac dictation with Claude Code.
It has limits, though. It works only inside Claude Code, it needs a particular kind of account, and it sends audio to Anthropic's servers. So this post covers three routes: Claude Code's own /voice, Apple's Dictation, and a separate hold-to-talk app. Claude Code facts come from Anthropic's docs and Apple's from the Mac User Guide, both checked on October 30, 2026.
What Claude Code's /voice does
Anthropic's docs say you can "speak your prompts instead of typing them in the Claude Code CLI", with the speech "transcribed live into the prompt input, so you can mix voice and typing in the same message". There are two modes. In hold mode, the default, Space is push-to-talk. In tap mode you tap once to start, speak, then tap again to send the prompt.
Transcription is tuned for coding vocabulary. Anthropic's examples are terms like regex, OAuth, JSON and localhost, and your project name and git branch name are added as recognition hints automatically.
What it requires
- A claude.ai account. It's not available when Claude Code is set up with an Anthropic API key directly, or with Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry.
- A local microphone. Anthropic says voice dictation doesn't work in cloud sessions or SSH sessions. The VS Code extension supports it too, but not in VS Code Remote sessions.
- An internet connection. Audio is streamed to Anthropic's servers for transcription and, in their words, "is not processed locally".
- Your organization's permission. The docs list a "Voice mode is disabled by your organization's policy" message for accounts where an administrator has turned it off.
Anthropic also says transcription doesn't use up Claude messages or tokens and doesn't count toward the limits shown in /usage. The docs mention the CLI and the VS Code extension. They don't mention the desktop app or a JetBrains plugin, so check there before assuming it's available.
How to turn on /voice on a Mac
- Start Claude Code and sign in with a claude.ai account. If you use an API key or a cloud provider,
/voiceisn't available. - Type
/voice. Claude Code runs a microphone check. On a Mac that triggers the system permission prompt for your terminal app if it's never been granted. You should see "Voice mode enabled (hold)". - Allow the microphone. If you missed the prompt, go to System Settings > Privacy & Security > Microphone, turn on your terminal app, and run
/voiceagain. - Hold Space and speak. There's a short warmup before recording starts. When you release, the transcript goes in at your cursor and waits for you to press Enter. Press Esc or Ctrl+C instead to cancel and discard it.
- Try tap mode if holding is awkward: run
/voice tap. With the prompt empty, tap Space to start and tap again to stop. Claude Code sends the prompt by itself if the transcript is at least three words long. Recording also stops after 15 seconds of silence or two minutes in total. - Set your language in
/config. Dictation uses the same language setting as Claude's responses and defaults to English if that's empty.
Anthropic's list has 20 languages: Czech, Danish, Dutch, English, French, German, Greek, Hindi, Indonesian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Russian, Spanish, Swedish, Turkish and Ukrainian. If your setting isn't on it, /voice warns you and falls back to English.
If your terminal isn't in the Microphone list
This is the usual snag on a Mac. Anthropic's troubleshooting section says that if your terminal isn't listed under Microphone in Privacy & Security, you reset its permission and let macOS ask again. For the built-in Terminal app, run tccutil reset Microphone com.apple.Terminal. For iTerm2 the identifier is com.googlecode.iterm2. Then quit the terminal with Cmd+Q, not just by closing windows, reopen it, start Claude Code and run /voice.
Anthropic warns that running tccutil reset Microphone without an identifier removes microphone access from every app, so don't do that during a call.
Using Apple's Dictation instead
Apple's Dictation is a different tool. Apple says "with Dictation, you can speak to enter text anywhere you can type it", and you can start it with the Microphone key, the Dictation keyboard shortcut, or Edit > Start Dictation. To turn it on, open System Settings > Keyboard and switch on Dictation.
What Apple's pages don't tell you is how Dictation behaves inside Terminal or a particular terminal app. The Terminal guide has no page on dictation, and Apple doesn't say whether Terminal's Secure Keyboard Entry setting affects it. So we can't promise it works in your terminal. Try it, and if it doesn't, see our post on Mac dictation not working in Terminal. Mac's Privacy & Security also keeps separate Microphone and Speech Recognition lists, so check both if an app can't hear you.
Claude Code's /voice and Apple Dictation side by side
| What | Claude Code /voice | Apple Dictation |
|---|---|---|
| Works in | Claude Code only | Any text field, per Apple |
| Turn on | Run /voice | System Settings > Keyboard |
| Account | claude.ai sign-in required | None mentioned on Apple's pages |
| Start | Hold Space, or tap | Microphone key or shortcut |
| Audio | Streamed to Anthropic | See Apple's privacy page |
| Over SSH | Not available | Apple doesn't say |
A third route is a separate dictation app that types at your cursor wherever you are, covered next. If you're after prompts specifically, our guide to dictating prompts for Claude has habits that help whichever route you pick.
Where Voice Keyboard Pro fits
Where /voice lives inside Claude Code, Voice Keyboard Pro lives in the menu bar and types wherever your cursor is: Terminal, VS Code, Cursor, Xcode or Slack. You hold a key you choose (Left Control by default), speak, and let go. It's its own dictation, so it doesn't rely on Apple's Dictation being on, and it listens through whatever microphone is your Mac's current sound input.
It's built with terminals in mind. There, it keeps commands literal (no capital letter, no closing period) and formats prose, such as an instruction to an AI assistant, as normal sentences. It puts text in by pasting at the cursor and then restores your clipboard, and nothing is sent until you press Return yourself. On Apple silicon Macs, Offline Mode runs transcription entirely on the Mac with no network.
You can add project names and jargon to its personal vocabulary, and it also learns terms it sees on your screen. The trade-offs: there's no hands-free or tap-to-toggle mode on Mac, since it listens only while you hold the key, and it's a separate app rather than something built into Claude Code. See the Terminal integration page and our post on voice typing in Terminal.
Which one to use
- You only dictate prompts, and you have a claude.ai account: start with
/voice. It's built in and tuned for code terms. - You use an API key, Bedrock or another provider:
/voiceisn't available, so you need Apple's Dictation or a separate app. - You dictate in Slack, email and your editor as well: use something that works in every app, so you learn one habit.
- You work over SSH: Anthropic says
/voicedoesn't work in SSH sessions, so check that limit before you plan around it.
Frequently asked questions
Does Claude Code have voice input?
Yes. Run /voice to turn it on, then hold Space to record. It requires a claude.ai account and a local microphone, and it uses Anthropic's servers for transcription.
Why does /voice say my microphone isn't available?
On a Mac a common cause is that your terminal app hasn't been given microphone access. Turn it on under System Settings > Privacy & Security > Microphone and run /voice again. Voice also won't work in SSH or cloud sessions.
Can I change the key from Space?
Yes. Anthropic documents a voice:pushToTalk action in ~/.claude/keybindings.json. A key you bind there replaces Space, and for hold mode the docs suggest a modifier combination such as meta+k rather than a bare letter, which would type into the prompt during the warmup.
Does voice dictation use my Claude usage limits?
Anthropic says transcription doesn't consume Claude messages or tokens and doesn't count toward the limits in /usage. Your prompt, once sent, is a normal prompt.
Can I use Apple's Dictation in the Claude Code prompt?
Apple says Dictation works anywhere you can type text, but it doesn't say anything specific about terminals. Try it in your terminal app. If it types nothing, check Dictation is on and the microphone is allowed.
The bottom line
For Claude Code on a Mac, start with its own /voice if you have a claude.ai account, because it's the shortest path and understands code terms. Reach for Apple's Dictation or a hold-to-talk app when you want one way of talking that works in every app, or when /voice isn't available for your setup.
Hold your key, speak the instruction as a sentence, release, then press Return yourself. Offline Mode keeps transcription on the Mac on Apple silicon.
3-day free trial on the monthly plan · Apple Silicon & Intel
