1.3 KiB
name, description, metadata
| name | description | metadata | ||
|---|---|---|---|---|
| claude-tui-fullscreen-crash | Claude Code "flicker-free rendering" prompt writes tui=fullscreen to settings.json and can crash-loop the CLI on Windows; fix = delete the tui key |
|
On ACG-TECH03L (2026-07-04, Claude Code 2.1.201), accepting the startup prompt asking to
enable flicker-free rendering wrote "tui": "fullscreen" into
~/.claude/settings.json. On that machine's terminal the fullscreen/alternate-screen
mode crashed the CLI instantly on every subsequent launch ("opens and then closes") —
from any launch path, since all read the same settings file.
Why: the setting persists, so one bad answer to the prompt turns into a permanent crash loop; reinstalling Claude Code does NOT fix it because settings survive reinstall.
How to apply: if a fleet machine's Claude Code exits immediately at launch, check
~/.claude/settings.json for "tui": "fullscreen" and set it to "tui": "default"
(surgically — keep hooks/plugins; explicit "default" also suppresses re-prompting,
which deleting the key does not). Emergency override without touching config:
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1. Decline the flicker-free prompt on machines
with older terminals/conhost. Related: tech03l-systemprofile-shortcut-corruption.