Skip to main content

Claude Cowork Plugin System Reference

Source: https://support.claude.com/en/articles/13837440-use-plugins-in-claude-cowork Source: https://github.com/anthropics/knowledge-work-plugins Retrieved: 2026-04-11
이 문서는 vox.ai plugin이 Claude Cowork에서 동작하기 위한 참고 자료다. TEST.md의 미션 실행 시 참조한다.

Claude Cowork Plugin 시스템 개요

Cowork는 file-based plugin 시스템을 사용한다. Plugin 구조가 Claude Code와 동일하다.
plugin-name/
├── .claude-plugin/plugin.json   # 매니페스트
├── .mcp.json                    # MCP 서버 연결
├── commands/                    # 슬래시 명령 (명시적 호출)
└── skills/                      # 도메인 지식 (자동 활성화)
핵심: 모든 컴포넌트는 markdown과 JSON만 사용. 코드 없음, 인프라 없음, 빌드 없음.

Plugin 설치 방법

방법 1: Cowork 앱 (데스크톱)

  1. Claude Desktop 앱 → Cowork
  2. Customize 메뉴 → Browse plugins
  3. Plugin 선택 → Install
  4. 커스텀 plugin 파일 업로드도 가능

방법 2: Claude Code CLI

# 마켓플레이스 추가
claude plugin marketplace add anthropics/knowledge-work-plugins

# Plugin 설치
claude plugin install sales@knowledge-work-plugins

방법 3: 웹 (claude.com/plugins)

claude.com/plugins에서 직접 설치. CLI 불필요.

공식 Plugin 생태계

  • GitHub 레포: anthropics/knowledge-work-plugins
  • 라이선스: Apache-2.0
  • 포함 plugin: productivity, sales, customer-support, product-management, marketing, legal, finance, data, enterprise-search, bio-research, cowork-plugin-management

MCP 서버 설정

Plugin 내 .mcp.json으로 외부 도구를 연결한다.
{
  "mcpServers": {
    "vox": {
      "type": "http",
      "url": "https://mcp.tryvox.co/mcp"
    }
  }
}
Cowork의 MCP 커넥터는 Anthropic의 클라우드를 통해 외부 서비스에 접근한다. 커스텀 커넥터는 공개 인터넷에서 접근 가능한 서버를 가리켜야 한다.

Claude Code와의 차이점 (업데이트됨)

항목Claude CodeCodexCowork
매니페스트.claude-plugin/plugin.json.codex-plugin/plugin.json.claude-plugin/plugin.json (동일)
Plugin 설치CLI claude plugin add/plugins 마켓플레이스앱 Browse plugins 또는 파일 업로드
MCP 연결.mcp.json 자동 등록.mcp.json 자동 등록.mcp.json (클라우드 경유)
Skill 호출/plugin-name:skill-name@plugin-name자동 활성화
네트워크로컬 직접 연결로컬 직접 연결Anthropic 클라우드 경유

vox.ai Cowork 연동 시 경로

  1. 이상적: vox.ai plugin이 공식 Cowork 마켓플레이스에 등록 → Browse plugins에서 설치
  2. 현재 가능: vox-skills 레포에서 plugin 다운로드 → 커스텀 plugin 파일 업로드
  3. CLI 경유: claude plugin marketplace add vox-public/vox-skills → CLI에서 설치

조직 관리 Plugin

Team/Enterprise 플랜에서는 관리자가 Plugin 마켓플레이스를 통해 조직 전체에 Plugin을 배포할 수 있다. 편집 제한을 걸어 일관성을 유지할 수 있다.