[BUG] Claude Code freezes when Terminal.app menu bar / toolbar is activated (macOS)
Bug Description
Claude Code completely freezes when macOS Terminal.app's menu bar or toolbar is activated during a session. The TUI becomes unresponsive and requires force-killing the process.
This bug was previously reported in #33271, which was auto-closed by the stale bot as "not planned." The issue is still reproducible on the latest version.
Steps to Reproduce
- Run Claude Code in macOS Terminal.app
- During a session (especially while a tool is executing or output is being rendered), do one of the following:
- Click "Shell" menu → attempt to open a new tab
- Accidentally activate the toolbar
- Claude Code freezes immediately — the tool execution display remains on screen, no input is accepted
Expected Behavior
Menu bar / toolbar interactions should not affect the Claude Code TUI session.
Actual Behavior
- The terminal becomes completely unresponsive
- Ctrl+C does not work
- The only recovery is force-quitting the terminal or
kill -9 - This happens consistently, not intermittently
Environment
- Claude Code: v2.1.98 (also reproduced on v2.1.72)
- Model: Opus 4.6 (Claude Max)
- OS: macOS (Darwin 24.5.0, Apple Silicon)
- Terminal: macOS Terminal.app (default)
- Shell: zsh
Why this is not a duplicate
The previous issue #33271 was flagged as a potential duplicate of #25290 / #25346 / #25616. However:
- #25290 / #25346 — these appear to be about general hangs or performance issues, not specifically triggered by Terminal.app menu bar interaction
- #25616 — related but distinct root cause; this issue is specifically about macOS Terminal.app's native menu bar / toolbar interaction freezing the ink/React-based TUI renderer
The trigger is deterministic: activating Terminal.app's menu bar during Claude Code execution reliably causes a freeze. This suggests a specific interaction between Terminal.app's menu handling and the TUI rendering loop.
Possibly Related
- #20547 (tool execution completes but never returns to prompt)
- #24478 (SIGKILL required)
- #25286 (100% write ratio in terminal renderer)
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