CLAUDE_CODE_DEBUG_REPAINTS
Updated by Alex Sorokoletov
CLAUDE_CODE_DEBUG_REPAINTS is a Claude Code environment variable: Enables debug logging for terminal repaint operations. This release fixes several rendering issues — screen flashing blank after idle, scrollback jumping when collapsed groups finish, ghost characters in height-constrained lists — and this variable likely helped the team diagnose them. Added between v2.1.79 and v2.1.83 and still present in v2.1.294. It is not in the official reference.
| Status | Present in v2.1.294 |
|---|---|
| Added | Added between v2.1.79 and v2.1.83 |
| Category | Debugging |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_DEBUG_REPAINTS=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_DEBUG_REPAINTS": "<value>"
}
}Release notes that mention it
Related variables
CLAUDE_CODE_DEBUG_LOG_LEVEL: Set debug logging verbosity level.CLAUDE_CODE_DEBUG_LOGS_DIR: Custom directory for debug logs.CLAUDE_DEBUG: Enable debug logging.DEBUGCLAUDE_CODE_YOU_SHOULD_KNOW_DEBUGCLAUDE_RUNNER_DEBUG_LOG_PATHANTHROPIC_LOG: SDK internal logging level.ANTHROPIC_PROFILE
Frequently asked questions
What does CLAUDE_CODE_DEBUG_REPAINTS do?
Enables debug logging for terminal repaint operations. This release fixes several rendering issues — screen flashing blank after idle, scrollback jumping when collapsed groups finish, ghost characters in height-constrained lists — and this variable likely helped the team diagnose them.
Which Claude Code version has CLAUDE_CODE_DEBUG_REPAINTS?
Added between v2.1.79 and v2.1.83 and still present in v2.1.294.
How do I set CLAUDE_CODE_DEBUG_REPAINTS?
Export it before starting Claude Code (export CLAUDE_CODE_DEBUG_REPAINTS=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.
All variables, searchable: Claude Code environment variables.