Shift+Enter in Claude Code inserts a newline without submitting your prompt—essential for writing multi-line code or complex queries. However, getting this key combination to work reliably through a terminal stack involving iTerm2 and tmux requires configuration at multiple layers.
This guide explains both the fix and the reasoning behind it.
If you just want it working, here's what you need: