Marketplace를 통해 사전 빌드된 플러그인 검색 및 설치

marketplace에서 플러그인을 찾아 설치하여 Claude Code에 새로운 명령어, 에이전트, 기능을 확장하세요.

플러그인은 skill, 에이전트, hook, MCP 서버를 통해 Claude Code를 확장합니다. 플러그인 marketplace는 직접 빌드하지 않고도 이러한 extension을 검색하고 설치할 수 있도록 도와주는 카탈로그입니다.

자체 marketplace를 만들어 배포하고 싶다면 플러그인 marketplace 생성 및 배포를 참조하세요.

Marketplace 작동 방식

marketplace는 누군가가 만들어 공유한 플러그인 카탈로그입니다. marketplace 사용은 2단계 프로세스입니다:

Step 1: Marketplace 추가

카탈로그를 Claude Code에 등록하여 사용 가능한 항목을 탐색할 수 있습니다. 아직 플러그인은 설치되지 않습니다.

Step 2: 개별 플러그인 설치

카탈로그를 탐색하고 원하는 플러그인을 설치합니다.

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

공식 Anthropic marketplace

공식 Anthropic marketplace(claude-plugins-official)는 Claude Code를 시작하면 자동으로 사용할 수 있습니다. /plugin을 실행하고 Discover 탭으로 이동하여 사용 가능한 항목을 탐색하세요.

공식 marketplace에서 플러그인을 설치하려면:

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

참고:

공식 marketplace는 Anthropic에서 관리합니다. 공식 marketplace에 플러그인을 제출하려면 인앱 제출 양식 중 하나를 사용하세요:

Claude.ai: claude.ai/settings/plugins/submit

Console: platform.claude.com/plugins/submit

플러그인을 독립적으로 배포하려면 자체 marketplace를 만들어 사용자들과 공유하세요.

공식 marketplace에는 여러 카테고리의 플러그인이 포함되어 있습니다:

Code intelligence

Code intelligence 플러그인은 Claude Code의 내장 LSP 도구를 활성화하여 Claude가 정의로 이동하고, 참조를 찾고, 편집 직후 타입 오류를 확인할 수 있게 합니다. 이 플러그인들은 VS Code의 code intelligence를 구동하는 것과 동일한 기술인 Language Server Protocol 연결을 구성합니다.

이 플러그인들은 시스템에 language server 바이너리가 설치되어 있어야 합니다. 이미 language server가 설치되어 있다면 프로젝트를 열 때 Claude가 해당 플러그인을 설치하라고 안내할 수 있습니다.

