Guide

Claude Code dictation

Claude Code can take a spoken prompt with /voice, in the CLI, when you are signed in with a Claude.ai account on a machine that has a microphone. On a Mac, JuTalk is separate: hold Option and Shift and it types a prompt into Terminal, VS Code, or the Claude desktop app.

The /voice limits below are Claude Code's, quoted from their docs. JuTalk is not affiliated with Claude Code or the Claude desktop app.

Claude Code and Claude Desktop docs checked on November 18, 2026.

How do I dictate to Claude Code?

Run /voice, then hold Space while you speak, or use tap mode, and the words land in the prompt input.

Claude Code's voice dictation docs say you speak prompts in the CLI instead of typing them. Speech is transcribed live into the prompt, so you can mix voice and typing in the same message. Enable it with /voice. Hold mode is the default: hold Space to record, and release to stop. The docs say the transcript is inserted and Claude Code waits for Enter. autoSubmit sends on release when the transcript is at least three words. /voice tap starts with one keypress and stops with another, and sends when the transcript is at least three words. A shorter tap transcript is inserted and not sent. /voice off turns it off. The setting sticks across sessions.

On a Mac, the first /voice run can ask the system for microphone permission for your terminal. Transcription is tuned for coding words, and the docs say the current project name and git branch are added as recognition hints. Press Esc or Ctrl+C to cancel a recording instead of keeping it.

The docs say the recorded audio is streamed to Claude's servers for transcription, and that audio is not processed locally. They also say transcription does not consume Claude messages or tokens, and does not count toward the limits shown in /usage.

Does /voice work with an API key?

No: the docs say it needs a Claude.ai account and is not available on an API key.

The requirements on the voice dictation page say speech-to-text is only available when you sign in with a Claude.ai account, not when Claude Code uses an API key or a third-party cloud provider.

If /voice replies "Unknown command", the same page says the command is available only while a Claude.ai account is your active sign-in. An API key, an auth token, an apiKeyHelper setting, or a third-party provider takes precedence over that sign-in. The documented step is to remove that and restart, then run /login. "Voice mode requires a Claude.ai account" means the same thing: run /login again.

Does Claude Code dictation work over SSH or in the cloud?

No: the docs say voice dictation does not work in cloud sessions or SSH sessions.

It needs a local microphone. The voice dictation page says it does not work in cloud sessions or SSH sessions. The Claude Code VS Code extension supports voice dictation with the same Claude.ai account requirement. That extension is not available in VS Code Remote sessions, including SSH, Dev Containers, and Codespaces, because the microphone is on your local machine and the extension runs on the remote host.

How do I dictate to Claude Code on a Mac?

Use /voice in a local terminal, or click in Terminal or VS Code on your Mac and hold Option and Shift with JuTalk.

/voice is Claude Code's dictation. It runs in the CLI on a machine with a microphone, and in the VS Code extension when that extension is not in a remote session. If the Mac says the microphone is denied, the docs say to open System Settings, then Privacy & Security, then Microphone, enable your terminal app, and run /voice again. If the terminal is not listed there, the same page has the steps to reset that permission and trigger the prompt again.

JuTalk is a macOS app, and it is not /voice. Click where you type, in Terminal or in VS Code on your Mac, hold Option and Shift, and talk. The mic turns blue. When you let go, JuTalk types a prompt at the cursor: reworded, reordered and shortened. The same hold works in any app on your Mac. Let go of Shift first for plain dictation. Press Esc while holding to cancel, and that recording isn't sent.

JuTalk types into the app on your Mac. It does not remove the /voice limits above. A cloud or SSH session still cannot use Claude Code's own voice dictation. Prompt mode is included in the free trial and in every paid plan. The trial is 7 days or 1 hour of audio, whichever runs out first, with no card. Polish what you typed is free with every plan. The steps are on the prompt mode guide.

JuTalk is not affiliated with Claude Code.

M1 or newer, on macOS 14 Sonoma or later.

How do I dictate in the Claude desktop app on a Mac?

Claude Desktop has its own Caps Lock dictation in quick entry, and you can also hold Option and Shift so JuTalk types a prompt into that app.

Claude's quick entry help says quick entry on the Mac desktop app can take voice dictation. Press Caps Lock to start, speak, press Caps Lock again, review the text, then click the arrow to send. The Caps Lock shortcut is off by default because it takes over that key. Turn it on from the voice prompt, or later in Settings, Desktop app (or Settings, System, under This computer, in the older Settings layout). You can pick a different voice shortcut there, or turn it off.

That page says voice dictation needs macOS 14 or later, and the Speech recognition permission. Quick entry itself needs macOS 12 or later, and Claude Desktop has to be running, though the window can stay in the background. It says the speech is transcribed to text in real time, and that text is sent to Claude as the message, like anything else you type. Quick entry is not available on Windows.

JuTalk does not use that Caps Lock shortcut. Click in the Claude desktop app, hold Option and Shift, and the rewritten prompt is typed at the cursor, in the same way as in any app on your Mac. There is no separate Claude page for that. This is the one.

JuTalk is not affiliated with the Claude desktop app.

Mac dictation and Claude Code: which one is which?

Claude Code's /voice, the Claude desktop Caps Lock shortcut, and JuTalk's Option and Shift are three different controls.

/voice transcribes into the Claude Code prompt, on a local Claude.ai sign-in, and it does not work over SSH or in the cloud. The desktop shortcut transcribes into Claude's quick entry, after you turn it on. JuTalk is the system-wide case on a Mac: one hold, in Terminal, VS Code, the Claude desktop app, or any other app on your Mac where you can type, with the ramble rewritten as a prompt.

Questions

How do I dictate to Claude Code?

Run /voice in the Claude Code CLI, then hold Space to record, or switch to tap mode. Speech is transcribed into the prompt input. The docs say this needs a Claude.ai account and a local microphone.

Does Claude Code dictation work with an API key?

No. Voice dictation is only available when you sign in with a Claude.ai account, not when Claude Code uses an API key or a third-party cloud provider.

Does Claude Code dictation work over SSH or in the cloud?

No. The docs say voice dictation does not work in cloud sessions or SSH sessions. The VS Code extension is also not available in VS Code Remote sessions, including SSH, Dev Containers, and Codespaces.

How do I dictate to Claude Code on a Mac?

For Claude Code's own dictation, run /voice in a local terminal and allow the microphone for that terminal. For the same hold-to-talk in Terminal, VS Code, and the Claude desktop app, click where you type and hold Option and Shift with JuTalk. JuTalk types a prompt there. It does not change the /voice limits.

Does the Claude desktop app have dictation?

Yes, in quick entry on a Mac. Claude's help page says press Caps Lock to dictate, if you turned that shortcut on. It needs macOS 14 or later. JuTalk can also type a prompt into the Claude desktop app. JuTalk is not affiliated with Claude.

Keep reading

Or read how JuTalk works on the homepage.

Built by Jurij Malovrh in Slovenia. Questions come straight to me at support@jutalk.app.

Sources

Claude Code facts are from the voice dictation docs. Claude Desktop facts are from Use quick entry with Claude Desktop on Mac. Both checked on November 18, 2026. JuTalk facts are from jutalk.app and the prompt mode guide.

Try JuTalk on your Mac.

Hold Option, talk, let go. Your words land where you're typing, cleaned up.

Download

No account needed to install. Your free trial starts when you sign in on your Mac.

Start free trial

JuTalk is a macOS app today. Join the Windows waitlist and we'll email you when it's ready.

JuTalk is a macOS app.

7 days or 1 hour of audio free, whichever runs out first. No card. macOS 14 Sonoma or later · Apple silicon.