[DOCS] VS Code docs omit `macOptionClickForcesSelection`
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/vs-code
Section/Topic
Selection behavior on macOS / extension settings
Current Documentation
The VS Code docs currently say:
When you select text in the editor, Claude can see your highlighted code automatically. The prompt box footer shows how many lines are selected. PressOption+K(Mac) /Alt+K(Windows/Linux) to insert an @-mention with the file path and line numbers (e.g.,@app.ts#5-10). Click the selection indicator to toggle whether Claude can see your highlighted text - the eye-slash icon means the selection is hidden from Claude.
The extension settings table documents settings like selectedModel, useTerminal, disableLoginPrompt, and allowDangerouslySkipPermissions, but it does not list macOptionClickForcesSelection.
What's Wrong or Missing?
Claude Code v2.1.77 now points macOS users to macOptionClickForcesSelection when Option+click does not trigger native selection.
That setting is not documented in the VS Code docs, so users have no reference for what it does or when they should change it.
Suggested Improvement
Add macOptionClickForcesSelection to the VS Code extension settings table and add a short troubleshooting note in the text-selection section.
Suggested coverage:
- what behavior the setting changes on macOS
- when users should try it
- how it interacts with Claude's automatic selection sharing and Option-based selection behavior
Impact
Low - Minor confusion or inconvenience
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/vs-code | Selection behavior and extension settings for the VS Code extension |
| https://code.claude.com/docs/en/ide-integrations | Duplicate integration page with the same selection workflow text |
Total scope: 2 pages affected
Source: Claude Code v2.1.77 release notes
Exact release entry:
[VSCode] When option+click doesn't trigger native selection on macOS, the footer now points to the macOptionClickForcesSelection settingThis issue has 6 comments on GitHub. Read the full discussion on GitHub ↗