johnzfitch/claude-cowork-linux

해결하는 문제

이 프로젝트는 Claude Desktop의 "Cowork" 기능을 Linux(x86_64)에서 네이티브로 실행할 수 있도록 합니다. 공식적으로 Cowork는 macOS 전용 미리보기로, 파일 읽기, 쓰기, 정리 작업을 위해 사전에 사전 설정된 Linux VM에 의존합니다. 이 저장소는 VM이나 macOS가 필요 없도록 애플리케이션을 역설계하고 macOS 전용 구성 요소를 스텁으로 대체함으로써 이를 해결합니다.

작동 방식

Claude Desktop 애플리케이션을 Linux에서 실행하도록 하기 위해 여러 기술을 사용합니다:

• 플랫폼 위장: Anthropic 서버에 macOS 헤더를 전송하여 Cowork 기능이 활성화되도록 합니다.
• 플랫폼 게이트 바이패스: Python 스크립트가 애플리케이션 내부의 체크를 수정하여 Cowork가 지원된다고 항상 보고하도록 합니다.
• 네이티브 스텁화: macOS 전용 네이티브 모듈(@ant/claude-swift 및 @ant/claude-native)을 JavaScript 스텁으로 교체합니다. 이 스텁은 VM 스타일 경로를 실제 Linux 호스트 경로로 변환하고, 인증을 위해 xdg-open을 사용해 브라우저를 여는 등의 시스템 수준 작업을 처리합니다.
• 직접 실행: VM을 시작하는 대신, 스텁이 Claude Code 바이너리를 Linux 호스트에서 직접 실행합니다.
• 세션 오케스트레이션: 15개의 모듈로 구성된 사용자 정의 계층이 프로세스 생명 주기, IPC 통신, 대화 기록 지속성, 파일 감시를 관리합니다.

대상 사용자

Claude Pro 이상(또는 그 이상의 구독)을 보유한 Linux 사용자(특히 x86_64) 중, macOS 기계나 가상 머신 없이 Cowork 기능을 사용하고 싶은 사용자.

주요 특징

• VM 필요 없음: 호스트에서 Claude Code 바이너리를 직접 실행하여 성능과 간편함이 향상됩니다.
• 세부 경로 변환: /sessions과 같은 가상 경로를 사용자 홈 디렉터리로 투명하게 매핑합니다.
• 광범위한 테스트: IPC, 경로 변환, 보안을 검증하는 599개의 테스트 케이스를 포함합니다.
• 다양한 디스트로 지원: Arch Linux, Ubuntu, Fedora, Debian, openSUSE에서 테스트 완료되었으며, NixOS용 플레이크도 제공됩니다.