언어	플러그인	필요한 바이너리
C/C++	`clangd-lsp`	`clangd`
C#	`csharp-lsp`	`csharp-ls`
Go	`gopls-lsp`	`gopls`
Java	`jdtls-lsp`	`jdtls`
Kotlin	`kotlin-lsp`	`kotlin-language-server`
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`

다른 언어를 위한 자체 LSP 플러그인을 만들 수도 있습니다.

참고:

플러그인 설치 후 /plugin Errors 탭에서 Executable not found in $PATH가 표시되면 위 표에서 필요한 바이너리를 설치하세요.

Code intelligence 플러그인으로 Claude가 얻는 능력

code intelligence 플러그인이 설치되고 language server 바이너리가 사용 가능하면 Claude는 두 가지 능력을 얻습니다:

자동 진단: Claude가 파일을 편집할 때마다 language server가 변경 사항을 분석하고 오류 및 경고를 자동으로 보고합니다. Claude는 컴파일러나 린터를 실행할 필요 없이 타입 오류, 누락된 import, 구문 문제를 확인합니다. Claude가 오류를 발생시키면 같은 턴에서 문제를 인식하고 수정합니다. 플러그인 설치 외에 추가 구성이 필요하지 않습니다. "diagnostics found" 표시가 나타나면 Ctrl+O를 눌러 인라인으로 진단을 확인할 수 있습니다.
코드 네비게이션: Claude는 language server를 사용하여 정의로 이동, 참조 찾기, 호버 시 타입 정보 확인, 심볼 목록 조회, 구현 찾기, 호출 계층 추적을 수행할 수 있습니다. 이러한 작업은 grep 기반 검색보다 더 정확한 네비게이션을 제공하지만, 언어 및 환경에 따라 가용성이 다를 수 있습니다.

문제가 발생하면 Code intelligence 문제 해결을 참조하세요.

외부 통합

이 플러그인들은 사전 구성된 MCP 서버를 번들로 제공하여 수동 설정 없이 Claude를 외부 서비스에 연결할 수 있게 합니다:

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

개발 워크플로우

일반적인 개발 작업을 위한 명령어와 에이전트를 추가하는 플러그인:

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

출력 스타일

Claude의 응답 방식을 커스터마이즈:

explanatory-output-style: 구현 선택에 대한 교육적 인사이트
learning-output-style: 스킬 빌딩을 위한 대화형 학습 모드

데모 marketplace 추가해보기

Anthropic은 또한 플러그인 시스템으로 무엇이 가능한지 보여주는 예시 플러그인이 포함된 데모 플러그인 marketplace(claude-code-plugins)를 관리하고 있습니다. 공식 marketplace와 달리 이것은 수동으로 추가해야 합니다.

Step 1: Marketplace 추가

Claude Code 내에서 anthropics/claude-code marketplace에 대해 plugin marketplace add 명령을 실행합니다:

/plugin marketplace add anthropics/claude-code

이것은 marketplace 카탈로그를 다운로드하고 플러그인을 사용할 수 있게 합니다.

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

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

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

방금 추가한 marketplace의 플러그인을 보려면 Discover 탭으로 이동하세요.

Step 3: 플러그인 설치

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

User scope: 모든 프로젝트에서 자신을 위해 설치
Project scope: 이 저장소의 모든 협업자를 위해 설치
Local scope: 이 저장소에서 자신만을 위해 설치

예를 들어, commit-commands(git 워크플로우 명령어를 추가하는 플러그인)를 선택하고 user scope로 설치합니다.

명령줄에서 직접 설치할 수도 있습니다:

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

scope에 대해 자세히 알아보려면 구성 scope를 참조하세요.

Step 4: 새 플러그인 사용

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

파일을 변경한 후 다음을 실행해 보세요:

/commit-commands:commit

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

각 플러그인은 다르게 작동합니다. 플러그인이 제공하는 명령어와 기능을 알아보려면 Discover 탭의 플러그인 설명이나 홈페이지를 확인하세요.

이 가이드의 나머지 부분에서는 marketplace를 추가하고, 플러그인을 설치하고, 구성을 관리하는 모든 방법을 다룹니다.

Marketplace 추가

/plugin marketplace add 명령을 사용하여 다양한 소스에서 marketplace를 추가합니다.

팁:

단축키: /plugin marketplace 대신 /plugin market을, remove 대신 rm을 사용할 수 있습니다.

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 저장소를 가리킵니다:

/plugin marketplace add anthropics/claude-code

다른 Git 호스트에서 추가

전체 URL을 제공하여 모든 git 저장소를 추가합니다. GitLab, Bitbucket, 자체 호스팅 서버를 포함한 모든 Git 호스트에서 작동합니다:

HTTPS 사용:

/plugin marketplace add https://gitlab.com/company/plugins.git

SSH 사용:

/plugin marketplace add [email protected]:company/plugins.git

특정 브랜치나 태그를 추가하려면 # 뒤에 ref를 붙입니다:

/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

로컬 경로에서 추가

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

/plugin marketplace add ./my-marketplace

marketplace.json 파일에 대한 직접 경로를 추가할 수도 있습니다:

/plugin marketplace add ./path/to/marketplace.json

원격 URL에서 추가

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

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

참고:

URL 기반 marketplace는 Git 기반 marketplace에 비해 일부 제한이 있습니다. 플러그인 설치 시 "path not found" 오류가 발생하면 문제 해결을 참조하세요.

플러그인 설치

marketplace를 추가한 후 플러그인을 직접 설치할 수 있습니다 (기본적으로 user scope에 설치):

/plugin install plugin-name@marketplace-name

다른 설치 scope를 선택하려면 대화형 UI를 사용하세요: /plugin을 실행하고 Discover 탭으로 이동한 후 플러그인에서 Enter를 누릅니다. 다음 옵션이 표시됩니다:

User scope (기본값): 모든 프로젝트에서 자신을 위해 설치
Project scope: 이 저장소의 모든 협업자를 위해 설치 (.claude/settings.json에 추가)
Local scope: 이 저장소에서 자신만을 위해 설치 (협업자와 공유되지 않음)

managed scope의 플러그인도 볼 수 있습니다 — 이것은 관리자가 managed settings를 통해 설치한 것으로 수정할 수 없습니다.

/plugin을 실행하고 Installed 탭으로 이동하면 scope별로 그룹화된 플러그인을 볼 수 있습니다.

주의:

설치하기 전에 플러그인을 신뢰하는지 확인하세요. Anthropic은 플러그인에 포함된 MCP 서버, 파일 또는 기타 소프트웨어를 제어하지 않으며 의도한 대로 작동하는지 확인할 수 없습니다. 자세한 정보는 각 플러그인의 홈페이지를 확인하세요.

설치된 플러그인 관리

/plugin을 실행하고 Installed 탭으로 이동하여 플러그인을 보고, 활성화, 비활성화 또는 제거합니다. 플러그인 이름이나 설명으로 목록을 필터링할 수 있습니다.

직접 명령어로도 플러그인을 관리할 수 있습니다.

제거하지 않고 플러그인 비활성화:

/plugin disable plugin-name@marketplace-name

비활성화된 플러그인 재활성화:

/plugin enable plugin-name@marketplace-name

플러그인 완전히 제거:

/plugin uninstall plugin-name@marketplace-name

--scope 옵션으로 CLI 명령에서 특정 scope를 지정할 수 있습니다:

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

재시작 없이 플러그인 변경 사항 적용

세션 중 플러그인을 설치, 활성화 또는 비활성화하면 일부 변경 사항(새 명령어, hook 등)은 즉시 적용됩니다. LSP 서버 업데이트를 포함한 다른 변경 사항은 재시작이 필요합니다.

재시작 없이 모든 보류 중인 플러그인 변경 사항을 활성화하려면 다음을 실행하세요:

/reload-plugins

Claude Code가 모든 활성 플러그인을 다시 로드하고 로드된 내용을 보고합니다. LSP 서버가 추가되거나 업데이트된 경우 재시작이 필요하다고 알려줍니다.

Marketplace 관리

대화형 /plugin 인터페이스 또는 CLI 명령을 통해 marketplace를 관리할 수 있습니다.

대화형 인터페이스 사용

/plugin을 실행하고 Marketplaces 탭으로 이동하여:

소스 및 상태와 함께 추가된 모든 marketplace 보기
새 marketplace 추가
marketplace 목록을 업데이트하여 최신 플러그인 가져오기
더 이상 필요하지 않은 marketplace 제거

CLI 명령 사용

직접 명령으로도 marketplace를 관리할 수 있습니다.

구성된 모든 marketplace 나열:

/plugin marketplace list

marketplace에서 플러그인 목록 새로고침:

/plugin marketplace update marketplace-name

marketplace 제거:

/plugin marketplace remove marketplace-name

주의:

marketplace를 제거하면 해당 marketplace에서 설치한 모든 플러그인이 제거됩니다.

자동 업데이트 구성

Claude Code는 시작 시 marketplace와 설치된 플러그인을 자동으로 업데이트할 수 있습니다. marketplace에 대해 자동 업데이트가 활성화되면 Claude Code는 marketplace 데이터를 새로고침하고 설치된 플러그인을 최신 버전으로 업데이트합니다. 플러그인이 업데이트된 경우 Claude Code를 재시작하라는 알림이 표시됩니다.

UI를 통해 개별 marketplace의 자동 업데이트를 토글합니다:

/plugin을 실행하여 플러그인 관리자를 엽니다
Marketplaces를 선택합니다
목록에서 marketplace를 선택합니다
Enable auto-update 또는 Disable auto-update를 선택합니다

공식 Anthropic marketplace는 기본적으로 자동 업데이트가 활성화되어 있습니다. 서드파티 및 로컬 개발 marketplace는 기본적으로 자동 업데이트가 비활성화되어 있습니다.

Claude Code와 모든 플러그인의 자동 업데이트를 완전히 비활성화하려면 DISABLE_AUTOUPDATER 환경 변수를 설정합니다. 자세한 내용은 자동 업데이트를 참조하세요.

Claude Code 자동 업데이트는 비활성화하면서 플러그인 자동 업데이트는 유지하려면 DISABLE_AUTOUPDATER와 함께 FORCE_AUTOUPDATE_PLUGINS=true를 설정합니다:

export DISABLE_AUTOUPDATER=true
export FORCE_AUTOUPDATE_PLUGINS=true

이것은 Claude Code 업데이트는 수동으로 관리하면서 자동 플러그인 업데이트는 계속 받고 싶을 때 유용합니다.

팀 marketplace 구성

팀 관리자는 marketplace 구성을 .claude/settings.json에 추가하여 프로젝트에 대한 자동 marketplace 설치를 설정할 수 있습니다. 팀 멤버가 저장소 폴더를 신뢰하면 Claude Code가 이 marketplace와 플러그인을 설치하라는 메시지를 표시합니다.

프로젝트의 .claude/settings.json에 extraKnownMarketplaces를 추가합니다:

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

extraKnownMarketplaces 및 enabledPlugins을 포함한 전체 구성 옵션은 플러그인 설정을 참조하세요.

보안

플러그인과 marketplace는 사용자 권한으로 머신에서 임의의 코드를 실행할 수 있는 높은 신뢰 수준의 구성 요소입니다. 신뢰할 수 있는 소스의 플러그인만 설치하고 marketplace만 추가하세요. 조직은 managed marketplace 제한을 사용하여 사용자가 추가할 수 있는 marketplace를 제한할 수 있습니다.

문제 해결

/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에서 설치 명령을 다시 실행합니다
Claude Code 재시작: 업데이트 후 터미널을 재시작하고 claude를 다시 실행합니다.

일반적인 문제

Marketplace가 로드되지 않음: URL이 접근 가능하고 해당 경로에 .claude-plugin/marketplace.json이 존재하는지 확인합니다
플러그인 설치 실패: 플러그인 소스 URL이 접근 가능하고 저장소가 공개되어 있거나(또는 접근 권한이 있는지) 확인합니다
설치 후 파일을 찾을 수 없음: 플러그인은 캐시에 복사되므로 플러그인 디렉토리 외부의 파일을 참조하는 경로는 작동하지 않습니다
플러그인 skill이 나타나지 않음: rm -rf ~/.claude/plugins/cache로 캐시를 삭제하고 Claude Code를 재시작한 후 플러그인을 다시 설치합니다.

자세한 문제 해결과 해결 방법은 marketplace 가이드의 문제 해결을 참조하세요. 디버깅 도구는 디버깅 및 개발 도구를 참조하세요.

Code intelligence 문제

Language server가 시작되지 않음: 바이너리가 설치되어 있고 $PATH에서 사용 가능한지 확인합니다. 자세한 내용은 /plugin Errors 탭을 확인하세요.
높은 메모리 사용량: rust-analyzer나 pyright 같은 language server는 대규모 프로젝트에서 상당한 메모리를 소비할 수 있습니다. 메모리 문제가 발생하면 /plugin disable <plugin-name>으로 플러그인을 비활성화하고 Claude의 내장 검색 도구를 대신 사용하세요.
모노레포에서의 오탐 진단: workspace가 올바르게 구성되지 않은 경우 language server가 내부 패키지에 대해 해결되지 않은 import 오류를 보고할 수 있습니다. 이는 Claude의 코드 편집 능력에 영향을 미치지 않습니다.

다음 단계

자체 플러그인 빌드: skill, 에이전트, hook을 만들려면 Plugins를 참조하세요
Marketplace 만들기: 팀이나 커뮤니티에 플러그인을 배포하려면 플러그인 marketplace 만들기를 참조하세요
기술 레퍼런스: 전체 사양은 Plugins reference를 참조하세요

Marketplace를 통해 사전 빌드된 플러그인 검색 및 설치

marketplace에서 플러그인을 찾아 설치하여 Claude Code에 새로운 명령어, 에이전트, 기능을 확장하세요.

자체 marketplace를 만들어 배포하고 싶다면 플러그인 marketplace 생성 및 배포를 참조하세요.

Marketplace 작동 방식

marketplace는 누군가가 만들어 공유한 플러그인 카탈로그입니다. marketplace 사용은 2단계 프로세스입니다:

Step 1: Marketplace 추가

카탈로그를 Claude Code에 등록하여 사용 가능한 항목을 탐색할 수 있습니다. 아직 플러그인은 설치되지 않습니다.

Step 2: 개별 플러그인 설치

카탈로그를 탐색하고 원하는 플러그인을 설치합니다.

공식 Anthropic marketplace

공식 marketplace에서 플러그인을 설치하려면:

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

참고:

공식 marketplace는 Anthropic에서 관리합니다. 공식 marketplace에 플러그인을 제출하려면 인앱 제출 양식 중 하나를 사용하세요:

Claude.ai: claude.ai/settings/plugins/submit

Console: platform.claude.com/plugins/submit

플러그인을 독립적으로 배포하려면 자체 marketplace를 만들어 사용자들과 공유하세요.

공식 marketplace에는 여러 카테고리의 플러그인이 포함되어 있습니다:

Code intelligence

언어	플러그인	필요한 바이너리
C/C++	`clangd-lsp`	`clangd`
C#	`csharp-lsp`	`csharp-ls`
Go	`gopls-lsp`	`gopls`
Java	`jdtls-lsp`	`jdtls`
Kotlin	`kotlin-lsp`	`kotlin-language-server`
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`

