Cmd. /tui

터미널 UI 렌더러(기본/fullscreen)를 전환하고 같은 대화를 유지한 채 다시 시작하는 명령

핵심 요약

/tui [default|fullscreen]은 터미널 UI 렌더러를 전환하며, 현재 대화를 유지한 채 CLI를 다시 시작합니다.
fullscreen은 flicker-free alt-screen 렌더러로 깜빡임 제거·일정한 메모리·마우스 지원을 더하고, default는 스크롤백을 살리는 클래식 렌더러입니다.
/tui 설정과 CLAUDE_CODE_NO_FLICKER 환경 변수는 동등하며, 명령은 v2.1.110에서 도입됐습니다.
fullscreen에서는 Cmd+f·tmux 검색이 대화를 못 보므로 Ctrl+o transcript 모드로 검색하고, iTerm2 tmux -CC와는 호환되지 않습니다.

명령어 원본 선언

/tui [default|fullscreen]

공식 설명 요약

/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처럼 터미널의 그리기 표면을 점유한다는 의미입니다. 창 크기와 무관하게 동작합니다.

최소 지원 버전

/tui 명령과 tui 설정: v2.1.110에서 도입 ("Added /tui command and tui setting").
fullscreen 렌더링 자체(research preview): v2.1.89 이상 필요.
v2.1.110 이전 버전에서는 /tui 대신 환경 변수로 켰습니다: CLAUDE_CODE_NO_FLICKER=1.

공식 Commands 레퍼런스의 /tui 항목에는 별도의 최소 버전 주석이 표기되어 있지 않습니다. 위 버전은 전용 fullscreen 문서와 v2.1.110 릴리스 노트를 근거로 합니다.

사용법

# 현재 활성 렌더러 확인
/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`	렌더러·마우스 관련 설정 점검	영구 설정 관리가 목적

활용 사례

기본 렌더러에서 tearing이나 깜빡임이 보일 때 fullscreen으로 전환
긴 대화에서 메모리 사용량을 일정하게 유지하고 싶을 때 fullscreen 사용 (보이는 메시지만 렌더 트리에 유지)
원격(SSH) 세션과 로컬 세션의 렌더링 동작 차이 비교
fullscreen에서 입력창을 화면 하단에 고정해두고 작업 진행 중에도 프롬프트 위치를 유지

주의사항

렌더러 전환 과정에서 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로 신고할 수 있습니다.

출처

Commands: https://code.claude.com/docs/en/commands
Fullscreen rendering: https://code.claude.com/docs/en/fullscreen
Release v2.1.110: https://github.com/anthropics/claude-code/releases/tag/v2.1.110

핵심 요약

/tui [default|fullscreen]은 터미널 UI 렌더러를 전환하며, 현재 대화를 유지한 채 CLI를 다시 시작합니다.
fullscreen은 flicker-free alt-screen 렌더러로 깜빡임 제거·일정한 메모리·마우스 지원을 더하고, default는 스크롤백을 살리는 클래식 렌더러입니다.
/tui 설정과 CLAUDE_CODE_NO_FLICKER 환경 변수는 동등하며, 명령은 v2.1.110에서 도입됐습니다.
fullscreen에서는 Cmd+f·tmux 검색이 대화를 못 보므로 Ctrl+o transcript 모드로 검색하고, iTerm2 tmux -CC와는 호환되지 않습니다.

명령어 원본 선언

/tui [default|fullscreen]

공식 설명 요약

/tui는 터미널 UI 렌더러를 설정하고, 현재 대화를 유지한 채 선택한 렌더러로 CLI를 다시 시작하는 명령입니다.

/tui fullscreen — flicker-free alt-screen(대체 화면 버퍼) 렌더러를 켭니다. vim이나 htop처럼 터미널의 대체 화면 버퍼에 인터페이스를 그리며, 현재 보이는 메시지만 렌더링합니다. 깜빡임이 사라지고, 긴 대화에서도 메모리 사용량이 일정하게 유지되며, 마우스 지원이 추가됩니다.
/tui default — 기본(클래식) 렌더러로 되돌립니다. 클래식 렌더러는 대화를 터미널의 기본 스크롤백에 남겨 Cmd+f나 tmux copy 모드가 평소대로 동작합니다.
인자를 생략하면 현재 활성 렌더러를 출력합니다.

여기서 말하는 "fullscreen"은 터미널 창을 최대화한다는 뜻이 아니라, vim처럼 터미널의 그리기 표면을 점유한다는 의미입니다. 창 크기와 무관하게 동작합니다.

최소 지원 버전

/tui 명령과 tui 설정: v2.1.110에서 도입 ("Added /tui command and tui setting").
fullscreen 렌더링 자체(research preview): v2.1.89 이상 필요.
v2.1.110 이전 버전에서는 /tui 대신 환경 변수로 켰습니다: CLAUDE_CODE_NO_FLICKER=1.

공식 Commands 레퍼런스의 /tui 항목에는 별도의 최소 버전 주석이 표기되어 있지 않습니다. 위 버전은 전용 fullscreen 문서와 v2.1.110 릴리스 노트를 근거로 합니다.

사용법

# 현재 활성 렌더러 확인
/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`	렌더러·마우스 관련 설정 점검	영구 설정 관리가 목적

활용 사례

기본 렌더러에서 tearing이나 깜빡임이 보일 때 fullscreen으로 전환
긴 대화에서 메모리 사용량을 일정하게 유지하고 싶을 때 fullscreen 사용 (보이는 메시지만 렌더 트리에 유지)
원격(SSH) 세션과 로컬 세션의 렌더링 동작 차이 비교
fullscreen에서 입력창을 화면 하단에 고정해두고 작업 진행 중에도 프롬프트 위치를 유지

주의사항

렌더러 전환 과정에서 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로 신고할 수 있습니다.

출처

Commands: https://code.claude.com/docs/en/commands
Fullscreen rendering: https://code.claude.com/docs/en/fullscreen
Release v2.1.110: https://github.com/anthropics/claude-code/releases/tag/v2.1.110

명령어 원본 선언

공식 설명 요약

최소 지원 버전

사용법

좋은 사용 예

비슷한 명령어 추천

활용 사례

주의사항

출처

목차

Cmd. /tui

명령어 원본 선언

공식 설명 요약

최소 지원 버전

사용법

좋은 사용 예

비슷한 명령어 추천

활용 사례

주의사항

출처

목차