설치 가이드

이 가이드는 MoAI Cowork Plugins을 Claude Desktop에 설치하는 전체 과정을 단계별로 상세히 안내합니다. 약 5-7분 (Claude Desktop이 이미 설치된 경우) 안에 마켓플레이스 등록 + moai-core 활성화까지 완료됩니다.

flowchart TD
    A["① Claude Desktop
다운로드"] --> B["② Anthropic
계정 로그인"]
    B --> C["③ Cowork 모드
활성화"]
    C --> D["④ 작업 폴더
연결"]
    D --> E["⑤ 마켓플레이스
추가"]
    E --> F["⑥ moai-core
설치"]
    F --> G["✅ 설치 완료"]

    style A fill:#eaeaea,stroke:#6e6e6e,color:#09110f
    style B fill:#eaeaea,stroke:#6e6e6e,color:#09110f
    style C fill:#e6f0ef,stroke:#144a46,color:#09110f
    style D fill:#e6f0ef,stroke:#144a46,color:#09110f
    style E fill:#fbf0dc,stroke:#c47b2a,color:#09110f
    style F fill:#fbf0dc,stroke:#c47b2a,color:#09110f
    style G fill:#d6ebe7,stroke:#1c7c70,stroke-width:2px,color:#09110f

Note

시스템 요구사항

• macOS 10.13 이상
• Windows 10 이상
• 8GB 이상 RAM
• 안정적인 인터넷 연결

공식 사이트에서 Claude Desktop을 다운로드합니다:

1. claude.com/download 접속
2. 운영체제에 맞는 버전 다운로드
3. 다운로드된 파일 실행하여 설치 진행

1. Desktop 앱 — 주요 다운로드 대상입니다. macOS와 Windows 버전을 선택할 수 있습니다.
2. Chrome 확장 프로그램 — 브라우저에서 Claude를 사용할 수 있는 확장 프로그램입니다.
3. Slack 통합 — Slack 워크스페이스에서 Claude를 연동합니다.
4. Excel 통합 — Microsoft Excel과 연동하여 스프레드시트 작업을 보조합니다.
5. PowerPoint 통합 — PowerPoint 프레젠테이션 제작을 보조합니다.
6. Word 통합 — Word 문서 작성을 보조합니다.
7. 모바일 앱 — iOS/Android 모바일 앱입니다.

Claude Desktop을 실행하고 Anthropic 계정으로 로그인합니다:

1. Claude Desktop 애플리케이션 실행
2. 로그인 화면에서 Anthropic 계정 정보 입력
3. 2단계 인증이 설정된 경우 인증 코드 입력

Note

중요: 개인 계정 또는 조직 계정 모두 사용 가능하지만, 조직 계정의 경우 관리자 승인이 필요할 수 있습니다.

Cowork 모드를 활성화하여 플러그인 사용이 가능한 환경을 설정합니다:

1. Claude Desktop 왼쪽 사이바에서 “Projects” 선택
2. “Cowork mode"가 표시되지 않으면 설정 메뉴에서 활성화
3. Cowork 모드가 활성화되면 추가 기능 탭이 표시됩니다

1. Cowork 탭 — 사이드바에서 Cowork 탭을 선택합니다.
2. 모델 선택기 — 사용할 AI 모델(Opus 4.7 등)을 선택합니다.
3. 직접 설정 토글 — 수동으로 설정을 제어하는 스위치입니다.
4. 프로젝트 선택기 — 작업 컨텍스트를 전환합니다.
5. Info 드롭다운 — 현재 설정의 상세 정보를 확인합니다.

사용할 작업 폴더를 Claude Desktop에 연결합니다:

1. Customize — 사이드바의 Customize 메뉴를 통해 폴더 연결 및 설정에 접근합니다
2. “Connect a local work folder” 버튼 클릭
3. 작업할 프로젝트 폴더 선택
4. 연결 확인 완료

Note

팁: 기존 프로젝트 폴더를 연결하거나 새로운 폴더를 생성하여 사용할 수 있습니다.

MoAI Cowork Plugins 마켓플레이스를 추가합니다:

1. + 버튼 — 개인 폴더그룹을 추가합니다
2. 추가 버튼 — 새 폴더그룹을 생성합니다
3. 마켓플레이스 추가 — 하단 메뉴에서 마켓플레이스를 추가할 수 있습니다

4. URL 입력 필드 — modu-ai/cowork-plugins을 입력하고 추가를 확인합니다

가장 먼저 moai-core 플러그인을 설치합니다:

1. 개인 탭 — 설치된 플러그인 목록을 확인합니다
2. cowork-plugins 필터 — 마켓플레이스 플러그인만 표시합니다
3. 자동 추가 토글 — 새 스킬 자동 포함 여부를 설정합니다
4. + moai-core 버튼 — moai-core 플러그인을 추가합니다

5. Moai core — 사이드바에 설치된 moai-core 메뉴가 표시됩니다
6. 기능 카드 — 제공되는 스킬 목록을 확인합니다
7. 사용자 지정 토글 — 개별 스킬 활성화/비활성화를 제어합니다

Note

필수 플러그인: moai-core는 /project init과 ai-slop-reviewer 스킬을 포함한 핵심 기능을 제공하므로 반드시 먼저 설치해야 합니다.

설치가 완료되었는지 다음과 같이 확인합니다:

1. Claude Desktop에서 “Plugins” 탭 선택
2. 설치된 플러그인 목록에서 moai-core 확인
3. 상태가 “Active"로 표시되는지 확인

간단한 명령어로 설치를 테스트합니다:

1. Cowork 모드에서 채팅창 열기
2. /project init 입력 후 실행
3. 7단계 인터뷰가 정상적으로 진행되는지 확인

Q: 마켓플레이스가 표시되지 않아요 A: Claude Desktop 최신 버전인지 확인하고, 인터넷 연결 상태를 점검하세요.

Q: moai-core 설치 실패 A: 조직 계정 사용 시 관리자 승인이 필요할 수 있습니다. 관리자에게 문의하세요.

Q: /project init 명령어가 작동하지 않아요 A: moai-core 플러그인이 먼저 설치되었는지 확인하세요. 설치 순서가 중요합니다.

Q: 스킬 목록이 나타나지 않아요 A: Claude Desktop을 재시작하거나, 캐시를 초기화해보세요.

네트워크 문제

• 프록시 설정 확인
• 방화벽에서 Claude Desktop 허용 목록 추가
• DNS 캐시 재시도

권한 문제

• 작업 폴더 읽기/쓰기 권한 확인
• macOS 보안 설정에서 Claude Desktop 권한 부여
• Windows Defender 실행 허용

설치가 완료되었다면 이제 첫 작업을 진행할 준비가 되었습니다:

• 첫 작업 가이드 - 약 5-7분 실습 예제 (설치 완료 후)
• 빠른 시작 가이드 - 주요 스킬 빠르게 숙지하기

• GitHub 저장소: https://github.com/modu-ai/cowork-plugins
• Claude Desktop 다운로드: https://claude.com/download
• 온라인 문서: https://cowork.mo.ai.kr