읽는 시간: 5분 | 난이도: 초급자

플러그인은 Claude Code를 스킬, 에이전트, 훅, MCP 서버로 확장합니다. 플러그인 마켓플레이스는 직접 구축하지 않아도 이러한 확장 기능을 발견하고 설치할 수 있는 카탈로그입니다.

마켓플레이스의 작동 방식

마켓플레이스는 다른 사람들이 만들어 공유한 플러그인의 카탈로그입니다. 마켓플레이스 사용은 두 단계로 이루어집니다:

1단계: 마켓플레이스 추가 카탈로그를 Claude Code에 등록하여 사용 가능한 것들을 탐색할 수 있게 합니다. 아직 플러그인은 설치되지 않습니다.

2단계: 개별 플러그인 설치 카탈로그를 탐색하고 원하는 플러그인을 설치합니다.

앱 스토어를 추가하는 것과 비슷합니다. 스토어를 추가하면 컬렉션을 탐색할 수 있지만, 다운로드할 앱은 개별적으로 선택합니다.

공식 Anthropic 마켓플레이스

공식 Anthropic 마켓플레이스(claude-plugins-official)는 Claude Code를 시작할 때 자동으로 사용 가능합니다. /plugin을 실행하고 Discover 탭으로 이동하여 사용 가능한 것들을 탐색하세요.

공식 마켓플레이스에서 플러그인 설치:

/plugin install plugin-name@claude-plugins-official

코드 인텔리전스 플러그인

코드 인텔리전스 플러그인은 Claude Code의 내장 LSP 도구를 활성화하여 Claude가 정의로 이동하고, 참조를 찾고, 편집 후 즉시 타입 오류를 확인할 수 있게 합니다.

코드 인텔리전스 플러그인이 설치되면 Claude는 두 가지 기능을 갖습니다:

• 자동 진단: Claude가 파일 편집 후 언어 서버가 변경 사항을 분석하고 오류와 경고를 자동으로 보고합니다. 타입 오류, 누락된 임포트, 문법 오류를 컴파일러를 실행하지 않고도 확인합니다.
• 코드 탐색: 정의로 이동, 참조 찾기, 호버 타입 정보, 심볼 목록, 구현 찾기, 호출 계층 추적 기능을 사용할 수 있습니다.

외부 통합 플러그인

사전 설정된 MCP 서버를 번들로 제공하여 수동 설정 없이 Claude를 외부 서비스에 연결합니다:

• 소스 컨트롤: github, gitlab
• 프로젝트 관리: atlassian (Jira/Confluence), asana, linear, notion
• 디자인: figma
• 인프라: vercel, firebase, supabase
• 커뮤니케이션: slack
• 모니터링: sentry

개발 워크플로우 플러그인

일반적인 개발 작업을 위한 명령어와 에이전트를 추가합니다:

• commit-commands: 커밋, 푸시, PR 생성을 포함한 Git 커밋 워크플로우
• pr-review-toolkit: PR 검토를 위한 전문 에이전트
• agent-sdk-dev: Claude Agent SDK로 빌드하기 위한 도구
• plugin-dev: 자체 플러그인 생성을 위한 툴킷

데모 마켓플레이스 시작하기

Anthropic은 플러그인 시스템으로 가능한 것을 보여주는 예제 플러그인이 포함된 데모 플러그인 마켓플레이스(claude-code-plugins)도 유지 관리합니다.

1단계: 마켓플레이스 추가

Claude Code 내에서 다음 명령어를 실행합니다:

/plugin marketplace add anthropics/claude-code

이 명령어는 마켓플레이스 카탈로그를 다운로드하고 플러그인을 사용 가능하게 만듭니다.

2단계: 사용 가능한 플러그인 탐색

/plugin을 실행하여 플러그인 관리자를 엽니다. Tab (또는 뒤로 이동하려면 Shift+Tab)으로 사이클할 수 있는 네 개의 탭이 있는 인터페이스가 열립니다:

• Discover: 모든 마켓플레이스의 사용 가능한 플러그인 탐색
• Installed: 설치된 플러그인 보기 및 관리
• Marketplaces: 추가된 마켓플레이스 추가, 제거, 업데이트
• Errors: 플러그인 로딩 오류 보기

Discover 탭으로 이동하여 방금 추가한 마켓플레이스의 플러그인을 확인합니다.

3단계: 플러그인 설치

플러그인을 선택하여 세부 정보를 보고 설치 스코프를 선택합니다:

• User scope: 모든 프로젝트에서 직접 사용 가능
• Project scope: 이 저장소의 모든 협업자에게 설치
• Local scope: 이 저장소에서만, 본인만 사용

커맨드라인에서 직접 설치할 수도 있습니다:

/plugin install commit-commands@anthropics-claude-code

4단계: 새 플러그인 사용하기

설치 후 플러그인 명령어를 즉시 사용할 수 있습니다. 플러그인 명령어는 플러그인 이름으로 네임스페이스가 지정됩니다. commit-commands 플러그인은 /commit-commands:commit 같은 명령어를 제공합니다:

/commit-commands:commit

