마켓플레이스를 통해 미리 빌드된 플러그인 발견 및 설치

플러그인은 Claude Code를 skills, agents, hooks 및 MCP servers로 확장합니다. 플러그인 마켓플레이스는 직접 빌드하지 않고도 이러한 확장 기능을 발견하고 설치할 수 있도록 도와주는 카탈로그입니다. 자신의 마켓플레이스를 만들고 배포하려고 하시나요? 플러그인 마켓플레이스 만들기 및 배포를 참조하세요.

마켓플레이스 작동 방식

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

마켓플레이스 추가

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

개별 플러그인 설치

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

앱 스토어를 추가하는 것과 같다고 생각하면 됩니다. 스토어를 추가하면 해당 컬렉션을 검색할 수 있지만, 여전히 개별적으로 다운로드할 앱을 선택합니다.

공식 Anthropic 마켓플레이스

공식 Anthropic 마켓플레이스(claude-plugins-official)는 Claude Code를 시작할 때 자동으로 사용 가능합니다. /plugin을 실행하고 Discover 탭으로 이동하여 사용 가능한 항목을 검색합니다. 공식 마켓플레이스에서 플러그인을 설치하려면:

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

공식 마켓플레이스는 Anthropic에서 유지 관리합니다. 공식 마켓플레이스에 플러그인을 제출하려면 다음 앱 내 제출 양식 중 하나를 사용하세요:

Claude.ai: claude.ai/settings/plugins/submit
Console: platform.claude.com/plugins/submit

플러그인을 독립적으로 배포하려면 자신의 마켓플레이스를 만들고 사용자와 공유하세요.

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

코드 인텔리전스

코드 인텔리전스 플러그인은 Claude Code의 기본 제공 LSP 도구를 활성화하여 Claude가 정의로 이동하고, 참조를 찾으며, 편집 직후 타입 오류를 볼 수 있도록 합니다. 이러한 플러그인은 Language Server Protocol 연결을 구성하며, 이는 VS Code의 코드 인텔리전스를 지원하는 동일한 기술입니다. 이러한 플러그인은 언어 서버 바이너리가 시스템에 설치되어 있어야 합니다. 이미 언어 서버가 설치되어 있으면 프로젝트를 열 때 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를 보면 위 표에서 필요한 바이너리를 설치하세요.

코드 인텔리전스 플러그인이 Claude에 제공하는 것

코드 인텔리전스 플러그인이 설치되고 해당 언어 서버 바이너리를 사용할 수 있으면 Claude는 두 가지 기능을 얻습니다:

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

문제가 발생하면 코드 인텔리전스 문제 해결을 참조하세요.

외부 통합

이러한 플러그인은 미리 구성된 MCP servers를 번들로 제공하므로 수동 설정 없이 Claude를 외부 서비스에 연결할 수 있습니다:

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

개발 워크플로우

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

commit-commands: commit, push 및 PR 생성을 포함한 Git commit 워크플로우
pr-review-toolkit: pull request 검토를 위한 특화된 에이전트
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 marketplace add anthropics/claude-code

이는 마켓플레이스 카탈로그를 다운로드하고 해당 플러그인을 사용 가능하게 합니다.

사용 가능한 플러그인 검색

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

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

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

플러그인 설치

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

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

예를 들어 commit-commands(git 워크플로우 명령어를 추가하는 플러그인)를 선택하고 사용자 범위에 설치합니다.명령줄에서 직접 설치할 수도 있습니다:

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

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

새 플러그인 사용

설치 후 /reload-plugins를 실행하여 플러그인을 활성화합니다. 플러그인 명령어는 플러그인 이름으로 네임스페이스되므로 commit-commands는 /commit-commands:commit과 같은 명령어를 제공합니다.파일을 변경하고 다음을 실행하여 시도해보세요:

/commit-commands:commit

이는 변경 사항을 스테이징하고, commit 메시지를 생성하며, commit을 만듭니다.각 플러그인은 다르게 작동합니다. Discover 탭의 플러그인 설명이나 해당 홈페이지를 확인하여 제공하는 명령어 및 기능을 알아보세요.

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

마켓플레이스 추가

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

