claude-code - 💡(How to fix) Fix [DOCS] Fullscreen rendering docs missing `/tui` command and `tui` setting [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#48851Fetched 2026-04-16 06:49:13
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
Participants
Timeline (top)
labeled ×4

Code Example

> CLAUDE_CODE_NO_FLICKER=1 claude
>

---

> export CLAUDE_CODE_NO_FLICKER=1
>
RAW_BUFFERClick to expand / collapse

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/fullscreen

Section/Topic

Fullscreen rendering enablement and the related command/settings references for switching TUI modes

Current Documentation

The docs currently describe fullscreen rendering as an environment-variable-based feature:

Set the CLAUDE_CODE_NO_FLICKER environment variable when starting Claude Code:

CLAUDE_CODE_NO_FLICKER=1 claude

To enable it for every session, export the variable in your shell profile such as ~/.zshrc or ~/.bashrc:

export CLAUDE_CODE_NO_FLICKER=1

The terminal configuration guide also says:

If you see flicker during long sessions, or your terminal scroll position jumps to the top while Claude is working, try fullscreen rendering. It uses an alternate rendering path that keeps memory flat and adds mouse support. Enable it with CLAUDE_CODE_NO_FLICKER=1.

The commands reference says:

The table below lists all the commands included in Claude Code.

But there is no /tui entry in that table, and the settings reference does not document a tui key.

What's Wrong or Missing?

Claude Code v2.1.110 added a new user-facing way to switch rendering modes in an existing session: /tui fullscreen. The same release also added a tui setting.

Those surfaces are not documented in the main docs. Current fullscreen guidance only explains enabling flicker-free rendering through CLAUDE_CODE_NO_FLICKER=1, which implies users must decide before launch or restart Claude Code to change modes.

As a result, the docs miss two important behaviors users need to know about:

  1. You can switch to fullscreen rendering in the same conversation with /tui fullscreen.
  2. There is a tui setting for configuring this behavior persistently.

Suggested Improvement

Update the docs to cover the new runtime and persistent configuration paths for fullscreen rendering:

  1. Add /tui to the commands reference with at least one example:
  • /tui fullscreen switches to flicker-free rendering in the current conversation without restarting.
  1. Add tui to the settings reference, including the accepted values and how it interacts with CLAUDE_CODE_NO_FLICKER.
  2. Update the fullscreen guide and terminal configuration guidance to explain that users can either:
  • enable fullscreen rendering before launch with CLAUDE_CODE_NO_FLICKER=1, or
  • switch during an active session with /tui fullscreen.
  1. Cross-link the command, setting, and fullscreen guide so users can discover the feature from any of those entry points.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

PageLine(s)Context
https://code.claude.com/docs/en/fullscreen31-43Documents fullscreen enablement only through CLAUDE_CODE_NO_FLICKER=1
https://code.claude.com/docs/en/terminal-config101-103Recommends fullscreen rendering via env var only
https://code.claude.com/docs/en/commands9-17Says the table lists included commands, but /tui is not documented
https://code.claude.com/docs/en/settings153-215Lists available settings, but does not document a tui setting
https://code.claude.com/docs/en/env-vars107Documents CLAUDE_CODE_NO_FLICKER but not the newer command/setting alternatives

Total scope: 5 pages affected

Source: Changelog v2.1.110

Exact changelog entry:

Added /tui command and tui setting - run /tui fullscreen to switch to flicker-free rendering in the same conversation

extent analysis

TL;DR

Update the documentation to include the new /tui fullscreen command and tui setting for switching rendering modes.

Guidance

  • Add the /tui command to the commands reference table with an example of how to use /tui fullscreen to switch to flicker-free rendering.
  • Include the tui setting in the settings reference, detailing its accepted values and interaction with CLAUDE_CODE_NO_FLICKER.
  • Update the fullscreen guide and terminal configuration sections to explain both methods of enabling fullscreen rendering: using CLAUDE_CODE_NO_FLICKER=1 before launch and switching during an active session with /tui fullscreen.
  • Cross-link the command, setting, and fullscreen guide for easy discovery.

Example

An example of how the updated commands reference could include:

| Command | Description |
| --- | --- |
| /tui fullscreen | Switches to flicker-free rendering in the current conversation. |

Notes

The current documentation only covers enabling fullscreen rendering through an environment variable, which may lead to confusion about the availability of runtime configuration options.

Recommendation

Apply the suggested improvements to update the documentation, ensuring that users are aware of both the environment variable method and the new /tui fullscreen command and tui setting for configuring fullscreen rendering behavior. This update will improve the usability and understanding of the feature.

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

claude-code - 💡(How to fix) Fix [DOCS] Fullscreen rendering docs missing `/tui` command and `tui` setting [1 participants]