[DOCS] VS Code docs missing voice dictation setup and macOS microphone permission behavior

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/vs-code

Section/Topic

"Use the prompt box" and "VS Code extension vs. Claude Code CLI"

Current Documentation

The VS Code page currently says:

The prompt box supports several features: Permission modes: click the mode indicator at the bottom of the prompt box to switch modes. Command menu: click / or type / to open the command menu. Context indicator: the prompt box shows how much of Claude's context window you're using. Extended thinking: lets Claude spend more time reasoning through complex problems. * Multi-line input: press Shift+Enter to add a new line without sending.

And later:

Claude Code is available as both a VS Code extension (graphical panel) and a CLI (command-line interface in the terminal). Some features are only available in the CLI. If you need a CLI-only feature, run claude in VS Code's integrated terminal.

The voice dictation page documents the CLI/macOS flow as:

Run /voice to toggle voice dictation on. The first time you enable it, Claude Code runs a microphone check. On macOS, this triggers the system microphone permission prompt for your terminal if it has never been granted.

What's Wrong or Missing?

Changelog v2.1.119 includes this VS Code-specific fix:

[VSCode] Fixed voice dictation's first recording producing nothing on macOS while the microphone permission prompt is showing

That release note shows voice dictation exists in the VS Code experience and that first-use microphone permission behavior on macOS is user-visible there.

The current docs do not explain whether voice dictation is supported in the VS Code extension, how users enable or invoke it there, or what they should expect when macOS shows a microphone permission prompt on first use. The only microphone-permission guidance currently targets the terminal/CLI flow.

Suggested Improvement

Add a short VS Code-specific subsection to vs-code that:

1. states whether voice dictation is available in the graphical extension UI, terminal mode, or both
2. explains how VS Code users start or enable it
3. documents the first-use macOS microphone permission flow for VS Code users and what to do after granting permission
4. links to the main voice dictation page for shared settings, keybindings, and troubleshooting

Also update the voice dictation page to clarify that its current macOS permission instructions are terminal-specific and add a cross-reference to the VS Code page for extension behavior.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/vs-code | VS Code extension feature overview and prompt-box behavior; currently no voice dictation guidance |
| https://code.claude.com/docs/en/voice-dictation | Primary voice dictation page; currently describes the macOS microphone prompt only for the terminal flow |
| https://code.claude.com/docs/en/commands | /voice reference; does not clarify how this relates to VS Code extension usage |

Total scope: 3 pages affected

Source: Changelog v2.1.119

Exact changelog entry: [VSCode] Fixed voice dictation's first recording producing nothing on macOS while the microphone permission prompt is showing