Claude Code mouse clicks 비활성화: fullscreen 선택 충돌을 줄이는 법 | DAKER 커뮤니티
Claude Code mouse clicks 비활성화: fullscreen 선택 충돌을 줄이는 법
Claude Code mouse clicks 비활성화란, fullscreen rendering에서 클릭·드래그·호버만 끄고 마우스 휠 스크롤은 유지하는 설정입니다. 2026년 6월 26일 공개된 Claude Code v2.1.195 기준으로 긴 터미널 세션에서 복사 선택이 자주 꼬이는 팀은 이 설정을 먼저 시험할 가치가 있습니다.
클로드 코드 디렉터리용 Claude Code mouse clicks 비활성화 카드: 클릭 캡처는 끄고 휠 스크롤은 유지하는 장면.
문제 상황은 왜 fullscreen에서 더 자주 생기나요?
문제 상황은 복사와 스크롤의 기대가 엇갈릴 때 생깁니다. Claude Code fullscreen rendering은 터미널의 alternate screen buffer를 쓰고, 클릭·드래그·호버를 앱 안에서 처리합니다. 그래서 긴 로그를 읽는 동안 터미널 기본 선택, tmux copy mode, IDE 터미널의 마우스 동작이 팀원마다 다르게 느껴질 수 있습니다.
한 줄 요약: 복사를 자주 하는 팀은 fullscreen을 끄기보다 마우스 클릭 캡처만 먼저 줄이는 편이 낫습니다.
핵심 개념은 무엇인가요?
핵심 개념은 mouse capture를 통째로 끄는 것과 클릭 계열만 끄는 것을 구분하는 것입니다. 기존 문서의 CLAUDE_CODE_DISABLE_MOUSE=1은 mouse capture를 꺼서 휠 스크롤까지 포기합니다. v2.1.195의 CLAUDE_CODE_DISABLE_MOUSE_CLICKS는 클릭, 드래그, 호버만 비활성화하고 wheel scroll은 남기는 선택지입니다.
선택 | 남는 기능 | 잃는 기능 | 적합한 상황 |
|---|---|---|---|
기본 fullscreen | 클릭, 드래그, 휠 모두 Claude Code가 처리 | 터미널 기본 선택과 충돌 가능 | 로컬 터미널에서 앱식 조작 선호 |
| 휠 스크롤 | 클릭 위치 이동, 드래그 선택, 호버 | 로그를 읽고 복사 선택을 자주 함 |
| 키보드 스크롤 | 클릭, 드래그, 휠 | SSH/tmux에서 mouse reporting이 불안정 |
단계별 사용법은 어떻게 적용하나요?
먼저 Claude Code 버전을 v2.1.195 이상으로 맞춥니다.
현재 세션에서
/tui fullscreen을 켜고 복사, 링크 클릭, 휠 스크롤이 어떻게 동작하는지 확인합니다.클릭 선택이 방해되면 셸 시작 스크립트나 팀 런북에
CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1을 추가합니다.wheel scroll이 꼭 필요한지 확인합니다. 필요 없다면
CLAUDE_CODE_DISABLE_MOUSE=1까지 비교합니다.VS Code, Cursor, tmux, iTerm2처럼 팀에서 많이 쓰는 터미널별로 2분짜리 복사 테스트를 기록합니다.
짧은 예시는 어떻게 쓰나요?
팀원이 tmux 안에서 긴 test output을 읽고 복사해야 한다면 fullscreen은 유지하고 클릭 캡처만 끕니다. 이렇게 하면 화면 깜빡임과 긴 세션 메모리 이점은 유지하면서, 마우스 휠로 대화를 넘기고 터미널 선택 충돌은 줄일 수 있습니다.
팀 적용 체크리스트는 무엇인가요?
CLAUDE_CODE_DISABLE_MOUSE_CLICKS는 v2.1.195 기준 새 항목이므로 버전을 먼저 고정한다.터미널 기본 선택 키가 필요한 사람은 OS와 터미널별 보조키를 함께 문서화한다.
tmux에서는 mouse mode와 copy mode가 팀 설정과 충돌하지 않는지 확인한다.
IDE 통합 터미널은
/terminal-setup영향까지 같이 본다.설정을 바꾼 뒤
Ctrl+otranscript mode 검색과 휠 스크롤을 둘 다 확인한다.
Claude Code fullscreen에서 기본 mouse capture, clicks 비활성화, 전체 mouse 비활성화를 비교하는 워크플로 카드.
함께 보면 좋은 DAKER 글은 무엇인가요?
Claude Code Keybindings 글, Claude Code /theme 글, Claude Code 알림 설정 글을 함께 보면 입력 조작, 터미널 가독성, 긴 작업 알림을 한 번에 정리할 수 있습니다.
공식 출처는 어디인가요?
Anthropic Claude Code fullscreen rendering 문서: 2026년 6월 29일 확인
Anthropic Claude Code terminal configuration 문서: 2026년 6월 29일 확인
anthropics/claude-code v2.1.195 릴리스: 2026년 6월 29일 확인
FAQ
CLAUDE_CODE_DISABLE_MOUSE_CLICKS는 fullscreen을 끄는 설정인가요?
아닙니다. fullscreen rendering은 유지하고 클릭, 드래그, 호버 계열의 mouse capture만 끄는 설정으로 이해하면 됩니다.
마우스 휠 스크롤은 계속 되나요?
v2.1.195 릴리스 기준으로 이 설정은 wheel scroll을 유지하는 목적입니다. 휠까지 끄려면 전체 mouse capture 비활성화 설정을 별도로 검토합니다.
모든 팀원이 같은 값을 써야 하나요?
아닙니다. 터미널과 작업 습관 차이가 크므로 프로젝트 기본값보다 개인 셸 설정이나 온보딩 체크리스트에 두는 편이 안전합니다.
언제 기본 fullscreen으로 돌아가야 하나요?
클릭으로 prompt cursor를 옮기거나 접힌 tool output을 자주 펼치는 사람은 기본 mouse capture가 더 편할 수 있습니다.
오늘 긴 Claude Code 세션을 열기 전, 팀에서 가장 많이 쓰는 터미널 하나를 골라 복사 선택과 wheel scroll을 2분만 비교해 보세요.