johnzfitch/claude-cowork-linux

解决的问题

该项目使 Claude Desktop 的 "Cowork" 功能能够在 Linux（x86_64）上原生运行。官方上，Cowork 是一个仅限 macOS 的预览功能，依赖沙盒化的 Linux 虚拟机来读取、写入和组织文件。本仓库通过逆向工程应用程序并替换 macOS 原生组件，消除了对虚拟机或 macOS 的需求。

工作原理

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

• 平台伪装： 向 Anthropic 服务器发送 macOS 头部信息，使 Cowork 功能得以启用。
• 平台检查绕过： 一个 Python 脚本修补应用程序内部检查，强制报告 Cowork 始终受支持。
• 原生模块模拟： 将 macOS 特有的原生模块（@ant/claude-swift 和 @ant/claude-native）替换为 JavaScript 模拟模块。这些模拟模块将 VM 风格路径转换为实际的 Linux 主机路径，并处理打开浏览器（通过 xdg-open）进行认证等系统级任务。
• 直接执行： 不再启动虚拟机，而是由模拟模块直接在 Linux 主机上执行 Claude Code 二进制文件。
• 会话编排： 一个由 15 个模块组成的自定义层，负责管理进程生命周期、IPC 通信、对话记录持久化和文件监控。

适用人群

拥有 Claude Pro 或更高订阅的 Linux 用户（特别是 x86_64 架构），希望在无需 macOS 机器或虚拟机的情况下使用 Cowork 功能。

主要亮点

• 无需虚拟机： 直接在主机上执行 Claude Code 二进制文件，性能更优，结构更简单。
• 详细路径转换： 透明地将虚拟路径（如 /sessions）映射到用户主目录。
• 全面测试： 包含 599 个测试用例，验证 IPC、路径转换和安全性。
• 广泛发行版支持： 已在 Arch Linux、Ubuntu、Fedora、Debian 和 openSUSE 上测试，提供 NixOS flake 配置。