[BUG] Ctrl+Z suspend not working (macOS iTerm2)
Resolved 💬 8 comments Opened Jan 9, 2026 by eesb99 Closed Apr 18, 2026
Describe the bug
Ctrl+Z no longer suspends Claude Code CLI. Pressing Ctrl+Z does nothing - the process remains in foreground instead of suspending.
To reproduce
- Open iTerm2 on macOS
- Run
claudeto start Claude Code CLI - Press Ctrl+Z
- Expected: Process suspends, shows
[1]+ Stopped claude, returns to shell prompt - Actual: Nothing happens, Ctrl+Z is ignored
Environment
- Claude Code version: 2.1.2
- OS: macOS 26.2 (Build 25C56)
- Terminal: iTerm2
- Shell: zsh
Verification done
- Terminal
suspis set correctly:stty -a | grep suspshowssusp = ^Z - No iTerm2 key binding overrides for ^Z (checked both global Keys > Key Bindings and Profiles > Keys > Key Bindings - both empty/no ^Z)
- Ctrl+Z works for other processes (e.g.,
sleep 100suspends correctly)
Previous behavior
Ctrl+Z suspend was implemented in v1.0.44 (#588) and worked in earlier versions.
Related issues
- #588 - Original implementation of Ctrl+Z suspend (CLOSED - COMPLETED)
- #11898 - iTerm2 TTY/focus issues (possibly related)
This issue has 8 comments on GitHub. Read the full discussion on GitHub ↗