<div align="center"> <img src="https://github.com/user-attachments/assets/b50a50bb-2404-4153-a312-aa5784a16928" alt="Claude Cowork for Linux (Unofficial)" width="800">

Claude Cowork on Linux

No macOS, no VM required.

<br>

Quick Start · How It Works · Manual Setup · Troubleshooting

</div>

---

Overview

Claude Cowork is a special Claude Desktop build that works inside a folder you point it at—it reads, writes, and organizes files there while it runs a plan. Cowork is currently a macOS-only preview backed by a sandboxed Linux VM; this repo reverse-engineers and stubs the macOS-native pieces so Cowork can run directly on Linux (x86_64)—no VM and no macOS required. The stub translates VM paths to host paths so Cowork points at the right files on Linux.

How it works:

| Step | Description | |:-----|:------------| | Stubbing | Replace macOS-only native modules (@ant/claude-swift, @ant/claude-native) with JavaScript | | | Run the Claude Code binary directly (no VM needed—we're already on Linux!) | | | Convert VM paths to host paths transparently | | | Send macOS headers so the server enables the feature |