다른 언어를 위한 자체 LSP 플러그인을 만들 수도 있습니다.

참고:

플러그인 설치 후 /plugin Errors 탭에서 Executable not found in $PATH가 표시되면 위 표에서 필요한 바이너리를 설치하세요.

Code intelligence 플러그인으로 Claude가 얻는 능력

code intelligence 플러그인이 설치되고 language server 바이너리가 사용 가능하면 Claude는 두 가지 능력을 얻습니다:

자동 진단: Claude가 파일을 편집할 때마다 language server가 변경 사항을 분석하고 오류 및 경고를 자동으로 보고합니다. Claude는 컴파일러나 린터를 실행할 필요 없이 타입 오류, 누락된 import, 구문 문제를 확인합니다. Claude가 오류를 발생시키면 같은 턴에서 문제를 인식하고 수정합니다. 플러그인 설치 외에 추가 구성이 필요하지 않습니다. "diagnostics found" 표시가 나타나면 Ctrl+O를 눌러 인라인으로 진단을 확인할 수 있습니다.
코드 네비게이션: Claude는 language server를 사용하여 정의로 이동, 참조 찾기, 호버 시 타입 정보 확인, 심볼 목록 조회, 구현 찾기, 호출 계층 추적을 수행할 수 있습니다. 이러한 작업은 grep 기반 검색보다 더 정확한 네비게이션을 제공하지만, 언어 및 환경에 따라 가용성이 다를 수 있습니다.

