johnzfitch/claude-cowork-linux

解決する問題

このプロジェクトは、「Claude Cowork」機能——ローカルディレクトリ内のファイルを読み書き・整理できるように特別に構成されたClaude Desktopのビルド——をLinux上で実行可能にします。Coworkは公式にはmacOS専用のプレビューであり、サンドボックス化されたLinux VMに依存していますが、このプロジェクトはVMやmacOSを必要とせず、ネイティブmacOSコンポーネントを逆引きしてスタブ化することで、その依存を排除します。

動作方法

このプロジェクトは、Claude DesktopアプリケーションがLinux上でネイティブに実行されるようにするための複数のテクニックを使用しています。

• プラットフォームスプーフィング: AnthropicのサーバーにmacOSのヘッダーを送信することで、Cowork機能が有効になります。
• ネイティブスタブ化: @ant/claude-swift や @ant/claude-native のようなmacOS専用ネイティブモジュールを、同じAPI表面を実装するJavaScriptスタブに置き換えます。
• 直接実行: macOS内でのLinux VMの実行ではなく、Claude CodeバイナリをLinuxホスト上で直接実行し、VMスタイルのパスを実際のホストパスに変換します。
• プラットフォームゲートバイパス: Pythonスクリプトでアプリケーションコードを修正し、現在のプラットフォームでCoworkがサポートされていることを条件に関係なく報告するようにします。
• オーケストレーションレイヤー: セッションのライフサイクル管理、IPC通信、ファイル監視を担当するカスタム15モジュールのセットです。

対象ユーザー

Claude Pro以上（またはそれ以上のサブスクリプション）のLinuxユーザー（特にx86_64アーキテクチャ）で、仮想マシンを使わずにローカルマシン上でCoworkのエージェント機能を利用したい方。

特徴

• VM不要: ホスト上でClaude Codeを直接実行するため、パフォーマンスとシンプルさが向上します。
• macOS制限の回避: プラットフォームスプーフィングとネイティブモジュールスタブ化により、macOS専用機能を有効にします。
• 広範なLinuxサポート: Arch Linuxでテスト済みで、Ubuntu、Fedora、Debian、openSUSEでも動作すると予想されます。
• 自動インストール: install.sh スクリプトとArch Linuxユーザー向けのAURパッケージを提供しています。