johnzfitch/claude-cowork-linux

Run Claude Desktop’s Cowork mode natively on Linux — no macOS or VM required

What it solves

This project enables the "Claude Cowork" feature—a specialized build of Claude Desktop that can read, write, and organize files in a local directory—to run on Linux. Since Cowork is officially a macOS-only preview that relies on a sandboxed Linux VM, this project removes the need for a VM or macOS by reverse-engineering and stubbing the native macOS components.

How it works

The project uses several techniques to trick the Claude Desktop application into running natively on Linux:

  • Platform Spoofing: It sends macOS headers to Anthropic's servers so the Cowork features are enabled.
  • Native Stubbing: It replaces macOS-only native modules (like @ant/claude-swift and @ant/claude-native) with JavaScript stubs that implement the same API surface.
  • Direct Execution: Instead of running a Linux VM inside macOS, it runs the Claude Code binary directly on the Linux host, translating VM-style paths to actual host paths.
  • Platform Gate Bypass: A Python script patches the application's code to unconditionally report that Cowork is supported on the current platform.
  • Orchestration Layer: A custom set of 15 modules manages session lifecycles, IPC communication, and file watching.

Who it’s for

Linux users (specifically x86_64) with a Claude Pro or higher subscription who want to use the Cowork agentic capabilities on their local machine without using a virtual machine.

Highlights

  • No VM Required: Runs Claude Code directly on the host for better performance and simplicity.
  • Bypasses macOS Restrictions: Uses platform spoofing and native module stubbing to enable macOS-exclusive features.
  • Broad Linux Support: Tested on Arch Linux and expected to work on Ubuntu, Fedora, Debian, and openSUSE.
  • Automated Installation: Provides an install.sh script and an AUR package for Arch Linux users.

Related

  • Project
    ttnear/Clarc

    A native macOS desktop client for Claude Code that brings the CLI agent workflow into a project-centric GUI for non-developers.

  • Project
    patrickjaja/claude-desktop-extra

    A repackaged version of Claude Desktop for Linux that extends support to Arch, Fedora, and NixOS while adding exclusive features like Computer Use and custom themes.

  • Dispatch
    Claude Desktop for Linux: Community Demand and Technical Challenges

    Linux users are calling for an official Claude Desktop client to enable access to 'Computer Use' and plugin development, highlighting a technical paradox where Anthropic's 'Cowork' agent already runs on Linux internally.

  • Project
    OpenCoworkAI/open-cowork

    Open Cowork is a free, open‑source desktop app that wraps Claude‑style (and other) LLMs into a local AI‑agent workspace. With one‑click installers for Windows/macOS, VM‑level sandboxing (WSL2/Lima), a built‑in “Skills” system for generating PPTX/DOCX/PDF/XLSX files, MCP connectors for browsers/Notion, and remote control via Feishu or Slack, it lets non‑technical users give natural‑language commands that read/write files, automate GUI apps, and produce professional documents—all running locally with optional VM isolation.

  • Dispatch
    Claude Desktop VM Issues: Automatic VM Spawning and Resource Consumption

    Claude Desktop automatically spawns a virtual machine for its 'Cowork' feature, leading to significant storage and memory consumption without providing users a way to disable it.