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用のflakeも提供されています。