바로가기: /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 기반 마켓플레이스는 Git 기반 마켓플레이스에 비해 몇 가지 제한 사항이 있습니다. 플러그인 설치 시 “경로를 찾을 수 없음” 오류가 발생하면 문제 해결을 참조하세요.

플러그인 설치

마켓플레이스를 추가한 후 플러그인을 직접 설치할 수 있습니다(기본적으로 사용자 범위에 설치됨):

/plugin install plugin-name@marketplace-name

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

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

managed 범위의 플러그인도 볼 수 있습니다. 이는 관리자가 관리되는 설정을 통해 설치하며 수정할 수 없습니다. /plugin을 실행하고 Installed 탭으로 이동하여 범위별로 그룹화된 플러그인을 확인합니다.

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

설치된 플러그인 관리

/plugin을 실행하고 Installed 탭으로 이동하여 플러그인을 보고, 활성화하고, 비활성화하거나, 제거합니다. 플러그인 이름 또는 설명으로 목록을 필터링하려면 입력합니다. 직접 명령어로 플러그인을 관리할 수도 있습니다. 플러그인을 제거하지 않고 비활성화합니다:

/plugin disable plugin-name@marketplace-name

비활성화된 플러그인을 다시 활성화합니다:

/plugin enable plugin-name@marketplace-name

플러그인을 완전히 제거합니다:

/plugin uninstall plugin-name@marketplace-name

--scope 옵션을 사용하면 CLI 명령어로 특정 범위를 대상으로 할 수 있습니다:

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

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

세션 중에 플러그인을 설치, 활성화 또는 비활성화할 때 /reload-plugins를 실행하여 재시작 없이 모든 변경 사항을 선택합니다:

/reload-plugins

Claude Code는 모든 활성 플러그인을 다시 로드하고 다시 로드된 명령어, skills, agents, hooks, 플러그인 MCP servers 및 플러그인 LSP servers의 개수를 표시합니다.

마켓플레이스 관리

대화형 /plugin 인터페이스 또는 CLI 명령어를 통해 마켓플레이스를 관리할 수 있습니다.

대화형 인터페이스 사용

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

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

CLI 명령어 사용

직접 명령어로 마켓플레이스를 관리할 수도 있습니다. 구성된 모든 마켓플레이스 나열:

/plugin marketplace list

마켓플레이스에서 플러그인 목록 새로 고침:

/plugin marketplace update marketplace-name

마켓플레이스 제거:

/plugin marketplace remove marketplace-name

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

자동 업데이트 구성

Claude Code는 시작 시 마켓플레이스 및 설치된 플러그인을 자동으로 업데이트할 수 있습니다. 마켓플레이스에 대해 자동 업데이트가 활성화되면 Claude Code는 마켓플레이스 데이터를 새로 고치고 설치된 플러그인을 최신 버전으로 업데이트합니다. 플러그인이 업데이트된 경우 /reload-plugins를 실행하도록 요청하는 알림이 표시됩니다. UI를 통해 개별 마켓플레이스에 대한 자동 업데이트를 전환합니다:

/plugin을 실행하여 플러그인 관리자 열기
Marketplaces 선택
목록에서 마켓플레이스 선택
자동 업데이트 활성화 또는 자동 업데이트 비활성화 선택

공식 Anthropic 마켓플레이스는 기본적으로 자동 업데이트가 활성화되어 있습니다. 타사 및 로컬 개발 마켓플레이스는 기본적으로 자동 업데이트가 비활성화되어 있습니다. Claude Code 및 모든 플러그인에 대해 모든 자동 업데이트를 완전히 비활성화하려면 DISABLE_AUTOUPDATER 환경 변수를 설정합니다. 자세한 내용은 자동 업데이트를 참조하세요. Claude Code 자동 업데이트를 비활성화하면서 플러그인 자동 업데이트를 활성화된 상태로 유지하려면 DISABLE_AUTOUPDATER와 함께 FORCE_AUTOUPDATE_PLUGINS=true를 설정합니다:

export DISABLE_AUTOUPDATER=true
export FORCE_AUTOUPDATE_PLUGINS=true

Claude Code 업데이트를 수동으로 관리하지만 여전히 자동 플러그인 업데이트를 받으려는 경우에 유용합니다.

팀 마켓플레이스 구성

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

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

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

보안

