Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [DOCS] VS Code docs missing voice dictation setup and macOS microphone permission behavior [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#52631•Fetched 2026-04-24 06:01:58
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
coygeekcoygeek
Participants
coygeekcoygeek
Timeline (top)
labeled ×4
RAW_BUFFERClick to expand / collapse

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:

PageContext
https://code.claude.com/docs/en/vs-codeVS Code extension feature overview and prompt-box behavior; currently no voice dictation guidance
https://code.claude.com/docs/en/voice-dictationPrimary 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

extent analysis

TL;DR

Add a VS Code-specific subsection to the vs-code documentation page to clarify voice dictation support, usage, and first-use microphone permission flow.

Guidance

  • Review the suggested improvement section to understand the required documentation updates.
  • Update the vs-code page to include a new subsection that addresses voice dictation in the graphical extension UI, terminal mode, or both.
  • Clarify how VS Code users can start or enable voice dictation and document the first-use macOS microphone permission flow.
  • Cross-reference the main voice dictation page for shared settings, keybindings, and troubleshooting.

Example

No code snippet is necessary for this documentation update.

Notes

The current documentation lacks clarity on voice dictation support in the VS Code extension, which may cause confusion for users. The suggested improvement provides a clear outline of the required updates.

Recommendation

Apply the suggested improvement to update the documentation and provide clear guidance on voice dictation in the VS Code extension. This will improve the overall user experience and reduce confusion.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#tokenizer error#prompt formatting#chain error#conversation history#tool integration

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [DOCS] VS Code docs missing voice dictation setup and macOS microphone permission behavior [1 participants]