Claude Code 답변 완료 오버레이 플러그인 — 기다림 끝, 알림 한 번에

Claude Code 답변 완료 오버레이 플러그인

Claude Code 답변 완료 오버레이 플러그인 — 기다림 끝, 알림 한 번에

Claude Code에 긴 작업을 맡기면 한 가지가 아쉽습니다. 답변이 끝나도 알림이 없습니다. 터미널을 다른 창에 가려두면 알람도 푸시도 없습니다. 결국 다시 돌아와서 "이미 답이 와 있었네"를 반복합니다. Roeniss Moon이 만든 claude-code-done-overlay 플러그인이 이 문제를 풉니다. 답변이 끝나면 화면 전체에 검은 오버레이를 띄웁니다. 사운드 한 번이 합류를 알립니다. 본문은 1500자 이상, 핵심 키워드를 반복해 가독성과 SEO를 함께 잡습니다.

플러그인이 해결하는 문제

CLI 도구는 알림 센터에 푸시가 없습니다. macOS 알림도 자동으로 울리지 않습니다. 사용자는 마우스를 한 번씩 클릭하며 다른 일을 합니다. 작은 단절이 하루에 수십 번 쌓입니다. 이 비용은 결국 흐름의 끊김으로 돌아옵니다. Roeniss Moon은 이 흐름 끊김을 정확히 짚어 풀었습니다.

핵심 기능 한눈에

• 풀스크린 오버레이 알림, 반투명 검은색

• 완료 시 한 번 울리는 차임 사운드

• 키 또는 마우스 클릭으로 즉시 해제

• 중복 호출 방지, 같은 알림이 두 번 뜨지 않음

• macOS 13+, Linux X11 공식 지원

설치는 단 한 줄

별도 환경 설정은 필요 없습니다. 마켓플레이스 명령으로 바로 설치됩니다.

claude plugin marketplace add https://github.com/roeniss/claude-code-done-overlay.gitclaude plugin install claude-code-done-overlay

첫 트리거에서 사전 빌드된 바이너리가 자동 다운로드됩니다. SHA256SUMS 검증도 함께 진행됩니다. 다운로드가 막힌 환경이라도 Rust 툴체인이 있으면 소스에서 빌드합니다.

트리거 조건 두 가지

플러그인은 단순한 응답 종료만 잡지 않습니다. 사용자가 봐야 하는 두 순간을 모두 감지합니다.

1. Stop — 턴이 끝나고 입력 대기

2. AskUserQuestion — 다중 선택지를 띄운 직후

이 두 지점이 "지금 사용자가 봐야 하는 순간"입니다. 일반 텍스트 응답 중에는 절대 오버레이가 뜨지 않습니다.

CLI 옵션으로 미세 조정

환경에 맞춰 동작을 조정할 수 있습니다.

claude-code-done-overlay -m "다시 볼 시간입니다" -t 30

-m은 표시할 메시지입니다. -t는 자동 해제 시간(초)입니다. 생략하면 직접 해제할 때까지 유지됩니다. 발표나 미팅 중에는 짧은 타임아웃이 자연스럽습니다.

직접 테스트하는 방법

설치 직후 가장 빠른 검증은 notify 스크립트를 직접 실행하는 것입니다.

bash ~/.claude/plugins/cache/claude-code-done-overlay/claude-code-done-overlay/*/scripts/notify.sh

화면 전체가 검은색으로 덮입니다. 가운데 "Claude Code" 타이틀이 뜹니다. 차임이 한 번 울립니다. 아무 키나 누르면 사라집니다. 이게 안 되면 데스크톱 GUI 세션이 있는 환경인지부터 확인합니다.

플랫폼 호환성 정리

모든 환경이 같은 수준은 아닙니다. 미리 알아두면 도입 판단이 빨라집니다.

• macOS 13+ — 유니버설 바이너리로 완전 지원

• Linux X11 — 정상 동작

• Linux Wayland — 최선의 노력, 일부 컴포지터에서 불안정

• WSL, SSH, Windows, 헤드리스 — 의도적으로 비지원

풀스크린 오버레이는 GUI 세션이 필수입니다. 원격 서버에서 Claude Code를 쓴다면 다른 알림 수단을 찾는 편이 맞습니다.

결론과 마무리: 워크플로의 작은 도약

오버레이 하나가 워크플로를 바꾸진 않습니다. 다만 "잠시 딴 일을 해도 다시 돌아올 신호는 분명하다"는 확신을 줍니다. 그 확신이 쌓이면 컨텍스트 스위칭 비용이 줄어듭니다. 깊은 작업에 더 오래 머물 수 있습니다. Claude Code를 진지하게 쓰는 개발자라면, 5분짜리 설치로 충분히 가치 있는 변화입니다.

요약: 핵심 정리

• Claude Code 응답 종료와 다중 선택지 질문 시점에 풀스크린 오버레이

• 설치는 마켓플레이스 add + install 두 줄

• macOS 13+와 Linux X11에서 가장 안정적

• CLI 옵션으로 메시지·자동 해제 시간 조정 가능

• 중복 알림 방지, 키 한 번으로 해제