Alt/Option keyboard shortcuts break international keyboard layouts
Problem
Several Claude Code keyboard shortcuts require configuring Option (macOS) or Alt as the Meta key:
Alt+P- Switch modelAlt+B- Move back wordAlt+F- Move forward wordAlt+M- Toggle model menu- etc.
This configuration breaks essential character input on non-US keyboard layouts.
Impact
On many international keyboards (Swedish, German, French, Spanish, and others), the Option/Alt key is required to type fundamental programming characters:
| Character | Usage |
|-----------|-------|
| { } | Blocks, objects, interpolation |
| [ ] | Arrays, subscripts |
| \ | Escape sequences, paths |
| | | Pipes, OR operators |
| @ | Decorators, email, mentions |
| ~ | Home directory, bitwise NOT |
When Option is configured as Meta, these characters become impossible to type, making the terminal unusable for coding.
Current workaround
Users must choose between:
- Using keyboard shortcuts but losing the ability to type essential characters
- Keeping their keyboard functional but losing access to shortcuts
Neither is acceptable for daily use.
Suggested solutions
- Make shortcuts configurable - Allow users to rebind shortcuts to different key combinations
- Use Ctrl-based shortcuts - Ctrl doesn't conflict with character input on international layouts
- Use Cmd-based shortcuts on macOS - Cmd is not used for character input
- Support multiple bindings - e.g., both
Alt+PandCtrl+Shift+Pfor the same action
Environment
- macOS with Swedish keyboard layout (but affects many other layouts)
- Issue applies to any terminal emulator (iTerm2, Terminal.app, etc.)
This is an accessibility/internationalization issue that affects a significant portion of users outside the US.
This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