[DOCS] VS Code docs omit `macOptionClickForcesSelection`

Open 💬 6 comments Opened Mar 17, 2026 by coygeek

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. Press Option+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 setting

View original on GitHub ↗

This issue has 6 comments on GitHub. Read the full discussion on GitHub ↗