[BUG] Real-time screen refresh issue when typing characters in macOS Terminal.app

[jeffery9]

Environment:

• Platform: Anthropic API
• Claude CLI version: [Please run claude --version to get this]
• Operating System: macOS [Please specify version]
• Terminal: macOS Terminal.app (built-in terminal)

Issue Description: When using Claude Code in macOS Terminal.app, every character typed triggers a complete interface re-render, causing continuous frame refreshes in the terminal. This issue affects both Chinese and English character input.

Steps to Reproduce:

1. Launch Claude Code in macOS Terminal.app
2. Start typing any characters (Chinese or English)
3. Observe the interface behavior with each character input

Expected Behavior: Characters should display normally within the same input box without creating new interface frames for each character.

Actual Behavior: Each character input creates a new bordered display area, as shown below:

╭───────────────────────────────────────────────────────────────╮  
│ > r                                                           │  
╭───────────────────────────────────────────────────────────────╮  
│ > re                                                          │  
╭───────────────────────────────────────────────────────────────╮  
│ > ret                                                         │  

Related Information:

• This appears to be related to Claude Code's terminal compatibility CHANGELOG.md:221
• Claude Code added terminal type detection in version 1.0.28 CHANGELOG.md:208
• Version 0.2.30 added ANSI color themes for better terminal compatibility CHANGELOG.md:495

Additional Context: The issue may be related to how macOS Terminal.app handles ANSI escape sequences. Investigation into Claude Code's rendering mechanism in macOS Terminal.app, particularly the real-time input display functionality, would be helpful.

Notes

This issue template is based on the specific symptoms you described and Claude Code's known terminal compatibility improvements. You can use this template to submit the issue on GitHub, making sure to fill in the specific version information and system details.

Wiki pages you might want to explore:

• Claude Code Overview (anthropics/claude-code)

[github-actions[bot]]

Found 3 possible duplicate issues:

1. https://github.com/anthropics/claude-code/issues/5721
2. https://github.com/anthropics/claude-code/issues/1854
3. https://github.com/anthropics/claude-code/issues/4575

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

[ozziek]

Hi @jeffery9 does your theme have "Unicode East Asian Ambiguous characters are wide" on by chance?

Settings -> Advanced -> "Unicode East Asian Ambiguous characters are wide" (at the bottom)

We might have the same issue: https://github.com/anthropics/claude-code/issues/5940

[PaulRBerg]

Also happens on Tabby

https://github.com/user-attachments/assets/4b1015d4-7464-42e7-9688-2874da630da1

[github-actions[bot]]

This issue has been inactive for 30 days. If the issue is still occurring, please comment to let us know. Otherwise, this issue will be automatically closed in 30 days for housekeeping purposes.

[PaulRBerg]

No longer seeing any flickers in the most recent v2 releases so I think this issue can be closed