Cmd. /tui
터미널 UI 렌더러(기본/fullscreen)를 전환하고 같은 대화를 유지한 채 다시 시작하는 명령
핵심 요약
- TUI renderer 전환 후 대화 유지
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
TUI renderer 전환 후 대화 유지
/tui [default|fullscreen]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/tui fullscreen# 현재 활성 렌더러 확인
/tui# flicker-free alt-screen 렌더러 켜기
/tui fullscreen# 기본(클래식) 렌더러로 되돌리기
/tui default# 명령 대신 환경 변수로 fullscreen 시작 (v2.1.110 이전 호환 경로)
CLAUDE_CODE_NO_FLICKER=1 claude선택 시점
- 현재 렌더러가 깜빡이거나 스크롤이 맨 위로 튈 때
/tui fullscreen으로 전환 - VS Code 통합 터미널, tmux, iTerm2처럼 렌더링 처리량이 병목인 환경에서 안정적인 alt-screen 경로 시험
- 데모 직전 렌더링을 더 깔끔한 모드로 맞추기
- 인자 없이 실행해 지금 어떤 렌더러가 활성인지 확인
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/tui | 렌더러(기본/fullscreen) 전환 | 화면 렌더링 품질이 목적 |
/focus | 같은 렌더러 안에서 뷰를 조용하게 축소 | 노이즈 감소가 목적 |
/scroll-speed | 마우스 휠 스크롤 속도 조정 | fullscreen 스크롤 미세조정 |
/config | 렌더러·마우스 관련 설정 점검 | 영구 설정 관리가 목적 |
실행 결과와 유지 범위
대화를 유지한 채 선택한 터미널 렌더러로 다시 실행합니다.
/tui는 터미널 UI 렌더러를 설정하고, 현재 대화를 유지한 채 선택한 렌더러로 CLI를 다시 시작하는 명령입니다.
/tui fullscreen— flicker-free alt-screen(대체 화면 버퍼) 렌더러를 켭니다.vim이나htop처럼 터미널의 대체 화면 버퍼에 인터페이스를 그리며, 현재 보이는 메시지만 렌더링합니다. 깜빡임이 사라지고, 긴 대화에서도 메모리 사용량이 일정하게 유지되며, 마우스 지원이 추가됩니다./tui default— 기본(클래식) 렌더러로 되돌립니다. 클래식 렌더러는 대화를 터미널의 기본 스크롤백에 남겨Cmd+f나 tmux copy 모드가 평소대로 동작합니다.- 인자를 생략하면 현재 활성 렌더러를 출력합니다.
/tui는 tui 설정값을 저장한 뒤 그 렌더러로 다시 시작합니다. 세션 중간에 컨텍스트를 잃지 않고 전환할 수 있습니다. tui 설정과 CLAUDE_CODE_NO_FLICKER 환경 변수는 동등합니다(설정 파일: ~/.claude/settings.json).
여기서 말하는 "fullscreen"은 터미널 창을 최대화한다는 뜻이 아니라,
vim처럼 터미널의 그리기 표면을 점유한다는 의미입니다. 창 크기와 무관하게 동작합니다.
주의사항
- 렌더러 전환 과정에서 CLI가 재시작되므로, 터미널/멀티플렉서와의 호환성을 함께 봐야 합니다.
/tui명령은 다시 시작되는 프로세스에서CLAUDE_CODE_NO_FLICKER를 비워, 명령이 기록한tui설정이 적용되도록 합니다.- fullscreen에서는 대화가 대체 화면 버퍼에 있어 터미널의
Cmd+f나 tmux 검색으로는 대화를 찾을 수 없습니다.Ctrl+o로 transcript 모드에 들어간 뒤/로 검색하거나[로 스크롤백에 기록할 수 있습니다. - tmux에서 마우스 휠 스크롤을 쓰려면
~/.tmux.conf에set -g mouse on이 필요합니다. - fullscreen은 iTerm2의 tmux 통합 모드(
tmux -CC)와 호환되지 않습니다. 일반 tmux는 정상 동작합니다. - 마우스 캡처가 native 텍스트 선택을 막는 게 불편하면, flicker-free 렌더링은 유지하면서
CLAUDE_CODE_DISABLE_MOUSE=1로 마우스 캡처만 끌 수 있습니다. - 저장된
tui설정과 무관하게 강제로 클래식 렌더러를 쓰려면CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1을 설정합니다. - fullscreen 렌더링은 아직 research preview입니다. 흔하지 않은 터미널에서는 렌더링 문제가 있을 수 있으며,
/feedback로 신고할 수 있습니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록