Last updated: 2026-07-06T12:18:58.543Z
How to Install Claude Cowork: A Step-by-Step Setup Guide for Mac, Windows, and Linux
Claude Cowork brings Claude's agentic capabilities to your desktop for non-technical, multi-step work — no terminal required. Here's exactly how to install it, what you need before you start, and how to fix the most common setup issues.
How to Install Claude Cowork: A Step-by-Step Setup Guide for Mac, Windows, and Linux
Claude Cowork brings Claude Code's agentic capabilities into a visual, no-terminal-required interface inside the Claude Desktop app. Instead of typing one prompt at a time, you describe an outcome — organize a folder, draft a report, reconcile two spreadsheets — and Claude plans the steps, works through them, and hands back a finished result.
Unlike Claude Code, Cowork is built for non-technical, everyday knowledge work: researchers, analysts, operations teams, and anyone who works with documents and files but doesn't want to touch a command line. Here's exactly how to get it installed and running.
Before You Start: What You Need
- A paid Claude plan. Cowork is available on Pro, Max, Team, and Enterprise plans. There's no free-tier access at this time.
- The Claude Desktop app. Cowork only runs inside Claude Desktop — there's no browser-only or online version.
- macOS, Windows 10+, or Linux (beta). Windows and Linux have a couple of extra requirements covered below.
- About 25 GB of free disk space and at least 8 GB of RAM, since Cowork runs tasks inside an isolated virtual machine on your computer.
Step 1: Download and Install Claude Desktop
On macOS or Windows:
1. Go to the Claude downloads page and grab the installer for your operating system.
2. Run the installer and follow the on-screen prompts.
3. Launch Claude from your Applications folder (Mac) or Start menu (Windows).
4. Sign in with your Anthropic account.
On Linux (beta):
Anthropic recommends installing via the apt repository on Ubuntu or Debian, so updates arrive through your normal system package updates rather than manually:
```bash
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc
echo "deb [signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
sudo apt update && sudo apt install claude-desktop
```
If you can't use apt, download the `.deb` file for your architecture (x64 or arm64) from the downloads page instead:
```bash
sudo apt install ~/Downloads/claude-desktop_amd64.deb
```
Either way, launch Claude from your applications menu (or run `claude-desktop` from a terminal) and sign in.
Step 2: Handle Platform-Specific Requirements
Cowork runs tasks inside a virtual machine on your own computer, so Windows and Linux need virtualization enabled before it will work.
Windows needs the Virtual Machine Platform feature turned on. You can enable it manually with:
```powershell
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All -NoRestart
```
Restart your machine after enabling it if prompted.
Linux needs hardware virtualization (KVM) enabled — usually on by default, but sometimes disabled in firmware/BIOS. You'll also need to:
1. Add yourself to the KVM group, then log out and back in:
```bash
sudo usermod -aG kvm $USER
```
2. Make sure QEMU and its supporting packages are installed. If you installed via apt, these come automatically. If you installed the `.deb` manually on x64:
```bash
sudo apt install qemu-system-x86 ovmf virtiofsd
```
On arm64, use `qemu-system-arm qemu-efi-aarch64 virtiofsd` instead.
If Cowork tells you virtualization isn't available, this is almost always the fix — enable it in your BIOS/UEFI settings and restart.
macOS typically needs no extra setup.
Step 3: Open Cowork and Start a Task
1. Open Claude Desktop and look for the mode selector at the top of the app.
2. Click Cowork to switch into Cowork mode (as opposed to Chat or Code).
3. Describe the outcome you want — for example, "Read through these ten PDFs and summarize the key findings into one document" — and let Claude plan and execute the task.
4. Keep the desktop app open while Claude works. If the app closes or your computer goes to sleep, the session may end.
You can monitor progress, step in with direction mid-task, or let Claude run independently and check back later.
Optional: Letting Claude Use Apps on Your Computer
Cowork can also interact directly with apps on your screen — clicking, typing, and navigating — for tasks that don't have a clean integration, like an internal dashboard or specialized tool. This is off by default and permission-gated:
1. Open Claude Desktop and go to Settings > General (under Desktop app).
2. Turn on computer use.
3. Add any sensitive apps you want off-limits to the blocklist (investment/trading and cryptocurrency apps are blocked by default).
4. Start a Cowork session and ask Claude to do something involving one of your apps — Claude will ask for permission before accessing it.
This feature is a research preview, so it's worth starting with low-stakes apps you trust while you get a feel for how it behaves.
Troubleshooting Common Issues
- "VM service not running" (Windows): This usually means Cowork was installed via the older `.exe`/Squirrel installer instead of MSIX, or the Windows service has stopped. Reinstall from the downloads page, or start it manually via `services.msc` or `sc start CoworkVMService`.
- Virtualization not available: Enable Hardware Virtualization / VirtualMachinePlatform (Windows) or KVM (Linux) in your BIOS/UEFI settings, then restart.
- Task seems to have stopped: Check whether the desktop app was closed or your computer went to sleep mid-task — Cowork needs the app open and your machine awake to keep running.
Cowork vs. Claude Code: Which One Do You Need?
If you're not sure whether you want Cowork or Claude Code, the short version: Claude Code is a CLI-based tool for developers working directly in a codebase, while Cowork is the same underlying agentic architecture wrapped in a graphical interface for non-technical, document- and file-based work. Both live inside Claude Desktop, so installing the app gives you access to try either one.
---
Once it's installed, the best way to get a feel for Cowork is to hand it something you'd normally put off — a messy downloads folder, a stack of PDFs to summarize, a first draft you keep meaning to start. That's exactly the kind of work it's built for.
Looking for other AI tools worth adding to your workflow? Browse the full, regularly updated list on the Nexorzo AI Tools Directory.