요약

Claude Code 안에서 다음을 실행하세요.

/tui fullscreen

Claude Code의 전체 화면 렌더러로 전환되며, Anthropic은 이를 깜빡임 없는 렌더러로 설명합니다. 대화는 그대로 다시 시작되고 설정은 이후 세션에도 저장됩니다. 되돌리려면 /tui default를 실행하세요.

원인에 따른 다른 해결책:

• 깜빡임만 있고 터미널이 동기화 출력을 지원하는 경우: CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 claude로 시작하세요. 기존 렌더러가 유지됩니다.
• 환경 변수로 설정하고 싶은 경우: CLAUDE_CODE_NO_FLICKER=1 claude로 시작 시 전체 화면 렌더링이 켜집니다.
• tmux 안에서: tmux를 업그레이드하거나 Claude Code를 별도 터미널 탭에서 실행하세요.
• Windows Terminal에 잔상이 남는 경우: CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1.

전체 화면 렌더링은 Anthropic 문서(2026년 10월 26일 확인)에서 리서치 프리뷰로 표시되어 있으므로 세부 사항이 바뀔 수 있습니다.

문제

증상은 익숙합니다. 도구 출력이 흘러나올 때 화면이 번쩍입니다. Claude가 작업하는 동안 스크롤 위치가 맨 위로 튑니다. 세션이 길어질수록 터미널이 느려지고 깜빡임도 심해집니다. 그리기 속도가 병목인 터미널에서 특히 두드러집니다. Anthropic은 VS Code 통합 터미널, tmux, iTerm2를 꼽습니다.

원인은 기존 렌더러가 업데이트마다 화면의 큰 부분을 다시 그리기 때문입니다. 해결책은 Claude Code의 그리기 방식을 바꾸거나, 터미널이 각 업데이트를 한 번에 적용하도록 하는 것입니다.

해결책 1: Claude Code를 전체 화면 렌더링으로 전환

/tui fullscreen

전체 화면 렌더링은 vim이나 htop처럼 터미널의 대체 화면 버퍼에 그리고, 보이는 메시지만 렌더링합니다. 그래서 업데이트당 보내는 데이터가 줄고, 긴 대화에서도 메모리가 일정하게 유지되며, 마우스도 지원됩니다. "전체 화면"은 그리기 영역을 차지한다는 뜻이며 창 크기와 상관없이 동작합니다.

다시 시작할 때 유지되는 것: 화면에 표시된 대화, 권한 모드와 effort 수준, /model로 고른 모델, --allowed-tools와 --agent 같은 플래그.

어떤 렌더러가 켜져 있는지 확인:

/tui

Claude가 작업하는 동안 입력창이 아래에 고정되어 있다면 전체 화면이 켜진 것입니다.

전체 화면 모드에서 달라지는 점

대화가 대체 화면 버퍼에 있으므로 터미널 자체의 스크롤백과 검색으로는 보이지 않습니다.

