[DOCS] Not everyone is using a MAC! Some people use Linux (or even Windows)

Resolved 💬 3 comments Opened Apr 30, 2026 by Branpolo Closed May 3, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/terminal-config#vs-code

Section/Topic

Settings and commands even for VSCode are Mac oriented, do not work in Windows/Linux

Current Documentation

  1. Docs say: Add "terminal.integrated.macOptionIsMeta": true to your VS Code settings.
  2. Also, when selected VSCode (https://code.claude.com/docs/en/terminal-config#vs-code) the Notification Bell advice is for iTerm, despite VSCode having been selected above.
  3. Continuing, we see: _The allow-passthrough line lets notifications and progress updates reach iTerm2, Ghostty, or Kitty instead of being swallowed by tmux._ - What about non-Mac TMUX users (Linux/WSL!)

What's Wrong or Missing?

The guide pretends to be for VSCode, but actually it is just for Mac users

Suggested Improvement

Most important - get some non Mac users at Anthropic, at least for Claude Code testing and Docs review! That is the 'systemic' fix. On the specific issues:

  1. Remove, or suggest ""terminal.integrated.sendKeybindingsToShell": true"
  2. Should say to enable "terminal.integrated.enableVisualBell": true
  3. Replace "iTerm2, Ghostty, or Kitty" with 'the Terminal'

Impact

High - Prevents users from using a feature

Additional Context

Non Mac claude code program and docs support is essential

View original on GitHub ↗

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