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

​

마켓플레이스 작동 방식

​

공식 Anthropic 마켓플레이스

/plugin install github@claude-plugins-official

• Marketplace "claude-plugins-official" not found: /plugin marketplace add anthropics/claude-plugins-official을 사용하여 마켓플레이스를 추가한 후 설치를 다시 시도합니다.
• 플러그인이 마켓플레이스에서 찾을 수 없음: 플러그인 이름을 확인합니다.

​

코드 인텔리전스

​

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

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

​

외부 통합

• 소스 제어: 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 검토를 위한 특화된 agents
• agent-sdk-dev: Claude Agent SDK로 빌드하기 위한 도구
• plugin-dev: 자신의 플러그인을 만들기 위한 도구 모음

​

출력 스타일

• explanatory-output-style: 구현 선택에 대한 교육적 통찰력
• learning-output-style: 기술 습득을 위한 대화형 학습 모드

​

커뮤니티 마켓플레이스

/plugin marketplace add anthropics/claude-plugins-community

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

​

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

/plugin marketplace add anthropics/claude-code

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

/commit-commands:commit

​

마켓플레이스 추가

• GitHub 저장소: owner/repo 형식입니다. 예를 들어 anthropics/claude-code
• Git URL: GitLab, Bitbucket 및 자체 호스팅 서버를 포함한 모든 git 저장소 URL
• 로컬 경로: 디렉터리 또는 marketplace.json 파일에 대한 직접 경로
• 원격 URL: 호스팅된 marketplace.json 파일에 대한 직접 URL

​

GitHub에서 추가

/plugin marketplace add anthropics/claude-code

​

다른 Git 호스트에서 추가

• github.com 및 gitlab.com: Claude Code는 .git 접미사가 있거나 없는 저장소 URL을 인식하고 복제합니다. 접미사 없이 gitlab.com URL을 추가하려면 Claude Code v2.1.232 이상이 필요합니다. v2.1.232 이전에는 Claude Code가 이를 호스팅된 marketplace.json 파일에 대한 직접 링크로 취급했습니다.
• Azure DevOps: 접미사를 생략합니다. Claude Code는 경로에 /_git/이 포함된 모든 URL을 복제합니다. /_git/ 경로에 .git을 추가하면 복제가 실패합니다.
• 자체 관리 GitLab 서버를 포함한 다른 모든 호스트: Claude Code가 URL을 호스팅된 marketplace.json 파일에 대한 직접 링크로 취급하지 않고 저장소를 복제하도록 .git 접미사를 포함합니다. AWS CodeCommit과 같이 복제 URL에 접미사가 없는 호스트의 경우 대신 extraKnownMarketplaces의 git 항목으로 마켓플레이스를 추가합니다. Claude Code는 URL이 .git으로 끝나는지 여부와 관계없이 git 항목을 복제합니다.

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

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

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

​

로컬 경로에서 추가

/plugin marketplace add ./my-marketplace

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

​

원격 URL에서 추가

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

​

플러그인 설치

/plugin install plugin-name@marketplace-name

• 사용자 범위: 모든 프로젝트에서 자신을 위해 설치
• 프로젝트 범위: 이 저장소의 모든 협력자를 위해 설치(.claude/settings.json에 추가)
• 로컬 범위: 이 저장소에서만 자신을 위해 설치(협력자와 공유되지 않음)

• 마켓플레이스 이름 포함: plugin-name@marketplace-name을 설치할 때, 세션에서 또는 claude plugin install을 사용하여 설치하면 Claude Code는 조회 전에 해당 마켓플레이스를 새로 고칩니다. Claude Code는 마켓플레이스에 대해 자동 업데이트를 비활성화했거나 DISABLE_AUTOUPDATER를 설정한 경우에도 새로 고침을 실행합니다. v2.1.232 이전에는 Claude Code가 조회 전에 마켓플레이스를 새로 고치지 않았습니다. Claude Code는 다음의 경우 이 새로 고침을 건너뜁니다:
  • 마켓플레이스가 GitHub, 다른 Git 호스트 또는 원격 URL에서 추가되지 않은 경우.
  • 시드 디렉토리가 마켓플레이스를 제공하는 경우.
  • Claude Code가 지난 30초 이내에 마켓플레이스를 새로 고친 경우.
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC을 설정한 경우.
  • 관리 설정이 마켓플레이스를 차단하는 경우. 이 경우 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>을 실행한 후 설치를 다시 시도하세요.