문제가 발생하면 Code intelligence 문제 해결을 참조하세요.

외부 통합

이 플러그인들은 사전 구성된 MCP 서버를 번들로 제공하여 수동 설정 없이 Claude를 외부 서비스에 연결할 수 있게 합니다:

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

개발 워크플로우

일반적인 개발 작업을 위한 명령어와 에이전트를 추가하는 플러그인:

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

출력 스타일

Claude의 응답 방식을 커스터마이즈:

explanatory-output-style: 구현 선택에 대한 교육적 인사이트
learning-output-style: 스킬 빌딩을 위한 대화형 학습 모드

데모 marketplace 추가해보기

Step 1: Marketplace 추가

Claude Code 내에서 anthropics/claude-code marketplace에 대해 plugin marketplace add 명령을 실행합니다:

/plugin marketplace add anthropics/claude-code

이것은 marketplace 카탈로그를 다운로드하고 플러그인을 사용할 수 있게 합니다.

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

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

방금 추가한 marketplace의 플러그인을 보려면 Discover 탭으로 이동하세요.

Step 3: 플러그인 설치

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

User scope: 모든 프로젝트에서 자신을 위해 설치
Project scope: 이 저장소의 모든 협업자를 위해 설치
Local scope: 이 저장소에서 자신만을 위해 설치

