마켓플레이스에서 미리 만든 플러그인 찾기·설치

마켓플레이스에서 미리 만든 플러그인 찾기·설치

플러그인은 스킬·에이전트·훅·MCP 서버로 Claude Code를 확장합니다. 플러그인 마켓플레이스는 직접 만들지 않고 이런 확장을 찾고 설치할 수 있게 도와주는 카탈로그예요. 남이 만들고 공유한 플러그인을 여러분 대신 찾아주는 창고라고 생각하면 됩니다. 직접 마켓플레이스를 만들고 배포하고 싶다면 플러그인 마켓플레이스 만들기·배포를 보세요.

출처: 공식문서

본문

마켓플레이스가 동작하는 방식

마켓플레이스는 다른 누군가가 만들어 공유한 플러그인의 카탈로그입니다. 마켓플레이스를 쓰는 것은 두 단계로 이뤄져요.

1. 마켓플레이스 추가 — 이 단계는 카탈로그를 Claude Code에 등록해 무엇이 있는지 탐색할 수 있게 합니다. 아직 플러그인은 설치되지 않습니다.
2. 개별 플러그인 설치 — 카탈로그를 탐색하고 원하는 플러그인을 설치하세요.

공식 Anthropic 마켓플레이스

Claude Code는 처음 대화형으로 시작할 때 공식 Anthropic 마켓플레이스(claude-plugins-official)를 자동으로 추가합니다. 네트워크가 다운로드를 막거나 마켓플레이스 정책이 이전 시도를 막아 추가하지 못하면 /plugin marketplace add anthropics/claude-plugins-official로 직접 추가하세요.

무엇이 있는지 탐색하려면 /plugin을 실행하고 Discover 탭으로 가거나 claude.com/plugins에서 카탈로그를 보세요.

공식 마켓플레이스에서 플러그인을 설치하려면 /plugin install <name>@claude-plugins-official을 쓰세요. 예를 들어 GitHub 통합을 설치하려면:

/plugin install github@claude-plugins-official

/plugin은 터미널 CLI에서 대화형 패널을 엽니다. Claude가 이 환경에서는 /plugin을 쓸 수 없다고 답하면, Claude 데스크톱 앱의 플러그인 브라우저를 사용하거나 클라우드 세션에서는 .claude/settings.json의 enabledPlugins 아래에 플러그인을 선언하세요.

설치가 실패하면 Claude Code가 보고하는 메시지를 확인하세요.

• Marketplace "claude-plugins-official" not found: /plugin marketplace add anthropics/claude-plugins-official로 마켓플레이스를 추가한 뒤 설치를 재시도.
• 플러그인이 마켓플레이스에 없음: 플러그인 이름을 확인.

Note: 공식 마켓플레이스는 Anthropic이 선별하며, 포함 여부는 Anthropic의 재량입니다. 인앱 제출 양식은 공식이 아니라 커뮤니티 마켓플레이스에 플러그인을 추가합니다. 독립 배포하려면 직접 마켓플레이스를 만들고 사용자와 공유하세요.

공식 마켓플레이스에는 여러 카테고리의 플러그인이 포함됩니다.

코드 인텔리전스

코드 인텔리전스 플러그인은 Claude Code 내장 LSP 도구를 활성화해, 정의로 이동·참조 찾기·편집 직후 타입 에러 확인 기능을 Claude에게 줍니다. 이 플러그인들은 Language Server Protocol 연결을 설정하는데, VS Code의 코드 인텔리전스를 지원하는 것과 같은 기술이에요. 클라우드 세션에서는 Claude Code가 플러그인 언어 서버를 시작하지 않으므로 Claude가 LSP 도구를 얻지 못합니다.

이 플러그인을 쓰기 전에 아래 표에서 언어 서버 바이너리를 설치하세요. 플러그인이 대신 설치해 주지 않아요. 이미 언어 서버가 설치되어 있다면, 프로젝트를 열 때 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 플러그인을 만들 수도 있어요.

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

코드 인텔리전스 플러그인이 Claude에게 주는 것

