Voice Mode: Hold Spacebar and Talk to Claude

The Short Version

Hold spacebar, talk, release. Claude Code converts your speech to text and sends it as your prompt. You do not need to configure much — it works out of the box on macOS and Windows with the default microphone.

How It Actually Works

Voice mode uses your operating system's native speech recognition. On macOS it goes through Apple's speech engine. On Windows it uses the Windows speech API. The recognition happens locally, not on Anthropic's servers — what leaves your machine is the transcribed text, not the audio.

When you hold spacebar, a small indicator appears in the terminal to show it is listening. Release spacebar to send. If you hold too long and hit the OS dictation limit (usually around 30-60 seconds of continuous speech), it will send what it has so far and you can continue in the next hold.

When This Is Actually Useful

Voice mode is not a replacement for typing — it is a supplement for moments when typing is awkward. Talking through a refactor idea while your hands are busy with something else. Jotting a quick note about a direction you want to take a feature. Walking through a bug description out loud before diving into debugging.

For longer, precise technical instructions, typing is still faster and less ambiguous. Dictating "add error handling to the auth middleware" is fine. Dictating a complex multi-step refactor tends to introduce more rework than typing does.

Microphone Setup

Claude Code uses the system default microphone. On macOS, check your input device in System Settings > Sound > Input. On Windows, check it in System > Sound > Input. If you have multiple microphones — laptop mic vs headset, for example — make sure the right one is set as default before starting a session.

If voice mode cannot find a microphone, it will tell you in the terminal. Double-check your OS input settings.

Making Voice Mode More Reliable

Speak clearly and at a natural pace. Background noise causes transcription errors that then get sent as prompts. If you are in a noisy environment, a headset microphone significantly improves accuracy compared to your laptop's built-in mic.

Technical terms — variable names, function names, specific jargon — are often transcribed incorrectly. After dictating, check what was actually sent before letting Claude Code act on it. You can always correct the prompt before sending.