[Bug] Scroll position jumps when Claude streams output during upward scrolling

[jkaster]

Bug Description
you've introduce a bug with scrolling jitter when scrolling up through conversation history. while Claude is displaying new results, if I scroll up now my scroll position jumps around and I often get put to the top of the scroll buffer so I can never even read the recent output from Claude Code that has scrolled past the current screen

Environment Info

• Platform: darwin
• Terminal: iTerm.app
• Version: 2.1.73
• Feedback ID: 30867ea8-0488-42c1-8e25-f9681c2cabe9

[github-actions]

Found 3 possible duplicate issues:

1. [BUG] Console scrolling top of history when claude add text to the console #826
2. [BUG] Scroll position constantly snapping to end of conversation preventing scrolling to view previous output #21631
3. [BUG] After the recent updates Claude Code jumps and loses track of scroll position in Terminal window #18299

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

[binaryfire]

Same. This bug was fixed, and now it's back.

[ijstokes]

Oh this is so painful. Yes, it worked fine until at least 2.1.71 (earlier this week), and then somewhere between there and 2.1.74 if I've scrolled up even just a little to look at some output or comments and new output is produced "lower down" then my viewport jumps TO THE VERY BEGINNING. My Claude Code sessions go on for days. There are 10s of THOUSANDS of lines I then need to scroll back down through to get to the "right now", and in fact I don't even want to be at the "right now", I need to be reading the output from the current agent session which might be taking 3-5-10 minutes to complete, but I want to track and see what is happening so I can think about it, form next step questions, and exceptionally, if needed, stop it from proceeding. But can I do any of that right now? So far as I can tell: no. I have to scroll up quickly, get a glimpse of what is there on the screen from output I need to grok from the last few minutes (and sometimes for reference from earlier finished interactions & agent actions), before more output is produced which will kick me to the top of the terminal session. Ugh. Please fix. I can't believe more people haven't found this issue to upvote it.

[jakeg]

This is really annoying and makes it impossible to read what Claude just said as I have to try to hold the scroll bar in a particular position then it jumps to somewhere else.

Unlike the op, I'm on Windows in PowerShell.

[VoxCore84]

We hit this too and collected working workarounds into a repo: claude-code-scroll-fix

Quick fix (Windows Terminal): Add "snapOnOutput": false to your profiles.defaults in settings.json. Reduces jumping ~60-70%.

Complete fix: Run Claude inside tmux — it completely decouples your scroll position from Claude's cursor repositioning. The repo has a one-click installer that sets up WSL + tmux + a Windows Terminal profile.

Root cause: Claude Code uses CSI escape sequences to rewrite the thinking spinner in-place, and terminals follow the cursor position back up. snapOnOutput only fixes output-triggered scrolling, not cursor repositioning — tmux fixes both.

[jaywonchung]

Getting this on Claude Code 2.1.76, MacOS 26.3, and Ghostty 1.3.0 as well.

[FurbySoup]

This is the same root cause as #826 — Claude Code's full screen redraws reset scroll position.
https://github.com/FurbySoup/quell is a Windows proxy that fixes this by stripping the clear-screen from redraw sync blocks. quell claude and it just works.