LiveClaude는 Windows, Linux, macOS에서 Claude Code Remote Control과 Cursor My Machines 세션을 백그라운드로 실행하고 관리하는 데스크톱 앱이다. 세션 프로세스가 종료되면 다시 시작하고, 로그인이나 재부팅 뒤에도 실행하도록 운영체제의 작업 스케줄러·서비스·systemd·LaunchAgent 등을 이용한다.

프로젝트 페이지 · 최신 릴리스 다운로드 · 오류 신고

주요 기능과 조건

앱에서 세션을 만들고 편집하거나 삭제할 수 있으며, 상태와 로그를 확인하고 감독 프로세스(supervisor)를 설치·제거할 수 있다. 내장 터미널은 실제 의사 터미널을 사용해 작업공간 신뢰 확인, Remote Control 승인, 로그인처럼 대화형 입력이 필요한 절차를 앱 안에서 처리한다. 실행 중인 프로세스에 연결해 입력하는 기능도 제공한다.

제작자는 모든 구성요소를 C#으로 구현했으며 Node, Python, tmux, 브라우저 제어를 사용하지 않는다고 설명한다. 운영체제별 기능과 Claude Code·Cursor 제품별 처리는 별도 어셈블리로 분리했다. LiveClaude는 Anthropic과 제휴하거나 승인·후원받은 프로젝트가 아니다.

Claude Code Remote Control을 쓰려면 Pro, Max, Team 또는 Enterprise 계정으로 로그인해야 한다. API 키와 Bedrock, Vertex, Foundry는 지원하지 않는다. Claude Code를 별도로 설치하는 것이 권장되며, 컴퓨터가 절전 상태에 들어가면 Remote Control 세션도 오프라인이 된다. Windows는 10 1809 이상 또는 Windows 11, Linux는 systemd, macOS는 12 이상이 필요하다. 패키지에 포함되지 않은 경우 .NET 10 런타임이 필요하다.

설치와 시작

Windows에서는 다음 명령으로 설치하거나, 최신 릴리스에서 ZIP 파일을 받을 수 있다.

text
winget install LeandroCannizzaro.LiveClaude

Linux 설치 스크립트는 시스템에 맞는 .deb, .rpm 또는 tarball을 골라 /opt/liveclaude에 설치한다. x86_64와 arm64를 지원하며 패키지는 자체 포함형이다.

text
curl -fsSL https://leandrocannizzaro.github.io/LiveClaude/install.sh | sh

macOS 설치 스크립트는 .dmg를 내려받아 앱을 /Applications에 복사한다. Apple silicon과 Intel을 지원한다. 앱은 아직 공증되지 않아 직접 설치하면 처음 실행할 때 앱을 우클릭해 열어야 한다.

text
curl -fsSL https://leandrocannizzaro.github.io/LiveClaude/install-macos.sh | sh

기본 사용 절차는 앱의 Sessions에서 새 세션을 만들고 프로젝트 디렉터리와 이름, 실행·권한 모드를 지정하는 것이다. 내장 터미널에서 디렉터리 신뢰와 Remote Control 사용을 처음 한 번 승인한 뒤 세션을 저장하고, Service & startup에서 감독 프로세스를 설치한다. 이후 서버는 claude.ai/code와 Claude 모바일 앱에 표시된다.

자동 시작과 세션 관리

LiveClaude는 사용자 세션에서 실행하는 방식을 권장한다. 시스템 전체 범위로 설치하면 로그인 전부터 시작할 수 있는 경우가 있지만, 권한 상승이 필요하고 Claude 자격 증명을 읽지 못할 수 있다. 특히 macOS의 LaunchDaemon은 로그인 전 잠겨 있는 로그인 키체인에 접근할 수 없다. Linux 사용자 단위 systemd를 로그인 없이 유지하려면 loginctl enable-linger가 필요할 수 있다.

세션을 강제 종료하면 Anthropic 쪽에 사용하지 않는 브리지 환경이 남을 수 있다. LiveClaude는 종료 시 Ctrl+C를 보내고 기본 12초 동안 기다려 CLI가 환경 등록을 해제하도록 한다. 환경 탭에서는 디렉터리별 환경을 활성·오래됨·추적 안 됨 상태로 확인하고 중복 항목이나 오래된 항목을 선택해 삭제할 수 있다. 이 기능은 Anthropic의 베타·비공개 API를 사용하므로 API 변경 시 환경 탭이 오류를 표시할 수 있지만, 나머지 LiveClaude 기능은 계속 동작한다고 프로젝트는 설명한다. 관련 이슈는 anthropics/claude-code#50884에서 확인할 수 있다.

서버가 중단된 뒤 약 4시간 이내에는 --continue로 기존 세션에 다시 연결할 수 있다. 그 이후에는 새 세션을 시작하며, 대화는 로컬에서 claude --resume으로 다시 이어갈 수 있다.

Windows ClickOnce 설치는 1.x와 2.0이 별도 채널이다. 기존 1.x 채널은 1.0.15에서 고정됐으며, 2.0 설치가 1.x를 자동으로 대체하지 않는다. macOS와 Linux 패키지 및 Windows의 런타임 요구사항은 프로젝트 설치 안내에 정리돼 있다. 교차 플랫폼 재작업 계획은 Issue #2, 개발 과정 기록은 Issue #1에서 볼 수 있다. 라이선스는 MIT다.