SpyBara
Go Premium

plugins/security.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 32 additions and 32 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Thu 8 22:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59 Wed 28 23:57

플러그인 보안 및 신뢰

플러그인을 설치하기 전에 신뢰할 수 있는지 결정하세요. 플러그인이 머신에서 할 수 있는 작업부터 플러그인을 검토하고 제거하는 방법까지 알아봅니다.

설치하는 Claude Code 플러그인은 사용자 권한으로 머신에서 임의의 코드를 실행할 수 있습니다.

마켓플레이스에서 플러그인을 설치합니다. 마켓플레이스는 Claude Code가 플러그인을 가져오는 카탈로그입니다. 일부 마켓플레이스 이름은 Anthropic의 자체 마켓플레이스용으로 예약되어 있으며, 다른 모든 마켓플레이스는 타사입니다. 마켓플레이스의 이름은 카탈로그를 게시하는 사람을 나타내지만, 카탈로그의 각 플러그인이 무엇을 하는지는 나타내지 않으므로, 설치하기 전에 플러그인을 검토하세요. 어느 마켓플레이스에서 가져오든 상관없습니다.

플러그인 설치 여부를 결정하거나 팀이 도구를 사용하기 전에 검토하는 경우 이 페이지를 읽으세요.

[!NOTE]

다음 경우는 다른 페이지에서 다룹니다:

플러그인이 할 수 있는 작업과 어느 마켓플레이스가 Anthropic의 것인지부터 시작한 다음, 설치하기 전에 플러그인을 검토하세요.

플러그인이 할 수 있는 것 이해하기

플러그인은 사용자 권한으로 머신에서 실행되는 코드와 Claude의 컨텍스트에 지침으로 입력되는 콘텐츠를 포함할 수 있으므로 플러그인을 설치하기 전에 검토하십시오. 설치된 플러그인이 할 수 있는 것은 다음과 같습니다:

  • Hooks: 플러그인의 hooks는 도구 호출 전후와 같이 Claude Code의 수명 주기의 특정 지점에서 셸 명령으로 실행됩니다.
  • Monitors: 플러그인의 monitors는 세션이 시작될 때, 사용자가 플러그인을 다시 로드할 때, 또는 지정된 스킬이 처음 실행될 때 Claude Code가 자체적으로 시작하는 백그라운드 셸 명령으로 실행됩니다.
  • Mods: 플러그인의 mod는 Claude Code 내에서 사용자의 권한으로 JavaScript를 실행합니다. 설치하기 전에 mod가 수행하는 작업을 나열하려면 mod를 신뢰할지 결정하기를 참조하십시오.
  • MCP 및 LSP 서버: Claude Code는 활성화된 플러그인이 선언하는 MCP 서버에 연결되고 Claude에 해당 도구를 제공합니다. stdio MCP 서버는 Claude Code가 머신에서 시작하는 프로세스로 실행됩니다. Claude Code는 플러그인이 선언하는 언어 서버도 시작합니다.
  • bin/ 디렉토리: Claude Code는 활성화된 각 플러그인의 bin/ 디렉토리를 Bash 도구의 셸의 PATH에 추가하므로 Claude의 Bash 명령은 여기의 모든 실행 파일을 실행할 수 있습니다. Claude가 PowerShell 도구로 실행하는 명령은 샌드박스 외부에서 실행될 때는 해당 디렉토리가 PATH에 포함되지만, 샌드박스 내부에서 실행될 때는 포함되지 않습니다.
  • Skills, commands, and agents: 이들은 Claude의 컨텍스트에 지침으로 입력되므로 Claude가 이미 가지고 있는 도구로 수행하는 작업에 영향을 미칩니다.
  • 업데이트: 플러그인을 설치한 마켓플레이스에서 자동 업데이트가 켜져 있으면 Claude Code는 백그라운드에서 해당 플러그인을 업데이트하므로 검토한 파일이 디스크에서 변경될 수 있습니다. 자동 업데이트가 실행되는 시기에 타이밍이 있습니다. 마켓플레이스별로 자동 업데이트를 켜거나 끄려면 플러그인 업데이트 유지를 참조하십시오.

Claude Code의 권한 규칙 및 sandbox는 Claude가 수행하는 도구 호출을 다루며, 플러그인이 자체적으로 실행하는 코드는 다루지 않습니다:

  • Hooks, monitors 및 서버 프로세스: 명령 hooks와 monitors는 전체 사용자 권한으로 실행되는 셸 명령입니다. Claude Code는 hooks, monitors, MCP 서버, LSP 서버 및 mod가 시작하는 프로세스를 샌드박스 외부에서 실행합니다.
  • Claude의 도구 호출: 플러그인의 MCP 도구 중 하나에 대한 호출 및 플러그인의 bin/에서 실행 파일을 실행하는 Bash 명령은 도구 호출이므로 권한 규칙이 적용됩니다. mod가 도구 호출에 수행할 수 있는 작업에 대해서는 mod를 신뢰할지 결정하기를 참조하십시오.