코드 인텔리전스 플러그인이 설치되고 언어 서버 바이너리를 쓸 수 있게 되면 Claude는 두 가지 능력을 얻습니다.

• 자동 진단: Claude가 파일을 편집할 때마다 언어 서버가 에러와 경고를 알려줘서, 컴파일러나 린터를 실행하지 않아도 타입 에러·누락된 import·문법 문제를 봅니다. Claude가 에러를 도입하면 같은 턴 안에 알아차리고 고칩니다.
• 코드 탐색: Claude는 언어 서버로 정의로 이동·참조 찾기·호버 타입 정보·심볼 나열·구현 찾기·호출 계층 추적을 할 수 있어요. 이 연산들은 grep 기반 검색보다 정밀한 탐색을 주지만, 언어·환경에 따라 가용성이 다를 수 있습니다.

플러그인 설치 외에 진단을 설정할 필요는 없어요. 직접 읽으려면 Claude Code가 Found 3 new diagnostic issues in 2 files 같은 표시를 보여줄 때 Ctrl+O를 누르세요.

문제가 생기면 코드 인텔리전스 문제 해결을 보세요.

외부 통합

이 플러그인들은 미리 설정된 MCP 서버를 묶어, 수동 설정 없이 Claude를 외부 서비스에 연결합니다.

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

자동 보안 검토

security-guidance 플러그인은 Claude가 만든 각 변경을 일반적인 취약점에 대해 검토하고, 같은 세션에서 찾은 것을 고치도록 지시합니다. 무엇을 검사하고 프로젝트별 규칙을 추가하는 방법은 Claude가 코드를 쓸 때 보안 문제 잡기를 보세요.

개발 워크플로

일반적인 개발 작업을 위한 스킬·에이전트를 추가하는 플러그인:

• commit-commands: 커밋·푸시·PR 생성 등 Git 커밋 워크플로
• pr-review-toolkit: 풀 리퀘스트 검토 전용 특화 에이전트
• agent-sdk-dev: Claude Agent SDK로 빌드하기 위한 도구
• plugin-dev: 플러그인 만들기용 툴킷

출력 스타일

Claude가 응답하는 방식을 맞춤 설정:

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

커뮤니티 마켓플레이스

anthropics/claude-plugins-community의 커뮤니티 마켓플레이스는 Anthropic의 자동 검증·안전 스크리닝을 통과한 타사 플러그인을 호스팅합니다. 각 플러그인은 카탈로그의 특정 커밋 SHA에 고정됩니다. 공식 마켓플레이스와 달리 직접 추가해야 해요.

/plugin marketplace add anthropics/claude-plugins-community

그런 다음 claude-community 마켓플레이스 이름으로 플러그인을 설치하세요.

/plugin install <plugin-name>@claude-community

자신의 플러그인을 커뮤니티 마켓플레이스에 제출하려면 create-plugins 가이드의 커뮤니티 마켓플레이스에 플러그인 제출을 보세요.

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

Anthropic은 플러그인 시스템으로 무엇이 가능한지 보여주는 예제 플러그인이 든 데모 플러그인 마켓플레이스(claude-code-plugins)도 유지합니다. 공식 마켓플레이스와 달리 이건 직접 추가해야 해요.

1. 마켓플레이스 추가 — Claude Code 안에서 anthropics/claude-code 마켓플레이스에 대해 plugin marketplace add 명령을 실행하세요.

   /plugin marketplace add anthropics/claude-code
   

   이 명령은 마켓플레이스 카탈로그를 다운로드하고 그 플러그인들을 사용할 수 있게 합니다.