• Plugin is now active.: Claude Code가 설치의 일부로 플러그인을 활성화했습니다.
• Run /reload-plugins to activate.: 플러그인이 아직 활성화되지 않았습니다. 활성화하면 프롬프트 캐시가 무효화되거나 활성화 시도가 실패했기 때문입니다. Claude Code가 /reload-plugins을 실행합니다. 해당 다시 로드가 프롬프트 캐시에 대한 경고를 표시하면 플러그인을 어쨌든 활성화하려면 /reload-plugins --force를 실행하세요.
• 플러그인이 로드되지 않으면 요약에서 실패를 보고하며 /plugin Errors 탭에서 세부 정보를 표시합니다.

​

설치된 플러그인 관리

• f를 눌러 선택한 플러그인을 즐겨찾기에 추가하거나 제거
• 입력하여 플러그인 이름 또는 설명으로 필터링
• Enter를 눌러 플러그인의 세부 정보 보기를 열고 활성화, 비활성화 또는 제거

• 조직에서 관리하거나 --plugin-dir로 로드하는 플러그인
• theme, output style, monitor 또는 workflow를 제공하는 플러그인. 이들은 추적할 호출 없이 값을 제공하기 때문입니다

• /plugin disable, /plugin enable 또는 /plugin uninstall을 실행하면 Claude Code는 플러그인 패널을 열어 변경 사항을 적용하고 열린 상태로 둡니다. 다른 명령어를 입력하기 전에 Esc를 눌러 패널을 닫습니다. 재시작 없이 플러그인 변경 사항 적용에서 변경 사항이 세션에서 언제 적용되는지 설명합니다.
• 스크립팅의 경우 claude plugin 셸 명령어를 대신 사용하면 패널을 열지 않습니다.

/plugin list

/plugin disable plugin-name@marketplace-name

/plugin enable plugin-name@marketplace-name

/plugin uninstall plugin-name@marketplace-name

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

​

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

• 다른 터미널에서 실행한 claude plugin 명령어
• 개발 중에 --plugin-dir로 로드한 플러그인 편집
• 재로드하도록 요청하는 플러그인 자동 업데이트 알림
• 적용하면 프롬프트 캐시를 무효화할 --plugin-dir 폴더의 변경 사항

• 명령어는 -p 프롬프트 또는 데스크톱 앱의 프롬프트 상자와 같이 세션에 직접 입력할 때만 실행됩니다. Remote Control 또는 중계된 채팅 메시지와 같이 원격 연결을 통해 전송하면 명령어는 아무것도 다시 로드하지 않고 거부합니다.
• 재로드는 플러그인 MCP servers를 연결하거나 연결 해제하지 않습니다. 이러한 변경 사항은 다음 세션에서 적용됩니다.

​

마켓플레이스 관리

​

대화형 인터페이스 사용

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

​

CLI 명령어 사용

/plugin marketplace list

/plugin marketplace update marketplace-name

/plugin marketplace remove marketplace-name

​

자동 업데이트 구성

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

export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1

​

팀 마켓플레이스 구성

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

​

보안

​

문제 해결

​

/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
   • 네이티브 설치 프로그램: 설정에서 설치 명령어를 다시 실행합니다.
3. Claude Code 재시작: 업데이트 후 터미널을 재시작하고 claude를 다시 실행합니다.

​

일반적인 문제

​

코드 인텔리전스 문제

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

​

다음 단계

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