Misleading UI message: "/terminal-setup" message suggests enabling alt+p, but it only configures Shift+Enter
Resolved 💬 5 comments Opened Dec 24, 2025 by WarrenZhu050413 Closed Feb 14, 2026
Description
The Claude Code interface displays a message "To enable alt+p, run /terminal-setup" when alt+p is not functional. However, running /terminal-setup does NOT enable alt+p. The command only configures Shift+Enter (multiline input shortcut).
This creates confusion because:
- User sees the suggestion and runs
/terminal-setup - Command succeeds (shows "Installed iTerm2 Shift+Enter key binding")
- alt+p still doesn't work
- User is left wondering what went wrong
Environment
- Claude Code version: v2.0.76
- OS: macOS (iTerm2)
- Terminal: iTerm2
Current Behavior
After running /terminal-setup, the message still appears: "To enable alt+p, run /terminal-setup"
Expected Behavior
The UI should either:
- Option A: Remove the alt+p suggestion from the
/terminal-setupoutput, OR - Option B: Show accurate instructions that alt+p requires separate terminal configuration (Option as Meta key in iTerm2 settings)
Steps to Reproduce
- Open Claude Code in iTerm2
- See the message "To enable alt+p, run /terminal-setup"
- Run
/terminal-setup - Command completes with "Installed iTerm2 Shift+Enter key binding"
- Try alt+p - it still doesn't work
- See the same message again
Root Cause
/terminal-setup only handles Shift+Enter configuration. alt+p requires a completely separate setup:
- Users must manually enable Option as Meta key in iTerm2 → Settings → Profiles → Keys
Suggested Fix
Update the UI message logic to:
- Only suggest running
/terminal-setupif Shift+Enter isn't configured - For alt+p, direct users to the terminal configuration steps instead
Impact
Medium - Confuses users and makes them think Claude Code has a bug or doesn't work properly
This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