johnzfitch/claude-cowork-linux

解決的問題

此專案讓「Claude Cowork」功能——一個專門為 Claude Desktop 打造的版本，可讀取、撰寫並整理本機目錄中的檔案——能在 Linux 上執行。由於 Cowork 官方僅支援 macOS，且依賴沙盒化的 Linux VM，此專案透過逆向工程與模擬原生 macOS 元件，移除了對 VM 或 macOS 的需求。

如何運作

此專案使用多種技術，讓 Claude Desktop 應用程式誤以為在 Linux 上原生執行：

• 平台偽裝：向 Anthropic 的伺服器傳送 macOS 標頭，以啟用 Cowork 功能。
• 原生模擬：以 JavaScript 模擬檔取代僅限 macOS 的原生模組（如 @ant/claude-swift 和 @ant/claude-native），並實作相同的 API 表面。
• 直接執行：不需在 macOS 內執行 Linux VM，而是直接在 Linux 主機上執行 Claude Code 二進位檔，並將 VM 風格的路徑轉換為實際主機路徑。
• 平台門檻繞過：一個 Python 腳本修補應用程式的程式碼，使其無條件報告目前平台支援 Cowork。
• 協調層：一組自訂的 15 個模組，負責管理會話生命週期、IPC 通訊與檔案監聽。

適用對象

擁有 Claude Pro 或更高訂閱方案的 Linux 使用者（特別是 x86_64 架構），希望在本機電腦上使用 Cowork 的代理功能，而無需使用虛擬機。

主要特色

• 無需 VM：直接在主機上執行 Claude Code，提升效能並簡化流程。
• 繞過 macOS 限制：透過平台偽裝與原生模組模擬，啟用僅限 macOS 的功能。
• 廣泛的 Linux 支援：已在 Arch Linux 上測試，預期可在 Ubuntu、Fedora、Debian 與 openSUSE 上運作。
• 自動安裝：提供 install.sh 腳本與 Arch Linux 用的 AUR 套件。