claude-code-ultimate-guide/cowork

Claude Cowork Documentation

Complete guide for Claude's agentic desktop feature for knowledge workers

---

What is Cowork?

Cowork is Claude's desktop-native autonomous assistant that manipulates local files, generates documents, and organizes your digital workspace—without writing code.

Think of it as Claude Code for everyone: same agentic capabilities, but through a visual interface with file-only operations.

┌─────────────────────────────────────────────────┐
│              CLAUDE DESKTOP APP                 │
│  ┌───────────────────────────────────────────┐  │
│  │              COWORK                       │  │
│  │   "Organize my Downloads folder by type"  │  │
│  │                    ↓                      │  │
│  │   [Analysis] → [Planning] → [Execution]   │  │
│  │                    ↓                      │  │
│  │   ~/Downloads/ → Organized structure      │  │
│  └───────────────────────────────────────────┘  │
└─────────────────────────────────────────────────┘

---

⚡ Quick Start

Prerequisites

Requirement	Details
Subscription	Pro ($20/mo) or Max ($100-200/mo)
Platform	macOS only (Windows planned, no ETA)
App	Claude Desktop (latest version)

Enable Cowork

1. Open Claude Desktop app
2. Go to Settings → Features
3. Enable Cowork toggle
4. Grant folder access when prompted

Your First Task

# Create workspace
mkdir -p ~/Cowork-Workspace/{input,output}

# Add sample files to organize
# Then in Claude Desktop:
"Organize the files in ~/Cowork-Workspace/input/ by type"

Interactive Onboarding (personalized learning)

Run this in Claude Desktop for a guided tour adapted to your use case:

Follow the Cowork onboarding instructions from:
https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/cowork/tools/cowork-onboarding.md

Cowork will analyze your needs and create a personalized learning path.

→ Complete Getting Started Guide

---

🎯 Learning Paths

Knowledge Worker — Foundation path (5 steps)

1. Overview — What is Cowork, architecture
2. Getting Started — First workflow, CTOC framework
3. File Organization Workflow — Practical example
4. Prompts Library — 15+ ready-to-use prompts
5. Cheatsheet — Print this

Product Manager / Executive — Overview path (4 steps)

1. What's Inside — Scope & capabilities
2. Golden Rules — Key principles
3. Security — Safe usage practices
4. Comparison — Cowork vs Copilot/Gemini/ChatGPT

Power User — Comprehensive path (6 steps)

1. Complete Capabilities — Detailed feature matrix
2. All Workflows — 5 step-by-step guides
3. Troubleshooting — Error resolution
4. FAQ — 20+ questions
5. Advanced Prompts — Web research & synthesis
6. Team Handoff — Dev ↔ Non-dev patterns

---

📚 What's Inside

Core Guides (6 files)

Guide	Description	Reading Time
Overview	What is Cowork, architecture, who should use it	5 min
Getting Started	Installation, setup, first workflow	10 min
Capabilities	What Cowork can and cannot do	8 min
Security	Best practices, risk mitigation, safe usage	12 min
Troubleshooting	Common issues, decision tree, recovery	8 min

Workflows (5 guides)

Workflow	Use Case	Complexity
File Organization	Downloads → structured folders	Beginner
Expense Tracking	Receipts → Excel report	Intermediate
Report Synthesis	Multi-doc → structured report	Intermediate
Meeting Prep	Research → briefing document	Intermediate
Team Handoff	Dev ↔ Non-dev patterns	Advanced

Ready-to-Use Prompts (60+ prompts)

Collection	Count	Description
File Operations	20	Organization, renaming, cleanup, deduplication
Document Creation	15	Reports, summaries, presentations, Excel
Data Extraction	15	Images → data, PDF parsing, OCR
Research	17	Web research, synthesis, competitive analysis

Total: 67 copy-paste prompts

Reference Materials

Resource	Description
Cheatsheet	1-page printable quick reference
Comparison	Cowork vs Copilot/Gemini/ChatGPT/Apple Intelligence
FAQ	20+ frequently asked questions
Glossary	Cowork-specific terminology

Templates