플러그인을 설치하면 해당 매니페스트 또는 마켓플레이스 항목이 defaultEnabled: false를 설정하고 사용자가 직접 활성화하지 않은 경우를 제외하고는 플러그인이 활성화됩니다.

더 이상 신뢰하지 않는 플러그인을 제거하려면 더 이상 신뢰하지 않는 플러그인 제거를 참조하십시오.

이름으로 Anthropic의 마켓플레이스 식별하기

마켓플레이스의 이름은 공식, 커뮤니티 또는 타사의 세 가지 계층 중 하나에 배치합니다. Claude Code는 github.com/anthropics/ 저장소에서 소싱된 마켓플레이스에 대해서만 공식 및 커뮤니티 이름을 허용하므로, 타사 마켓플레이스는 자신을 Anthropic 마켓플레이스로 제시할 수 없습니다. 동료 또는 조직이 게시하는 마켓플레이스는 타사입니다.

표는 각 계층에 어떤 이름이 속하는지 나열합니다:

계층 마켓플레이스
공식 공식 마켓플레이스 이름(예: claude-plugins-official)
커뮤니티 claude-community, claude-plugins-community, 및 healthcare
타사 다른 모든 마켓플레이스

claude-community 카탈로그가 플러그인을 커밋 SHA에 고정하는 경우(거의 모든 항목에 대해 수행), Claude Code는 다른 커밋 설치를 거부합니다.

공식 마켓플레이스 이름

이 마켓플레이스 이름은 공식 계층을 구성합니다:

  • claude-plugins-official
  • claude-code-marketplace
  • claude-code-plugins
  • anthropic-marketplace
  • anthropic-plugins
  • agent-skills
  • anthropic-agent-skills
  • life-sciences
  • knowledge-work-plugins
  • claude-for-legal
  • claude-for-financial-services
  • financial-services-plugins
  • first-party-plugins
  • claude-tag-plugins

공식, 커뮤니티 및 데모 마켓플레이스가 어떻게 다르고 각각 어디에서 나열된 내용을 찾아볼 수 있는지는 Anthropic의 마켓플레이스를 참조하세요.

설치하기 전에 플러그인 검토하기

플러그인을 설치하기 전에 추가되는 내용과 출처를 확인하세요.

1. 마켓플레이스의 소스 확인

셸에서 claude plugin marketplace list를 실행하여 GitHub 저장소 또는 디렉토리와 같이 각 마켓플레이스가 추가된 소스를 인쇄합니다.

2. 세부 정보 창 읽기

Claude Code 세션에서 /plugin을 실행하고 플러그인을 선택합니다. 세부 정보 창은 플러그인의 명령, agents, skills, hooks 및 MCP와 LSP 서버를 나열하는 설치될 항목 섹션을 표시합니다. Anthropic이 게시된 구성 요소 데이터가 없는 플러그인의 경우, 섹션은 마켓플레이스 항목이 선언하는 내용을 표시하거나, 마켓플레이스 내에 저장된 플러그인의 경우 설치 시 구성 요소가 발견됩니다 또는 다른 곳에서 가져온 플러그인의 경우 원격 플러그인에 대해 구성 요소 요약을 사용할 수 없습니다라는 메모를 표시합니다.

3. 플러그인의 소스 읽기

세부 정보 창에서 설치 옵션 아래의 홈페이지 열기 또는 GitHub에서 보기를 선택합니다. 창이 둘 다 제공하지 않으면, 첫 번째 단계에서 찾은 마켓플레이스 저장소를 엽니다. 거기서 플러그인의 디렉토리를 찾습니다. 설치될 항목 섹션은 hook이 존재함을 보여주지만 실행되는 내용은 보여주지 않으므로, 플러그인의 디렉토리에서 이 파일들을 읽으세요:

  • hooks/hooks.json: 각 hook이 실행하는 명령
  • .mcp.json: 각 서버의 명령 또는 URL
  • bin/: 디렉토리의 모든 파일

4. 플러그인이 포함하는 내용 나열

플러그인의 디렉토리를 보유한 저장소를 복제한 다음, 셸에서 claude --plugin-dir <plugin directory> plugin details <plugin name>을 실행하여 Claude Code가 찾은 내용을 확인합니다. 명령은 세션을 시작하지 않고 플러그인의 파일을 읽고 플러그인의 skills 및 명령, agents, 각 hook의 이벤트가 있는 hooks 및 MCP와 LSP 서버를 나열하는 구성 요소 인벤토리를 인쇄합니다.

플러그인을 설치한 후, 셸에서 claude plugin details <plugin name>을 실행하여 ~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/ 아래의 설치된 복사본에 대해 동일한 구성 요소 인벤토리를 인쇄합니다.

더 이상 신뢰하지 않는 플러그인 제거