플러그인 및 마켓플레이스는 사용자 권한으로 머신에서 임의의 코드를 실행할 수 있는 매우 신뢰할 수 있는 구성 요소입니다. 신뢰할 수 있는 소스에서만 플러그인을 설치하고 마켓플레이스를 추가합니다. 조직은 관리되는 마켓플레이스 제한을 사용하여 사용자가 추가할 수 있는 마켓플레이스를 제한할 수 있습니다.

문제 해결

/plugin 명령어를 인식하지 못함

“알 수 없는 명령어” 또는 /plugin 명령어가 나타나지 않으면:

버전 확인: claude --version을 실행합니다. 플러그인은 버전 1.0.33 이상이 필요합니다.
Claude Code 업데이트:
- Homebrew: brew upgrade claude-code
- npm: npm update -g @anthropic-ai/claude-code
- 네이티브 설치 프로그램: 설정에서 설치 명령어를 다시 실행합니다.
Claude Code 재시작: 업데이트 후 터미널을 재시작하고 claude를 다시 실행합니다.

일반적인 문제

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

자세한 문제 해결 및 솔루션은 마켓플레이스 가이드의 문제 해결을 참조하세요. 디버깅 도구는 디버깅 및 개발 도구를 참조하세요.

코드 인텔리전스 문제

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

다음 단계

자신의 플러그인 빌드: 플러그인을 참조하여 skills, agents 및 hooks를 만듭니다.
마켓플레이스 만들기: 플러그인 마켓플레이스 만들기를 참조하여 팀 또는 커뮤니티에 플러그인을 배포합니다.
기술 참조: 플러그인 참조를 참조하여 완전한 사양을 확인합니다.

에이전트

도구 및 플러그인

자동화

문제 해결

마켓플레이스를 통해 미리 빌드된 플러그인 발견 및 설치

마켓플레이스 작동 방식

공식 Anthropic 마켓플레이스

코드 인텔리전스

코드 인텔리전스 플러그인이 Claude에 제공하는 것

외부 통합

개발 워크플로우

출력 스타일

시도해보기: 데모 마켓플레이스 추가

마켓플레이스 추가

GitHub에서 추가

다른 Git 호스트에서 추가

로컬 경로에서 추가

원격 URL에서 추가

플러그인 설치

설치된 플러그인 관리

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

마켓플레이스 관리

대화형 인터페이스 사용

CLI 명령어 사용

자동 업데이트 구성

팀 마켓플레이스 구성

보안

문제 해결

/plugin 명령어를 인식하지 못함

일반적인 문제

코드 인텔리전스 문제

다음 단계

에이전트

도구 및 플러그인

자동화

문제 해결

​마켓플레이스 작동 방식

​공식 Anthropic 마켓플레이스

​코드 인텔리전스

​코드 인텔리전스 플러그인이 Claude에 제공하는 것

​외부 통합

​개발 워크플로우

​출력 스타일

​시도해보기: 데모 마켓플레이스 추가

​마켓플레이스 추가

​GitHub에서 추가

​다른 Git 호스트에서 추가

​로컬 경로에서 추가

​원격 URL에서 추가

​플러그인 설치

​설치된 플러그인 관리

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

​마켓플레이스 관리

​대화형 인터페이스 사용

​CLI 명령어 사용

​자동 업데이트 구성

​팀 마켓플레이스 구성

​보안

​문제 해결

​/plugin 명령어를 인식하지 못함

​일반적인 문제

​코드 인텔리전스 문제

​다음 단계

마켓플레이스 작동 방식

공식 Anthropic 마켓플레이스

코드 인텔리전스

코드 인텔리전스 플러그인이 Claude에 제공하는 것

외부 통합

개발 워크플로우

출력 스타일

시도해보기: 데모 마켓플레이스 추가

마켓플레이스 추가

GitHub에서 추가

다른 Git 호스트에서 추가

로컬 경로에서 추가

원격 URL에서 추가

플러그인 설치

설치된 플러그인 관리

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

마켓플레이스 관리

대화형 인터페이스 사용

CLI 명령어 사용

자동 업데이트 구성

팀 마켓플레이스 구성

보안

문제 해결

/plugin 명령어를 인식하지 못함

일반적인 문제

코드 인텔리전스 문제

다음 단계