로드 중
로드 중

플러그인

신뢰할 수 있는 설정은 팀 전체가 그것을 사용하게 되면 훨씬 더 가치가 커집니다. 문제는 그것을 옮기는 일입니다. skill, subagent, hook이 포함된 훌륭한 .claude 디렉토리를 만들었다면, 그다음은 어떻게 할까요? 모두가 파일을 이 기기 저 기기로 복사하고 붙여넣으면서 동기화가 유지되기를 바랍니다. 플러그인이 이 문제를 해결합니다. 플러그인은 Claude Code가 설정을 패키징하여 한 사람에게서 다음 사람에게로 옮기는 방식입니다.

여기에는 두 가지 측면이 있으며, 둘 다 다룰 것입니다. 첫째, 다른 사람이 게시한 플러그인을 사용하는 것입니다. 둘째, 공유할 만한 것을 만들었다면 직접 패키징하는 것입니다.

플러그인이란 무엇인가

플러그인은 설치 가능한 하나의 단위입니다. 그렇지 않으면 직접 공유해야 할 모든 것, 즉 skill, subagent, hook, MCP 서버 설정과 더불어 language server protocol 서버, 백그라운드 모니터, 테마 같은 더 다양한 것들까지 한데 묶습니다. 하나의 버전, 하나의 설치입니다.

플러그인이 어디에 있는지에 따라 설치 방법이 달라집니다. 세션 내에서는 이름으로 직접 플러그인을 설치할 수 있습니다:

/plugin install github@claude-plugins-official

이 명령은 먼저 플러그인의 세부 정보를 열어 검토하고 범위를 선택할 수 있게 해줍니다. 그런 다음 Claude Code가 플러그인을 설치하고 간단한 요약을 출력합니다. 플러그인이 이미 이 세션에서 활성화되어 있다고 표시되거나, /reload-plugins를 언급하며 Claude Code가 해당 재로드를 대신 실행합니다. 재로드 시 다음 메시지가 전체 대화를 다시 읽게 된다는 경고가 뜰 때만 직접 개입하면 됩니다: 이 경우에도 플러그인을 활성화하려면 /reload-plugins --force를 실행하세요.

팀을 위한 마켓플레이스 추가하기

팀의 경우, 프라이빗 마켓플레이스를 한 번 추가하는 것이 더 나은 방법입니다. 마켓플레이스는 플러그인이 참조하는 공유 소스입니다:

/plugin marketplace add your-org/claude-plugins

이름은 원하는 대로 지정하면 됩니다. 추가하고 나면 이후의 모든 설치가 이를 통해 처리됩니다. 모든 사람의 노트북에 흩어져 있는 대신, 중앙화된 검색, 버전 추적, 업데이트를 한곳에서 관리할 수 있습니다.

Discover 탭에서 사용 가능한 항목을 둘러볼 수 있습니다. 여기에는 마켓플레이스에 있는 플러그인이 나열되어 검색하고 선택할 수 있습니다.

설치하기 전에 먼저 읽어보세요

가장 중요한 부분이 여기 있습니다. 플러그인은 여러분의 권한으로 여러분의 기기에서 코드를 실행합니다. 플러그인의 hook은 일치하는 모든 도구 호출 시마다 실행됩니다. 따라서 플러그인을 skill 때문에 설치하더라도, 읽어봤든 안 읽어봤든 해당 플러그인의 PreToolUse와 Stop hook도 함께 얻게 됩니다.

이것이 무엇을 의미하는지 생각해보세요. 커뮤니티 플러그인이 매번 네트워크 엔드포인트를 호출하는 Stop hook을 포함하고 있을 수도 있으며, 여러분의 설정에는 이를 경고해줄 것이 전혀 없습니다. 그렇다고 플러그인을 피해야 한다는 뜻은 아닙니다. 먼저 확인해야 한다는 뜻입니다.

설치하기 전에 플러그인의 세부 정보를 확인하세요. Claude Code는 설치될 내용을 보여주고 컨텍스트 비용을 추정해주며, Anthropic이 서드파티 플러그인 내부의 내용을 통제하지 않는다는 명확한 경고도 함께 제공합니다.

플러그인의 출처에 대해 알아두면 좋은 두 가지가 있습니다:

  • 플러그인이 커뮤니티 마켓플레이스에 등록되는 것은 작성자가 이를 Anthropic에 제출했기 때문입니다.
  • 공식 마켓플레이스는 별도의 독립적인 과정을 통해 큐레이션됩니다.