Template	Use Case
CLAUDE.md for Cowork	Project context file template

---

🔑 Golden Rules

1. Always review the plan before approval — Cowork proposes, you decide
2. Dedicated workspace only — Never grant access to Documents/Desktop/system folders
3. No credentials in workspace — Keep secrets out of Cowork-accessible folders
4. Verify file sources — Prompt injection risk in untrusted files (PDFs, docs)
5. Budget error correction time — OCR accuracy ~97% fields, ~63% line items
6. Disconnect VPN — #1 issue: VPN breaks VM networking
7. Backup before destructive ops — No undo for file deletions

See Security Guide for detailed practices.

---

Key Differences: Code vs Cowork

Aspect	Claude Code	Cowork
User	Developers	Knowledge workers
Interface	Terminal/CLI	Desktop app
Execute code	Yes	No
File access	Full filesystem	Sandboxed folder
Outputs	Any file type	Office docs, Excel, PDF
Browser automation	Yes (Chrome)	Yes (Chrome)
Maturity	Production-ready	Research preview

→ Full Comparison

---

🌍 About

Origins & Philosophy

This Cowork documentation is part of the Claude Code Ultimate Guide, created after several months of AI-assisted development practice.

Philosophy: Practical over theoretical. Real use cases over feature lists. Understanding why before how.

Created with Claude Code. Community-validated through testing and feedback.

Related: Claude Code Ultimate Guide — For developers

Privacy & Data

Cowork sends your prompts, file contents, and results to Anthropic servers.

• Default: 5 years retention (training enabled)
• Opt-out: 30 days retention
• Enterprise: 0 retention

Action: Disable training | Data Privacy Guide

Current Limitations (January 2026)

Platform & Access:

• macOS only (Windows planned, Linux not announced)
• Pro ($20/mo) or Max ($100-200/mo) subscription required
• Research preview = expect bugs

Technical Constraints:

• VPN incompatible (VM routing conflict)
• Usage limits: resets every 5 hours
• Pro tier: ~1-1.5h intensive use before quota exhaustion
• Context limit: ~165K effective (not 200K)
• No cloud storage connectors confirmed
• No official security documentation

→ Complete Limitations

Roadmap & Future Repository

Current Status: Cowork documentation lives in the Claude Code Ultimate Guide repository.

Future Plan: Migrate to dedicated claude-cowork-guide repository when:

• Feature reaches stable release (exit research preview)
• Documentation exceeds 50+ files
• Community requests standalone resource

Why separate?: Different audiences (knowledge workers vs developers), independent versioning, focused contribution guidelines.

Timeline: TBD, depends on Cowork maturity and community feedback.

---

🤝 Contributing

Found an error? Have a workflow to share?

For now: Open an issue in the main claude-code-ultimate-guide repo with [cowork] prefix.

Include: Platform, subscription tier, reproduction steps.

Future: Dedicated repo with Cowork-specific contribution guidelines.

---

📄 License & Support

Licensed under CC BY-SA 4.0. Free to share and adapt with attribution.

Stay Updated: Watch releases | Discussions | Connect on LinkedIn

---

Navigation

cowork/
├── README.md                    ← You are here
├── guide/                       # Core documentation (6 files)
│   ├── 00-overview.md
│   ├── 01-getting-started.md
│   ├── 02-capabilities.md
│   ├── 03-security.md
│   └── 04-troubleshooting.md
├── workflows/                   # Step-by-step guides (5 files)
│   ├── file-organization.md
│   ├── expense-tracking.md
│   ├── report-synthesis.md
│   ├── meeting-prep.md
│   └── team-handoff.md
├── prompts/                     # 60+ ready-to-use prompts (4 files)
│   ├── file-ops.md
│   ├── document-creation.md
│   ├── data-extraction.md
│   └── research.md
├── reference/                   # Quick references (4 files)
│   ├── cheatsheet.md
│   ├── comparison.md
│   ├── faq.md
│   └── glossary.md
└── examples/                    # Templates (1 file)
    └── CLAUDE.md

---

Version 1.0.0 | January 2026 | Part of Claude Code Ultimate Guide | Crafted with Claude