claude plugin으로 실행하거나, Claude Code 세션 내에서 /plugin 및 /reload-plugins로 실행합니다. 이 참조는 각 명령어의 플래그, 기본값, 출력 및 종료 코드와 함께 한 세션 동안 플러그인을 로드하는 두 가지 플래그를 제공합니다.
빌드에서 claude plugin --help를 실행하여 버전에 어떤 하위 명령어가 있는지 확인하세요.
다음 경우는 다른 페이지에서 다룹니다:
- 단계 설치 및 관리, 그리고
/plugin이 실행되는 위치: 플러그인 설치 및 관리 참조 - 명령어가 디스크에서 변경하는 내용 및 어떤 범위가 우선순위를 갖는지: 플러그인 로딩 참조 참조
- 오류 메시지의 의미: 플러그인 문제 해결 참조
claude plugin 명령어
셸이나 스크립트에서 Claude Code 세션 외부에서claude plugin <subcommand>를 실행합니다. 이러한 하위 명령어는 /plugin 패널을 열지 않고 플러그인을 설치하고 관리합니다.
claude plugins는 claude plugin의 별칭입니다.
모든 하위 명령어는 다음 종료 코드, 플러그인 인수 및 범위 값을 공유합니다:
- 종료 코드: 성공 시
0, 실패 시1.validate는 예상치 못한 오류에 대해 종료2를 추가하고,eval은 해당 섹션에 나열된 코드를 추가합니다. - 플러그인 인수:
<plugin>인수는 플러그인name또는name@marketplace입니다. 두 마켓플레이스가 같은 이름을 제공할 때는 정규화된 형식을 사용하세요. - 범위:
--scope는user,project또는local을 사용하며, 명령어가 쓰는 설정 파일의 이름을 지정합니다.update는managed도 사용합니다.
plugin init
~/.claude/skills/<name>/에서 새 플러그인을 스캐폴드합니다. 다음 세션에서 설치 단계 없이 <name>@skills-dir로 로드됩니다.
new는 init의 별칭입니다.
이 명령어로 시작하는 생성, 테스트 및 편집 워크플로우는 플러그인 생성을 참조하세요.
<name>은 ~/.claude/skills/ 아래의 디렉토리 이름이 되고 플러그인의 매니페스트에서 name이 됩니다.
명령어에는 다른 위치에 대한 플래그가 없습니다. 대신 프로젝트 내에서 스캐폴드하려면 플러그인 생성을 참조하세요.
스킬 및 훅 파일 스타터를 사용하여 플러그인을 스캐폴드합니다:
Created plugin "my-helper" at ~/.claude/skills/my-helper를 출력한 후 로드되는 id와 이를 끄는 claude plugin disable 명령어를 출력합니다.
Claude Code는 안전하게 스캐폴드할 수 없을 때 1로 종료하고 메시지는 이유를 명시합니다. 다음은 일반적인 이유입니다:
- 알 수 없는
--with값 --force없이 대상에 기존 스캐폴드가 있음- skills-directory 플러그인을 차단하는 관리되는 설정
plugin install
추가한 마켓플레이스에서 플러그인을 설치합니다.i는 install의 별칭입니다.
headersHelper를 설정하는 플러그인의 경우, Claude Code는 먼저 명령어를 출력하고 Run this command now? [y/N]을 묻습니다.
자신의 터미널에서
-y를 전달하여 프롬프트 없이 표시된 명령어를 수락합니다. TTY가 없을 때와 Claude가 명령어를 실행할 때 어떤 일이 발생하는지 다음과 같습니다:
- stdin 또는 stdout이 TTY가 아니고
-y또는--accept-command를 전달하지 않음: 설치가 거부됩니다. 출력은 명령어가 표시되었을 뿐이라고 말하고 종료 코드는1입니다 - Claude가 Bash 도구를 통해 명령어를 실행:
-y는 무시됩니다. 대신 자신의 터미널에서 명령어를 실행하세요
Successfully installed plugin: formatter@my-marketplace (scope: project)를 출력합니다. 새로운 것이 설치되지 않으면 출력은 이유를 설명합니다:
- 해당 범위에 이미 설치됨: 출력은
Plugin "formatter@my-marketplace" is already installed (scope: project)이고 종료 코드는0입니다 - 명령어 소스 프롬프트를 거부함: 출력은
Aborted.이고 종료 코드는1입니다 headersHelper프롬프트를 거부하거나 TTY 없이 확인할 수 없음: 출력은Aborted — the command was not run.이고 종료 코드는1입니다
JSON 결과 형식
plugin install에 --json을 전달하면 stdout의 마지막 줄은 하나의 JSON 객체입니다. 마켓플레이스가 선언한 명령어가 앞에 출력될 수 있으므로 해당 줄만 파싱하세요.
세 가지 필드는 항상 존재합니다:
command: 실행된 하위 명령어(예:install)outcome:ok또는failedmessage: 결과에 대한 사람이 읽을 수 있는 설명
pluginId, scope 및 failureCode와 같은 다른 필드는 적용될 때만 나타납니다.
plugin uninstall, plugin update, plugin enable 및 plugin disable의 --json 옵션은 해당 하위 명령어의 자체 필드를 포함한 동일한 객체를 출력합니다.
사용 오류(예: 잘못된 --scope)는 결과 줄을 출력하지 않고 stderr의 이유와 함께 1로 종료합니다.
표시된 설치 명령어 수락
--json 실행이 마켓플레이스에서 선언한 명령어를 표시하고 실행하지 않으면 failed 결과는 shownCommand 객체도 포함합니다. 해당 필드에는 표시된 명령어, 속한 플러그인 및 명령어의 sha256이 포함됩니다.
정확히 그 명령어를 수락하려면 자신의 터미널에서 해당 sha256을 --accept-command로 다시 실행하세요. 플래그는 Claude Code 세션 내에서 효과가 없기 때문입니다. Claude Code v2.1.271 이상 필요합니다.
sha256은 정확히 그 명령어, 플러그인 및 마켓플레이스 카탈로그에 대한 수락으로 계산됩니다. 명령어가 표시된 이후 이들 중 하나라도 변경되면 Claude Code는 sha256을 수락하지 않고 명령어를 다시 표시합니다. 실행 자체의 마켓플레이스 새로고침이 가져오는 변경도 그러한 변경으로 계산됩니다.
shownCommand.acceptCommandMatched가 false이면 전달한 sha256이 현재 표시된 명령어와 일치하지 않습니다. 해당 명령어를 검토한 후 해당 sha256으로 다시 실행하세요.
plugin uninstall
설치된 플러그인을 한 범위에서 제거합니다.remove 및 rm은 uninstall의 별칭입니다.
프로젝트 범위에서 플러그인을 제거합니다:
Successfully uninstalled plugin: formatter (scope: project)를 출력합니다. 플러그인이 해당 범위에 설치되지 않으면 명령어는 Failed to uninstall plugin "formatter@my-marketplace":로 시작하는 줄을 출력하고 1로 종료합니다.
plugin enable
비활성화된 플러그인을 활성화합니다. claude.ai에서 동기화된 플러그인의 경우<name>@synced를 플러그인으로 전달합니다.
--scope 없이 명령어는 local, project, user 순서로 설정 파일을 확인하고 플러그인을 언급하는 첫 번째 범위를 사용합니다.
플러그인이 선언되지 않은 --scope를 전달하면 명령어는 재정의를 쓰거나 실패합니다:
- 선언하는 범위보다 우선순위를 갖는 범위: Claude Code는 전달한 범위에서 재정의를 씁니다. 예를 들어
claude plugin disable formatter --scope local은 프로젝트에서 활성화된 플러그인을 당신만 끕니다 - 다른 범위: 명령어는
Plugin "formatter" is installed at project scope, not user. Use --scope project or omit --scope to auto-detect.로 실패합니다
Plugin "formatter" is already enabled를 출력하고 1로 종료합니다. --json을 사용하면 결과는 "failureCode": "already_in_goal_state"와 "alreadyInGoalState": true를 가지므로 스크립트는 그 경우를 성공으로 처리할 수 있습니다.
플러그인이 종속성을 선언하면 Claude Code는 이들도 활성화합니다. 명령어는 다음 경우에 실패합니다:
- 종속성이 설치되지 않음: 활성화가 실패하고 누락된 각 종속성에 대해
claude plugin install명령어를 출력합니다 - 종속성이 조직의 플러그인 정책에 의해 차단됨: 활성화가 실패하고 차단된 종속성의 이름을 지정합니다
- 종속성이 대상 범위보다 높은 우선순위를 가진 범위에서
false로 설정됨: 활성화가 실패합니다. 해당 범위에서 종속성을 활성화하거나--scope를 전달하여 거기에 쓰세요
Successfully enabled plugin: formatter (scope: project)를 출력하고 감지된 범위의 이름을 지정합니다.
plugin disable
플러그인을 제거하지 않고 비활성화합니다. claude.ai에서 동기화된 플러그인의 경우<name>@synced를 플러그인으로 전달합니다.
--scope 없이 범위는 plugin enable과 동일한 local, project, user 순서로 자동 감지됩니다.
플러그인 이름이나 --all을 전달하지 않으면 Claude Code는 Please specify a plugin name or use --all to disable all plugins를 출력하고 1로 종료합니다. 이미 비활성화된 플러그인을 비활성화하면 Plugin "formatter" is already disabled를 출력하고 1로 종료합니다. plugin enable이 이미 활성화된 플러그인에 대해 하는 것처럼 말입니다.
명령어는 여전히 필요한 플러그인에 대해 실패합니다:
- 다른 활성화된 플러그인이 이에 종속됨: 명령어는 실패하고 먼저 비활성화할 종속성의 이름을 지정합니다
- 조직이 동기화된 플러그인으로 이를 요구함: 명령어는 실패하고 아무것도 저장하지 않습니다
Successfully disabled plugin: formatter (scope: project)를 출력합니다.
plugin update
플러그인을 마켓플레이스가 제공하는 최신 버전으로 업데이트합니다. 새 버전은 다음 세션에 로드되거나 실행 중인 세션에서/reload-plugins를 실행한 후 로드됩니다.
managed는 업데이트할 수 있지만 설치할 수 없는 유일한 범위입니다. 관리자가 설치한 플러그인의 경우 조직을 위한 플러그인 관리를 참조하세요.
플러그인을 업데이트합니다:
Checking for updates for plugin "formatter@my-marketplace"…를 출력한 후 결과를 출력합니다. 더 새로운 것이 없으면 formatter is already at the latest version (1.0.0).를 출력하고 0으로 종료합니다.
설치된 플러그인과 일치하는 베어 플러그인 이름을 전달할 수 있습니다. 다른 마켓플레이스의 설치된 플러그인이 이름을 공유하면 명령어는 업데이트를 거부하고 실행할 정규화된 plugin-name@marketplace-name 명령어를 나열합니다. 베어 이름으로 업데이트하려면 Claude Code v2.1.246 이상이 필요합니다.
plugin list
설치된 플러그인을 버전, 범위 및 상태와 함께 나열합니다.
Claude Code는 각 플러그인이 로드되는 방식에 따라 사람이 읽을 수 있는 출력을 그룹화합니다:
Installed plugins:: 마켓플레이스에서 설치한 플러그인Session-only plugins (--plugin-dir / --plugin-url):: 같은 명령어에서 이러한 플래그로 로드된 플러그인(예:claude --plugin-dir ./my-plugin plugin list)Skills-directory plugins (.claude/skills/*):: Claude Code가 skills 디렉토리에서 찾은 플러그인Synced from claude.ai: claude.ai 계정에서 동기화된 플러그인
No plugins installed. Use `claude plugin install` to install a plugin.를 출력합니다.
JSON 출력
--json을 사용하면 Claude Code는 설치당 하나의 객체를 포함하는 배열을 출력합니다. 각 객체는 아래 필드를 포함합니다. id, version, scope, enabled 및 installPath는 항상 존재하고 다른 필드는 적용될 때만 나타납니다.
--json --available을 사용하면 Claude Code는 배열 대신 하나의 객체를 출력합니다. 해당 installed 필드는 설치된 플러그인 객체의 배열을 보유하고 available 필드는 아래 필드를 포함하는 설치되지 않은 마켓플레이스 플러그인당 하나의 객체를 보유합니다.
plugin details
플러그인의 구성 요소 인벤토리 및 예상 토큰 비용을 표시합니다. 플러그인은 로드되어야 합니다: 설치되거나, skills 디렉토리에서 찾거나, 같은 명령어에서--plugin-dir 또는 --plugin-url로 전달됩니다. <name>은 플러그인 name 또는 name@marketplace입니다.
--help 이외의 플래그를 사용하지 않습니다.
설치된 플러그인이 기여하는 것을 표시합니다:
Component inventory: 플러그인의 skills, agents, hooks, MCP 서버 및 LSP 서버Projected token cost: 플러그인이 모든 세션에 추가하는 항상 켜진 토큰Per-component (rounded): 각 skill, agent 및 명령어에 대한 항상 켜진 및 호출 시 추정치입니다. 플러그인에 없을 때 생략됩니다
Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.를 출력하고 1로 종료합니다.
plugin prune
설치된 플러그인이 더 이상 필요하지 않은 자동 설치된 종속성을 제거합니다. 명령어는 직접 설치한 플러그인을 절대 제거하지 않습니다.autoremove는 prune의 별칭입니다.
정리가 제거할 항목을 미리 봅니다:
(dry run — nothing removed)로 끝냅니다. 제거할 것이 없으면 Nothing to prune으로 시작하는 줄을 출력합니다.
--dry-run 없이 명령어는 프롬프트에서 확인하거나 -y를 전달한 후에만 고아 종속성을 제거합니다.
프롬프트에서 어떻게 답하든 종료 코드는 0입니다.
prune이 하는 일은 터미널이 연결되어 있는지와 -y를 전달하는지에 따라 다릅니다:
plugin eval
플러그인의 eval 케이스를 실행하고 점수가 매겨진 결과를 보고합니다. Claude Code v2.1.269 이상 필요합니다. 각 케이스는 프롬프트와 채점자입니다. Claude Code는 대상 플러그인만 로드된 격리된 세션에서 여러 번 실행하고 기본적으로 플러그인 없이도 실행하므로 보고서는 차이를 보여줍니다. 케이스 형식, 채점자, 결과 및 CI 사용법은 evals로 플러그인 테스트를 참조하세요.target은 기본값이 현재 디렉토리이고 다음 형식 중 하나를 사용합니다:
- 플러그인 디렉토리
- 단일
prompt.md또는case.yaml파일 name또는name@marketplace로 설치된 플러그인name@skills-dir
--tag, --allow-tools 및 --json 앞에 대상을 배치합니다. 이러한 각 옵션은 뒤따르는 단어를 값으로 사용하므로 이들 중 하나 뒤에 작성된 대상은 태그, 도구 이름 또는 대상 대신 JSON 출력 경로로 읽힙니다.
이 표는 대부분의 실행이 사용하는 옵션을 나열합니다. --case, --tag, --output-dir, --report, --allow-real-servers, --keep-temp 및 --verbose를 포함한 전체 집합에 대해 claude plugin eval --help를 실행하세요.
종료 코드는 실행이 어떻게 끝났는지 보고합니다. 파이프라인에서 이에 대해 조치하려면 CI에서 evals 실행을 참조하세요.
plugin eval init
현재 디렉토리의 플러그인에 대한 eval 스위트를 만듭니다. Claude Code v2.1.269 이상 필요합니다. 첫 번째 eval 스위트 생성을 참조하세요.- 플러그인을 읽습니다
- 잘 해야 할 일을 묻습니다
- 케이스와 채점자를 제안합니다
- 케이스 파일을 씁니다
- 케이스를 실행하고 채점자가 당신이 하는 방식으로 점수를 매기는지 확인하기 위해 당신과 함께 등급을 검토합니다
--bare를 사용하거나 터미널이 없으면 명령어는 대신 빈 단일 케이스 템플릿을 씁니다. Claude가 Claude Code 세션 내에서 명령어를 실행하면 명령어는 해당 세션이 따를 인터뷰 지침을 출력합니다.
선택적 name은 케이스 이름입니다. --bare를 사용하거나 터미널이 없을 때 필요합니다. 명령어가 해당 케이스에 대한 빈 템플릿을 쓰기 때문입니다. 인터뷰는 하나가 필요하지 않습니다.
명령어는 다음 옵션을 수락합니다:
plugin tag
플러그인 릴리스에 대해<name>--v<version>이라는 주석이 달린 git 태그를 만듭니다. 태그 지정 전에 명령어는 플러그인의 plugin.json과 이를 나열하는 마켓플레이스 항목이 버전에 동의하는지 확인합니다.
릴리스를 태그할 때는 플러그인 게시를 참조하세요.
[path]는 플러그인 디렉토리이며 기본값은 현재 디렉토리입니다. 명령어는 플러그인을 나열하는 .claude-plugin/marketplace.json에 대해 해당 디렉토리에서 위로 걸어가서 마켓플레이스 항목을 찾습니다.
마켓플레이스 체크아웃의 플러그인에 대한 태그를 미리 봅니다:
- 플러그인 이름
- 버전 및 어느 파일에서 왔는지
- 일치하는 마켓플레이스 항목(있을 때)
- 태그 이름
- 실행할
git tag및git push명령어
--dry-run 없이 Claude Code는 Created tag formatter--v1.0.0을 출력하고 Pushed to origin 또는 직접 실행할 푸시 명령어를 출력합니다. 푸시가 실패하면 태그는 여전히 로컬로 생성되고 명령어는 오류로 종료됩니다.
명령어는 안전하게 태그 지정할 수 없을 때 1로 종료하고 이유를 출력합니다. 일반적인 이유는:
plugin.json또는 마켓플레이스 항목에version없음- 태그가 이미 존재함
- 작업 트리가 더티함
plugin validate
플러그인 매니페스트, 마켓플레이스 매니페스트 또는 디렉토리의 skills, agents 및 명령어를 검증하고 CI 작업이 조치할 수 있는 코드로 종료합니다. 생성, 테스트 및 편집 워크플로우는 플러그인 생성을 참조하세요. 검증자가 각 매니페스트에서 확인하는 내용은 플러그인 매니페스트 참조 및 마켓플레이스 참조를 참조하세요.
커밋하기 전에 플러그인을 검증합니다:
디렉토리 검증
<path>는 매니페스트 파일 또는 디렉토리입니다. 디렉토리가 주어지면 Claude Code는 거기서 찾은 것으로 검증할 항목을 선택합니다:
.claude-plugin/marketplace.json(존재할 때)- 그렇지 않으면
.claude-plugin/plugin.json - 그렇지 않으면 구성 요소 파일(디렉토리 이름으로 선택). 매니페스트 없이 구성 요소 파일을 검증하려면 Claude Code v2.1.233 이상이 필요합니다:
skills,agents또는commands라는 디렉토리: 그 안의 파일.claude라는 디렉토리: 그 안의skills,agents및commands디렉토리- 다른 디렉토리: 해당
.claude아래의 세 디렉토리
- 플러그인 또는
.claude루트 아래의 연결된skills,agents또는commands디렉토리: Claude Code는 그 안의 아무것도 읽지 않았다고 경고합니다. skills,agents또는commands디렉토리 내의 연결된 항목: Claude Code는 이를 건너뛰고 경고하며 디렉토리당 세션이 로드할 건너뛴 항목 수를 경고합니다.- 이름을 지정한
skills,agents또는commands디렉토리 자체가 심볼릭 링크이거나 해당 부모.claude디렉토리가 심볼릭 링크: Claude Code는 오류를 보고하고 그 안의 아무것도 확인하지 않습니다. 대신 실제 디렉토리의 이름을 지정하세요.
- 플러그인 루트의
SKILL.md: 플러그인 디렉토리에 대해claude plugin validate를 실행하면 Claude Code는 플러그인 루트의SKILL.md를 확인하지 않습니다 - 플러그인 루트의
CLAUDE.md: 플러그인 실행에서 Claude Code는 플러그인 루트의CLAUDE.md에 대해서도 경고합니다 - 마켓플레이스 실행의 플러그인 파일: 마켓플레이스 디렉토리에서 Claude Code는 플러그인의 skill, agent, command 또는 hook 파일을 열지 않습니다. 이러한 파일의 오류를 찾으려면 각 플러그인 디렉토리를 검증하세요
출력 및 종료 코드
Claude Code는 검증한 파일, 경로가 있는 오류 및 경고, 그리고 판정 줄을 출력합니다. 종료 코드는 판정을 따릅니다:--json을 사용하면 Claude Code는 보고서를 stdout에 다음 최상위 필드를 포함하는 하나의 JSON 객체로 씁니다:
success: 종료 코드가 제공하는 동일한 판정strict: 실행이 경고를 오류로 취급했는지 여부target: Claude Code가 검증한 해결된 경로manifest: 매니페스트의 자체 결과 또는 매니페스트 없는 실행의 경우nullcontents: 파일당 결과로file의 이름을 지정하고errors,warnings및notes배열을 포함합니다
2에서 명령어는 stdout에 아무것도 쓰지 않습니다. 오류 메시지는 stderr로 이동합니다.
claude plugin marketplace 명령어
셸에서claude plugin marketplace <subcommand>를 실행하여 플러그인을 설치하는 마켓플레이스를 추가, 나열, 새로고침 및 제거합니다.
- 종료 코드: 이러한 하위 명령어는 플러그인 명령어의 종료 코드 규칙을 따릅니다
- 범위: 해당
--scope플래그에는-s짧은 형식이 없습니다
plugin marketplace add
GitHub 저장소, git URL, 호스팅된marketplace.json 또는 로컬 경로에서 마켓플레이스를 추가하고 설정 파일에 선언합니다.
추가한 후 Claude Code는 설치된 플러그인이 누락된 종속성을 설치합니다.
<source>는 아래 표의 형식 중 하나를 사용하고 해당 형식은 소스 유형과 Claude Code가 마켓플레이스를 가져오는 방식을 결정합니다. 결과 소스 객체는 마켓플레이스 참조를 참조하세요.
복제 URL이
.git 접미사를 포함하지 않는 호스트(예: AWS CodeCommit)의 경우 마켓플레이스를 extraKnownMarketplaces의 git 항목으로 추가하세요. Claude Code는 URL이 .git으로 끝나는지 여부에 관계없이 git 항목을 복제합니다.
Claude Code는 https://gitlab.com/group/subgroup/project와 같은 중첩된 하위 그룹이 있는 gitlab.com URL도 복제합니다.
마켓플레이스를 추가하고 프로젝트와 공유합니다:
Successfully added marketplace: your-marketplace (declared in project settings)를 출력하고 마켓플레이스의 자체 매니페스트에서 name을 사용합니다. 반복 추가 또는 잘못된 소스는 대신 다음 결과 중 하나를 출력합니다:
- 마켓플레이스가 이미 디스크에 있음: 출력은
Marketplace 'your-marketplace' already on disk — declared in project settings이고 종료 코드는0입니다 - 인식되지 않은 소스: 출력은
Invalid marketplace source format. Try: owner/repo, https://..., or ./path이고 종료 코드는1입니다 gitlab.example.com/team/plugins와 같은 베어 호스트: 추가는 잘못된owner/repo약자로 실패하고 메시지는https://를 추가하거나 로컬 경로를 사용하도록 알려줍니다
claude plugin marketplace list의 From claude.ai: 섹션에 출력된 이름으로 추가합니다:
--claudeai를 사용하면 명령어는 --scope 및 --sparse를 거부합니다. 마켓플레이스는 계정에 대해 호스팅되고 설정 파일에 선언되지 않으므로 프로젝트의 .claude/settings.json을 통해 공유할 수 없습니다.
plugin marketplace list
추가한 모든 마켓플레이스를 소스와 함께 나열합니다.
Claude Code는
Configured marketplaces:를 출력하고 마켓플레이스당 하나의 Source: 줄을 출력하거나 No marketplaces configured를 출력합니다.
--json을 사용하면 Claude Code는 마켓플레이스당 하나의 객체를 포함하는 배열을 출력하고 아래 필드를 포함합니다. 모든 필드는 문자열입니다.
추가된 claude.ai 마켓플레이스에는 로컬 복제본이 없으므로 해당 항목은
installLocation 대신 claude.ai 식별자 marketplaceId 및 organizationUuid를 포함합니다. 또한 기록된 경우 scope와 status를 포함합니다.
터미널 세션이 claude.ai 계정에서 플러그인을 동기화하면 텍스트 목록은 From claude.ai: 섹션으로 끝납니다. 해당 섹션은 claude.ai가 추가하지 않은 계정에 대해 나열하는 마켓플레이스의 이름을 지정합니다(git 기반 및 호스팅). Claude Code v2.1.273 이상 필요합니다.
해당 섹션에서 마켓플레이스를 추가하려면 claude.ai에서 마켓플레이스 추가를 참조하세요.
--json 출력은 구성된 마켓플레이스만 다루고 섹션을 제외합니다.
plugin marketplace remove
설정에서 마켓플레이스의 선언을 제거합니다.rm은 remove의 별칭입니다.
<name>은 전달한 소스가 아니라 plugin marketplace list가 표시하는 마켓플레이스 이름입니다.
모든 범위에서 마켓플레이스를 제거합니다:
Successfully removed marketplace: your-marketplace를 출력하고 범위를 지정할 때 (from project settings)를 추가합니다. 마켓플레이스를 선언하지 않는 설정 파일로 범위를 지정하면 명령어는 Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.로 실패합니다.
plugin marketplace update
한 마켓플레이스 또는 모든 마켓플레이스를 소스에서 새로고침하여 새 플러그인 및 버전을 가져옵니다. 분기 또는 태그ref로 추가된 마켓플레이스는 저장소의 기본 분기가 아니라 해당 ref의 최신 커밋으로 업데이트됩니다.
--help 이외의 플래그를 사용하지 않습니다.
한 마켓플레이스를 새로고침합니다:
Successfully updated marketplace: your-marketplace를 출력합니다. 이름을 생략하면 Successfully updated 2 marketplaces와 같은 수를 출력합니다. 추가된 마켓플레이스가 없으면 No marketplaces configured를 출력하고 0으로 종료합니다.
세션의 /plugin
대화형 세션 내에서/plugin은 플러그인 패널을 엽니다. 각 하위 명령어는 패널을 탭에서 열고 거기서 작업을 실행하거나 결과를 인라인으로 출력합니다. /plugins 및 /marketplace는 /plugin의 별칭입니다.
이러한 명령어는 대화형 터미널 세션에서만 실행할 수 있습니다. claude -p와 같은 비대화형 실행에서 Claude Code는 /plugin이 이 환경에서 사용 가능하지 않다고 회신합니다.
어떤 표면에 /plugin이 있는지, 이를 설치하지 않고 설치하는 방법, 각 패널 탭이 표시하는 것은 플러그인 설치 및 관리를 참조하세요.
<plugin>은 플러그인 name 또는 name@marketplace입니다.
아래 표는 모든 세션 형식을 나열합니다. 셸 하위 명령어 init, update, details, prune, eval 및 eval init에는 세션 형식이 없습니다.
/plugin enable, disable, uninstall 또는 configure에서 현재 프로젝트에 설치되지 않은 플러그인의 이름을 지정하면 Claude Code는 조치하는 대신 Plugin "<plugin>" is not installed in this project를 출력합니다.
/reload-plugins
실행 중인 세션을 다시 시작하지 않고 보류 중인 플러그인 변경 사항을 적용합니다. 보류 중인 변경 사항은 세션이 시작된 이후 설치, 업데이트, 활성화, 비활성화 또는 디스크에서 편집한 플러그인입니다. 보류 중인 변경 사항으로/plugin 패널을 닫으면 Claude Code는 자동으로 /reload-plugins를 실행합니다. 다른 터미널에서 실행한 claude plugin 명령어와 같이 패널 외부에서 발생하는 플러그인 변경 사항 후에 직접 실행하세요.
다시 로드 요약
Claude Code는 모든 활성 플러그인을 다시 로드하고 하나의 요약 줄Reloaded: N plugins · N skills · N agents · N hooks · N plugin MCP servers · N plugin LSP servers를 출력하고 대화형 터미널이 없는 세션에서 플러그인 MCP 서버 수를 생략합니다. 플러그인이 실패하면 요약은 N errors during load. Run /plugin for details.를 추가합니다.
skills 수는 플러그인이 제공하는 모든 skill을 포함합니다. 즉, commands/ 항목과 SKILL.md skills 모두입니다. agents 수는 플러그인에서 오지 않은 것을 포함하여 세션에 로드된 agents의 수입니다.
다시 로드된 플러그인의 종속성이 누락되면 Claude Code는 이들을 설치하고 다시 로드하고 요약에 (+ N dependencies: <names>) resolved를 추가합니다.
MCP 도구를 변경하는 다시 로드
다시 로드가 플러그인 MCP 서버 또는LSP 도구를 추가하거나 제거할 때 그 변경이 프롬프트 캐시를 무효화할 것이면 Claude Code는 다시 로드를 적용하지 않습니다. This reload changes MCP tools (<server>) — your next message will re-read the whole conversation instead of using the cache. Run /reload-plugins --force to apply.와 같은 줄을 출력합니다. --force를 전달하여 어쨌든 적용하세요.
대화형 터미널이 없는 세션
/reload-plugins는 데스크톱 앱, Agent SDK 및 -p를 사용한 비대화형 모드와 같이 대화형 터미널이 없는 세션에서도 실행됩니다. Claude Code v2.1.260 이상 필요합니다.
이러한 세션에서 명령어는 -p 프롬프트 또는 데스크톱 앱의 프롬프트 상자와 같이 세션에 직접 입력할 때만 실행됩니다. Remote Control 또는 Slack에서 중계된 메시지와 같이 다른 방식으로 도착하면 명령어는 /reload-plugins isn't available over a remote connection in this session.을 회신하고 아무것도 다시 로드하지 않습니다.
이러한 세션의 다시 로드는 플러그인 MCP 서버를 연결하거나 연결 해제하지 않습니다. 이러한 변경 사항은 다음 세션에서 적용됩니다.
한 세션 동안 플러그인을 로드하는 플래그
두claude 플래그는 설치하지 않고 한 세션 동안만 플러그인을 로드합니다. 둘 다 반복 가능합니다.
플러그인 작성자는 이들을 사용하여 게시하기 전에 플러그인을 테스트합니다. 로드-편집-다시 로드 워크플로우는 마켓플레이스 없이 개발을 참조하세요.
이러한 플래그가 로드하는 플러그인은 세션 전용 플러그인입니다.
claude plugin list는 <name>@inline으로 범위 session으로 표시하지만 같은 플래그가 하위 명령어 앞에 올 때만 표시합니다. 예를 들어 claude --plugin-dir ./my-plugin plugin list를 실행합니다.
세션 전용 플러그인이 설치된 플러그인과 이름을 공유하면 Claude Code는 해당 세션에 대해 세션 전용 복사본을 로드하고 설치된 것을 건너뜁니다. claude plugin disable <name>@inline으로 세션 전용 복사본을 비활성화했거나 관리되는 설정이 해당 플러그인 이름을 잠그면 설치된 복사본이 대신 로드됩니다. 우선순위는 플러그인 로딩 참조를 참조하세요.
관리자는 CLAUDE_CODE_PLUGIN_DIRS 변수에 명명된 폴더와 함께 두 플래그를 거부할 수 있습니다. 관리되는 disableSideloadFlags 설정을 사용합니다. Claude Code는 플래그가 조직의 관리되는 설정에 의해 비활성화되었다고 출력하고 시작하지 않고 1로 종료합니다.
Agent SDK에서 plugins 옵션은 --plugin-dir과 동등합니다.
다음 단계
- 플러그인 설치 및 관리: 단계와 동일한 작업으로 각 단계에서 보는 것
- 플러그인 로딩 참조: 각 명령어가 디스크에서 변경하는 것과 어떤 범위가 적용되는지
- 플러그인 문제 해결: 설치, 마켓플레이스, 로드 및 검증 오류 메시지와 해당 수정 사항
- 플러그인 매니페스트 참조:
claude plugin validate가 확인하는 필드