설치 가이드: 플러그인 마켓 vs 수동 설치

이 튜토리얼을 마치면 할 수 있는 것

본 튜토리얼 완료 후 다음을 수행할 수 있습니다:

플러그인 마켓을 통해 원클릭으로 Everything Claude Code 설치
필요한 컴포넌트를 선택하여 정밀하게 구성하는 수동 설치
MCP 서버와 Hooks 올바르게 구성
설치 성공 여부 확인

현재 직면한 문제

Everything Claude Code를 빠르게 시작하고 싶지만 다음을 알지 못합니다:

플러그인 마켓 원클릭 설치와 수동으로 각 컴포넌트 제어 중 어떤 방식을 사용할까?
구성 오류로 인해 기능이 작동하지 않는 것을 어떻게 피할까?
수동 설치 시 어떤 파일을 어떤 위치에 복사해야 할까?

이 방법을 사용해야 할 때

시나리오	권장 방식	이유
처음 사용하는 경우	플러그인 마켓 설치	가장 간단, 5분 완료
특정 기능을 체험하고 싶은 경우	플러그인 마켓 설치	전체 체험 후 결정
특정 요구사항이 있는 경우	수동 설치	각 컴포넌트 정밀 제어
기존 사용자 정의 구성이 있는 경우	수동 설치	기존 설정 덮어쓰기 방지

핵심 아이디어

Everything Claude Code는 두 가지 설치 방식을 제공합니다:

플러그인 마켓 설치 (권장)
- 대부분의 사용자에게 적합
- 모든 의존성 자동 처리
- 단일 명령어로 설치 완료
수동 설치
- 특정 요구사항이 있는 사용자에게 적합
- 어떤 컴포넌트를 설치할지 정밀 제어
- 수동 구성 필요

어떤 방식을 선택하든 최종적으로는 ~/.claude/ 디렉토리에 구성 파일을 복사하여 Claude Code가 이러한 컴포넌트를 인식하고 사용할 수 있도록 합니다.

🎒 시작 전 준비

전제 조건

시작 전 다음을 확인하세요:

[ ] Claude Code가 설치되어 있음
[ ] GitHub에 접근할 수 있는 네트워크 연결
[ ] 수동 설치를 선택한 경우 기본적인 명령줄 작업 지식

따라 합니다

방식 1: 플러그인 마켓 설치 (권장)

처음 사용하거나 빠르게 체험하고 싶은 사용자에게 가장 적합한 가장 간단한 방식입니다.

1단계: 플러그인 마켓 추가

이유 GitHub 저장소를 Claude Code의 플러그인 마켓으로 등록해야 그곳의 플러그인을 설치할 수 있습니다.

Claude Code에서 다음을 입력하세요:

bash

/plugin marketplace add affaan-m/everything-claude-code

다음과 같이 표시되어야 합니다:

Successfully added marketplace affaan-m/everything-claude-code

2단계: 플러그인 설치

이유 방금 추가한 마켓에서 Everything Claude Code 플러그인을 설치합니다.

Claude Code에서 다음을 입력하세요:

bash

/plugin install everything-claude-code@everything-claude-code

다음과 같이 표시되어야 합니다:

Successfully installed everything-claude-code@everything-claude-code

체크포인트 ✅

플러그인이 설치되었는지 확인:

bash

/plugin list

출력에서 everything-claude-code@everything-claude-code를 확인해야 합니다.

3단계 (선택사항): settings.json 직접 구성

이유 명령줄을 건수하고 바로 구성 파일을 수정하고 싶은 경우.

~/.claude/settings.json을 열어 다음 내용을 추가하세요:

json

{
  "extraKnownMarketplaces": {
    "everything-claude-code": {
      "source": {
        "source": "github",
        "repo": "affaan-m/everything-claude-code"
      }
    }
  },
  "enabledPlugins": {
    "everything-claude-code@everything-claude-code": true
  }
}