2. 사용 가능한 플러그인 탐색 — /plugin을 실행해 플러그인 관리자를 엽니다. Tab(또는 뒤로 가려면 Shift+Tab)으로 순환할 수 있는 탭 인터페이스가 열려요.

   • Discover: 모든 마켓플레이스의 사용 가능한 플러그인 탐색
   • Installed: 설치된 플러그인 보기·관리
   • Marketplaces: 추가한 마켓플레이스 추가·제거·업데이트
   • Errors: 플러그인 로드 에러 보기
   • Stats: /skill-doctor를 쓸 수 있는 세션에서 각 스킬이 컨텍스트에서 드는 비용과 사용 빈도 보기

   Discover 탭으로 가면 방금 추가한 마켓플레이스의 플러그인을 볼 수 있어요. 관리자가 pluginSuggestionMarketplaces managed 설정으로 마켓플레이스를 허용 목록에 올렸으면, 현재 작업 디렉토리와 관련된 것으로 표시된 플러그인이 suggested for this directory 라벨과 함께 맨 위에 고정됩니다.

3. 플러그인 설치 — 플러그인을 선택해 세부 정보를 봅니다. 세부 정보 창은 플러그인이 무엇을 담고 얼마나 드는지 보여줍니다.

   • 매 턴마다 플러그인이 컨텍스트 창에 추가할 토큰 수를 알 수 있는 Context cost 추정치
   • 플러그인의 Last updated 날짜
   • 플러그인의 명령·에이전트·스킬·훅·MCP·LSP 서버를 나열하는 Will install 섹션. 설치 전 정확히 무엇이 추가되는지 검토 가능

   모든 플러그인이 이 필드 뒤의 데이터를 제공하는 건 아니에요. 로컬·커스텀 마켓플레이스의 플러그인은 Context cost·Last updated 행이 안 보일 수 있고, Will install 섹션이 Components will be discovered at installation을 보여줄 수도 있습니다.

   설치 범위를 고르세요.

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

   예를 들어 git 워크플로 스킬을 추가하는 commit-commands 플러그인을 선택하고 user scope로 설치해 보세요.

   명령줄에서도 설치를 시작할 수 있어요.

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

   범위에 대해 더 알아보려면 Settings files를 보세요.

4. 새 플러그인 사용 — 설치 요약이 Run /reload-plugins to activate.라고 보고하면 Claude Code가 그 리로드를 대신 실행합니다. 리로드가 다음 메시지가 대화를 다시 읽게 될 것이라고 경고하면 /reload-plugins --force를 실행해 플러그인을 활성화하세요.

   플러그인 스킬은 플러그인 이름으로 네임스페이스되므로, commit-commands는 /commit-commands:commit 같은 스킬을 제공합니다.

   파일을 변경한 뒤 다음을 실행해 시도해 보세요.

   /commit-commands:commit
   

   이 명령은 변경을 스테이징하고, 커밋 메시지를 만들고, 커밋을 생성합니다.

   각 플러그인은 다르게 동작해요. Discover 탭의 플러그인 세부 정보에서 제공하는 명령과 스킬을 확인하거나, 사용 안내를 위해 홈페이지를 방문하세요.

마켓플레이스 추가

/plugin marketplace add 명령으로 다양한 소스에서 마켓플레이스를 추가하세요.

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

• GitHub 저장소: owner/repo 형식, 예: anthropics/claude-code
• Git URL: GitLab, Bitbucket, 자체 호스팅 서버를 포함한 모든 git 저장소 URL
• 로컬 경로: 디렉토리 또는 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 호스트에서 추가

git 마켓플레이스 저장소를 전체 URL로 추가하세요. https:// URL의 경우 .git 접미사 포함 여부는 호스트에 달려 있습니다.

• github.com와 gitlab.com: Claude Code는 .git 접미사 유무와 관계없이 저장소 URL을 인식하고 클론합니다. 접미사 없는 gitlab.com URL 추가는 Claude Code v2.1.232 이상이 필요해요. v2.1.232 이전에는 호스팅된 marketplace.json 파일로의 직접 링크로 취급했습니다.
• Azure DevOps: 접미사를 생략하세요. Claude Code는 경로에 /_git/이 있는 모든 URL을 클론합니다. /_git/ 경로에 .git을 붙이면 클론이 실패합니다.
• 그 외 모든 호스트(자체 관리 GitLab 서버 포함): .git 접미사를 포함해 Claude Code가 URL을 호스팅된 marketplace.json 파일의 직접 링크로 취급하지 않고 저장소를 클론하게 하세요. AWS CodeCommit처럼 클론 URL에 접미사가 없는 호스트는 대신 extraKnownMarketplaces에 git 항목으로 마켓플레이스를 추가하세요. Claude Code는 URL이 .git로 끝나는지와 무관하게 git 항목을 클론합니다.

