마켓플레이스 작동 방식
마켓플레이스는 다른 사람이 만들고 공유한 플러그인의 카탈로그입니다. 마켓플레이스를 사용하는 것은 2단계 프로세스입니다:
앱 스토어를 추가하는 것과 같다고 생각하면 됩니다. 스토어를 추가하면 해당 컬렉션을 찾아볼 수 있지만, 여전히 개별적으로 다운로드할 앱을 선택합니다.
공식 Anthropic 마켓플레이스
공식 Anthropic 마켓플레이스(claude-plugins-official)는 Claude Code를 시작할 때 자동으로 사용 가능합니다. /plugin을 실행하고 Discover 탭으로 이동하여 사용 가능한 항목을 찾아보세요.
공식 마켓플레이스에서 플러그인을 설치하려면:
공식 마켓플레이스는 Anthropic에서 유지 관리합니다. 자신의 플러그인을 배포하려면 자신의 마켓플레이스를 만들고 사용자와 공유하세요.
코드 인텔리전스
코드 인텔리전스 플러그인은 Claude가 코드베이스를 더 깊이 있게 이해하도록 도와줍니다. 이러한 플러그인이 설치되면 Claude는 정의로 이동하고, 참조를 찾으며, 편집 직후 유형 오류를 볼 수 있습니다. 이러한 플러그인은 Language Server Protocol (LSP)을 사용하며, 이는 VS Code의 코드 인텔리전스를 구동하는 동일한 기술입니다. 이러한 플러그인을 사용하려면 언어 서버 바이너리가 시스템에 설치되어 있어야 합니다. 이미 언어 서버가 설치되어 있으면 프로젝트를 열 때 Claude가 해당 플러그인을 설치하도록 요청할 수 있습니다.| 언어 | 플러그인 | 필요한 바이너리 |
|---|---|---|
| C/C++ | clangd-lsp | clangd |
| C# | csharp-lsp | csharp-ls |
| Go | gopls-lsp | gopls |
| Java | jdtls-lsp | jdtls |
| Lua | lua-lsp | lua-language-server |
| PHP | php-lsp | intelephense |
| Python | pyright-lsp | pyright-langserver |
| Rust | rust-analyzer-lsp | rust-analyzer |
| Swift | swift-lsp | sourcekit-lsp |
| TypeScript | typescript-lsp | typescript-language-server |
플러그인을 설치한 후
/plugin Errors 탭에서 Executable not found in $PATH를 보면 위 표에서 필요한 바이너리를 설치하세요.외부 통합
이러한 플러그인은 미리 구성된 MCP 서버를 번들로 제공하므로 수동 설정 없이 Claude를 외부 서비스에 연결할 수 있습니다:- 소스 제어:
github,gitlab - 프로젝트 관리:
atlassian(Jira/Confluence),asana,linear,notion - 디자인:
figma - 인프라:
vercel,firebase,supabase - 커뮤니케이션:
slack - 모니터링:
sentry
개발 워크플로우
일반적인 개발 작업을 위한 명령 및 에이전트를 추가하는 플러그인:- commit-commands: 커밋, 푸시 및 PR 생성을 포함한 Git 커밋 워크플로우
- pr-review-toolkit: 풀 요청 검토를 위한 특화된 에이전트
- agent-sdk-dev: Claude Agent SDK로 빌드하기 위한 도구
- plugin-dev: 자신의 플러그인을 만들기 위한 도구 키트
출력 스타일
Claude가 응답하는 방식을 사용자 정의하세요:- explanatory-output-style: 구현 선택에 대한 교육적 통찰력
- learning-output-style: 기술 구축을 위한 대화형 학습 모드
시도해보기: 데모 마켓플레이스 추가
Anthropic은 또한 플러그인 시스템으로 가능한 것을 보여주는 예제 플러그인이 있는 데모 플러그인 마켓플레이스(claude-code-plugins)를 유지 관리합니다. 공식 마켓플레이스와 달리 이 마켓플레이스는 수동으로 추가해야 합니다.
마켓플레이스 추가
Claude Code 내에서 이는 마켓플레이스 카탈로그를 다운로드하고 해당 플러그인을 사용 가능하게 합니다.
anthropics/claude-code 마켓플레이스에 대해 plugin marketplace add 명령을 실행하세요:사용 가능한 플러그인 찾아보기
/plugin을 실행하여 플러그인 관리자를 엽니다. 이는 Tab (또는 뒤로 가려면 Shift+Tab)을 사용하여 순환할 수 있는 4개의 탭이 있는 탭 인터페이스를 엽니다:- Discover: 모든 마켓플레이스에서 사용 가능한 플러그인 찾아보기
- Installed: 설치된 플러그인 보기 및 관리
- Marketplaces: 추가된 마켓플레이스 추가, 제거 또는 업데이트
- Errors: 플러그인 로딩 오류 보기
플러그인 설치
플러그인을 선택하여 세부 정보를 보고 설치 범위를 선택하세요:범위에 대해 자세히 알아보려면 Configuration scopes를 참조하세요.
- User scope: 모든 프로젝트에서 자신을 위해 설치
- Project scope: 이 저장소의 모든 협력자를 위해 설치
- Local scope: 이 저장소에서 자신을 위해서만 설치
마켓플레이스 추가
/plugin marketplace add 명령을 사용하여 다양한 소스에서 마켓플레이스를 추가하세요.
- GitHub 저장소:
owner/repo형식 (예:anthropics/claude-code) - Git URL: 모든 git 저장소 URL (GitLab, Bitbucket, 자체 호스팅)
- 로컬 경로: 디렉토리 또는
marketplace.json파일에 대한 직접 경로 - 원격 URL: 호스팅된
marketplace.json파일에 대한 직접 URL
GitHub에서 추가
.claude-plugin/marketplace.json 파일을 포함하는 GitHub 저장소를 owner/repo 형식을 사용하여 추가하세요. 여기서 owner는 GitHub 사용자 이름 또는 조직이고 repo는 저장소 이름입니다.
예를 들어 anthropics/claude-code는 anthropics가 소유한 claude-code 저장소를 나타냅니다:
다른 Git 호스트에서 추가
전체 URL을 제공하여 모든 git 저장소를 추가하세요. 이는 GitLab, Bitbucket 및 자체 호스팅 서버를 포함한 모든 Git 호스트에서 작동합니다: HTTPS 사용:# 뒤에 ref를 추가하세요:
로컬 경로에서 추가
.claude-plugin/marketplace.json 파일을 포함하는 로컬 디렉토리를 추가하세요:
marketplace.json 파일에 대한 직접 경로를 추가할 수도 있습니다:
원격 URL에서 추가
URL을 통해 원격marketplace.json 파일을 추가하세요:
URL 기반 마켓플레이스는 Git 기반 마켓플레이스에 비해 일부 제한 사항이 있습니다. 플러그인을 설치할 때 “path not found” 오류가 발생하면 문제 해결을 참조하세요.
플러그인 설치
마켓플레이스를 추가한 후 플러그인을 직접 설치할 수 있습니다 (기본적으로 사용자 범위에 설치됨):/plugin을 실행하고 Discover 탭으로 이동한 후 플러그인에서 Enter를 누르세요. 다음 옵션이 표시됩니다:
- User scope (기본값): 모든 프로젝트에서 자신을 위해 설치
- Project scope: 이 저장소의 모든 협력자를 위해 설치 (
.claude/settings.json에 추가) - Local scope: 이 저장소에서 자신을 위해서만 설치 (협력자와 공유되지 않음)
/plugin을 실행하고 Installed 탭으로 이동하여 범위별로 그룹화된 플러그인을 확인하세요.
설치된 플러그인 관리
/plugin을 실행하고 Installed 탭으로 이동하여 플러그인을 보고, 활성화하고, 비활성화하거나, 제거하세요.
직접 명령으로 플러그인을 관리할 수도 있습니다.
플러그인을 제거하지 않고 비활성화:
--scope 옵션을 사용하면 CLI 명령으로 특정 범위를 대상으로 지정할 수 있습니다:
마켓플레이스 관리
대화형/plugin 인터페이스 또는 CLI 명령을 통해 마켓플레이스를 관리할 수 있습니다.
대화형 인터페이스 사용
/plugin을 실행하고 Marketplaces 탭으로 이동하여:
- 소스 및 상태와 함께 추가된 모든 마켓플레이스 보기
- 새 마켓플레이스 추가
- 마켓플레이스 목록을 업데이트하여 최신 플러그인 가져오기
- 더 이상 필요하지 않은 마켓플레이스 제거
CLI 명령 사용
직접 명령으로 마켓플레이스를 관리할 수도 있습니다. 구성된 모든 마켓플레이스 나열:자동 업데이트 구성
Claude Code는 시작 시 마켓플레이스 및 설치된 플러그인을 자동으로 업데이트할 수 있습니다. 마켓플레이스에 대해 자동 업데이트가 활성화되면 Claude Code는 마켓플레이스 데이터를 새로 고치고 설치된 플러그인을 최신 버전으로 업데이트합니다. 플러그인이 업데이트되면 Claude Code를 다시 시작하도록 제안하는 알림이 표시됩니다. UI를 통해 개별 마켓플레이스에 대한 자동 업데이트를 전환하세요:/plugin을 실행하여 플러그인 관리자 열기- Marketplaces 선택
- 목록에서 마켓플레이스 선택
- Enable auto-update 또는 Disable auto-update 선택
DISABLE_AUTOUPDATER 환경 변수를 설정하세요. 자세한 내용은 Auto updates를 참조하세요.
Claude Code 자동 업데이트를 비활성화하면서 플러그인 자동 업데이트를 활성화된 상태로 유지하려면 DISABLE_AUTOUPDATER와 함께 FORCE_AUTOUPDATE_PLUGINS=true를 설정하세요:
팀 마켓플레이스 구성
팀 관리자는.claude/settings.json에 마켓플레이스 구성을 추가하여 프로젝트에 대한 자동 마켓플레이스 설치를 설정할 수 있습니다. 팀 멤버가 저장소 폴더를 신뢰하면 Claude Code는 이러한 마켓플레이스 및 플러그인을 설치하도록 요청합니다.
extraKnownMarketplaces 및 enabledPlugins를 포함한 전체 구성 옵션은 Plugin settings를 참조하세요.
문제 해결
/plugin 명령을 인식하지 못함
“unknown command”가 표시되거나/plugin 명령이 나타나지 않으면:
- 버전 확인:
claude --version을 실행하세요. 플러그인에는 버전 1.0.33 이상이 필요합니다. - Claude Code 업데이트:
- Homebrew:
brew upgrade claude-code - npm:
npm update -g @anthropic-ai/claude-code - Native installer: Setup에서 설치 명령을 다시 실행하세요.
- Homebrew:
- Claude Code 다시 시작: 업데이트 후 터미널을 다시 시작하고
claude를 다시 실행하세요.
일반적인 문제
- 마켓플레이스가 로드되지 않음: URL에 액세스할 수 있고 경로에
.claude-plugin/marketplace.json이 있는지 확인하세요. - 플러그인 설치 실패: 플러그인 소스 URL에 액세스할 수 있고 저장소가 공개되어 있거나 액세스 권한이 있는지 확인하세요.
- 설치 후 파일을 찾을 수 없음: 플러그인은 캐시에 복사되므로 플러그인 디렉토리 외부의 파일을 참조하는 경로는 작동하지 않습니다.
- 플러그인 Skills가 나타나지 않음:
rm -rf ~/.claude/plugins/cache로 캐시를 지우고, Claude Code를 다시 시작한 후 플러그인을 다시 설치하세요. 자세한 내용은 Plugin Skills not appearing을 참조하세요.
다음 단계
- 자신의 플러그인 빌드: 사용자 정의 명령, 에이전트 및 훅을 만들려면 Plugins를 참조하세요.
- 마켓플레이스 만들기: 팀 또는 커뮤니티에 플러그인을 배포하려면 Create a plugin marketplace를 참조하세요.
- 기술 참조: 완전한 사양은 Plugins reference를 참조하세요.