셸에서 설치한 --scope와 함께 claude plugin uninstall <plugin>을 실행합니다. 그런 다음 제거된 내용과 남겨진 내용을 확인합니다:

  • 지속적인 데이터: 기본적으로 이것이 플러그인이 설치된 마지막 범위인 경우, 제거하면 플러그인의 지속적인 데이터 디렉토리도 삭제됩니다. --keep-data 및 남아 있는 다른 경우들에 대해서는 플러그인 제거를 참조하세요.
  • 캐시된 파일: 플러그인의 파일은 ~/.claude/plugins/cache/ 아래 디스크에 남아 있으며, 백그라운드 스윕이 제거하기 전에 14일 동안 남아 있습니다. 마지막 플러그인을 제거한 후, 고아 디렉토리는 다른 플러그인을 설치할 때까지 남아 있습니다. 지금 파일을 삭제하려면, ~/.claude/plugins/cache/<marketplace>/<plugin>/ 아래의 플러그인 디렉토리를 직접 제거하세요.
  • 마켓플레이스: 마켓플레이스의 소유자도 신뢰하지 않으면, 마켓플레이스도 제거하세요. 이렇게 하면 해당 마켓플레이스에서 설치한 모든 플러그인이 제거됩니다.

Claude Code가 거부하거나 경고하는 경우 인식하기

/plugin의 Discover 또는 Marketplaces 탭에서 열 수 있는 세부 정보 창에는 각 플러그인에 대해 동일한 신뢰 경고가 표시됩니다. Claude Code는 신뢰할 수 없는 마켓플레이스 소스 및 무결성 검사 실패에 해당하는 경우와 같은 경우에 경고 대신 거부합니다.

설치 전 신뢰 경고

경고는 플러그인이 어느 마켓플레이스에서 오든 동일하게 표시됩니다:

Make sure you trust a plugin before installing, updating, or using it. Anthropic does not control what MCP servers, files, or other software are included in plugins and cannot verify that they will work as intended or that they won't change. See each plugin's homepage for more information.

조직에서 관리 설정에서 pluginTrustMessage를 설정한 경우, Claude Code는 해당 텍스트를 경고에 추가합니다.

신뢰할 수 없는 마켓플레이스 소스 및 무결성 검사 실패

Claude Code는 다음의 경우에 마켓플레이스를 로드하거나 플러그인을 설치하기를 거부하며, 각각 고유한 오류 메시지가 있습니다:

  • 신뢰할 수 없는 마켓플레이스 소스: 마켓플레이스가 공식 또는 커뮤니티 이름을 사용하지만 해당 소스가 github.com/anthropics/ 외부에 있을 때, Claude Code는 마켓플레이스 로드를 중지하고 해당 마켓플레이스에서 설치한 플러그인을 로드하기를 거부합니다. 오류는 Marketplace is registered from an untrusted source입니다.
  • 아카이브 무결성: 마켓플레이스 항목이 archive 소스를 sha256 다이제스트에 고정하고 다운로드된 파일의 다이제스트가 일치하지 않을 때, Claude Code는 설치를 거부합니다. 오류는 Plugin archive integrity check failed입니다.

sha256 핀은 체크아웃할 git 커밋을 선택하는 커뮤니티 카탈로그의 커밋 SHA 핀과 별개입니다.

조직을 위한 플러그인 제어 적용

관리 설정을 사용하면, 관리자는 다음 플러그인 제어를 적용할 수 있습니다:

  • 마켓플레이스 소스 허용 목록 또는 차단 목록
  • 플러그인 강제 활성화
  • --plugin-dir 및 --plugin-url 플래그와 CLAUDE_CODE_PLUGIN_DIRS 변수 끄기
  • hooks를 관리 설정 및 강제 활성화된 플러그인의 hooks로 제한
  • 구성원의 claude.ai 계정의 플러그인이 Claude Code에서 로드되지 않도록 중지(syncClaudeAiPlugins 포함)

제어 매트릭스는 각 키가 무엇을 하고 하지 않는지 말합니다.

원격 분석에서 플러그인 찾기

조직이 Claude Code의 OpenTelemetry 이벤트를 자체 백엔드로 내보내면, 마켓플레이스 계층은 어떤 플러그인 이름이 나타나는지 결정합니다:

  • 플러그인 로드 이벤트: 이벤트는 공식 계층 플러그인 및 마켓플레이스 이름을 그대로 보고합니다. 커뮤니티 및 타사 계층의 경우, plugin.name 및 marketplace.name은 OTEL_LOG_TOOL_DETAILS=1을 설정하지 않는 한 리터럴 문자열 third-party입니다.
  • 플러그인 범위: 로드된 이벤트의 plugin.scope는 여전히 플러그인이 온 위치(예: 관리 설정이 활성화하는 플러그인의 경우 org 또는 다른 타사 플러그인의 경우 user-local)를 보고합니다. 플러그인 로드 이벤트는 모든 값을 나열합니다.
  • 플러그인 설치 이벤트: OTEL_LOG_TOOL_DETAILS=1을 설정하지 않는 한, 이벤트는 third-party를 보고하는 대신 비공식 플러그인의 이름 필드를 생략합니다.
  • Claude Code Analytics API: Claude Code는 공식 및 커뮤니티 계층의 플러그인을 이름으로 보고하고 다른 모든 플러그인을 third-party로 보고합니다.

다음 단계