Claude Code는 중첩 하위 그룹이 있는 gitlab.com URL(예: https://gitlab.com/group/subgroup/project)도 클론합니다.

https:// 프리픽스를 포함하세요. Claude Code v2.1.196 이상은 gitlab.com/company/plugins.git처럼 프리픽스 없이 입력한 호스트를 잘못된 GitHub owner/repo 약칭으로 거부하고, 에러가 프리픽스를 추가하라고 알려줍니다. 이전 버전은 이를 GitHub 저장소 경로로 오독해 클론 시점에 실패했습니다.

HTTPS 사용:

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

SSH 사용:

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

Claude Code는 .git로 끝나든 아니든 SSH 주소를 클론합니다.

특정 브랜치나 태그를 추가하려면 # 뒤에 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

Note: URL 기반 마켓플레이스는 Git 기반 마켓플레이스보다 제한이 있어요. URL 기반 마켓플레이스에서 플러그인 설치가 실패하면 Troubleshooting을 보세요.

플러그인 설치

마켓플레이스를 추가했으면 이름으로 플러그인을 설치할 수 있어요.

/plugin install plugin-name@marketplace-name

이 명령은 그 플러그인의 세부 정보를 열고, 여기서 설치 범위를 고릅니다. /plugin을 실행하고 Discover 탭으로 가 플러그인에서 Enter를 눌러도 같은 선택지를 볼 수 있어요.

• User scope: 모든 프로젝트에서 자신을 위해 설치
• Project scope: 이 저장소의 모든 협업자를 위해 설치. 플러그인을 .claude/settings.json에 추가
• Local scope: 이 저장소에서만 자신을 위해 설치. 협업자와 공유하지 않음

대화형 단계 없이 설치하려면 --scope를 넘기지 않으면 user scope로 설치하는 claude plugin install 셸 명령을 쓰세요. command 소스가 있는 플러그인은 --yes를 넘겨 표시된 명령을 수락하세요.

managed 범위의 플러그인도 볼 수 있어요. 이들은 관리자가 managed settings로 설치하며 수정할 수 없습니다.

Claude Code는 마켓플레이스 카탈로그의 로컬 복사본에서 플러그인을 찾습니다. 플러그인 이름을 어떻게 부르는지에 따라 Claude Code가 먼저 그 복사본을 갱신할지가 결정돼요.

• 마켓플레이스 이름 포함: 세션에서나 claude plugin install로 plugin-name@marketplace-name을 설치하면, Claude Code는 조회 전에 그 마켓플레이스를 갱신합니다. 마켓플레이스의 자동 업데이트를 껐거나 DISABLE_AUTOUPDATER를 설정해도 갱신을 실행해요. v2.1.232 이전에는 조회 전에 마켓플레이스를 갱신하지 않았습니다. Claude Code는 다음 경우에 이 갱신을 건너뜁니다.
  • 마켓플레이스가 GitHub, 다른 Git 호스트, 또는 원격 URL에서 추가되지 않았거나
  • 시드 디렉토리가 마켓플레이스를 공급하거나
  • Claude Code가 지난 30초 안에 마켓플레이스를 갱신했거나
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC를 설정했거나
  • Managed settings가 마켓플레이스를 막는 경우. 이 경우 Claude Code는 설치도 거부합니다.
• 플러그인 이름만: 세션에서 /plugin install plugin-name을 실행하면, Claude Code는 백그라운드에서 업데이트하는 마켓플레이스만, 그리고 조회가 빗나간 뒤에만 갱신합니다. claude plugin install plugin-name을 실행하면 Claude Code는 갱신 없이 캐시된 카탈로그를 읽습니다. 마지막 갱신 이후 게시된 플러그인을 설치하려면 세션에서 /plugin marketplace update <marketplace-name> 또는 셸에서 claude plugin marketplace update <marketplace-name>을 실행한 뒤 설치를 재시도하세요.

이름 있는 설치 전의 갱신이 오프라인 같은 이유로 실패하면, Claude Code는 그래도 캐시된 카탈로그에서 플러그인을 찾습니다. claude plugin install은 성공 메시지에 marketplace not refreshed를 보고하고, /plugin install은 플러그인 세부 정보 위 또는 not-found 메시지에 실패를 보여줍니다.

/plugin 인터페이스에서 설치하면 설치 요약이 플러그인이 현재 세션에 활성인지 알려줍니다.

• Plugin is now active.: Claude Code가 설치의 일부로 플러그인을 활성화했습니다.
• Run /reload-plugins to activate.: 활성화하면 프롬프트 캐시가 무효화되거나 활성화 시도가 실패해서 아직 활성화되지 않았습니다. Claude Code가 /reload-plugins를 대신 실행합니다. 그 리로드가 프롬프트 캐시에 대해 경고하면 /reload-plugins --force를 실행해 그래도 플러그인을 활성화하세요.
• 플러그인 로드가 실패하면 요약이 실패를 보고하고 /plugin Errors 탭이 세부 사항을 보여줍니다.

v2.1.221 이전에는 /reload-plugins를 실행하거나 재시작하기 전까지 어떤 설치도 현재 세션에 적용되지 않았습니다.

claude plugin install 셸 명령은 세션에서 실행되지 않으므로, Claude Code는 설치한 플러그인을 다음에 시작할 때 또는 이미 열린 세션에서 /reload-plugins를 실행할 때 로드합니다.

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

설치된 플러그인 관리

/plugin을 실행하고 Installed 탭으로 가면 플러그인을 보기·활성화·비활성화·제거할 수 있어요. 목록은 범위별로 그룹화되고 문제가 먼저 보이도록 정렬됩니다. 로드 에러·미해결 의존성이 있는 플러그인이 맨 위에, 즐겨찾기가 그 다음, 비활성화된 플러그인은 맨 아래 접힌 헤더 뒤에 와요.

목록에서:

• f를 눌러 선택한 플러그인을 즐겨찾기·즐겨찾기 해제
• 입력해 플러그인 이름이나 설명으로 필터
• Enter를 눌러 플러그인의 세부 보기를 열고 활성화·비활성화·제거

프로젝트의 .claude/settings.json이 활성화하는 플러그인을 제거하면, Claude Code가 어떤 범위를 뜻하는지 묻습니다. 자신만 비활성화(자신의 .claude/settings.local.json에 오버라이드를 쓰고 플러그인은 프로젝트에 설치 상태로 남김)할지, 모두를 위해 제거(공유 .claude/settings.json에서 제거)할지입니다.

세부 보기는 플러그인이 기여하는 구성 요소(명령·스킬·에이전트·훅·MCP 서버·LSP 서버)를 보여줍니다. 같은 인벤토리는 claude plugin details로 명령줄에서도 얻을 수 있어요.

Claude Code는 또한 직접 설치했지만 최소 10개 세션에 걸쳐 최소 2주 동안 사용하지 않은 마켓플레이스 플러그인을 Installed 탭의 Not used recently 헤더 아래에 나열합니다. 세부 보기는 각 플러그인의 Last used 줄을 보여줍니다. 이것들로 더 이상 쓰지 않는데도 시작·컨텍스트 비용을 더하는 플러그인을 찾아 비활성화·제거하세요.

두 종류의 플러그인은 사용 안 함으로 나열되지 않습니다.

• 조직이 관리하거나 --plugin-dir로 로드하는 플러그인
• 테마·출력 스타일·모니터·워크플로를 기여하는 플러그인. 추적할 호출이 없어도 가치를 제공하므로

Not used recently 헤더와 Last used 줄은 조직이 strictKnownMarketplaces로 마켓플레이스를 제한하면 둘 다 숨겨집니다.

플러그인의 언어 서버는 진단을 전달하거나 코드 탐색 요청에 답하면 사용된 것으로 계산됩니다. 따라서 세션에서 서버가 활성인 LSP 플러그인은 사용 안 함으로 나열되지 않아요. v2.1.203 이전에는 언어 서버 활동을 사용으로 계산할 수 없어서 LSP 서버를 기여하는 플러그인은 테마·출력 스타일 플러그인과 같은 방식으로 전체 그룹에서 면제됐습니다.

언어 서버 활동을 계산하는 버전에서의 첫 세션은 아직 사용 기록이 없는 각 LSP 플러그인의 사용 기록도 재설정하므로, Claude Code는 이전에 설치한 플러그인을 서버 활동이 추적되기 전에 기록된 데이터를 기준으로 사용 안 함으로 판단하지 않습니다.

의존성을 선언하는 플러그인을 설치하면, 설치 출력이 함께 자동 설치된 의존성이 무엇인지 나열합니다.

직접 명령으로도 플러그인을 관리할 수 있어요.

• /plugin disable, /plugin enable, /plugin uninstall을 실행하면 Claude Code가 그 변경을 위해 플러그인 패널을 열고 열어 둡니다. 다른 명령을 입력하기 전에 Esc로 패널을 닫으세요. 변경이 세션에 언제 적용되는지는 재시작 없이 플러그인 변경 적용이 설명합니다.
• 스크립팅에는 패널을 열지 않는 claude plugin 셸 명령을 쓰세요.

메뉴를 열지 않고 설치된 플러그인 나열:

/plugin list

--enabled나 --disabled를 넘기면 그 상태의 플러그인만 보여줍니다.

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

/plugin disable plugin-name@marketplace-name

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

/plugin enable plugin-name@marketplace-name

이 식별자에서 plugin-name은 마켓플레이스 항목의 플러그인 name으로, 플러그인 자신의 plugin.json의 name과 다를 수 있습니다.

Claude Code v2.1.195부터 /plugin 인터페이스의 Enable·Disable은 두 이름이 다른 플러그인에서도 동작하며, /plugin enable·/plugin disable은 어느 이름이든 받아들입니다. 이전 버전에서 그런 플러그인을 비활성화하면 Claude Code는 already disabled라고 보고하고 활성화된 채로 둡니다.

플러그인 완전 제거:

/plugin uninstall plugin-name@marketplace-name

--scope 옵션으로 CLI 명령에 특정 범위를 지정할 수 있어요.

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

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

/plugin 메뉴를 닫으면 Claude Code는 그 안에서 만든 변경(플러그인 설치·활성화·비활성화·제거)을 적용하기 위해 /reload-plugins를 대신 실행합니다. 리로드가 프롬프트 캐시를 무효화하게 되면 경고하고 변경을 보류한 채 두며, 그래도 적용하려면 /reload-plugins --force를 실행하세요. 메뉴를 닫을 때 Claude가 아직 응답 중이면 응답이 끝난 뒤 리로드가 실행됩니다.

메뉴 밖에서 일어난 플러그인 변경은 /reload-plugins를 직접 실행하세요. 이런 변경에는 다음이 포함됩니다.

• 다른 터미널에서 실행한 claude plugin 명령
• --plugin-dir로 로드한 플러그인을 개발하며 한 편집
• 알림이 리로드를 요청하는 플러그인 자동 업데이트
• 적용하면 프롬프트 캐시를 무효화해서 Claude Code가 보류한 --plugin-dir 폴더의 변경

v2.1.268 이전에는 메뉴에서 활성화·비활성화·제거한 플러그인과 설치 중 활성화되지 않은 설치가, /reload-plugins를 실행할 때까지 보류 상태였습니다.

/reload-plugins는 대화형 터미널이 없는 세션(데스크톱 앱, Agent SDK, -p를 쓰는 비대화형 모드)에서도 실행됩니다. Claude Code v2.1.260 이상이 필요해요. 그런 세션에는 두 가지 제한이 적용됩니다.

• 명령은 -p 프롬프트나 데스크톱 앱의 프롬프트 박스처럼 세션에 직접 입력할 때만 실행됩니다. Remote Control이나 릴레이된 채팅 메시지처럼 원격 연결로 보내면, 명령은 아무것도 리로드하지 않고 거절합니다.
• 리로드는 플러그인 MCP 서버를 연결·연결 해제하지 않습니다. 그 변경은 다음 세션에 적용돼요.

Claude Code는 모든 활성 플러그인을 리로드하고 플러그인·스킬·에이전트·훅·플러그인 MCP 서버·플러그인 LSP 서버의 개수를 보여주며, 대화형 터미널이 없는 세션에서는 플러그인 MCP 서버 개수를 생략합니다. 스킬 개수에서 Claude Code는 플러그인이 제공하는 모든 스킬(commands/ 항목과 SKILL.md 스킬 둘 다)을 포함합니다. v2.1.246 이전에는 commands/ 항목만 세어서 플러그인의 SKILL.md 스킬을 리로드해도 요약에 0 skills라고 보고할 수 있었습니다.

리로드는 다음 요청에 토큰 비용이 듭니다. 새로 로드된 구성 요소가 대화에 추가되는 콘텐츠로 자신을 알리지만, 기존 기록은 여전히 프롬프트 캐시에서 읽힙니다. MCP 서버를 제공하는 플러그인은 그 도구가 tool search로 지연되지 않으면 더 비쌉니다. 변경이 캐시를 무효화하고 다음 요청이 전체 대화를 다시 읽기 때문입니다. 자세한 내용은 플러그인 활성화·비활성화를 보세요.

마켓플레이스 관리

대화형 /plugin 인터페이스 또는 CLI 명령으로 마켓플레이스를 관리할 수 있어요.

대화형 인터페이스 사용

/plugin을 실행하고 Marketplaces 탭으로 가서:

• 소스·상태와 함께 추가된 모든 마켓플레이스 보기
• 새 마켓플레이스 추가
• 최신 플러그인을 가져오도록 마켓플레이스 목록 업데이트
• 더 이상 필요 없는 마켓플레이스 제거

CLI 명령 사용

직접 명령으로도 마켓플레이스를 관리할 수 있어요.

구성된 모든 마켓플레이스 나열:

/plugin marketplace list

마켓플레이스에서 플러그인 목록 갱신:

/plugin marketplace update marketplace-name

마켓플레이스 제거:

/plugin marketplace remove marketplace-name

Warning: 마켓플레이스를 제거하면 그 마켓플레이스에서 설치한 플러그인을 모두 제거합니다.

자동 업데이트 구성

Claude Code는 시작 후 백그라운드에서 마켓플레이스와 설치된 플러그인을 자동으로 업데이트할 수 있어요. 마켓플레이스에 자동 업데이트가 활성화되면, Claude Code는 마켓플레이스 데이터를 갱신하고 설치된 플러그인을 디스크의 최신 버전으로 업데이트합니다.

Claude Code는 세션이 시작한 뒤 최대 10분의 무작위 지연 후 마켓플레이스·플러그인 업데이트를 확인하므로, 실행 중 세션은 시작 시 로드한 버전을 계속 사용합니다. 플러그인이 업데이트됐다면 /reload-plugins를 실행하라는 알림이 보이거나, 다음 시작 시 새 버전이 로드됩니다.

자동 업데이트는 마켓플레이스 항목이 headersHelper를 선언한 플러그인도 빼놓습니다. Claude Code는 그 경로에서 명령을 실행하지도 아카이브를 다운로드하지도 않으며, 그 섹션은 Claude Code가 /plugin Errors 탭에 플러그인을 나열해 자신의 보기에서 업데이트할 수 있게 하는 시점을 말해줍니다.

command 소스가 있는 플러그인은 마켓플레이스 자동 업데이트 설정 및 DISABLE_AUTOUPDATER와는 별도의 주기로 업데이트됩니다. 대신 세션당 한 번 명령을 다시 실행하고, 그것의 해시가 바뀌었으면 출력을 새 플러그인 버전으로 설치합니다.

UI로 개별 마켓플레이스의 자동 업데이트를 토글하세요.

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

claude-plugins-official과 대부분의 다른 공식 Anthropic 마켓플레이스는 자동 업데이트가 기본으로 활성화됩니다. 타사·로컬 개발 마켓플레이스는 기본으로 비활성화됩니다.

관리자는 managed settings의 각 extraKnownMarketplaces 항목에 "autoUpdate": true를 설정해, 사용자마다 토글하지 않아도 조직 마켓플레이스의 자동 업데이트를 활성화할 수 있어요.

Claude Code와 마켓플레이스에서 가져온 플러그인의 자동 업데이트를 끄려면 DISABLE_AUTOUPDATER 환경 변수를 설정하세요. command 소스가 있는 플러그인은 세션당 한 번의 재해석을 따릅니다. 자세한 내용은 Auto updates를 보세요.

Claude Code 자동 업데이트는 끄면서 플러그인 자동 업데이트는 켜려면 DISABLE_AUTOUPDATER와 함께 FORCE_AUTOUPDATE_PLUGINS=1을 설정하세요.

export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1

팀 마켓플레이스 구성

팀 관리자는 .claude/settings.json에 마켓플레이스 설정을 추가해 프로젝트용 자동 마켓플레이스 설치를 설정할 수 있어요. 팀원이 저장소 폴더를 신뢰하면, Claude Code는 추가 프롬프트 없이 이 마켓플레이스를 추가합니다.

Claude Code v2.1.195부터 마켓플레이스 추가는 플러그인을 로드하는 어떤 경로에서도 외부 소스에서 온 플러그인을 설치하지 않습니다. 프로젝트의 .claude/settings.json만이 활성화하고 GitHub 저장소·npm 패키지 같은 외부 소스에서 온 플러그인은, 팀원이 설치할 때까지 로드되지 않아요. 그때까지 Claude Code는 플러그인을 설치되지 않음으로 보고하고 실행할 claude plugin install 명령을 보여줍니다.

프로젝트의 .claude/settings.json에 extraKnownMarketplaces를 추가하세요.

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

extraKnownMarketplaces와 enabledPlugins를 포함한 전체 설정 옵션은 Plugin settings를 보세요.

보안

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

문제 해결

/plugin 명령이 인식되지 않음

"unknown command"가 보이거나 /plugin 명령이 나타나지 않으면:

1. 버전 확인: claude --version으로 설치된 것을 확인.
2. Claude Code 업데이트:
   • Homebrew: brew upgrade claude-code, 또는 그 cask를 설치했다면 brew upgrade claude-code@latest
   • npm: npm install -g @anthropic-ai/claude-code@latest
   • Native 설치 프로그램: Setup의 설치 명령 재실행
3. Claude Code 재시작: 업데이트 후 터미널을 재시작하고 claude를 다시 실행.

일반적인 문제

플러그인 스킬이 나타나지 않으면 rm -rf ~/.claude/plugins/cache로 캐시를 지우고, Claude Code를 재시작하고, 플러그인을 다시 설치하세요.

해결책이 포함된 자세한 문제 해결은 마켓플레이스 가이드의 Troubleshooting을 보세요. 디버깅 도구는 Debugging and development tools를 참조하세요.

코드 인텔리전스 문제

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

다음 단계

• 직접 플러그인 만들기: Plugins에서 스킬·에이전트·훅 만들기
• 마켓플레이스 만들기: 플러그인 마켓플레이스 만들기에서 팀·커뮤니티에 플러그인 배포
• 기술 레퍼런스: 완전한 명세는 Plugins reference

더 알아보기

• 플러그인 만들기 - 스킬·에이전트·훅·MCP 서버로 직접 확장 제작
• 플러그인 마켓플레이스 - 마켓플레이스 생성·배포
• Plugins reference - 플러그인 기술 명세