플러그인 의존성

​

의존성 선언

​

버전 제약으로 의존성 선언

{
  "name": "deploy-kit",
  "version": "3.1.0",
  "dependencies": [
    "audit-logger",
    { "name": "secrets-vault", "version": "~2.1.0" }
  ]
}

​

팀을 위해 플러그인 번들

{
  "name": "backend-standard",
  "version": "1.0.0",
  "description": "Standard plugin set for backend engineers",
  "dependencies": [
    "secrets-vault",
    "deploy-kit",
    { "name": "db-migrate", "version": "^3.0" },
    "oncall-runbook"
  ]
}

• 마켓플레이스에 대해 자동 업데이트 켜기: 다음 자동 업데이트는 번들을 새 버전으로 이동하고 추가하는 모든 의존성을 설치합니다.
• 수동으로 업데이트: 셸에서 claude plugin update backend-standard를 실행한 후 열린 세션에서 /reload-plugins를 실행하여 새로 추가된 의존성을 설치합니다.

​

다른 마켓플레이스에서 플러그인에 의존

{
  "name": "your-marketplace",
  "owner": { "name": "Your Org" },
  "allowCrossMarketplaceDependenciesOn": ["your-shared-marketplace"],
  "plugins": [
    {
      "name": "deploy-kit",
      "source": "./deploy-kit",
      "dependencies": [
        { "name": "audit-logger", "marketplace": "your-shared-marketplace" }
      ]
    }
  ]
}

​

플러그인 및 해당 의존성을 로컬로 테스트

claude --plugin-dir ./my-dependency --plugin-dir ./my-plugin

• version 필요 없음: 로컬 plugin.json은 버전 제약이 로컬 복사본에 대해 확인되지 않으므로 version도 필요하지 않습니다.
• 마켓플레이스의 이름을 지정하는 항목: 마켓플레이스의 이름을 지정하는 항목도 Claude Code v2.1.242 이상에서 로컬 복사본과 일치합니다.

• 로컬 복사본을 비활성화했습니다: 플러그인은 다음 플러그인 로드에서 비활성화되고 오류는 is disabled — enable it or remove the dependency로 끝납니다. 오류가 의존성을 <name>@inline으로 이름 지으면 해당 식별자는 --plugin-dir 복사본을 나타냅니다.
• 의존성의 --plugin-dir 플래그 없이 세션을 시작했습니다: 오류는 의존성이 설치되지 않았다고 보고합니다. 플래그를 다시 전달하거나 마켓플레이스에서 의존성을 설치합니다.

​

다른 사용자가 의존하는 플러그인 릴리스하기

• github, url, 또는 git-subdir 소스: 플러그인 자체 저장소이므로 플러그인 작성자가 태그를 생성합니다
• ./plugins/secrets-vault와 같은 상대 경로: 마켓플레이스 저장소이므로 마켓플레이스 유지 관리자가 태그를 생성합니다

​

릴리스 태그 생성

claude plugin tag --push

• 플러그인 유효성 검사
• 플러그인 디렉터리가 마켓플레이스 체크아웃 내부에 있을 때 plugin.json과 마켓플레이스 항목이 버전에 대해 동의하는지 확인
• 플러그인 디렉터리 아래의 깨끗한 작업 트리 필요
• 태그가 이미 존재하면 거부

​

비 git 소스를 가진 종속성 제약

• /reload-plugins
• 종속 플러그인의 마켓플레이스 자동 업데이트
• 종속 플러그인에서 claude plugin install 다시 실행
• claude plugin marketplace add

​

사용자를 위해 의존성이 어떻게 작동하는지

​

제약이 태그에 대해 어떻게 해결되는지

• 자체 저장소가 있는 플러그인: 설치는 Dependency "secrets-vault@your-marketplace" has no git tag satisfying을 포함하는 메시지로 실패합니다.
• 상대 경로로 참조되는 플러그인: 설치는 대신 마켓플레이스의 현재 복사본을 사용하고 플러그인이 로드될 때 제약이 확인됩니다. 해당 복사본이 범위를 벗어나면 종속 플러그인은 비활성화된 상태로 유지되고 claude plugin list는 Requires "secrets-vault@your-marketplace" ~2.1.0, installed 3.0.0을 표시합니다.

​

해결된 버전 확인

​

여러 플러그인의 제약 결합

​

참고 항목

• claude plugin prune: 플러그인이 더 이상 필요하지 않은 자동 설치 의존성 제거
• 마켓플레이스 호스팅: 릴리스 채널 및 다른 플러그인 권장