Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Claude Overlay는 사용자가 현재 보고 있는 화면 전체를 인식하고 대화할 수 있게 해주는 Windows 전용 채팅 인터페이스입니다. 별도의 API 키나 추가 비용 없이 기존 Claude 구독을 사용하여, 열려있는 문서나 슬라이드 덱 등 실제 작업 환경과 상호작용하며 답변합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기<p align="center"><sub><b>Windows 10 / 11</b> 전용 (현재) · 기존 Claude 구독으로 실행 — API 키 불필요</sub></p>앱을 벗어날 필요 없이 Claude Code와 대화하고, 심지어 사용자의 화면을 실제로 볼 수 있게 합니다.
Claude Overlay는 사용자가 하는 모든 활동 위에 떠다니는 프레임리스(frameless), 항상 최상단에 표시되는 채팅 창입니다. 질문을 하면, Claude가 실제 화면—모든 모니터—을 보고 답변합니다. 복사-붙여넣기 오류 메시지나, 무엇을 보고 있는지 설명할 필요도 없고, 브라우저로 alt-tab 할 필요도 없습니다. 그리고 내부적으로 전체 Claude Code 에이전트를 구동하기 때문에, 단순히 채팅만 하는 것이 아니라 사용자를 위해 읽고, 편집하고, 실행할 수 있습니다. 열려 있는 슬라이드 덱, 문서 또는 스프레드시트를 가리키면 현재 보고 있는 파일을 변경할 수 있으며—파일의 위치를 알려주거나 alt-tab 할 필요가 없습니다.
무엇보다도, 추가 비용이 전혀 들지 않습니다: 사용자의 자체 claude CLI 로그인으로 구동되므로, 기존 Claude 구독을 사용하며 — API 키나 측정 청구(metered billing)가 없습니다.
⭐ 작업 화면 위에 떠다니는 화면 인식 Claude가 유용하게 느껴진다면, 이 저장소에 별표를 눌러주세요 — 다른 사람들이 이것을 찾도록 돕습니다.
화면이 이전 메시지 이후로 변경되지 않았다면, 중복 내용은 다시 전송되지 않습니다 (Claude는 이미 가지고 있는 것을 계속 사용하도록 지시받음) — 후속 질문에 대한 답변은 측정 가능하게 더 빠르게 제공됩니다.
CLI와 데스크톱 앱은 이미 터미널이나 채팅 창에 있을 때 완벽합니다. 이 오버레이는 사용자가 무엇을 하든, 그것을 보고, 그리고 그것에 행동함으로써 그 자리를 확보합니다 — 따라서 기존 도구들이 할 수 없는 바로 그 지점에서 빛을 발합니다:
Overlay (Tkinter UI) → claude-agent-sdk → `claude` CLI 실행 → Anthropic
▲ 스크린샷 (Pillow ImageGrab, 모니터당 이미지 1개)
claude-agent-sdk가 설치된 claude CLI를 서브프로세스로 실행하여 상호 작용합니다. 이는 직접적인 API 클라이언트가 아니므로, CLI가 필수입니다.ImageGrab이 각 모니터를 개별적으로 스냅샷 촬영하며, 프롬프트는 어느 화면이 주(primary) 화면인지 보조(secondary) 화면인지를 표시하고, Claude는 이 정보를 그 자체의 Read 도구로 읽습니다. 캡처 중에는 창이 스스로 숨겨집니다.세 가지가 필요합니다. 포함된 **setup.cmd**가 #2와 #3을 자동으로 처리해줍니다 — 누락된 경우 Claude Code CLI를 자동 설치하고 Python 패키지를 설치합니다.
이 앱은 Win32 API(DPI 인식, 둥근 모서리, 다중 모니터 캡처)를 사용하므로, 현재 Windows에서만 실행됩니다.
오버레이 자체의 두뇌가 있는 것이 아니라, claude 명령줄을 구동합니다.
가장 쉬운 방법: 아래의 **setup.cmd**를 실행하기만 하면 됩니다 — 이미 가지고 있지 않다면 공식 네이티브 설치 프로그램으로 CLI를 자동으로 설치해줍니다. 직접 설치하려면:
irm https://claude.ai/install.ps1 | iex
winget install Anthropic.ClaudeCode). 스스로 자동 업데이트됩니다.npm install -g @anthropic-ai/claude-code자신의 Claude 계정으로 로그인합니다 (Pro/Max 구독 - API 키 불필요):
claude auth login을 실행합니다 (PowerShell 또는 CMD에서 — Git Bash에서는 안 됨) 그리고 브라우저 프롬프트를 한 번 따릅니다.
확인: — 이 명령은 버전 번호를 출력해야 합니다:
claude --version
"command not found"가 표시되면, CLI가 설치되지 않았거나 PATH에 설정되지 않은 것입니다.
https://www.python.org/downloads/에서 설치하고 설치 프로그램에서 **"python.exe를 PATH에 추가(Add python.exe to PATH)"**를 체크합니다.
확인:
python --version
원하는 것을 선택하세요 — 세 가지 방법 모두 오버레이가 실행될 준비가 된 상태로 끝납니다.
setup.cmd (권장)저장소(repo)를 받은 다음, **setup.cmd**를 더블 클릭합니다. 이 파일은 Python을 확인하고,
claude CLI가 누락된 경우 자동으로 설치하며 (그리고 로그인할지 여부를 제안하고),
Python 패키지를 설치해 줍니다 — 따라서 새 컴퓨터라도 단 한 번의 더블 클릭만으로 준비가 완료됩니다.
git clone https://github.com/shengyanlin/claude-overlay.git
(또는 녹색 Code 버튼에서 ZIP을 다운로드하여 압축을 해제합니다.)
이것은 에이전트(agent)이므로 스스로 설정할 수 있습니다. claude CLI가 이미 설치되어 있다면
(Prerequisites 참조), 원하는 위치에서 다음을 실행합니다:
claude "Set up Claude Overlay for me: clone https://github.com/shengyanlin/claude-overlay, make sure Python 3.10+ is installed (install it if missing), ensure pip is present (python -m ensurepip --upgrade), then run python -m pip install -r requirements.txt, then launch it with pythonw. Tell me when it's running."
Claude는 각 단계 전에 질문할 것입니다.
git clone https://github.com/shengyanlin/claude-overlay.git
cd claude-overlay
python -m ensurepip --upgrade # pip가 누락된 경우에만 필요하며, 그렇지 않으면 무해합니다.
...
이것은 Python 패키지(claude-agent-sdk, pillow, keyboard)만 설치합니다. 여전히 claude CLI가 설치되어 있고 로그인해야 합니다(사전 준비 사항 참조). python -m pip을 사용하세요(단순히 pip을 사용하지 마세요): Python의 Scripts\ 폴더가 PATH에 없더라도 작동하며, ensurepip은 Python 설치 시 pip이 포함되지 않은 경우 이를 부트스트랩합니다.
오버레이는 하단 상태 표시줄에 버전을 보여주고(예: v1.7.2), 시작 시 GitHub에서 새 릴리스가 있는지 확인합니다. 새 버전이 있는 경우, 알림 종 모양 아이콘(🔔)과 버전 옆의 위쪽 화살표(⬆)를 볼 수 있습니다. 업그레이드하려면:
git clone으로 설치한 경우, 🔔 알림과 함께 ⬆ vX.Y.Z로 오버레이 업데이트 버튼이 제공됩니다. 이를 클릭하면 콘솔 창에서 update.cmd가 자동으로 실행되어 풀(pull) 과정, 패키지 새로고침, 그리고 새 코드가 여전히 시작되는지 확인하는 과정을 지켜볼 수 있습니다. 먼저 오버레이를 닫을 필요가 없으며, 이것이 마지막으로 해야 할 일입니다: 업데이트가 완료되면 콘솔이 스스로 닫히고 오버레이는 새로운 코드로 자체적으로 재시작됩니다 — 새로 열린 창은 이전에 진행하던 대화를 재개할지 제안합니다.