다음과 같이 표시되어야 합니다:

구성 파일 업데이트 후 Claude Code가 플러그인을 자동으로 로드
모든 agents, skills, commands, hooks가 즉시 활성화

방식 2: 수동 설치

어떤 컴포넌트를 설치할지 정밀하게 제어하고 싶은 사용자에게 적합합니다.

1단계: 저장소 클론

이유 Everything Claude Code의 모든 소스 파일을 가져옵니다.

bash

git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

다음과 같이 표시되어야 합니다:

Cloning into 'everything-claude-code'...
remote: Enumerating objects...

2단계: agents 복사

이유 전문화된 하위 에이전트를 Claude Code의 agents 디렉토리로 복사합니다.

bash

cp everything-claude-code/agents/*.md ~/.claude/agents/

다음과 같이 표시되어야 합니다:

~/.claude/agents/ 디렉토리에 9개의 agent 파일이 새로 추가됨

체크포인트 ✅

agents가 복사되었는지 확인:

bash

ls ~/.claude/agents/

다음과 유사하게 표시되어야 합니다:

planner.md architect.md tdd-guide.md code-reviewer.md ...

3단계: rules 복사

이유 강제 규칙을 Claude Code의 rules 디렉토리로 복사합니다.

bash

cp everything-claude-code/rules/*.md ~/.claude/rules/

다음과 같이 표시되어야 합니다:

~/.claude/rules/ 디렉토리에 8개의 규칙 파일이 새로 추가됨

4단계: commands 복사

이유 슬래시 명령어를 Claude Code의 commands 디렉토리로 복사합니다.

bash

cp everything-claude-code/commands/*.md ~/.claude/commands/

다음과 같이 표시되어야 합니다:

~/.claude/commands/ 디렉토리에 14개의 명령어 파일이 새로 추가됨

5단계: skills 복사

이유 워크플로우 정의와 도메인 지식을 Claude Code의 skills 디렉토리로 복사합니다.

bash

cp -r everything-claude-code/skills/* ~/.claude/skills/

다음과 같이 표시되어야 합니다:

~/.claude/skills/ 디렉토리에 11개의 스킬 디렉토리가 새로 추가됨

6단계: hooks 구성

이유 자동화 훅 구성을 Claude Code의 settings.json에 추가합니다.

hooks/hooks.json의 내용을 ~/.claude/settings.json에 복사합니다:

bash

cat everything-claude-code/hooks/hooks.json

출력 내용을 다음 형식으로 ~/.claude/settings.json에 추가합니다:

json

{
  "hooks": [
    {
      "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\.(ts|tsx|js|jsx)$\"",
      "hooks": [
        {
          "type": "command",
          "command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
        }
      ]
    }
  ]
}

다음과 같이 표시되어야 합니다:

TypeScript/JavaScript 파일을 편집할 때 console.log가 있으면 경고 표시

중요 알림

~/.claude/settings.json의 기존 구성을 덮어쓰지 않도록 hooks 배열을 확인하세요. 기존 hooks가 있으면 병합해야 합니다.

7단계: MCP 서버 구성

이유 Claude Code의 외부 서비스 통합 능력을 확장합니다.

mcp-configs/mcp-servers.json에서 필요한 MCP 서버를 선택하여 ~/.claude.json에 추가합니다:

bash

cat everything-claude-code/mcp-configs/mcp-servers.json

필요한 구성을 ~/.claude.json에 복사합니다. 예를 들어:

json

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "YOUR_GITHUB_TOKEN_HERE"
      }
    }
  }
}

중요: 플레이스홀더 교체

YOUR_*_HERE 플레이스홀더를 실제 API Key로 반드시 교체하세요. 그렇지 않으면 MCP 서버가 작동하지 않습니다.

MCP 사용 권장사항

모든 MCP를 활성화하지 마세요! 너무 많은 MCP는 컨텍스트 윈도우를 크게 차지합니다.

20-30개의 MCP 서버를 구성하는 것을 권장
프로젝트당 10개 이하를 활성화된 상태로 유지
80개 이하의 활성 도구 유지

프로젝트 구성에서 필요 없는 MCP를 비활성화하려면 disabledMcpServers를 사용하세요:

json

{
  "disabledMcpServers": ["firecrawl", "supabase"]
}

체크포인트 ✅

플러그인 마켓 설치 확인

bash

/plugin list

everything-claude-code@everything-claude-code가 활성화되어 있어야 합니다.

수동 설치 확인

bash

# agents 확인
ls ~/.claude/agents/ | head -5

# rules 확인
ls ~/.claude/rules/ | head -5

# commands 확인
ls ~/.claude/commands/ | head -5

# skills 확인
ls ~/.claude/skills/ | head -5

다음과 같이 표시되어야 합니다:

agents 디렉토리에 planner.md, tdd-guide.md 등이 있음
rules 디렉토리에 security.md, coding-style.md 등이 있음
commands 디렉토리에 tdd.md, plan.md 등이 있음
skills 디렉토리에 coding-standards, backend-patterns 등이 있음

기능 사용 가능 여부 확인

Claude Code에서 다음을 입력하세요:

bash

/tdd

TDD Guide agent가 작동하기 시작해야 합니다.

함정 경고

일반적인 오류 1: 플러그인 설치 후 작동하지 않음

증상: 플러그인을 설치했지만 명령어를 사용할 수 없습니다.

원인: 플러그인이 올바르게 로드되지 않았습니다.

해결 방법:

bash

# 플러그인 목록 확인
/plugin list

# 활성화되지 않은 경우 수동으로 활성화
/plugin enable everything-claude-code@everything-claude-code

일반적인 오류 2: MCP 서버 연결 실패

증상: MCP 기능을 사용할 수 없고 연결 실패 오류가 발생합니다.

원인: API Key가 교첸되지 않았거나 형식이 잘못되었습니다.

해결 방법:

~/.claude.json의 모든 YOUR_*_HERE 플레이스홀더가 교첸되었는지 확인
API Key가 유효한지 확인
MCP 서버 명령어 경로가 올바른지 확인

일반적인 오류 3: hooks가 트리거되지 않음

증상: 파일을 편집할 때 hooks 알림이 표시되지 않습니다.

원인: ~/.claude/settings.json의 hooks 구성 형식이 잘못되었습니다.

해결 방법:

hooks 배열의 형식이 올바른지 확인
matcher 표현식의 문법이 올바른지 확인
hook 명령어 경로가 실행 가능한지 확인

일반적인 오류 4: 파일 권한 문제 (수동 설치)

증상: 파일을 복사할 때 "Permission denied" 오류가 발생합니다.

원인: ~/.claude/ 디렉토리 권한이 부족합니다.

해결 방법:

bash

# .claude 디렉토리가 존재하고 권한이 있는지 확인
mkdir -p ~/.claude/{agents,rules,commands,skills}

# 필요한 경우 sudo 사용
sudo cp -r everything-claude-code/agents/*.md ~/.claude/agents/

본 강의 요약

두 가지 설치 방식 비교:

특성	플러그인 마켓 설치	수동 설치
속도	⚡ 빠름	🐌 느림
난이도	🟢 간단	🟡 중간
유연성	🔒 고정	🔓 사용자 정의 가능
권장 시나리오	초보자, 빠른 체험	고급 사용자, 특정 요구사항

핵심 요점:

플러그인 마켓 설치는 단일 명령어로 완료되는 가장 간단한 방식
수동 설치는 컴포넌트를 정밀하게 제어해야 하는 사용자에게 적합
MCP 구성 시 플레이스홀더를 교체하고 너무 많이 활성화하지 않기
설치 확인 시 디렉토리 구조와 명령어 사용 가능 여부 확인

다음 강의 예고

다음 강의에서는 **패키지 관리자 구성: 자동 감지 및 사용자 정의**를 학습합니다.
학습 내용:
Everything Claude Code가 패키지 관리자를 자동으로 감지하는 방법
6가지 감지 우선순위 작동 메커니즘
프로젝트 레벨 및 사용자 레벨 패키지 관리자 구성 사용자 정의 방법
/setup-pm 명령어로 빠르게 구성

부록: 소스 코드 참고

소스 코드 위치 보기

업데이트 시간: 2026-01-25

기능	파일 경로	라인
플러그인 메타데이터	`source/affaan-m/everything-claude-code/.claude-plugin/plugin.json`	1-28
마켓 목록	`source/affaan-m/everything-claude-code/.claude-plugin/marketplace.json`	1-45
설치 가이드	`source/affaan-m/everything-claude-code/README.md`	175-242
Hooks 구성	`source/affaan-m/everything-claude-code/hooks/hooks.json`	1-146
MCP 구성	`source/affaan-m/everything-claude-code/mcp-configs/mcp-servers.json`	1-95

핵심 구성:

플러그인 이름: everything-claude-code
저장소: affaan-m/everything-claude-code
라이선스: MIT
9개 agents, 14개 commands, 8개 rules, 11개 skills 지원

설치 방식:

플러그인 마켓 설치: /plugin marketplace add + /plugin install
수동 설치: agents, rules, commands, skills를 ~/.claude/에 복사

설치 가이드: 플러그인 마켓 vs 수동 설치 ​

이 튜토리얼을 마치면 할 수 있는 것 ​

현재 직면한 문제 ​

이 방법을 사용해야 할 때 ​

핵심 아이디어 ​

🎒 시작 전 준비 ​

따라 합니다 ​

방식 1: 플러그인 마켓 설치 (권장) ​

1단계: 플러그인 마켓 추가 ​

2단계: 플러그인 설치 ​

3단계 (선택사항): settings.json 직접 구성 ​

방식 2: 수동 설치 ​

1단계: 저장소 클론 ​

2단계: agents 복사 ​

3단계: rules 복사 ​

4단계: commands 복사 ​

5단계: skills 복사 ​

6단계: hooks 구성 ​

7단계: MCP 서버 구성 ​

체크포인트 ✅ ​

플러그인 마켓 설치 확인 ​

수동 설치 확인 ​

기능 사용 가능 여부 확인 ​

함정 경고 ​

일반적인 오류 1: 플러그인 설치 후 작동하지 않음 ​

일반적인 오류 2: MCP 서버 연결 실패 ​

일반적인 오류 3: hooks가 트리거되지 않음 ​

일반적인 오류 4: 파일 권한 문제 (수동 설치) ​

본 강의 요약 ​

다음 강의 예고 ​

부록: 소스 코드 참고 ​

설치 가이드: 플러그인 마켓 vs 수동 설치

이 튜토리얼을 마치면 할 수 있는 것

현재 직면한 문제

이 방법을 사용해야 할 때

핵심 아이디어

🎒 시작 전 준비

따라 합니다

방식 1: 플러그인 마켓 설치 (권장)

1단계: 플러그인 마켓 추가

2단계: 플러그인 설치

3단계 (선택사항): settings.json 직접 구성

방식 2: 수동 설치

1단계: 저장소 클론

2단계: agents 복사

3단계: rules 복사

4단계: commands 복사

5단계: skills 복사

6단계: hooks 구성

7단계: MCP 서버 구성

체크포인트 ✅

플러그인 마켓 설치 확인

수동 설치 확인

기능 사용 가능 여부 확인

함정 경고

일반적인 오류 1: 플러그인 설치 후 작동하지 않음

일반적인 오류 2: MCP 서버 연결 실패

일반적인 오류 3: hooks가 트리거되지 않음

일반적인 오류 4: 파일 권한 문제 (수동 설치)

본 강의 요약

다음 강의 예고

부록: 소스 코드 참고