johnzfitch/claude-cowork-linux

它解决了什么问题

这个项目使得“Claude Cowork”功能——一个专门构建的 Claude Desktop 版本，能够读取、编写和组织本地目录中的文件——能够在 Linux 上运行。由于 Cowork 官方仅限于 macOS 预览版本，并依赖于沙盒化的 Linux 虚拟机，该项目通过逆向工程和模拟原生 macOS 组件，消除了对虚拟机或 macOS 的需求。

它如何工作

该项目使用多种技术，欺骗 Claude Desktop 应用程序在 Linux 上原生运行：

• 平台伪装：向 Anthropic 的服务器发送 macOS 头信息，以启用 Cowork 功能。
• 原生模块模拟：用实现相同 API 表面的 JavaScript 模拟模块，替换仅限 macOS 的原生模块（如 @ant/claude-swift 和 @ant/claude-native）。
• 直接执行：不再在 macOS 内运行 Linux 虚拟机，而是直接在 Linux 主机上运行 Claude Code 二进制文件，并将虚拟机风格的路径转换为实际主机路径。
• 平台限制绕过：一个 Python 脚本修补应用程序代码，强制报告当前平台支持 Cowork。
• 协调层：一组自定义的 15 个模块管理会话生命周期、进程间通信和文件监听。

适合谁

拥有 Claude Pro 或更高订阅的 Linux 用户（特别是 x86_64 架构），希望在本地机器上使用 Cowork 的智能体功能，而无需使用虚拟机。

特色亮点

• 无需虚拟机：直接在主机上运行 Claude Code，性能更优，配置更简单。
• 绕过 macOS 限制：通过平台伪装和原生模块模拟，启用仅限 macOS 的功能。
• 广泛的 Linux 支持：已在 Arch Linux 上测试，预计可在 Ubuntu、Fedora、Debian 和 openSUSE 上正常运行。
• 自动化安装：提供 install.sh 脚本和 Arch Linux 用户的 AUR 包。