예를 들어, commit-commands(git 워크플로우 명령어를 추가하는 플러그인)를 선택하고 user scope로 설치합니다.

명령줄에서 직접 설치할 수도 있습니다:

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

scope에 대해 자세히 알아보려면 구성 scope를 참조하세요.

Step 4: 새 플러그인 사용

파일을 변경한 후 다음을 실행해 보세요:

/commit-commands:commit

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

각 플러그인은 다르게 작동합니다. 플러그인이 제공하는 명령어와 기능을 알아보려면 Discover 탭의 플러그인 설명이나 홈페이지를 확인하세요.

이 가이드의 나머지 부분에서는 marketplace를 추가하고, 플러그인을 설치하고, 구성을 관리하는 모든 방법을 다룹니다.

Marketplace 추가

/plugin marketplace add 명령을 사용하여 다양한 소스에서 marketplace를 추가합니다.

팁:

단축키: /plugin marketplace 대신 /plugin market을, remove 대신 rm을 사용할 수 있습니다.

GitHub 저장소: owner/repo 형식 (예: anthropics/claude-code)
Git URL: 모든 git 저장소 URL (GitLab, Bitbucket, 자체 호스팅)
로컬 경로: 디렉토리 또는 marketplace.json 파일에 대한 직접 경로
원격 URL: 호스팅된 marketplace.json 파일에 대한 직접 URL

