Claude Cowork vs Claude Code: Understanding Their Roles in the Claude Plugins Ecosystem

Claude Cowork and Claude Code are the two complementary runtime environments that power the Claude Plugins Community marketplace—Cowork as a collaborative web workspace and Code as a CLI-first developer environment.

Both products consume the same plugin manifest, enabling developers to write once and deploy across Anthropic's ecosystem. This article explains how each runtime works, their distinct use cases, and how they share the marketplace.json single source of truth.

What Is Claude Cowork?

Claude Cowork is the collaborative AI workspace where users interact with plugins through a web interface.

Key Characteristics

• Access: Browse and install plugins at https://claude.com/plugins
• Execution: Plugins run on Claude Cowork servers, interacting with user web sessions, calendars, and email
• Target users: Non-developers and teams needing collaborative AI assistance

According to the [README.md](https://github.com/anthropics/claude-plugins-community/blob/main/README.md#using-this-marketplace) (lines 13–16), Cowork users discover plugins through the web marketplace and add them directly to their workspace without touching code.

Typical Use Cases

• Scheduling social media posts
• Managing shared calendars
• Collaborative document editing
• Maintaining team knowledge bases across sessions

What Is Claude Code?

Claude Code is the AI-assisted coding environment that loads plugins as local "skills" through a command-line interface.

Key Characteristics

• Access: Configure via CLI with claude plugin marketplace add and claude plugin install
• Execution: Plugins load as skills under ~/.claude/skills/..., calling local tools and MCP servers
• Target users: Developers automating code-centric workflows

Per [README.md](https://github.com/anthropics/claude-plugins-community/blob/main/README.md#using-this-marketplace) (lines 19–22), developers add the community marketplace once, then install plugins by slug:

# Add the community marketplace (one-time setup)

claude plugin marketplace add anthropics/claude-plugins-community

# Install a specific plugin

claude plugin install author-automations-social@claude-community

Typical Use Cases

• Code generation and refactoring
• Security scanning
• API testing
• Infrastructure provisioning

How Both Runtimes Share the Same Plugin Source

The .claude-plugin/marketplace.json file serves as the single source of truth for both environments. Each plugin entry declares compatibility across Cowork and Code, eliminating duplication.

Plugin Manifest Structure

{
  "name": "author-automations-social",
  "description": "Create and schedule social media posts … from Claude Code or Claude Cowork.",
  "source": {
    "source": "url",
    "url": "https://github.com/author-automations/social-plugin.git",
    "sha": "a1b2c3d4…"
  },
  "homepage": "https://author-automations.com"
}

When Claude Code installs this plugin, it copies the SKILL.md bundle into ~/.claude/skills/author-automations-social/, exposing slash-commands like /schedule-post. Claude Cowork loads the same bundle from its MCP server, rendering equivalent UI actions.

Critical Files in the Claude Plugins Ecosystem

File	Purpose
README.md	High-level marketplace overview and installation guides for both runtimes
.claude-plugin/marketplace.json	Canonical plugin registry with descriptions, sources, and compatibility flags
*/.claude-plugin/plugin.json	Individual plugin metadata (e.g., [tres-finance-plugin/.claude-plugin/plugin.json](https://github.com/anthropics/claude-plugins-community/blob/main/tres-finance-plugin/.claude-plugin/plugin.json))
skills/*/SKILL.md	Markdown skill definitions consumed by both Cowork and Code (e.g., [quickdesign/skills/quickdesign/SKILL.md](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/skills/quickdesign/SKILL.md))

Summary

• Claude Cowork provides the collaborative web front-end for plugin execution—ideal for calendar, email, and document workflows
• Claude Code delivers the developer-oriented CLI back-end—optimized for coding, testing, and infrastructure tasks
• Both runtimes read from .claude-plugin/marketplace.json, enabling write-once, deploy-anywhere plugin development
• Skill definition files (SKILL.md) bridge both environments, translating the same commands into web UI actions or CLI slash-commands

Frequently Asked Questions

What is the difference between Claude Cowork and Claude Code?

Claude Cowork is a browser-based collaborative workspace for general users, while Claude Code is a terminal-first environment designed for software developers. Cowork integrates with web services like calendars and email; Code executes local scripts and interfaces with development tools.

Can a single plugin work in both Claude Cowork and Claude Code?

Yes. The [marketplace.json](https://github.com/anthropics/claude-plugins-community/blob/main/.claude-plugin/marketplace.json) compatibility declarations allow most plugins to function in both environments. The same SKILL.md definitions render as UI buttons in Cowork and slash-commands in Code.

Where are Claude Code plugins stored locally?

Installed skills reside under ~/.claude/skills/<plugin-name>/, containing the SKILL.md definitions and any bundled tools. This directory structure enables offline execution and version control integration.

How do I add the community marketplace to Claude Code?

Run claude plugin marketplace add anthropics/claude-plugins-community once per machine. This registers the repository's marketplace.json as a trusted source for claude plugin install operations.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}