Nadhebe
Guides

What is Claude Cowork? Desktop Agent Setup, Local Permissions & Workflow Guide

A deep dive into Anthropic's Claude Cowork feature—explaining local desktop workspace operations, security sandboxing, permission controls, and real-world workflows.

Nadhebe Editorial Team Nadhebe Editorial Team
· · 4 min read
Minimalist architectural diagram showing Claude Cowork desktop agent interacting with local files
On this page

Anthropic’s Claude Cowork represents a paradigm shift from traditional chat interfaces to autonomous desktop collaboration. Integrated directly into the Claude Desktop application, Cowork operates as a persistent, agentic assistant capable of reading, editing, organizing, and synthesizing files across your local computer folders.

Whether you are automating multi-file document refactoring, organizing local media libraries, or generating complex reports from raw spreadsheet data, Claude Cowork provides an interactive, human-in-the-loop desktop agent experience.

This guide details what Claude Cowork is, how its security architecture operates, how to configure local permissions, and key workflow execution patterns.


Architectural Breakdown: How Claude Cowork Operates

Claude Cowork bridges the gap between conversational AI and local operating system task execution.

flowchart TD
    UserInstruction[User Goal in Claude Desktop] --> ParseGoal[Parse Objective & Local Context]
    ParseGoal --> ScopeCheck{Folder Mounted in Cowork?}
    
    ScopeCheck -->|No| RequestMount[Prompt User to Mount Target Folder]
    ScopeCheck -->|Yes| PlanAgent[Plan Agent Sub-Tasks]
    RequestMount --> PlanAgent
    
    PlanAgent --> ExecRead[Read Files & Analyze Metadata]
    ExecRead --> DetectWrite{Requires File Modification / Creation?}
    
    DetectWrite -->|Read Only| OutputSummary[Output Report to User]
    DetectWrite -->|Write / Edit| PromptConfirm[Display Proposed File Changes]
    
    PromptConfirm -->|Approved [Y]| ApplyWrite[Execute Atomic File Write]
    PromptConfirm -->|Rejected [N]| Abort[Cancel File Operation]
    
    ApplyWrite --> OutputSummary

Claude Cowork vs Claude Code CLI vs Web Chat

Understanding where Cowork fits into Anthropic’s tool ecosystem:

Dimension / FeatureClaude Cowork (Desktop GUI)Claude Code (Terminal CLI)Web Chat (claude.ai)
Primary EnvironmentNative Desktop App GUISystem Shell TerminalBrowser Window
Target Document TypesDocs, PDFs, CSVs, Images, CodeCodebases, Repositories, GitText & Uploaded Assets
Local File ExecutionUser-mounted local foldersFull local git repositoryManual file upload
Permission ControlsOS Directory Sandbox + PromptsShift+Tab Permission ModesBrowser Sandbox
Primary User BaseKnowledge Workers & ExecutivesSoftware Engineers & DevOpsGeneral Audience

Step-by-Step: Setting Up Claude Cowork

1. Enable Cowork in Claude Desktop

  1. Download and install Claude Desktop (claude.ai/download).
  2. Launch the application and open Settings (Cmd + , on macOS or Ctrl + , on Windows).
  3. Navigate to the Cowork & Agentic Workspaces tab.
  4. Toggle Enable Local Workspace Agent to ON.

2. Mounting Local Folders & Setting Boundaries

For security, Claude Cowork cannot read your entire hard drive by default. You must explicitly mount specific project folders:

  1. Click + Add Workspace Folder in the Cowork panel.
  2. Select target directories (e.g., ~/Documents/Q3-Reports/ or C:\Users\Alice\Projects\DataAnalysis).
  3. Set folder permission level:
    • Read-Only: Claude can analyze documents but cannot modify or delete them.
    • Interactive Edit (Recommended): Claude can edit and create files after displaying a confirmation prompt.

Real-World Claude Cowork Workflows

1. Automated Financial Report Synthesis

Provide Cowork with access to a folder containing raw CSV sales logs and quarterly PDF invoices:

Prompt: “Analyze all CSV files in my ~/Documents/Sales-2026/ folder. Extract total revenue by region, calculate month-over-month growth, and create a formatted markdown summary file named Q2-Revenue-Summary.md.”

Cowork parses every spreadsheet in the background, calculates totals, and drafts the summary file directly in your folder.

2. Multi-Document Restructuring & Editing

Clean up inconsistent document formatting across dozens of files:

Prompt: “Scan all .docx and .md files in ~/Projects/User-Docs/. Ensure every document contains a standardized YAML header, fixes typo inconsistencies, and outputs the updated files to a new ./dist/ directory.”


Security & Privacy Architecture

Anthropic designed Claude Cowork with enterprise-grade security boundaries:

  • Zero Cloud Storage of Files: Your local files are processed ephemerally during active sessions and are not stored permanently on Anthropic servers.
  • Granular Directory Mounting: Cowork is restricted strictly to folders you explicitly mount. System root directories (/System, C:\Windows) are permanently blocked.
  • Interactive Diffs: Before executing any file write, rename, or deletion, Cowork displays a visual diff window requiring human approval.

Frequently asked questions

What is Claude Cowork?

Claude Cowork is Anthropic's native desktop agent feature inside Claude Desktop that allows Claude to read, edit, organize, and execute tasks across local files and folders in real time.

How does Claude Cowork differ from Claude Code CLI?

Claude Cowork operates inside the graphical Claude Desktop application for general workspace files (documents, spreadsheets, images), while Claude Code CLI is a terminal agent designed specifically for software codebases.

Is Claude Cowork secure for enterprise data?

Yes, Claude Cowork enforces strict user-granted folder permissions, interactive confirmation prompts for write operations, and localized execution.

Sources & references

  1. [1]Official Claude Desktop & Cowork Documentation
  2. [2]Anthropic Engineering Research on Desktop Agents
Nadhebe Editorial Team

Nadhebe Editorial Team

Technical research and documentation published by the Nadhebe editorial team.

Get the next issue

One focused essay a week. No noise, unsubscribe anytime.