Help screen (?) shows Shift+Return for multiline, but Option+Return is the actual macOS default
Resolved 💬 3 comments Opened Mar 19, 2026 by peanut-butter-tucker Closed Mar 19, 2026
Description
There's a discrepancy between the keybinding hints shown in different parts of the UI on macOS:
- Tips shown during thinking: Correctly show Option+Return for multiline input
- Help screen (
?): Shows Shift+Return for multiline input
Actual behavior
- Option+Return inserts a newline (works reliably across all macOS terminals)
- Shift+Return submits the message (behaves same as Return in most terminals)
The ? help screen is misleading — following its guidance causes the message to be sent instead of inserting a newline.
Expected behavior
The ? help screen should show Option+Return as the multiline shortcut on macOS, consistent with the tips and the actual default behavior.
Environment
- macOS (Darwin 24.6.0)
- Claude Code CLI
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