Incorrect keyboard shortcut documentation for newline on macOS

Resolved 💬 7 comments Opened Jan 17, 2026 by mohammedmanna-skyscanner Closed Mar 23, 2026

Description

The help/settings documentation incorrectly states that Shift + Enter creates a newline in the command prompt on macOS.

Current Behavior

  • Documentation shows: Shift + Enter for newline
  • Actual behavior: Shift + Enter submits the command (same as just pressing Enter)

Expected Behavior

  • The correct keyboard shortcut for creating a newline on macOS is Option + Enter

Platform

  • OS: macOS (Darwin 25.2.0)
  • Claude Code CLI

Steps to Reproduce

  1. Open Claude Code CLI on macOS
  2. Check help (?) settings for newline keyboard shortcut
  3. Try using Shift + Enter - it submits the command instead of creating a newline
  4. Use Option + Enter - this correctly creates a newline

Suggested Fix

Update the documentation/help settings to show the correct keyboard shortcut for macOS:

  • macOS: Option + Enter
  • Not: Shift + Enter

View original on GitHub ↗

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