Fullscreen 렌더링 (research preview)
기준일: 2026-07-26
공식 기준: Fullscreen rendering
개요
Fullscreen 렌더링은 opt-in research preview입니다. 대화에서 /tui fullscreen으로 전환합니다. 피드백에 따라 동작이 바뀔 수 있습니다.
CLI 대체 렌더 경로로 깜빡임을 줄이고, 긴 대화에서 메모리 사용을 평탄하게 유지하며 마우스 지원을 추가합니다. vim/htop처럼 터미널 alternate screen buffer에 그리고, 현재 보이는 메시지만 렌더해 업데이트당 터미널 전송량을 줄입니다.
VS Code 통합 터미널, tmux, iTerm2처럼 렌더 처리량이 병목인 환경에서 효과가 큽니다. 작업 중 스크롤이 맨 위로 튀거나 도구 출력이 깜빡이면 이 모드가 그 문제를 다룹니다.
이름은 터미널 그리기 표면을 점유하는 방식(vim과 유사)을 뜻하며, 창 최대화와 무관하고 모든 창 크기에서 동작합니다.
핵심 개념
| 항목 | 내용 |
|---|---|
| 전환 | /tui fullscreen (설정 저장 후 재기동, 대화 유지) / /tui default 복귀 / /tui 현재 렌더러 |
| env | CLAUDE_CODE_NO_FLICKER=1 동등. /tui는 재기동 프로세스에서 이 env를 지워 설정 우선 |
| 스크린 리더 | classic 강제 (attached background 세션 제외) |
| 입력 박스 | 화면 하단 고정 → 안 움직이면 fullscreen 활성 |
| 마우스 끄기 | CLAUDE_CODE_DISABLE_MOUSE=1 (렌더·플랫 메모리는 유지) |
상세
활성화
/tui fullscreen — tui 설정 저장 후 fullscreen으로 재기동. mid-session 전환 가능. screen reader mode에서는 classic만 (attached background sessions 제외). 그 외 세션에서 /tui fullscreen은 설명만 출력하고 설정을 바꾸지 않음.
재기동 세션은 화면 대화 유지. 이전에 /rewind했다면 디스크 긴 transcript가 아니라 rewound 지점에서 재개. v2.1.207 이전은 rewind 후 렌더러 전환이 rewind로 제거된 대화를 복원할 수 있었음.
CLAUDE_CODE_NO_FLICKER=1 claude
무엇이 바뀌는가
| 이전 | 지금 |
|---|---|
| Cmd+f / tmux 검색 | Ctrl+o transcript 모드 후 / 검색 또는 [ scrollback 기록 |
| 네이티브 클릭-드래그 선택 | 앱 내 선택, 마우스 떼면 자동 복사 |
| Cmd-click URL | macOS Cmd-click, 그 외 Ctrl-click |
마우스
- 프롬프트 클릭으로 커서 위치
/·@제안 클릭 수락- 선택 메뉴 옵션 클릭 (v2.1.187+). multi-select·Other 행 포커스 (v2.1.208+)
- 접힌 도구 결과 클릭 펼침/접기
- Cmd/Ctrl+클릭으로 URL·파일 경로 열기 (v2.1.181+ plain click은 링크 미개방; Ghostty·Warp v2.1.198+ 예외; VS Code xterm.js는 터미널 핸들러)
- 클릭-드래그 선택, 더블클릭 단어/URL(v2.1.198+), 트리플클릭 줄
- 휠 스크롤
Copy on select: /config 토글. off면 Ctrl+Shift+c (kitty 프로토콜 터미널은 Cmd+c). 선택 활성 시 Ctrl+c는 복사. Shift+화살표로 키보드 확장.
스크롤
| 단축키 | 동작 |
|---|---|
| PgUp/PgDn | 반 화면 |
| Ctrl+Home | 대화 시작 |
| Ctrl+End | 최신 + auto-follow 재개 |
| 휠 | 수 줄 |
MacBook: Fn+화살표. Ctrl+End가 안 닿으면 Jump to bottom 버튼, 휠로 하단, 또는 scroll:bottom 리바인드. Scroll actions.
Auto-follow: 위로 스크롤하면 일시 정지. Jump to bottom + 새 메시지 수. /config Auto-scroll off로 완전 비활성(권한 프롬프트 등은 여전히 스크롤 인).
휠 속도: CLAUDE_CODE_SCROLL_SPEED (양수 ≤20, 소수 가능). /scroll-speed 대화형 (최대 10 저장). JetBrains IDE 터미널에서는 명령 미제공. 가속 off: wheelScrollAccelerationEnabled: false (v2.1.174+).
JetBrains: 자체 스크롤 처리, CLAUDE_CODE_SCROLL_SPEED 무시. 2025.2 휠 버그는 런타임 완화, 2025.3+ 권장.
검색·검토
Ctrl+o — 일반 프롬프트 ↔ transcript 모드. /focus — 마지막 프롬프트·도구 한 줄·최종 응답만 (세션 간 유지).
Transcript: / 검색, n/N, j/k, g/G, {/}, Ctrl+u/d, Ctrl+b/f, Esc/q 종료. [ — 전체 대화를 네이티브 scrollback에 기록. v — $VISUAL/$EDITOR로 임시 파일.
대화 지우기
2초 내 Ctrl+L 두 번 → /clear. macOS Cmd+K 더블도 동일.
tmux
set -g mouse on 필요. iTerm2 tmux -CC와 비호환. tmux 3.6 계열은 synchronized output 없어 깜빡임 가능 → 최신 tmux 또는 tmux 밖 탭.
네이티브 선택 유지
마우스 캡처 시 터미널 네이티브 copy-on-select 중단. Claude Code가 시스템 클립보드에 씀 (macOS pbcopy, Linux wl-copy/xclip/xsel, Windows/WSL PowerShell, tmux paste buffer, SSH OSC 52). iTerm2 OSC 52 기본 차단 → Settings 또는 /terminal-setup.
일회성 네이티브 선택 홀드 키: Terminal.app Fn, iTerm2 Option, VS Code/Cursor Shift(또는 macOS Option+설정), 대부분 Shift.
CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude
클릭만 끄고 휠 유지: CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1 (v2.1.195+). DISABLE_MOUSE가 둘 다 있으면 우선.
트러블슈팅: 잔상·어긋난 텍스트
Windows Terminal 등 ConPTY가 증분 쓰기를 잘못 합칠 때:
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 claude
Windows 백그라운드·agent view는 이미 자동 full repaint.
Research preview
문제 시 /feedback 또는 GitHub issues. 끄기: /tui default 또는 env 해제. /tui default 시 선택 피드백 프롬프트. 강제 classic: CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1. agent view/claude attach 백그라운드 세션은 항상 fullscreen.
체크리스트
-
/tui fullscreen또는CLAUDE_CODE_NO_FLICKER=1로 켰다 - 입력 박스가 하단 고정인지 확인했다
- tmux면 mouse on,
-CC모드를 피했다 - 네이티브 선택이 필요하면 Shift 계열 키 또는 DISABLE_MOUSE를 썼다
- 잔상 시 FULL_REPAINT를 시도했다
다음 단계
기준일
- 문서 작성·동기화 기준일: 2026-07-26
- 원문: https://code.claude.com/docs/en/fullscreen