이 명령어는 변경 사항을 스테이징하고, 커밋 메시지를 생성하고, 커밋을 만듭니다.

마켓플레이스 추가하기

/plugin marketplace add 명령어를 사용하여 다양한 소스에서 마켓플레이스를 추가합니다.

GitHub에서 추가

owner/repo 형식을 사용하여 .claude-plugin/marketplace.json 파일이 포함된 GitHub 저장소를 추가합니다:

/plugin marketplace add anthropics/claude-code

다른 Git 호스트에서 추가

GitLab, Bitbucket, 자체 호스팅 서버를 포함한 모든 Git 저장소에서 추가할 수 있습니다:

# HTTPS 사용
/plugin marketplace add https://gitlab.com/company/plugins.git

# SSH 사용
/plugin marketplace add git@gitlab.com:company/plugins.git

# 특정 브랜치 또는 태그
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

로컬 경로에서 추가

.claude-plugin/marketplace.json 파일이 포함된 로컬 디렉터리를 추가합니다:

/plugin marketplace add ./my-marketplace

원격 URL에서 추가

URL을 통해 원격 marketplace.json 파일을 추가합니다:

/plugin marketplace add https://example.com/marketplace.json

플러그인 관리

설치된 플러그인 관리

/plugin을 실행하고 Installed 탭으로 이동하여 플러그인을 보기, 활성화, 비활성화, 제거합니다.

# 플러그인 비활성화 (제거 없이)
/plugin disable plugin-name@marketplace-name

# 비활성화된 플러그인 재활성화
/plugin enable plugin-name@marketplace-name

# 플러그인 완전 제거
/plugin uninstall plugin-name@marketplace-name

--scope 옵션으로 특정 스코프를 대상으로 합니다:

claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project

마켓플레이스 관리

# 마켓플레이스 목록 보기
/plugin marketplace list

# 마켓플레이스 플러그인 목록 새로고침
/plugin marketplace update marketplace-name

# 마켓플레이스 제거
/plugin marketplace remove marketplace-name

마켓플레이스를 제거하면 해당 마켓플레이스에서 설치한 모든 플러그인도 제거됩니다.

자동 업데이트 설정

Claude Code는 시작 시 마켓플레이스와 설치된 플러그인을 자동으로 업데이트할 수 있습니다. 자동 업데이트를 설정하려면:

1. /plugin을 실행하여 플러그인 관리자 열기
2. Marketplaces 선택
3. 마켓플레이스를 목록에서 선택
4. Enable auto-update 또는 Disable auto-update 선택

Claude Code 자동 업데이트는 비활성화하면서 플러그인 자동 업데이트는 유지하려면:

export DISABLE_AUTOUPDATER=true
export FORCE_AUTOUPDATE_PLUGINS=true

팀 마켓플레이스 설정

팀 관리자는 .claude/settings.json에 마켓플레이스 설정을 추가하여 프로젝트에 대한 자동 마켓플레이스 설치를 설정할 수 있습니다. 팀 멤버들이 저장소 폴더를 신뢰할 때 Claude Code가 이러한 마켓플레이스와 플러그인을 설치하도록 프롬프트합니다.

문제 해결

/plugin 명령어가 인식되지 않는 경우

1. 버전 확인: claude --version 실행. 플러그인에는 버전 1.0.33 이상이 필요합니다.
2. Claude Code 업데이트:
   • Homebrew: brew upgrade claude-code
   • npm: npm update -g @anthropic-ai/claude-code
3. Claude Code 재시작: 업데이트 후 터미널을 재시작하고 claude를 다시 실행합니다.

일반적인 문제

• 마켓플레이스가 로딩되지 않음: URL이 접근 가능하고 .claude-plugin/marketplace.json이 경로에 존재하는지 확인
• 플러그인 설치 실패: 플러그인 소스 URL이 접근 가능하고 저장소가 공개되어 있는지(또는 접근 권한이 있는지) 확인
• 플러그인 스킬이 나타나지 않음: rm -rf ~/.claude/plugins/cache로 캐시를 지우고, Claude Code를 재시작하고, 플러그인을 다시 설치

코드 인텔리전스 문제

• 언어 서버가 시작되지 않음: 바이너리가 설치되어 있고 $PATH에서 사용 가능한지 확인. /plugin Errors 탭에서 세부 정보 확인.
• 높은 메모리 사용량: rust-analyzer와 pyright 같은 언어 서버는 대형 프로젝트에서 상당한 메모리를 소비할 수 있습니다. 메모리 문제가 발생하면 /plugin disable <plugin-name>으로 플러그인을 비활성화하세요.

다음 단계

• 플러그인 만들기: 플러그인 가이드에서 스킬, 에이전트, 훅 만들기
• 마켓플레이스 만들기: 플러그인 마켓플레이스 만들기 가이드로 팀이나 커뮤니티에 플러그인 배포
• 기술 레퍼런스: 플러그인 레퍼런스에서 완전한 사양 확인
• VS Code에서 사용: VS Code 통합 가이드에서 그래픽 플러그인 관리 인터페이스 확인