Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [BUG] Claude Code freezes when Terminal.app menu bar / toolbar is activated (macOS) [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#46061•Fetched 2026-04-11 06:30:00
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
mhbmhbmhbmhb
Participants
mhbmhbmhbmhb
Timeline (top)
labeled ×4

Root Cause

  • #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
RAW_BUFFERClick to expand / collapse

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
  3. 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)

extent analysis

TL;DR

Investigate the interaction between Terminal.app's menu handling and the TUI rendering loop in Claude Code to identify the root cause of the freeze.

Guidance

  • Review the code handling menu bar and toolbar interactions in Terminal.app to ensure it does not interfere with the TUI rendering loop.
  • Inspect the TUI rendering loop in Claude Code for potential bottlenecks or blocking calls that could cause the freeze when the menu bar or toolbar is activated.
  • Consider adding logging or debugging statements to track the execution flow and identify the point where the freeze occurs.
  • Examine the possibly related issues (#20547, #24478, #25286) to see if they share a common root cause or provide insight into the problem.

Example

No specific code snippet can be provided without more information about the Claude Code implementation.

Notes

The root cause of the issue is likely specific to the interaction between Terminal.app and the TUI rendering loop in Claude Code. Further investigation is needed to determine the exact cause and develop a fix.

Recommendation

Apply a workaround, such as disabling menu bar or toolbar interactions during Claude Code sessions, until the root cause can be identified and addressed. This will allow users to continue using the application while a more permanent fix is developed.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#ssr#prompt issue#agent setup#task chaining

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING