[BUG] Claude Code freezes when Terminal.app menu bar / toolbar is activated (macOS)

Resolved 💬 2 comments Opened Apr 10, 2026 by mhbmhb Closed May 28, 2026

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

  1. Run Claude Code in macOS Terminal.app
  2. 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
  1. 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)

View original on GitHub ↗

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