claude-code - 💡(How to fix) Fix Caps Lock voice dictation silently fails on macOS — missing speech-recognition entitlement in Claude Desktop binary [2 comments, 2 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#52524Fetched 2026-04-24 06:04:54
View on GitHub
Comments
2
Participants
2
Timeline
5
Reactions
0
Timeline (top)
commented ×2closed ×1cross-referenced ×1labeled ×1

Root Cause

The Claude Desktop binary at /Applications/Claude.app is missing the com.apple.security.personal-information.speech-recognition entitlement. Without it, macOS silently denies speech recognition access — no TCC prompt is shown and no entry is created in the Speech Recognition pane.

RAW_BUFFERClick to expand / collapse

Environment

  • macOS 26 (Tahoe)
  • Latest Claude Desktop

Symptom

Pressing Caps Lock shows the orange overlay, but no audio is ever transcribed. Claude never appears in System Settings → Privacy & Security → Speech Recognition regardless of permission resets or reinstalls.

Root Cause

The Claude Desktop binary at /Applications/Claude.app is missing the com.apple.security.personal-information.speech-recognition entitlement. Without it, macOS silently denies speech recognition access — no TCC prompt is shown and no entry is created in the Speech Recognition pane.

Verification

Run: codesign -d --entitlements - /Applications/Claude.app | grep -i speech

Returns no match. Present entitlements include device.audio-input, device.camera, device.bluetooth, device.usb, device.print, personal-information.location, personal-information.photos-library, and virtualization — but no speech-recognition entitlement.

Why the in-app mic still works

The in-app microphone button in the prompt box uses standard audio capture (device.audio-input, which IS present) and transcribes correctly. Only the Caps Lock quick entry path, which per Anthropic's own documentation specifically requires Speech Recognition permission, fails.

Troubleshooting already attempted (all had no effect)

  • Granted Microphone and Accessibility permissions to Claude
  • Confirmed macOS Voice Control is off
  • Confirmed correct input device selected in Sound → Input
  • Confirmed Caps Lock not remapped in Keyboard → Modifier Keys
  • tccutil reset SpeechRecognition and tccutil reset Microphone + quit/relaunch
  • Toggled voice shortcut off/on in Claude settings

Fix required

Add com.apple.security.personal-information.speech-recognition to the code-signing entitlements of the Claude Desktop macOS binary.

Reference

Similar entitlement regression previously affected Claude Code (anthropics/claude-code#33023).

extent analysis

TL;DR

The issue can be resolved by adding the com.apple.security.personal-information.speech-recognition entitlement to the Claude Desktop macOS binary's code-signing entitlements.

Guidance

  • Verify the absence of the speech-recognition entitlement by running the provided codesign command and checking for the lack of a match.
  • Confirm that the in-app microphone button works as expected, as it uses standard audio capture and does not rely on the missing speech-recognition entitlement.
  • Review the reference issue (anthropics/claude-code#33023) for a similar entitlement regression that may provide additional insight or guidance.
  • To fix the issue, the com.apple.security.personal-information.speech-recognition entitlement must be added to the code-signing entitlements of the Claude Desktop macOS binary.

Example

No code snippet is provided as the issue is related to entitlements and not code.

Notes

The provided information suggests that the issue is specific to the Claude Desktop macOS binary and its entitlements. The fix required is clear, but the process of adding the entitlement may vary depending on the development environment and tools used.

Recommendation

Apply the workaround by adding the required entitlement to the code-signing entitlements of the Claude Desktop macOS binary, as this is the root cause of the issue and there is no mention of a fixed version that includes this entitlement.

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…

Still need to ship something?

×6

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

Back to top recommendations

TRENDING