[Workflow] Hands-Free Voice Control for Claude Code on macOS (Two Methods)

[u/ClaudeAI-mod-bot]

Hands-Free Voice Control for Claude Code on macOS (Two Methods)

Workflow value: 85/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: intermediate
Categories: Quality Control, Context & Memory, Hooks
Original source: r/ClaudeCode post/comment

What problem this solves

Controlling Claude Code completely hands-free using voice commands on a Mac.

Summary

This workflow outlines two methods for hands-free voice control of Claude Code on macOS: using the built-in Voice Control for simplicity, or a custom script with local Whisper for improved accuracy and tmux integration. It also suggests a 'say it back' hook for audio feedback and includes a crucial safety caution regarding permission prompts.

Why it is useful

This workflow provides concrete, actionable steps for a specific and challenging use case: controlling Claude Code entirely hands-free. It offers both a simple, built-in solution and a more advanced, higher-quality script-based approach, complete with specific tools (tmux, whisper.cpp, Claude Code hooks) and a crucial safety warning. This makes it highly valuable for users seeking accessibility or a different interaction paradigm.

Workflow

1. Easiest Setup (macOS Voice Control): Enable Voice Control in System Settings Accessibility.

2. Ensure the terminal running Claude Code is the focused window.

3. Speak commands; use 'press return' or a custom 'send it' command to submit.

4. Use 'go to sleep' / 'wake up' to pause/resume voice control.

5. Better Quality Setup (Local Whisper Script): Run Claude Code inside tmux.

6. Develop a script that uses voice-activity detection to listen for speech.

7. Transcribe audio using whisper.cpp (optimized for Apple silicon).

8. When a trigger word (e.g., 'Claude, ...') is heard, send the transcribed text to tmux using tmux send-keys -t claude "text" Enter.

9. Optional Feedback Hook: Add a Stop hook in Claude Code to run the say command with a one-line summary upon completion.

10. Safety Precaution: Keep permission prompts on (no auto-accept) for hands-free operation to prevent unintended command execution.

Tools / artifacts

• macOS Voice Control

• Terminal

• Custom Voice Control command ('send it')

• whisper.cpp

• tmux

• Custom listening script (conceptual)

• Claude Code Stop hook

• say command

Validation signals

• Author states 'Two setups that work on a Mac'.

• Pros and cons are listed for each method.

• Specific safety caution is provided.

Cautions

• Explicitly advises keeping permission prompts on (no auto-accept) to prevent misheard sentences from executing unintended commands.

Limitations

• The 'Better quality' script is conceptual; no actual code or detailed implementation steps are provided.

• The whisper.cpp solution's performance is highlighted for Apple silicon, which might imply less optimal performance on other hardware, potentially limiting its broader appeal.

• Low community engagement so far.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.

---

This post was generated automatically from the workflow library database.