# Claude Code, 깜빡임 없는 NO_FLICKER 모드 공개

> Clean Markdown view of GeekNews topic #28108. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=28108](https://news.hada.io/topic?id=28108)
- GeekNews Markdown: [https://news.hada.io/topic/28108.md](https://news.hada.io/topic/28108.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2026-04-02T10:37:02+09:00
- Updated: 2026-04-02T10:37:02+09:00
- Original source: [x.com/bcherny](https://x.com/bcherny/status/2039421575422980329)
- Points: 10
- Comments: 6

## Summary

Claude Code 사용 시 화면이 **깜빡이고 점프하는 문제**를 해결하는 실험적 풀스크린 렌더러가 공개되었습니다. `CLAUDE_CODE_NO_FLICKER=1`로 활성화하면 입력창이 **하단에 고정**되고, 대화가 길어져도 **메모리·CPU 사용량이 안정적**으로 유지됩니다. 터미널에서 **마우스 클릭이나 텍스트 드래그**까지 되는 건 꽤 신선한데요. 아직 네이티브 검색이나 복사-붙여넣기에 제약이 있는 실험 단계이긴 하지만, Claude Code를 장시간 쓰는 분이라면 체감 차이가 클 겁니다. 바로 써보시길 추천합니다.

## Topic Body

- 기존 렌더러의 화면 **깜박임·점프 현상을 해소**하는 실험적 렌더러 도입  
- 대화가 길어져도 **메모리·CPU 사용량이 일정**하게 유지되며, 터미널 환경에서 **마우스 클릭·커서 이동·UI 요소 클릭이 가능**해짐  
- `CLAUDE_CODE_NO_FLICKER=1` 환경변수로 활성화  
- 기존 터미널 ANSI 코드의 구조적 한계로 뷰포트 밖 행을 다시 그리려면 **전체 화면 지우기** 코드를 써야 했으나, 새 렌더러는 뷰포트 전체를 가상화해 이 문제를 해결  
- native cmd-f 검색·복사-붙여넣기 미지원, 스크롤 물리 조정 미완성 등 **트레이드오프**가 남아 있어 실험적 단계임  
- 대화 내용이 스크롤백이 아닌 대체 화면 버퍼에 존재하므로 `Ctrl+O`로 Transcript 모드 진입 후 **less 스타일 검색**(/, n/N) 사용 가능  
- 입력창은 출력이 스트리밍되는 동안에도 **화면 하단에 고정**됨  
- 마우스로 커서 위치 조정·툴 결과 확장·URL/파일 경로 열기·텍스트 드래그 선택 등 **인앱 마우스 이벤트 처리** 지원  
  
상세 내용은 [클로드 코드 문서의 Fullscreen rendering](https://code.claude.com/docs/en/fullscreen) 참고(아래 첨부)  
  
### 풀스크린 렌더링   
  
- **`CLAUDE_CODE_NO_FLICKER=1`** 환경변수를 설정해 실행하거나, `~/.zshrc` / `~/.bashrc`에 `export CLAUDE_CODE_NO_FLICKER=1`을 추가하면 모든 세션에 자동 적용  
- Claude Code **v2.1.88 이상** 필요, 현재 리서치 프리뷰 단계로 피드백에 따라 동작이 변경될 수 있음  
- "풀스크린"이라는 명칭은 터미널 창의 최대화와 무관하며, 어떤 창 크기에서도 작동  
  
### 기존 방식 대비 변경 사항  
  
- 입력창이 출력이 스트리밍되는 동안에도 **화면 하단에 고정**됨 (입력창이 고정되어 있으면 풀스크린 렌더링 활성화 상태)  
- 대화 내용이 대체 화면 버퍼에 존재하므로 기존과 달라진 점:  
  
| 기존 | 변경 후 |  
|------|---------|  
| `Cmd+F` 또는 tmux 검색으로 텍스트 탐색 | `Ctrl+O` 후 `/`로 검색, 또는 `[`로 네이티브 스크롤백에 쓴 후 `Cmd+F` 사용 |  
| 터미널 네이티브 드래그로 선택·복사 | 인앱 선택, 마우스 버튼 놓으면 자동 복사 |  
| `Cmd`-클릭으로 URL 열기 | URL 클릭으로 열기 |  
  
### 마우스 지원  
  
- **프롬프트 입력창 클릭**: 텍스트 어디서든 커서 위치 지정  
- **접힌 툴 결과 클릭**: 펼치거나 접기 (툴 호출과 결과가 함께 확장)  
- **URL·파일 경로 클릭**: 파일은 기본 앱으로 열리고, `http://`/`https://` URL은 브라우저로 열림  
  - VS Code 내장 터미널 등 xterm.js 기반 터미널에서는 링크를 두 번 열지 않도록 터미널 자체 링크 핸들러에 위임  
- **클릭 앤 드래그**: 텍스트 선택 (더블클릭: 단어 선택, 트리플클릭: 줄 선택)  
- **마우스 휠**: 대화 스크롤  
- 마우스 버튼을 놓으면 선택 텍스트가 클립보드에 자동 복사; `/config`에서 비활성화 가능  
  
### 스크롤 단축키  
  
| 단축키 | 동작 |  
|--------|------|  
| `PgUp` / `PgDn` | 반 화면씩 위/아래 스크롤 |  
| `Ctrl+Home` | 대화 맨 위로 이동 |  
| `Ctrl+End` | 최신 메시지로 이동 및 자동 따라가기 재활성화 |  
| 마우스 휠 | 몇 줄씩 스크롤 |  
  
- MacBook처럼 전용 키가 없는 키보드는 `Fn+↑/↓/←/→`으로 PgUp/PgDn/Home/End 대체  
- 위로 스크롤 시 **자동 따라가기(auto-follow)** 일시 중지; `Ctrl+End` 또는 맨 아래로 스크롤하면 재개  
- 단축키는 `scroll:pageUp`, `scroll:pageDown` 등의 액션명으로 **키바인딩 커스터마이징** 가능 (Keybindings 문서 참조)  
- **`CLAUDE_CODE_SCROLL_SPEED`** 환경변수로 마우스 휠 스크롤 속도 배율 조정 가능 (1~20, 기본 vim 기준 3 권장)  
  
### 대화 검색·검토 (트랜스크립트 모드)  
  
- `Ctrl+O`로 트랜스크립트 모드 진입 시 `less` 스타일 탐색 및 검색 사용 가능  
  
| 키 | 동작 |  
|----|------|  
| `/` | 검색 열기 (Enter: 확인, Esc: 취소) |  
| `n` / `N` | 다음/이전 검색 결과 이동 |  
| `j`/`k` 또는 `↑`/`↓` | 한 줄 스크롤 |  
| `g`/`G` 또는 Home/End | 맨 위/아래로 이동 |  
| `Ctrl+U` / `Ctrl+D` | 반 페이지 스크롤 |  
| `[` | 전체 대화를 터미널 네이티브 스크롤백에 기록 (`Cmd+F` 사용 가능) |  
| `v` | 임시 파일로 저장 후 `$VISUAL`/`$EDITOR`로 열기 |  
| `Esc`, `q`, `Ctrl+O` | 트랜스크립트 모드 종료 |  
  
### tmux 사용 시 주의사항  
  
- tmux에서 마우스 휠 스크롤을 사용하려면 `~/.tmux.conf`에 **`set -g mouse on`** 추가 필요  
  - 마우스 모드 없이는 휠 이벤트가 tmux로 전달됨; `PgUp`/`PgDn` 키보드 스크롤은 정상 작동  
  - tmux 마우스 모드가 꺼진 상태에서 시작 시 Claude Code가 일회성 안내 메시지 출력  
- **`tmux -CC` (iTerm2 통합 모드)** 와는 호환되지 않음  
  - 이 모드에서는 대체 화면 버퍼와 마우스 추적이 올바르게 작동하지 않으며, 더블클릭 시 터미널 상태 손상 가능  
  - `-CC` 없이 iTerm2 내에서 일반 tmux 사용은 정상 작동  
  
### 네이티브 텍스트 선택 유지 방법  
  
- 마우스 캡처가 불편한 경우 **`CLAUDE_CODE_DISABLE_MOUSE=1`** 을 추가로 설정하면 마우스 캡처 없이 깜빡임 방지·일정 메모리 유지만 활성화  
  ```  
  CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude  
  ```  
- 마우스 캡처 비활성화 시 키보드 스크롤(`PgUp`, `PgDn`, `Ctrl+Home`, `Ctrl+End`)은 유지되나, 클릭으로 커서 위치 지정·툴 결과 확장·URL 클릭·휠 스크롤은 비활성화  
- SSH 환경이나 tmux 내부에서 마우스 캡처 시 클립보드 경로가 달라지며, Claude Code는 복사 후 어떤 경로를 사용했는지 토스트로 알려줌  
  
### 리서치 프리뷰 및 피드백  
  
- 주요 터미널 에뮬레이터에서 테스트되었으나, 비일반적인 터미널이나 특이한 설정에서는 렌더링 문제가 발생할 수 있음  
- 문제 발생 시 Claude Code 내에서 **`/feedback`** 명령어 실행 또는 [claude-code GitHub 리포](https://github.com/anthropics/claude-code/issues)에 이슈 등록 (터미널 에뮬레이터 이름·버전 포함 필요)  
- 비활성화하려면 환경변수를 해제하거나 **`CLAUDE_CODE_NO_FLICKER=0`** 으로 설정

## Comments



### Comment 54614

- Author: neocode24
- Created: 2026-04-04T07:22:52+09:00
- Points: 1

iterm -CC 사용으로 통합모드로 쓰는데요.. 이상한걸 잘 모르겠던데요...  
오히려, 얼마전부터 랜더링 중에 스크롤하면, 최상단 강제 점프 되는 현상 때문에 불편했는데, 위치가 멈춰서면서 new message 알림으로 바뀌니 맘에 들어요. 좋네요..

### Comment 54557

- Author: sm0514sm
- Created: 2026-04-03T13:16:49+09:00
- Points: 1

이거 하니까 shift + enter로 줄바꿈이 안되는거 같아요 ㅠ

### Comment 54505

- Author: @deleted_gndfr0dev
- Created: 2026-04-03T07:38:46+09:00
- Points: 1

약간 opencode 느낌으로 바뀌고있네요

### Comment 54473

- Author: tested
- Created: 2026-04-02T20:29:03+09:00
- Points: 1

TUI가 GUI로

### Comment 54447

- Author: kimjoin2
- Created: 2026-04-02T15:58:57+09:00
- Points: 1

이런 변경 좋아요~

### Comment 54424

- Author: byforce
- Created: 2026-04-02T11:20:04+09:00
- Points: 1

아직은 조금더 다듬어야 할것 같아요.  
커서를 두고, 마우스로 다른곳을 선택 하면 자동 복사가 되고, 붙여넣기 하면 커서가 있던 곳에 붙여넣기가 되야 하는데.  
마우스로 선택한 곳에 붙여넣네요.