하지만 목록에 있다는 것이 곧 신뢰할 수 있다는 의미는 아닙니다. 그러니 원칙은 변하지 않습니다: 진정으로 신뢰하는 출처에서만 플러그인을 설치하고 마켓플레이스를 추가하며, 활성화하기 전에 플러그인이 실제로 무엇을 하는지 확인하세요.

컴포넌트는 여러분의 것과 함께 실행됩니다

플러그인은 여러분의 설정을 덮어쓰지 않습니다. 플러그인의 컴포넌트는 여러분 자신의 것과 함께 실행됩니다. 이는 대체로 좋은 일이지만, 이해해야 할 결과도 있습니다.

Hook은 누적됩니다. 플러그인의 PreToolUse hook과 여러분 자신의 PreToolUse hook이 모든 도구 호출 시마다 함께 실행됩니다. 어느 쪽도 다른 쪽을 대체하지 않습니다. 바로 이 때문에 세부 정보를 먼저 읽어야 하는 것입니다.

Skill, agent, command은 플러그인 이름 아래에 네임스페이스가 지정되므로 여러분의 것과 절대 충돌하지 않습니다.

플러그인이 설치되면 플러그인 패널에서 추가된 모든 것을 확인하고, 관리하고, 제거할 수 있습니다.

직접 플러그인 패키징하기

이제 반대편을 살펴보겠습니다. 동작하는 .claude 디렉토리를 만들었다면, 팀원들이 기기 간에 이를 복사하고 붙여넣게 하지 마세요. 대신 패키징하세요.

좋은 소식은 아무것도 다시 작성할 필요가 없다는 것입니다. .claude 디렉토리의 구성 요소들을 플러그인 자체 폴더로 복사하면 됩니다:

text
svg-splitter-review/
├── .claude-plugin/plugin.json
├── skills/<skill-name>/SKILL.md
├── agents/<agent-name>.md
├── hooks/hooks.json
└── .mcp.json

Hook은 settings.json을 벗어나는 유일한 구성 요소입니다: hooks 객체를 hooks/hooks.json으로 복사하세요. 나머지는 Claude Code가 관례에 따라 자동으로 찾아냅니다. 공유하기 전에 플러그인을 테스트해보려면, 해당 폴더로 세션을 시작하세요:

claude --plugin-dir ./svg-splitter-review

동작을 확인했다면 .claude에서 원본을 삭제하고 settings.json에서 hooks 객체를 제거하세요. 그렇게 하기 전까지는 각 hook이 두 번씩 실행됩니다.

매니페스트

이 외에도 선택적인 매니페스트가 있습니다. 이는 .claude-plugin/plugin.json에 위치하며 이름, 버전, 설명, 작성자 정보를 담고 있습니다:

json
{
  "name": "svg-splitter-review",
  "version": "0.1.0",
  "description": "Reviews the SVG Splitter repo",
  "author": {
    "name": "Lewis Menelaws"
  }
}

매니페스트는 선택 사항입니다. 생략하더라도 Claude Code는 디렉토리 관례에 따라 여전히 컴포넌트를 찾아냅니다. 하지만 알아두면 좋은 몇 가지 세부 사항이 있습니다:

  • 이름은 유일한 필수 필드입니다. 이는 여러분의 skill을 /plugin-name:skill-name 형태로 네임스페이스 처리하므로, 이 플러그인의 skill은 /svg-splitter-review:<skill-name>로 실행됩니다. 이를 통해 여러분의 skill이 다른 사람의 것과 충돌하지 않습니다.
  • 다른 의존성과 마찬가지로 버전을 관리하세요. 이것이 팀 전체에서 업데이트와 버전 추적이 동작하게 만드는 요소입니다.

핵심 요약

두 가지 간단한 규칙이 이 내용의 대부분을 아우릅니다:

  • 플러그인을 사용할 때는 설치하기 전에 읽어보세요. 플러그인은 여러분의 권한으로 코드를 실행하므로, 먼저 hook, agent, MCP 서버를 확인하세요.
  • 플러그인을 만들 때는 동작하는 즉시 .claude를 패키징하세요. 하나의 매니페스트, 하나의 설치입니다.

이것이 핵심입니다. 설치 가능한 하나의 단위로, 여러분이 신뢰하는 설정이 팀 전체에 전달됩니다.