GitHub에서 추가

예를 들어, anthropics/claude-code는 anthropics가 소유한 claude-code 저장소를 가리킵니다:

/plugin marketplace add anthropics/claude-code

다른 Git 호스트에서 추가

전체 URL을 제공하여 모든 git 저장소를 추가합니다. GitLab, Bitbucket, 자체 호스팅 서버를 포함한 모든 Git 호스트에서 작동합니다:

HTTPS 사용:

/plugin marketplace add https://gitlab.com/company/plugins.git

SSH 사용:

/plugin marketplace add [email protected]:company/plugins.git

특정 브랜치나 태그를 추가하려면 # 뒤에 ref를 붙입니다:

/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

로컬 경로에서 추가

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

/plugin marketplace add ./my-marketplace

marketplace.json 파일에 대한 직접 경로를 추가할 수도 있습니다:

/plugin marketplace add ./path/to/marketplace.json

원격 URL에서 추가

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

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

참고:

URL 기반 marketplace는 Git 기반 marketplace에 비해 일부 제한이 있습니다. 플러그인 설치 시 "path not found" 오류가 발생하면 문제 해결을 참조하세요.

플러그인 설치

marketplace를 추가한 후 플러그인을 직접 설치할 수 있습니다 (기본적으로 user scope에 설치):

/plugin install plugin-name@marketplace-name

User scope (기본값): 모든 프로젝트에서 자신을 위해 설치
Project scope: 이 저장소의 모든 협업자를 위해 설치 (.claude/settings.json에 추가)
Local scope: 이 저장소에서 자신만을 위해 설치 (협업자와 공유되지 않음)

