Claude Code 플러그인 개념과 비용 정리
Claude Code 플러그인의 정의와 설치 방법, 그리고 비용 구조를 상세히 설명합니다. 플러그인 자체는 무료이나, 실행 시 컨텍스트에 포함되는 토큰 사용량에 따라 비용이 발생합니다. 플러그인 패키징의 핵심 원리와 네임스페이스 관리 방식을 확인하십시오.
Claude Code 플러그인이란 무엇인가
Claude Code 플러그인은 Claude Code가 하나의 단위로 로드하고 관리하는 구성 요소들의 디렉터리입니다. 주요 구성 요소로는 스킬, 에이전트, 훅, MCP 서버, LSP 서버, 백그라운드 모니터가 있으며, 플러그인에는 명령어, 출력 스타일, 테마, 워크플로우, 그리고 실행 파일이 담긴 bin/ 디렉터리도 포함될 수 있습니다. 플러그인을 설치하면 모든 구성 요소가 한 번에 하나의 이름으로 추가되며, 비활성화하면 동일한 방식으로 제거됩니다.
플러그인은 기본적으로 에이전트에게 기존에 없던 새로운 능력을 부여하지 않습니다. 스킬, 에이전트, 훅, MCP 서버는 모두 .claude/ 디렉터리에 직접 작성할 수 있는 항목들입니다. 예외적으로 코드 인텔리전스를 위한 언어 서버와 mods는 Claude Code가 플러그인을 통해서만 로드합니다. 그 외의 모든 경우에 플러그인은 패키징 계층 역할을 합니다. 즉, 해당 구성 요소들의 버전을 관리하고, 여러 사람에게 배포하며, 파일을 일일이 복사하도록 요청할 필요 없이 나중에 업데이트할 수 있는 수단입니다. 이것이 플러그인의 핵심 개념이며, 플러그인에 대한 대부분의 혼란은 이를 새로운 종류의 기능으로 오해하는 데서 비롯됩니다.
.claude-plugin/plugin.json에 위치한 선택적 매니페스트 파일은 플러그인의 이름을 지정하며, 이 이름은 네임스페이스가 됩니다. commit-commands이라는 플러그인에 포함된 스킬은 /commit-commands:commit로 호출되므로, 두 플러그인이 각각 commit이라는 이름의 스킬을 제공하더라도 서로 충돌하지 않습니다. 플러그인 에이전트 또한 @-멘션 목록에서 plugin-name:agent-name과 같이 동일한 방식으로 범위가 지정됩니다.
플러그인, 스킬, MCP 서버 또는 규칙 파일
이 네 가지 용어는 마치 서로 경쟁하는 것처럼 사용되곤 합니다. 하지만 실제로는 그렇지 않으며, 그 경계를 한 번 명확히 할 필요가 있습니다.
- 스킬은 작업이 요구될 때 Claude가 불러오는 단일 명령어 단위입니다. 에이전트 스킬의 실제 의미를 참조하십시오.
- MCP 서버는 프로토콜을 통해 에이전트에 도구를 노출하는 별도의 프로세스이며, 주로 사용자가 직접 실행하는 네트워크 서비스입니다.
CLAUDE.md와 같은 규칙 파일은 세션 시작 시 읽혀 모든 작업에 적용되는 프로젝트 컨텍스트입니다.- 플러그인은 스킬, 에이전트, 훅, MCP 서버 또는 기타 구성 요소들을 포함하는 디렉터리이며, Claude Code는 이를 하나의 단위로 설치하고 로드합니다. 선택 사항인 매니페스트를 통해 이름을 지정하고 버전, 설명 및 기타 메타데이터를 추가할 수 있습니다. 배포는 플러그인의 일부가 아닙니다. 마켓플레이스는 플러그인을 나열하고 각 플러그인을 가져올 위치를 안내하는 별도의 카탈로그입니다.
따라서 플러그인이 답하는 질문은 "에이전트가 무엇을 할 수 있는가"가 아닙니다. 그 질문은 "어떻게 이것을 팀에 배포하고 다음 달에 업데이트할 것인가"입니다. 앞의 세 가지 중 무엇을 선택할지 고민 중이라면 스킬, MCP 서버 및 규칙 파일 비교에서 해당 결정에 대한 자세한 내용을 다룹니다. MCP 부분에 관심이 있다면 VPS에서 직접 MCP 서버 실행하기에서 호스팅 측면을 다룹니다.
플러그인이 저장되는 위치와 플러그인 내부 구성
대부분의 marketplace 플러그인은 ~/.claude/plugins/cache의 로컬 캐시에 복사되며, 설치된 각 버전마다 별도 디렉터리가 생성됩니다. 로컬 경로에서 추가한 marketplace의 상대 경로 플러그인은 원래 위치에서 로드됩니다. link 모드의 command-source 플러그인은 소스 디렉터리를 가리키는 링크를 통해 로드됩니다. 복사된 플러그인을 업데이트하거나 제거하면 이전 버전 디렉터리가 orphaned 상태로 표시되고 약 2주 후에 삭제됩니다. 따라서 이미 이전 버전을 로드한 세션은 작업 중간에 실패하지 않고 계속 실행됩니다. 정리는 하나 이상의 플러그인 설치 기록이 남아 있을 때만 실행됩니다. 마지막 플러그인을 제거한 뒤에는 다른 플러그인을 설치할 때까지 orphaned 디렉터리가 남아 있습니다.
복사된 플러그인의 경로는 업데이트할 때마다 바뀌므로 플러그인에서 자신의 위치를 하드코딩해서는 안 됩니다. 플러그인 내부의 hooks와 MCP 설정에서는 ${CLAUDE_PLUGIN_ROOT}를 사용합니다. 이 값은 현재 설치 디렉터리로 확인됩니다. 업데이트 후에도 유지해야 하는 상태는 ${CLAUDE_PLUGIN_DATA}에 저장합니다. 이 값은 ~/.claude/plugins/data/ 아래의 안정적인 디렉터리로 확인됩니다.
복사된 플러그인의 경우 캐시에는 플러그인 자체 디렉터리만 복사됩니다. 단, 같은 marketplace 안의 다른 위치에 있는 symlink 대상은 해당 위치에 복사됩니다. ../shared-utils처럼 플러그인 root 외부의 경로를 읽는 스크립트는 로컬 경로로 개발할 때는 작동하지만, 플러그인이 캐시에 복사되면 작동하지 않습니다. 해당 파일은 복사되지 않기 때문입니다. plugin.json에서 같은 방식으로 선언한 component 경로는 더 빨리 실패합니다. Claude Code는 개발 중에도 플러그인 root를 벗어나는 component 경로를 거부하며, path escapes plugin directory 오류를 표시합니다.
디렉터리 구조는 다음과 같습니다.
my-plugin/
├── .claude-plugin/
│ └── plugin.json
├── skills/
│ └── code-review/
│ └── SKILL.md
├── agents/
├── hooks/
│ └── hooks.json
├── .mcp.json
└── bin/plugin.json만 .claude-plugin/ 안에 들어갑니다. 나머지는 모두 플러그인 root에 위치합니다. skills/ 또는 hooks/를 .claude-plugin/ 안에 넣는 것은 플러그인이 정상적으로 설치된 후에도 전혀 동작하지 않는 가장 흔한 원인입니다. Claude Code는 해당 디렉터리를 root에서 찾지만 찾지 못하므로 component가 없는 플러그인을 로드합니다.
manifest 자체는 간단합니다.
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0"
}Claude Code 플러그인 설치 방법
설치는 2단계로 진행되며, 첫 번째 단계에서는 아무것도 설치하지 않는다. 플러그인 카탈로그인 marketplace를 추가한 다음, 해당 marketplace에서 개별 플러그인을 설치한다. Anthropic의 공식 marketplace인 claude-plugins-official은 관리 정책 또는 CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL이 차단하지 않는 한, Claude Code를 처음 대화형으로 시작할 때 자동으로 등록된다. 다른 marketplace는 직접 추가해야 한다.
/plugin marketplace add anthropics/claude-plugins-official
/plugin install commit-commands@claude-plugins-officialmarketplace 이름은 저장소 경로가 아니라 저장소 내부의 카탈로그 파일에서 가져온다. 따라서 설치 명령을 입력하기 전에 /plugin의 Marketplaces 탭에서 marketplace 이름을 확인해야 한다. anthropics/claude-code에 있는 이전 claude-code-plugins marketplace는 더 이상 사용되지 않으므로 새로 설치할 때는 claude-plugins-official을 사용한다. 이전 marketplace에서 설치한 기존 플러그인은 공식 저장소에서 업데이트되므로, marketplace만 변경하려고 commit-commands을 다시 설치할 필요는 없다.
설치가 끝나면 요약 줄을 확인한다. Plugin is now active.은 이 세션에서 구성 요소가 로드되었다는 뜻이다. Run /reload-plugins to apply.은 설치 중에 활성화되지 않았다는 뜻이다. 패널이 닫히고 Claude Code가 자동으로 다시 로드한다. 다시 로드하면서 대화를 다시 읽게 된다는 경고가 표시되면 플러그인은 보류 상태로 남는다. 이 경우 /reload-plugins --force로 다시 실행한다. 그런 다음 플러그인이 실제로 설치되었는지 확인한다. /plugin을 실행하면 Installed 탭에서 플러그인을 확인할 수 있다. /을 입력하면 해당 플러그인의 스킬이 /plugin-name:skill-name로 표시된다. 로드에 실패한 항목은 이유와 함께 Errors 탭에 표시된다.
설치할 때는 scope를 지정해야 하며, scope에 따라 플러그인을 사용할 수 있는 사람이 결정된다. User scope는 모든 프로젝트에서 본인만 사용한다. Project scope는 저장소의 .claude/settings.json에 플러그인을 기록하고 enabledPlugins 아래에 저장하므로, 저장소를 clone하는 모든 사용자가 해당 플러그인을 사용하게 된다. 다만 플러그인을 다른 사용자의 컴퓨터에 자동으로 다운로드하지는 않는다. 각 협업자는 자신의 컴퓨터에서 claude plugin install name@marketplace --scope project와 같은 명령으로 한 번 설치해야 한다. 단, marketplace 항목이 상대 경로이거나 seed 디렉터리에 플러그인이 이미 있는 경우는 예외다. Local scope는 현재 저장소에서 본인만 사용한다.
스크립트, Dockerfile 또는 대화형 패널을 사용할 수 없는 세션에서는 대신 shell 형식을 사용한다. 별도로 --scope을 지정하지 않으면 User scope에 설치된다. 아직 아무도 대화형 세션을 연 적이 없는 컴퓨터에서는 공식 marketplace가 등록되지 않으므로 먼저 추가해야 한다.
claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install commit-commands@claude-plugins-official --scope project
claude plugin listclaude plugin install은 세션 외부에서 실행되므로, 이미 열려 있는 세션에서는 /reload-plugins을 실행하거나 새 세션을 시작하기 전까지 새 플러그인을 인식하지 못한다.
설치된 항목을 관리하는 방식은 두 환경에서 동일하다. /plugin list은 설치된 항목을 출력하며, --enabled 또는 --disabled을 인수로 받을 수 있다. /plugin disable name@marketplace은 플러그인을 제거하지 않고 비활성화한다. /plugin enable은 다시 활성화하고, /plugin uninstall은 제거한다. slash-command 형식은 변경 사항을 적용하기 위해 플러그인 패널을 열기 때문에, 스크립트에서는 claude plugin ... shell 대응 명령을 사용해야 한다.
전체 팀에 marketplace를 제공하려면 프로젝트의 .claude/settings.json에 추가하거나, claude plugin marketplace add your-org/claude-plugins --scope project을 한 번 실행한 뒤 생성된 파일을 commit한다. Claude Code는 각 구성원이 저장소 폴더를 신뢰하면 해당 구성원에게 marketplace를 등록한다.
{
"extraKnownMarketplaces": {
"my-team-tools": {
"source": {
"source": "github",
"repo": "your-org/claude-plugins"
}
}
}
}직접 플러그인을 개발하는 동안에는 marketplace를 사용하지 않아도 된다. claude --plugin-dir ./my-plugin은 해당 세션에서 디렉터리를 로드하고, /reload-plugins은 재시작 없이 변경 사항을 반영하며, claude plugin validate ./my-plugin은 다른 사람이 사용하기 전에 manifest, skill 및 agent frontmatter와 hooks/hooks.json을 검사한다. 공유할 때도 marketplace는 필요하지 않다. 폴더 또는 그 폴더의 .zip을 다른 사람에게 보내고 --plugin-dir으로 로드하게 할 수 있다. 다만 새 복사본을 보내기 전까지는 업데이트되지 않는다.
Claude Code 플러그인의 비용은 얼마입니까?
플러그인 메커니즘 자체는 무료입니다. 2026년 11월 기준으로 마켓플레이스를 추가하거나, 플러그인을 설치하거나, 활성화 상태로 유지하는 데 드는 비용은 없습니다. 공식 및 커뮤니티 마켓플레이스는 공개 git 저장소이며, 플러그인은 텍스트 파일로 구성된 디렉터리입니다.
플러그인 사용 시 발생하는 비용은 토큰이며, 토큰은 구독 사용량이나 API 청구서에서 실제로 측정되는 단위입니다. 플러그인이 이 두 가지 중 어디에서 차감되는지는 도구 이용 방식에 따라 다르며, 플랜별 Claude Code 비용에서 구독 티어와 토큰당 API 가격을 확인할 수 있습니다. 이 비용은 세 가지 방식으로 발생하며 각각 다르게 작동합니다.
상주 컨텍스트 비용. 활성화된 모든 플러그인은 Claude가 스스로 호출할 수 있는 기술, 에이전트, 명령어의 이름과 설명을 컨텍스트에 포함하며, 이 부분은 작업 실행 여부와 관계없이 세션의 매 턴마다 다시 읽힙니다. 모든 구성 요소가 토큰을 소모하는 것은 아닙니다. 훅(hook)은 하니스(harness)에 의해 실행되며 모델의 컨텍스트에 아무것도 추가하지 않습니다. 설치 전 /plugin 상세 보기에는 설치하려는 명령어, 기술, 에이전트, 훅, MCP 및 LSP 서버를 나열하는 Will install 섹션이 표시됩니다. Anthropic 공식 마켓플레이스의 플러그인의 경우, 마켓플레이스 이름이나 Marketplaces 탭을 통해 플러그인을 열면 Every turn 및 When invoked 추정치가 포함된 Context cost 섹션도 표시됩니다. 두 항목 모두 확인하십시오. 사용자 본인이나 타사 마켓플레이스의 플러그인에는 Context cost 섹션이 없지만, 직접 추정할 필요는 없습니다. 셸에서 claude plugin details name을 실행하면 로드된 모든 플러그인에 대해 Always-on 토큰 수치와 구성 요소별 분석을 출력하며, --plugin-dir으로 전달하는 플러그인도 포함됩니다. 따라서 저장소를 복제한 후 설치 전에 claude --plugin-dir ./that-plugin plugin details that-plugin을 실행할 수 있습니다. 이 수치에는 MCP 서버는 포함되지 않습니다. MCP 서버를 포함하는 플러그인은 도구 정의가 크기 때문에 일반적으로 가장 무겁지만, MCP 도구 검색을 지원하는 모델에서는 도구가 필요할 때까지 해당 정의가 지연됩니다. 플러그인이 활성화된 세션에서 /context를 실행하고 MCP tools 라인을 읽어 추가되는 내용을 확인하십시오. (Discover 목록에서 여는 것 대신)
호출 비용. 플러그인의 기술을 실행하면 해당 지침이 대화 내용에 추가되므로, 기술 본문은 사용할 때만 비용을 지불합니다. 하지만 기술 본문은 저렴한 편이며, 기술이 에이전트에게 지시하는 내용은 그렇지 않을 수 있습니다. unlazy 기술의 Depth Tree 방식은 에이전트가 작업을 완료했다고 판단하기 전에 강제하는 추가 패스(pass)에 대부분의 토큰을 소모하며, 설치한 파일 자체에는 비용이 거의 들지 않습니다. 에이전트는 다릅니다. 서브 에이전트는 캐시 적중 없이 시작하여 자체 시스템 프롬프트와 자체 캐시를 사용하는 별도의 대화를 수행하므로, 워크플로우가 에이전트를 생성하는 플러그인은 컨텍스트 추정치보다 훨씬 많은 비용이 듭니다.
캐시 비용. 세션 중간에 플러그인을 활성화하거나 비활성화하면 다음 요청 시 전체 대화 내용을 다시 처리해야 할 수 있습니다. 기술, 명령어, 에이전트, 훅, 모니터, 테마는 이러한 현상을 유발하지 않습니다. 이들이 추가하는 내용은 기존 기록 뒤에 덧붙여지므로, 다음 요청은 새로운 콘텐츠에 대해서만 비용을 지불하고 그 이전 내용은 캐시에서 읽어옵니다. 예외는 MCP 서버를 제공하는 플러그인과 코드 인텔리전스 플러그인인데, 후자의 언어 서버는 Claude에게 LSP 도구를 제공합니다. MCP의 경우 도구 검색 여부에 따라 다릅니다. 도구가 지연 로드되면 캐시가 유지되지만, 프롬프트 접두사에 로드되면 다음 요청은 전체 대화를 캐시되지 않은 입력으로 다시 읽습니다. 바로 이 때문에 MCP 도구나 LSP 도구의 변경 사항이 캐시를 깨뜨릴 수 있는 경우 /reload-plugins가 경고를 표시하고 거부하며, --force을 전달해야만 진행할 수 있습니다.
이 과정을 추측하는 대신 직접 모니터링할 수 있습니다. 모든 API 응답은 cache_read_input_tokens 및 cache_creation_input_tokens를 보고하며, 실시간 토큰 사용량을 보여주는 사용자 지정 상태 표시줄을 통해 두 수치를 모두 확인할 수 있습니다. 정상적인 세션은 생성하는 것보다 훨씬 많은 양을 읽습니다. 생성량이 턴마다 계속 높게 유지된다면 접두사의 무언가가 매 턴 변경되고 있는 것입니다. 창을 채우는 요소에 대한 더 넓은 관점은 Claude Code 컨텍스트 창 관리 방법 및 토큰 수치의 실제 의미를 참조하십시오.
한 가지 관리 작업은 그 자체로 비용을 절감해 줍니다. Installed 탭은 최소 14일 및 10개의 세션 동안 사용하지 않은 마켓플레이스 설치 플러그인을 Not used recently 헤더 아래에 그룹화하며, 상세 보기에는 Last used 라인이 표시됩니다. 이 헤더에는 관리형 플러그인, 시드 디렉터리 플러그인, 테마·출력 스타일·모니터·워크플로우가 포함된 플러그인은 제외됩니다. LSP 서버는 진단 정보를 전달하거나 코드 탐색 요청에 응답할 때 사용된 것으로 간주합니다. strictKnownMarketplaces이 구성되면 헤더와 Last used: 라인 모두 나타나지 않습니다. 해당 플러그인은 여전히 모든 세션에서 시작 시간과 컨텍스트 비용을 발생시킵니다. 사용하지 않는다면 비활성화하거나 제거하십시오. 더 저렴한 습관은 설치 전 신중하게 선택하는 것입니다. Matt Pocock의 기술 중 설치할 가치가 있는 것에서는 27가지 기술 모음을 검토하여 개인 개발자에게 필요한 소수의 기술과 팀 단위에서만 효과가 있는 기술을 구분합니다.
플러그인은 사용자 권한으로 실행된다
Anthropic의 공식 문서도 이 점을 명확히 설명한다. 설치한 플러그인은 사용자 권한으로 컴퓨터에서 임의의 코드를 실행할 수 있다. 이는 가정이 아니다. 플러그인의 hooks는 세션 이벤트가 발생할 때 shell 명령을 실행하며, 여기에는 tool call 전후가 포함된다. 플러그인이 활성화되어 있는 동안 플러그인의 bin/ 디렉터리가 Bash tool의 PATH에 추가된다. 플러그인의 stdio MCP servers는 플러그인이 시작하는 프로세스이며, mod는 Claude Code 자체에서 JavaScript를 실행한다. hooks, monitors, server processes, mod processes는 Claude Code의 sandbox 밖에서 실행되지만, Claude가 수행하는 tool call에는 Claude Code의 permission rules가 계속 적용된다.
노트북에서는 해당 위험이 desktop user가 접근할 수 있는 범위로 제한된다. 서버에서는 대개 그렇지 않다. 에이전트를 실행하는 account에는 SSH keys, deploy tokens, cloud CLI session, Docker socket 접근 권한이 있는 경우가 많다. 따라서 "사용자 권한으로 임의의 코드를 실행한다"는 말은 곧 해당 machine 전체를 의미할 수 있다. VPS에서 Claude Code를 실행한다면 무언가를 설치하기 전에 VPS에서 Claude Code를 안전하게 실행하는 방법을 읽어야 한다. 외부 서비스와 통신하는 플러그인을 설치하기 전에는 자격 증명을 에이전트가 접근할 수 없게 하는 방법을 읽어야 한다. 다른 harness도 같은 임대 server에서 동일한 문제에 부딪힌다. 따라서 설치할 가치가 있는 DeepSeek Harness 플러그인은 새로운 기능보다 대부분 spend caps, tool permission rules, injection scanning을 제공한다.
일부 guardrails는 실제로 존재하며, 각각의 적용 범위를 아는 것이 도움이 된다. project-scope plugin은 사용자가 직접 제공하는 것이 아니라 repository에서 제공되므로 workspace를 신뢰한 뒤에만 로드된다. 해당 plugin의 MCP servers에는 여전히 server별 승인이 필요하며, background monitors는 전혀 로드되지 않는다. Plugin-shipped agents는 hooks, MCP servers 또는 permission mode를 선언할 수 없다. Marketplace plugins를 cache로 복사할 때 marketplace 외부를 가리키는 symlinks는 건너뛴다. 따라서 복사된 plugin이 이러한 links를 통해 임의의 host files를 가져올 수 없다.
그렇다고 설치할 내용을 직접 읽는 과정을 생략할 수는 없다. Will install 목록을 확인하고, source를 직접 열어 읽을 수 있는 plugins를 우선 사용해야 한다. 팀의 plugins는 직접 관리하는 marketplace repository에 보관하고, 직접 작성한 항목에는 claude plugin validate를 실행해야 한다. 검토한 내용도 나중에 변경될 수 있다. Anthropic의 official marketplaces에서는 knowledge-work-plugins 및 first-party-plugins를 제외하고 auto-update가 기본적으로 활성화되어 있다. source로 추가한 third-party marketplaces에서는 기본적으로 비활성화되어 있다. auto-update가 활성화된 경우 Claude Code가 백그라운드에서 plugin files를 업데이트한다.
FAQ
Claude Code 플러그인은 추가 비용이 듭니까?
아닙니다. 플러그인 시스템 사용, marketplace 추가, 플러그인 설치에는 비용이 없습니다. 비용이 발생하는 것은 token 사용량이며, 다른 context와 마찬가지로 요금제 또는 API 지출에 청구됩니다. 플러그인은 모든 turn에 상시 context를 추가하고, 해당 플러그인의 skill 또는 agent를 호출하면 더 많은 context를 추가합니다. 또한 MCP server를 제공하고 해당 server의 tool이 prompt prefix에 로드되면 비용이 큰 uncached turn이 1회 발생할 수 있습니다. Anthropic의 공식 marketplace에 있는 플러그인은 설치하기 전에 /plugin detail view에서 Context cost 추정치를 확인할 수 있습니다. 그 외 플러그인은 설치되거나 --plugin-dir로 로드될 때 claude plugin details name가 상시 token 비용을 한 번 출력합니다.
플러그인과 skill의 차이는 무엇입니까?
skill은 단일 지침 단위입니다. 플러그인은 skill, agent, hook, MCP server, LSP server, monitor를 포함할 수 있는 패키지입니다. 이름과 일반적으로 version이 있으며, 보통 설치할 marketplace도 있습니다. 다만 폴더 또는 .zip로 공유한 뒤 --plugin-dir로 로드할 수도 있습니다. 자신과 이 프로젝트를 위한 standalone skill은 .claude/에 작성합니다. 작동하는 가장 작은 변경을 하도록 agent를 유도하는 Ponytail 같은 단일 목적 skill이 이를 가장 분명하게 보여 줍니다. 하나의 규칙이 담긴 파일 하나로 시작하지만, 팀에서 사용하려는 시점이 오면 달라집니다. 다른 사람이 사용해야 하고 시간이 지나면서 업데이트해야 한다면 플러그인으로 전환합니다. 플러그인 skill에는 namespace가 적용되므로 플러그인 내부의 skill은 /plugin-name:skill-name로 호출하며, /skill-name로 호출하지 않습니다.
플러그인을 설치했지만 skill이 나타나지 않습니다. 무엇이 문제입니까?
먼저 설치 요약을 확인합니다. Run /reload-plugins to apply.라고 표시되었다면 Claude Code는 panel이 닫힐 때 reload를 실행합니다. reload에서 conversation을 다시 읽는다고 경고하면 /reload-plugins --force로 다시 실행합니다. 로드되었지만 아무것도 표시되지 않으면 /plugin을 열고 Errors tab을 확인합니다. 가장 흔한 구조적 실수는 skills/, agents/ 또는 hooks/을 .claude-plugin/ 안에 넣는 것입니다. Claude Code는 그 위치에서 해당 항목을 찾지 않습니다. 플러그인 skill에는 namespace가 적용되므로 /을 입력할 때 /plugin-name:skill-name를 찾고 있어야 합니다. 다른 사람이 만든 플러그인이고 오류 없이 로드된다면 Installed tab에서 detail pane을 엽니다. 해당 위치에 skill이 하나도 표시되지 않는 플러그인은 제공할 skill이 없습니다. Errors tab에 플러그인이 cached되지 않았다고 표시되면 설치 디렉터리가 없는 것입니다. shell에서 claude plugin install name@marketplace으로 다시 설치한 후 /reload-plugins을 실행합니다.
interactive panel 없이 플러그인을 설치할 수 있습니까?
예. shell command claude plugin install name@marketplace을 사용합니다. --scope project 또는 --scope local을 전달하지 않으면 user scope에 설치합니다. /plugin panel을 사용할 수 없는 script, image, non-interactive environment에서도 작동합니다. session 외부에서 실행되므로 이미 열려 있는 session에서는 플러그인을 적용하기 전에 /reload-plugins가 필요합니다. interactive terminal이 없는 session에서는 플러그인 MCP server 변경 사항이 다음 session에 적용됩니다.
GitHub에서 찾은 marketplace의 플러그인을 설치해도 안전합니까?
해당 repository의 install script를 자신으로 실행하는 것과 같은 방식으로 취급해야 합니다. 실제로도 거의 비슷하게 동작하기 때문입니다. 플러그인은 hook을 통해 shell command를 실행하고, Bash tool의 PATH에 executable을 추가하며, MCP server를 시작할 수 있습니다. 이 작업은 모두 사용자의 권한으로 수행됩니다. Anthropic은 third-party 플러그인의 내용을 관리하거나 검증하지 않습니다. 내용을 확인할 수 있는 source에서 설치하고, 확인하기 전에 Will install 목록을 검토합니다. 또한 laptop보다 server에서 더 엄격하게 검토해야 합니다. server의 계정에는 보통 탈취할 가치가 있는 key와 token이 보관되어 있기 때문입니다.