claude-code - 💡(How to fix) Fix [BUG]TUI banner duplication stacking repeatedly on macOS Terminal.app (v2.1.104) — blocking daily work [3 comments, 3 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#46983Fetched 2026-04-13 05:44:35
View on GitHub
Comments
3
Participants
3
Timeline
9
Reactions
0
Timeline (top)
labeled ×4commented ×3cross-referenced ×2

Error Message

Error Messages/Logs

Root Cause

This is severely blocking my daily work. I have lost multiple days of development time because of this rendering bug. The terminal becomes unusable within seconds of starting a session, and I have already submitted official support requests several days ago with no response. This is a long-standing TUI issue on macOS Terminal.app that has been acknowledged by the community but not fully resolved.

RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

On macOS Terminal.app with Claude Code CLI v2.1.104, the entire TUI (Claude Code logo, version header, working directory, input box, and bottom status bar) stacks multiple times vertically in the same terminal window after launching claude and sending a single message like "hello". The banners pile on top of each other, each one progressively narrower, as if SIGWINCH is being fired repeatedly on startup. Environment

  • Claude Code version: 2.1.104
  • OS: macOS (Darwin 25.2.0, Apple Silicon M1, 8GB RAM)
  • Terminal: Apple Terminal.app, version 466
  • Shell: zsh
  • TERM: xterm-256color
  • No tmux / screen
  • Window was NOT resized manually

Steps to Reproduce

  1. Open a fresh Terminal.app window
  2. Run claude
  3. Type hello and press Enter
  4. Observe: the full TUI banner (logo + version + cwd + prompt + status bar) renders multiple times stacked vertically in the same window

What I've Already Tried

  • Cleared all SessionStart hooks — issue persists
  • Set CLAUDE_CODE_NO_FLICKER=1 — issue persists (please confirm if this flag still exists in v2.1.104)
  • Verified no hook writes to stdout during startup
  • Confirmed TERM is correct
  • Did not resize the window

Impact

This is severely blocking my daily work. I have lost multiple days of development time because of this rendering bug. The terminal becomes unusable within seconds of starting a session, and I have already submitted official support requests several days ago with no response. This is a long-standing TUI issue on macOS Terminal.app that has been acknowledged by the community but not fully resolved.

Expected Behavior

The TUI should render once and redraw in place using the alternate screen buffer — not stack repeated copies of the banner in the scrollback.

Request

Please prioritize a fix for Apple Terminal.app users, or at minimum provide a --plain / --no-tui / --legacy fallback mode so we can keep working while the TUI bug is being investigated.

Screenshots attached.

<img width="962" height="1088" alt="Image" src="https://github.com/user-attachments/assets/dbe60a1a-37a9-40b1-bec2-7d4d7c48d053" />

What Should Happen?

<img width="962" height="1088" alt="Image" src="https://github.com/user-attachments/assets/742ebd75-8d8a-47e7-a5d2-d5350d22aa0f" /> <img width="920" height="1081" alt="Image" src="https://github.com/user-attachments/assets/92e3ba7a-c932-4a9f-adc3-65ea306ea399" /> <img width="962" height="1088" alt="Image" src="https://github.com/user-attachments/assets/dcf05051-9832-48be-b6d8-47643823f54b" /> <img width="950" height="1086" alt="Image" src="https://github.com/user-attachments/assets/db036eaf-7194-473d-8b64-d42382c9e785" /> <img width="950" height="1086" alt="Image" src="https://github.com/user-attachments/assets/41c4c5a4-2c38-479a-9c86-3a88342f4579" />

Error Messages/Logs

Steps to Reproduce

  1. Open a fresh macOS Terminal.app window (no tmux, no screen)
  2. Run claude
  3. Wait for the TUI to render (banner + prompt + status bar)
  4. Type any message, e.g. hello, and press Enter
  5. Observe: the full TUI (logo + version header + working directory + input box + bottom status bar) stacks multiple times vertically in the same window, each copy progressively narrower — as if SIGWINCH is being fired repeatedly on startup.

Environment:

  • Claude Code 2.1.104
  • macOS (Darwin 25.2.0, Apple M1, 8GB RAM)
  • Terminal.app version 466
  • zsh, TERM=xterm-256color
  • No tmux/screen, window was NOT resized

Already tried:

  • Cleared all SessionStart hooks — still happens
  • Set CLAUDE_CODE_NO_FLICKER=1 — still happens
  • Confirmed no hook writes to stdout during startup

Claude Model

Opus

Is this a regression?

I don't know

Last Working Version

No response

Claude Code Version

2.1.104

Platform

Other

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

No response

extent analysis

TL;DR

The issue can be potentially mitigated by using a different terminal emulator or configuring the existing one to handle SIGWINCH signals properly, as the repeated stacking of the TUI banner suggests an issue with terminal resizing or signal handling.

Guidance

  • Investigate if the issue persists when using a different terminal emulator on macOS, such as iTerm2, to isolate if the problem is specific to Terminal.app.
  • Check the Claude Code documentation or source code for any environment variables or configuration options that might influence how the TUI handles terminal resizing or SIGWINCH signals.
  • Consider reaching out to the Claude Code community or support channels for any known issues or workarounds related to Terminal.app on macOS, given the mention of this being a long-standing issue.
  • If possible, test an earlier version of Claude Code to determine if this is a regression, which could help in pinpointing the cause.

Example

No specific code example can be provided without more details on the internal workings of Claude Code or Terminal.app's handling of SIGWINCH. However, understanding how SIGWINCH is handled in the terminal and in Claude Code's TUI rendering could be crucial.

Notes

The exact cause of the issue is unclear without more technical details about how Claude Code handles terminal resizing and SIGWINCH signals. The problem might be specific to the interaction between Claude Code's TUI and Terminal.app's handling of these signals.

Recommendation

Apply a workaround by using a different terminal emulator if possible, as this might mitigate the issue temporarily until a proper fix is found or implemented in Claude Code or Terminal.app.

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…

Still need to ship something?

×6

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

Back to top recommendations

TRENDING