managed scope의 플러그인도 볼 수 있습니다 — 이것은 관리자가 managed settings를 통해 설치한 것으로 수정할 수 없습니다.

/plugin을 실행하고 Installed 탭으로 이동하면 scope별로 그룹화된 플러그인을 볼 수 있습니다.

주의:

설치하기 전에 플러그인을 신뢰하는지 확인하세요. Anthropic은 플러그인에 포함된 MCP 서버, 파일 또는 기타 소프트웨어를 제어하지 않으며 의도한 대로 작동하는지 확인할 수 없습니다. 자세한 정보는 각 플러그인의 홈페이지를 확인하세요.

설치된 플러그인 관리

직접 명령어로도 플러그인을 관리할 수 있습니다.

제거하지 않고 플러그인 비활성화:

/plugin disable plugin-name@marketplace-name

비활성화된 플러그인 재활성화:

/plugin enable plugin-name@marketplace-name

플러그인 완전히 제거:

/plugin uninstall plugin-name@marketplace-name

--scope 옵션으로 CLI 명령에서 특정 scope를 지정할 수 있습니다:

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

재시작 없이 플러그인 변경 사항 적용

재시작 없이 모든 보류 중인 플러그인 변경 사항을 활성화하려면 다음을 실행하세요:

/reload-plugins

Claude Code가 모든 활성 플러그인을 다시 로드하고 로드된 내용을 보고합니다. LSP 서버가 추가되거나 업데이트된 경우 재시작이 필요하다고 알려줍니다.

Marketplace 관리

대화형 /plugin 인터페이스 또는 CLI 명령을 통해 marketplace를 관리할 수 있습니다.

대화형 인터페이스 사용

/plugin을 실행하고 Marketplaces 탭으로 이동하여:

소스 및 상태와 함께 추가된 모든 marketplace 보기
새 marketplace 추가
marketplace 목록을 업데이트하여 최신 플러그인 가져오기
더 이상 필요하지 않은 marketplace 제거

CLI 명령 사용

직접 명령으로도 marketplace를 관리할 수 있습니다.

구성된 모든 marketplace 나열:

/plugin marketplace list

marketplace에서 플러그인 목록 새로고침:

/plugin marketplace update marketplace-name

marketplace 제거:

/plugin marketplace remove marketplace-name

주의:

marketplace를 제거하면 해당 marketplace에서 설치한 모든 플러그인이 제거됩니다.

자동 업데이트 구성

UI를 통해 개별 marketplace의 자동 업데이트를 토글합니다:

/plugin을 실행하여 플러그인 관리자를 엽니다
Marketplaces를 선택합니다
목록에서 marketplace를 선택합니다
Enable auto-update 또는 Disable auto-update를 선택합니다

Claude Code 자동 업데이트는 비활성화하면서 플러그인 자동 업데이트는 유지하려면 DISABLE_AUTOUPDATER와 함께 FORCE_AUTOUPDATE_PLUGINS=true를 설정합니다:

export DISABLE_AUTOUPDATER=true
export FORCE_AUTOUPDATE_PLUGINS=true

이것은 Claude Code 업데이트는 수동으로 관리하면서 자동 플러그인 업데이트는 계속 받고 싶을 때 유용합니다.

팀 marketplace 구성

프로젝트의 .claude/settings.json에 extraKnownMarketplaces를 추가합니다:

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

extraKnownMarketplaces 및 enabledPlugins을 포함한 전체 구성 옵션은 플러그인 설정을 참조하세요.

보안

문제 해결

/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에서 설치 명령을 다시 실행합니다
Claude Code 재시작: 업데이트 후 터미널을 재시작하고 claude를 다시 실행합니다.

일반적인 문제

