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 "Cowork" feature of Claude Desktop to run natively on Linux (x86_64). Officially, Cowork is a macOS-only preview that relies on a sandboxed Linux VM to read, write, and organize files. This repository removes the need for a VM or macOS by reverse-engineering the application and stubbing out the macOS-native components.

How it works

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

  • Platform Spoofing: It sends macOS headers to Anthropic's servers so the Cowork features are enabled.
  • Platform Gate Bypass: A Python script patches the application's internal checks to unconditionally report that Cowork is supported.
  • Native Stubbing: It replaces macOS-specific native modules (@ant/claude-swift and @ant/claude-native) with JavaScript stubs. These stubs translate VM-style paths to actual Linux host paths and handle system-level tasks like opening the browser via xdg-open for authentication.
  • Direct Execution: Instead of launching a VM, the stub executes the Claude Code binary directly on the Linux host.
  • Session Orchestration: A custom layer of 15 modules manages the lifecycle of processes, IPC communication, transcript persistence, 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 feature without needing a macOS machine or a virtual machine.

Highlights

  • No VM Required: Runs the Claude Code binary directly on the host for better performance and simplicity.
  • Detailed Path Translation: Transparently maps virtual paths (like /sessions) to the user's home directory.
  • Extensive Testing: Includes 599 test cases validating IPC, path translation, and security.
  • Broad Distro Support: Tested and expected to work on Arch Linux, Ubuntu, Fedora, Debian, and openSUSE, with a NixOS flake provided.

Related

  • Project
    patrickjaja/claude-desktop-extra

    A community-maintained Linux distribution of the Claude Desktop app that adds native package support, custom themes, multiple profile management, and enhanced features like IDE-style file navigation and third-party model integration.

  • 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
    javaht/claude-desktop-zh-cn

    A local interface patch for Claude Desktop that adds support for Simplified and Traditional Chinese across macOS, Windows, and Windows.

  • 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.

  • Project
    wesammustafa/Claude-Code-Everything-You-Need-to-Know

    A practical, up‑to‑date guide for Anthropic’s Claude Code CLI, covering installation, prompt engineering, custom slash‑commands (Skills), automatic Hooks, sub‑agents, JavaScript workflows, and the Model‑Context‑Protocol for external tool integration. Includes ready‑to‑copy `.claude/` examples for teams building AI‑augmented development pipelines.