긴 작업을 시키면 화면이 자꾸 깜빡였다.
VS Code 통합 터미널에서 특히 심했다. Claude가 도구 출력을 스트리밍할 때마다 입력창이 위로 밀려 올라가고, 가끔은 스크롤 위치가 갑자기 상단으로 튀었다. 작업 중인데 화면이 어지러우니 집중이 깨졌다.
해결 방법이 있었다. /tui fullscreen 한 줄.
뭐가 달라지나
기본 모드는 터미널의 scrollback 영역(평범한 로그가 쌓이는 곳)에 그린다. Fullscreen 모드는 alt-screen buffer(vim이나 htop이 쓰는 영역)에 그린다.
| 기본 모드 | Fullscreen 모드 |
|---|---|
| 출력이 스트리밍되며 입력창이 밀려 올라감 | 입력창이 화면 하단 고정 |
| 재렌더링 시 깜빡임 | 깜빡임 제거 |
| 긴 대화 = 메모리 증가 | 보이는 메시지만 렌더 → 메모리 일정 |
| 마우스는 터미널이 처리 | Claude Code가 직접 처리 (클릭으로 도구 결과 펼치기 등) |
VS Code 통합 터미널·tmux·iTerm2처럼 렌더링 처리량이 병목인 환경에서 효과가 가장 크다.
전환은 한 줄
/tui fullscreen대화는 유지된 채로 relaunch된다. 세션 중간에 쳐도 컨텍스트가 안 날아간다.
현재 모드 확인:
/tui원상 복귀:
/tui default세 줄이면 끝이다. 안 맞으면 바로 되돌릴 수 있어서 시도 부담이 없다.
/focus — 보너스 기능
Fullscreen 모드 전용 서브 기능이다.
/focus치면 조용한 뷰로 전환된다. 마지막 프롬프트 1개 + 한 줄짜리 도구 호출 요약(diffstat 포함) + 최종 응답만 보인다. 중간 도구 호출 노이즈는 다 가려진다.
긴 작업 끝나고 회고할 때 좋다. "내가 뭘 시켰지" → /focus → 한눈에 정리된 화면. /focus 한 번 더 치면 꺼진다.
설정은 세션 간 유지된다. 한 번 켜놓으면 계속 그 뷰.
알아둘 것
버전
Claude Code v2.1.89 이상에서 동작한다. claude --version으로 먼저 확인.
tmux 안에서
tmux 안에서도 동작한다. 단 마우스 모드를 켜둬야 한다. ~/.tmux.conf에:
set -g mouse on추가하고 설정 재로드. 안 그러면 마우스 휠이 tmux로 가서 Claude Code가 못 받는다. 키보드 PgUp·PgDn은 그대로 동작한다.
iTerm2 tmux integration mode 비호환
tmux -CC # ❌iTerm2의 tmux -CC 모드는 alt-screen buffer·마우스 추적이 정상 동작 안 한다. 일반 tmux는 iTerm2 안에서도 잘 된다.
MacBook 키보드
전용 PgUp·PgDn·Home·End 키 없는 MacBook은 Fn과 조합:
| MacBook | 대응 |
|---|---|
Fn+↑ | PgUp |
Fn+↓ | PgDn |
Fn+← | Home |
Fn+→ | End |
어색하면 마우스 휠로 끝까지 스크롤해도 auto-follow가 재개된다.
마우스 캡처가 부담스러우면
Fullscreen 모드는 마우스를 Claude Code가 직접 처리한다. SSH·tmux 사용자는 이게 마찰점일 수 있다(터미널 native 선택이 막힘).
깜빡임 제거·메모리 일정만 유지하고 마우스는 터미널이 처리하게 하려면:
CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude키보드 스크롤(PgUp, PgDn, Ctrl+Home, Ctrl+End)은 그대로 쓸 수 있다.
써본 인상
옵트인 모드라 부담 없이 시도할 수 있다. 한 줄 쳐보고 안 맞으면 한 줄로 복귀. 이 구조가 좋았다.
VS Code 통합 터미널에서 작업할 때 깜빡임이 신경 쓰였다면 한 번 켜볼 만하다. 긴 대화·메모리 이슈가 있는 세션에서도 효과가 명확하다.
/focus 까지 같이 켜면 회고 화면이 정리돼서 "오늘 뭐 했지"가 한눈에 들어온다. 그것만으로도 켜놓을 가치가 있다.
연구 프리뷰 단계라 흔하지 않은 터미널·특이 설정에서는 이슈가 있을 수 있다. 그땐 /feedback 안에서 제보하면 된다.
이 글은 Claude Code 플레이북을 만들면서 배운 것을 비개발자 시점으로 정리한 시리즈입니다.