Marketplace가 로드되지 않음: URL이 접근 가능하고 해당 경로에 .claude-plugin/marketplace.json이 존재하는지 확인합니다
플러그인 설치 실패: 플러그인 소스 URL이 접근 가능하고 저장소가 공개되어 있거나(또는 접근 권한이 있는지) 확인합니다
설치 후 파일을 찾을 수 없음: 플러그인은 캐시에 복사되므로 플러그인 디렉토리 외부의 파일을 참조하는 경로는 작동하지 않습니다
플러그인 skill이 나타나지 않음: rm -rf ~/.claude/plugins/cache로 캐시를 삭제하고 Claude Code를 재시작한 후 플러그인을 다시 설치합니다.

자세한 문제 해결과 해결 방법은 marketplace 가이드의 문제 해결을 참조하세요. 디버깅 도구는 디버깅 및 개발 도구를 참조하세요.

Code intelligence 문제

Language server가 시작되지 않음: 바이너리가 설치되어 있고 $PATH에서 사용 가능한지 확인합니다. 자세한 내용은 /plugin Errors 탭을 확인하세요.
높은 메모리 사용량: rust-analyzer나 pyright 같은 language server는 대규모 프로젝트에서 상당한 메모리를 소비할 수 있습니다. 메모리 문제가 발생하면 /plugin disable <plugin-name>으로 플러그인을 비활성화하고 Claude의 내장 검색 도구를 대신 사용하세요.
모노레포에서의 오탐 진단: workspace가 올바르게 구성되지 않은 경우 language server가 내부 패키지에 대해 해결되지 않은 import 오류를 보고할 수 있습니다. 이는 Claude의 코드 편집 능력에 영향을 미치지 않습니다.

다음 단계

자체 플러그인 빌드: skill, 에이전트, hook을 만들려면 Plugins를 참조하세요
Marketplace 만들기: 팀이나 커뮤니티에 플러그인을 배포하려면 플러그인 marketplace 만들기를 참조하세요
기술 레퍼런스: 전체 사양은 Plugins reference를 참조하세요

54. Marketplace를 통해 사전 빌드된 플러그인 검색 및 설치

Marketplace를 통해 사전 빌드된 플러그인 검색 및 설치

Marketplace 작동 방식

Step 1: Marketplace 추가

Step 2: 개별 플러그인 설치

공식 Anthropic marketplace

Code intelligence

Code intelligence 플러그인으로 Claude가 얻는 능력

외부 통합

개발 워크플로우

출력 스타일

데모 marketplace 추가해보기

Step 1: Marketplace 추가

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

Step 3: 플러그인 설치

Step 4: 새 플러그인 사용

Marketplace 추가

GitHub에서 추가

다른 Git 호스트에서 추가

로컬 경로에서 추가

원격 URL에서 추가

플러그인 설치

설치된 플러그인 관리

재시작 없이 플러그인 변경 사항 적용

Marketplace 관리

대화형 인터페이스 사용

CLI 명령 사용

자동 업데이트 구성

팀 marketplace 구성

보안

문제 해결

/plugin 명령이 인식되지 않음

일반적인 문제

Code intelligence 문제

다음 단계

54. Marketplace를 통해 사전 빌드된 플러그인 검색 및 설치

Marketplace를 통해 사전 빌드된 플러그인 검색 및 설치

Marketplace 작동 방식

Step 1: Marketplace 추가

Step 2: 개별 플러그인 설치

공식 Anthropic marketplace

Code intelligence

Code intelligence 플러그인으로 Claude가 얻는 능력

외부 통합

개발 워크플로우

출력 스타일

데모 marketplace 추가해보기

Step 1: Marketplace 추가

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

Step 3: 플러그인 설치

Step 4: 새 플러그인 사용

Marketplace 추가

GitHub에서 추가

다른 Git 호스트에서 추가

로컬 경로에서 추가

원격 URL에서 추가

플러그인 설치

설치된 플러그인 관리

재시작 없이 플러그인 변경 사항 적용

Marketplace 관리

대화형 인터페이스 사용

CLI 명령 사용

자동 업데이트 구성

팀 marketplace 구성

보안

문제 해결

/plugin 명령이 인식되지 않음

일반적인 문제

Code intelligence 문제

다음 단계