대화 기록 모드에서 [는 전체 대화를 터미널의 기본 스크롤백에 쓰고, v는 편집기에서 엽니다.

마우스 캡처가 방해된다면 렌더러는 유지하고 마우스만 끄세요.

CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude

해결책 2: 동기화 출력을 켜고 기존 렌더러 유지

일부 터미널은 각 다시 그리기를 하나의 업데이트로 적용하는 동기화 출력을 지원하지만, Claude Code가 감지할 수 있는 방식으로 알려 주지 않습니다. Anthropic은 Emacs eat을 예로 듭니다. 이런 터미널에서는 강제로 켜세요.

CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 claude

렌더러를 바꾸지 않고 깜빡임이 멈추므로 기본 스크롤백과 선택이 그대로 동작합니다.

해결책 3: CLAUDE_CODE_NO_FLICKER 설정

환경 변수로 전체 화면 렌더링을 켜려면:

CLAUDE_CODE_NO_FLICKER=1 claude

PowerShell:

$env:CLAUDE_CODE_NO_FLICKER = "1"; claude

또는 settings.json에:

{
  "env": {
    "CLAUDE_CODE_NO_FLICKER": "1"
  }
}

tmux에서 Claude Code 깜빡임 해결

Anthropic의 전체 화면 페이지에 따르면 3.6 계열까지의 tmux는 동기화 출력을 구현하지 않아, 터미널에서 직접 실행할 때보다 tmux 안에서 다시 그리기가 더 깜빡일 수 있습니다. v2.1.201 변경 내역에도 동기화 출력을 켜서 tmux 3.4 이상의 깜빡임을 고쳤다고 나와 있습니다. 그래도 깜빡인다면:

1. claude update로 Claude Code를 업데이트하세요.

2. tmux를 최신 릴리스로 업그레이드하세요.

3. 전체 화면 렌더링을 시도하세요. 그 안에서 마우스 휠로 스크롤하려면 tmux 마우스 모드를 켜세요.

   # ~/.tmux.conf
   set -g mouse on

4. 계속된다면 tmux 밖의 별도 터미널 탭에서 Claude Code를 실행하세요.

iTerm2의 tmux 통합 모드(tmux -CC)에서는 전체 화면 렌더링을 쓰지 마세요. Anthropic 문서에 따르면 마우스 휠이 동작하지 않고 더블 클릭이 터미널 상태를 망가뜨릴 수 있습니다. iTerm2 안의 일반 tmux는 괜찮습니다.

VS Code 터미널 깜빡임 해결

VS Code 통합 터미널은 Anthropic이 처리량이 제한된다고 꼽은 터미널 중 하나입니다. 주된 해결책은 전체 화면 렌더링입니다. 마우스가 캡처된 상태에서 기본 선택을 하려면 Shift를 누르거나, macOS에서는 terminal.integrated.macOptionClickForcesSelection을 켜고 Option을 누르세요.

Windows Terminal에 남는 텍스트 해결

창 크기를 바꿀 때까지 오래된 조각이 화면에 남는다면, 터미널이 Claude Code의 증분 업데이트를 잘못 합치고 있는 것입니다. Anthropic은 Windows Terminal과 기타 ConPTY 기반 호스트를 꼽습니다. 대신 모든 셀을 다시 그리게 하세요.

$env:CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT = "1"
claude

한 번만 다시 그리려면 Ctrl+L을 누르세요. 대화와 입력 내용은 유지됩니다.

터미널이 아닌 곳에서 세션 따라가기

깜빡임 문제 중 일부는 작은 터미널에서 긴 실행을 지켜보는 데서, 그것도 다른 기기에서 SSH로 보는 경우에 생깁니다. TUI에 입력하기보다 세션을 지켜보는 것이 목적이라면 렌더러를 조정하는 것보다 다른 화면을 쓰는 편이 낫습니다.

터미널 창 대신 휴대폰이나 브라우저에서 Claude Code를 따라가며 지시하고 싶다면, Happier는 Claude Code, Codex 등 여러 에이전트를 휴대폰, 데스크톱, 웹에서 크로스 디바이스로 실행하고 오케스트레이션할 수 있는 오픈 소스 앱입니다. 세션을 자체 인터페이스에서 메시지와 도구 호출의 대화 기록으로 보여 주므로 그 기기에서는 터미널 렌더러가 관여하지 않습니다. 실제 Claude TUI가 필요할 때는 Happier의 Claude 통합 터미널 옵션으로 tmux나 zellij 안에서 실행할 수 있습니다. 이 옵션은 직접 켜야 하며 새 세션에 적용됩니다.

설정 방법은 휴대폰에서 Happier 사용하기에 있습니다. Happier는 GitHub에 공개되어 있고, 여기서 다운로드할 수 있으며, Discord도 있습니다.

문제 해결

Cannot switch renderers in this session

Claude Code가 이유를 출력하고 전환하지 않습니다. 화면 낭독기 모드에서는 연결된 백그라운드 세션을 제외하고 항상 기존 렌더러를 사용합니다. 이유가 허용한다면 CLAUDE_CODE_NO_FLICKER=1로 새 세션을 시작하세요.

전체 화면 렌더러가 시작을 마치지 못했다는 경고

Claude Code는 전체 화면 시작 실패를 세고 기존 렌더러로 돌아갑니다. 시작에 실패한 뒤에도 CLAUDE_CODE_NO_FLICKER는 따르지만 저장된 설정은 따르지 않습니다. Claude Code와 터미널을 업데이트한 뒤 /tui fullscreen을 다시 시도하세요.

복사와 붙여넣기가 안 됨

전체 화면은 마우스를 캡처합니다. 터미널의 선택 키(iTerm2는 Option, Terminal.app은 Fn, 대부분의 다른 터미널은 Shift)를 누른 채로 선택하거나 CLAUDE_CODE_DISABLE_MOUSE=1을 설정하세요.

자주 묻는 질문

Claude Code는 왜 깜빡이나요?

기존 렌더러는 출력이 흘러나올 때 화면의 큰 부분을 다시 그립니다. 그리기가 느리거나 부분 업데이트를 적용하는 터미널에서는 이것이 깜빡임이나 튐으로 보입니다.

전체 화면 모드가 Claude의 동작을 바꾸나요?

아니요. CLI의 그리기 방식만 바뀝니다. 모델, 권한, 도구는 같습니다.

전체 화면 렌더링이 메모리를 덜 쓰나요?

Anthropic 문서에 따르면 보이는 메시지만 렌더 트리에 유지하므로 대화 길이와 관계없이 메모리가 일정하게 유지됩니다.

관련 가이드

• Herdr(및 tmux/zellij)에서 Claude Code나 Codex를 실행하고 휴대폰으로 이어가기
• Claude Code 세션을 터미널에서 휴대폰으로 옮기는 방법
• 휴대폰으로 Claude Code 모니터링하는 방법
• SSH로 원격 서버에서 Claude Code에 로그인하는 방법