Claude Code 플러그인은 skills, agents, hooks, MCP 서버와 같은 컴포넌트로 구성됩니다. 각 컴포넌트는 플러그인의 기본 폴더, .claude-plugin/plugin.json의 선택적 manifest 키(해당 폴더를 대체하거나 추가함), 그리고 사용자가 보는 이름을 가집니다. 각 키의 전체 필드 테이블은 manifest 참조를 참조하십시오.
이 페이지를 사용하여 이미 로드되는 플러그인에 컴포넌트를 추가합니다.
컴포넌트를 추가한 후, 실행 중인 세션에서 /reload-plugins를 실행하거나 새 세션을 시작하여 Claude Code가 이를 로드하도록 합니다. 로드하기 전에 컴포넌트의 파일을 확인하려면 플러그인 디렉토리에서 셸에서 claude plugin validate .를 실행합니다.
플러그인 디렉토리 탐색
탐색기는 기본 위치에 모든 종류의 컴포넌트 하나씩을 가진 예제 플러그인 my-plugin을 보여줍니다:
review skill과 about 명령
security-review 서브에이전트
Claude가 파일을 편집한 후 파일을 포맷하는 hook, 그리고 이를 호출하는 scripts/ 폴더
로그 모니터
출력 스타일과 색상 테마
route-audit 워크플로우
hello-plugin 실행 파일
기본 설정
로컬 MCP 서버와 Go 언어 서버
각 파일은 유용하기보다는 형태를 보여주기 위한 형식의 최소 유효 예제입니다: 실제 skill이나 agent는 전체 지침을 포함하고 종종 지원 파일을 가지며, 실제 hook이나 모니터는 실제 작업을 수행합니다. 탐색기 이후의 섹션은 예제로 동일한 파일을 사용하고 더 완전한 파일로 연결됩니다. 파일이나 폴더를 선택하여 그것이 무엇인지 읽고, 그 안에 무엇이 들어가는지 보고, 그것을 다루는 섹션을 찾습니다.
[manifest](/docs/ko/plugins/manifest-reference)는 플러그인의 `.claude-plugin/` 디렉토리에 있는 `plugin.json` 파일입니다. 플러그인의 메타데이터와 Claude Code가 사용자에게 프롬프트하는 `userConfig` 값을 포함합니다. `name`만 필수입니다. 이 파일에서 `description`은 사용자가 `/plugin`에서 플러그인에 대해 보는 텍스트이고, `version`은 변경할 때까지 사용자를 해당 버전에 유지합니다:
```json theme={null}
{
"name": "my-plugin",
"version": "1.0.0",
"description": "Review, formatting, and database tools for this team"
}
```
[skill](/docs/ko/skills)은 `SKILL.md` 파일입니다. 각 skill을 `skills/` 아래의 자신의 디렉토리에 저장합니다. Claude는 모든 skill의 `description`을 읽고, 사용자가 요청하는 것이 이를 일치할 때(예: 여기서 pull request를 검토하도록 Claude에 요청), Claude는 skill의 지침을 로드하고 따릅니다. 사용자는 또한 `/my-plugin:review`로 직접 실행할 수 있습니다:
```markdown theme={null}
---
description: Reviews a pull request for style and test coverage. Use when asked to review code.
---
Review the changed files. Report style problems first, then missing tests.
```
명령은 사용자가 이름으로 실행하는 단일 Markdown 파일입니다. 명령은 이전 형식입니다: skill은 같은 방식으로 이름으로 실행되고 자신의 디렉토리에 지원 파일을 포함할 수도 있으므로, 새로운 것은 skill로 작성하고 이미 가진 파일에 대해 `commands/`를 유지합니다. 이 파일은 `/my-plugin:about`이 되고 skill과 동일한 frontmatter를 사용합니다:
```markdown theme={null}
---
description: Summarize the repository
---
Summarize what this repository does in three sentences.
```
[서브에이전트](/docs/ko/sub-agents)는 자신의 지침과 자신의 컨텍스트 윈도우를 가진 별도의 어시스턴트로, Claude가 작업을 위임하고 결과를 다시 받을 수 있습니다. `agents/` 아래의 각 Markdown 파일은 하나를 정의합니다: frontmatter는 이를 이름 지정하고 사용 시기를 말하고, 본문은 시스템 프롬프트입니다. 이 파일은 `my-plugin:security-reviewer`로 이름 지정되고, 사용자는 `@agent-my-plugin:security-reviewer`로 호출할 수 있습니다:
```markdown theme={null}
---
name: security-reviewer
description: Reviews code changes for security issues. Use after edits to authentication or input handling.
model: sonnet
---
You are a security reviewer. Read the changed files and report injection, authentication, and secrets-handling risks.
```
[hook](/docs/ko/hooks-guide)은 Claude Code의 라이프사이클의 한 지점(예: 모든 파일 편집 후)에서 자동으로 무언가를 실행합니다: 셸 명령, HTTP 요청, MCP 도구 호출, 모델에 대한 프롬프트, 또는 서브에이전트. 플러그인의 hooks를 플러그인 루트의 `hooks/hooks.json`에 저장합니다. 이 파일은 Claude가 파일을 쓰거나 편집한 후 플러그인의 `scripts/format.sh`를 실행합니다:
모니터는 Claude Code가 세션 시작 시 백그라운드에서 시작하고 끝날 때까지 계속 실행하는 셸 명령으로, [Monitor 도구](/docs/ko/tools-reference#monitor-tool)를 사용합니다. 이것이 인쇄하는 것은 Claude에 알림으로 도달합니다. `when` 필드는 대신 명명된 skill이 처음 실행될 때 시작할 수 있습니다. 이 파일은 오류 로그를 추적합니다:
플러그인은 [출력 스타일](/docs/ko/output-styles)을 포함할 수 있으며, 이는 Claude가 응답을 포맷하고 표현하는 방식을 변경합니다. 각 출력 스타일을 `output-styles/.md`로 저장합니다. 이 파일은 `/output-style`에 `my-plugin:terse`로 나타납니다:
```markdown theme={null}
---
name: terse
description: Answer in as few words as possible
keep-coding-instructions: true
---
Keep every reply short. Skip preambles and summaries.
```
플러그인은 Claude Code 인터페이스의 [색상 테마](/docs/ko/terminal-config#create-a-custom-theme)를 포함할 수 있습니다. 각 테마를 `themes/.json`으로 저장합니다. 이 파일은 `/theme`에 `Dracula`로 나타나고, `my-plugin`에서 표시됩니다:
`bin/`은 플러그인이 명령줄 도구를 제공하는 방법입니다. 플러그인이 활성화되어 있는 동안, Claude Code는 이 폴더를 실행하는 셸의 `PATH`에 넣으므로, Claude 또는 skill의 지침이 사용자가 아무것도 설치하지 않고도 이름으로 도구를 실행할 수 있습니다. 이 [실행 파일](#executables)이 있으면, `hello-plugin`은 Claude가 실행할 수 있는 명령입니다:
```bash theme={null}
#!/bin/bash
echo "hello from my-plugin"
```
`hooks/hooks.json`의 hook은 스크립트를 실행하고, 이 폴더는 예제가 이를 유지하는 곳입니다. `scripts/` 이름은 관례이지 Claude Code가 찾는 것이 아닙니다: hook은 파일을 경로로 가리킵니다, `${CLAUDE_PLUGIN_ROOT}/scripts/format.sh`. 포매터 스크립트는 다음과 같을 수 있습니다:
플러그인 루트의 `settings.json`은 플러그인이 활성화되어 있는 동안 적용되는 [설정](/docs/ko/settings-reference)을 보유하므로, 플러그인은 세션의 동작 방식을 변경할 수 있고 컴포넌트만 추가하는 것이 아닙니다. 플러그인에서 효과를 발휘하는 두 개의 키만 있습니다, [`agent`](/docs/ko/settings-reference#agent)와 [`subagentStatusLine`](/docs/ko/settings-reference#subagentstatusline); 다른 모든 키는 삭제됩니다. [기본 설정](#default-settings)을 참조합니다.
이 파일은 `agent`를 설정하여, 세션의 주 스레드를 플러그인의 자신의 `security-reviewer` 에이전트로 실행하므로, 해당 에이전트의 시스템 프롬프트, 도구 제한, 모델이 전체 세션에 적용됩니다:
```json theme={null}
{
"agent": "security-reviewer"
}
```
[MCP 서버](/docs/ko/mcp)는 Claude에 외부 시스템의 도구를 제공합니다. 플러그인 루트의 `.mcp.json`에서 선언합니다. 이 파일은 플러그인 내부의 스크립트에서 로컬 서버를 시작하고, `/mcp`에 `plugin:my-plugin:db`로 나타납니다:
LSP 서버는 Claude에 언어에 대한 [진단 및 코드 네비게이션](/docs/ko/plugins/code-intelligence)을 제공합니다. 플러그인 루트의 `.lsp.json`에서 서버를 선언합니다. 이 파일은 `.go` 파일에 대해 Go 언어 서버를 연결합니다:
SKILL.md에 description을 제공하여 Claude가 언제 사용할지 알 수 있도록 합니다:
---
description: Reviews a pull request for style and test coverage. Use when asked to review code.
---
Review the changed files. Report style problems first, then missing tests.
플러그인을 로드한 후, /my-plugin:review는 skill을 실행합니다. 명령 이름과 누가 호출할 수 있는지는 다음 규칙을 따릅니다:
명령 이름: /<plugin>:<directory>, 따라서 my-plugin의 skills/review/SKILL.md는 /my-plugin:review입니다. frontmatter에서 name을 설정하면, 마지막 세그먼트를 대체하고 플러그인 접두사는 유지됩니다. skill이 명령 이름을 얻는 방법을 참조합니다
누가 호출하는가: Claude, 사용자, 또는 둘 다, frontmatter로 제어됩니다. skill 호출을 제어하는 사람을 참조합니다
기본 skills/ 디렉토리 외부에 skills를 배치할 수도 있습니다:
추가 디렉토리: skills manifest 키에 나열합니다. 이들은 commands와 agents와 달리 기본 skills/ 스캔을 대체하지 않고 추가합니다
플러그인 루트의 단일 skill: skills/ 디렉토리가 없고 skills manifest 키가 없으면, 플러그인 루트의 SKILL.md는 하나의 skill로 로드됩니다. frontmatter에서 name을 설정합니다, 그렇지 않으면 마켓플레이스 설치가 플러그인 이름이 아닌 캐시 디렉토리 이름으로 skill을 이름 지정합니다
플러그인에 지침을 포함하려면, 이를 skill로 작성합니다. Claude Code는 플러그인 루트의 CLAUDE.md를 로드하지 않으며, claude plugin validate는 CLAUDE.md at the plugin root is not loaded as project context 경고를 표시합니다.
명령은 사용자가 이름으로 실행하는 단일 Markdown 파일입니다(예: /my-plugin:about).
commands/<file>.md에 명령을 저장하면 /<plugin>:<file>이 됩니다. 서브디렉토리는 세그먼트를 추가하므로, commands/db/migrate.md는 /my-plugin:db:migrate입니다.
명령 파일은 skills와 동일한 frontmatter를 사용합니다.
manifest에서 명령 정의
명령 파일을 commands/ 이외의 다른 곳에 유지하거나, 별도의 Markdown 파일 없이 plugin.json 내부에 짧은 명령을 정의하려는 경우에만 필요합니다. commands manifest 키를 설정하면, Claude Code는 commands/를 스캔하는 대신 이를 읽습니다. 키는 경로, 경로 배열, 또는 각 명령 이름을 source 파일 또는 인라인 content로 매핑하는 객체를 사용합니다.
이 manifest는 /my-plugin:about을 인라인으로 정의하며, Markdown 파일이 없습니다:
{"name": "my-plugin",
"commands": {"about": {"content": "Summarize what this repository does in three sentences.",
"description": "Summarize the repository"}}}
서브에이전트는 자신의 지침과 컨텍스트 윈도우를 가진 별도의 어시스턴트로, Claude가 작업을 위임할 수 있습니다. agents/ 아래의 각 Markdown 파일은 하나를 정의합니다:
---
name: security-reviewer
description: Reviews code changes for security issues. Use after edits to authentication or input handling.
model: sonnet
---
You are a security reviewer. Read the changed files and report injection, authentication, and secrets-handling risks.
이 에이전트는 my-plugin:security-reviewer로 이름 지정되고, 사용자는 @agent-my-plugin:security-reviewer로 명시적으로 호출할 수 있습니다. 이름 형식은 <plugin>:<name>이며, <name>은 frontmatter에서 오거나 없을 때 파일 이름에서 옵니다.
agents manifest 키는 agents/ 스캔을 대체합니다.
agents의 서브폴더에서 agents 구성
플러그인 agent 파일을 agents/의 서브폴더에 넣을 수 있습니다. Claude Code는 재귀적으로 로드하고 플러그인 이름, 각 서브폴더 이름, 파일 이름을 콜론으로 결합하여 에이전트의 범위 지정 이름을 형성합니다. 예를 들어, my-plugin이라는 플러그인의 agents/review/security.md는 my-plugin:review:security로 로드됩니다. 두 가지 설정이 해당 이름을 변경합니다:
Frontmatter name: 파일 이름만 대체하므로, agents/review/security.md의 name: audit은 my-plugin:review:audit로 로드됩니다
Manifest agents 필드: 거기에 나열한 파일은 서브폴더 이름 없이 로드되므로, "agents": "./custom/review/security.md"는 my-plugin:security로 로드됩니다
플러그인 agents의 Frontmatter 필드
플러그인 agent의 frontmatter는 다음 규칙을 따릅니다:
지원되는 필드: name, description, model, effort, maxTurns, tools, disallowedTools, skills, memory, background, omitClaudeMd, isolation, color, 그리고 experimental의 cacheTtl 키. 유일한 유효한 isolation 값은 "worktree"입니다. 각각이 무엇을 하는지는 지원되는 frontmatter 필드를 참조합니다
무시되는 필드: permissionMode, hooks, mcpServers, initialPrompt. agent 파일은 자신의 hooks나 MCP 서버를 추가할 수 없으므로, 이들을 플러그인 hooks와 MCP 서버로 추가합니다
파싱되지 않는 Frontmatter: agent는 여전히 모든 필드가 무시된 상태로 로드됩니다. 파일 이름으로 이름 지정되고, 설명은 Agent from my-plugin plugin을 읽습니다. 셸에서 claude plugin validate를 실행하여 이러한 파일을 찾습니다
hook은 Claude Code의 라이프사이클의 한 지점(예: 모든 파일 편집 후)에서 자동으로 무언가를 실행합니다: 셸 명령, HTTP 요청, MCP 도구 호출, 모델에 대한 프롬프트, 또는 서브에이전트. 플러그인의 hooks를 플러그인 루트의 hooks/hooks.json에 저장하고, 최상위 "hooks" 키 아래에, settings.json의 hooks 객체와 동일한 형태로 저장합니다. 이를 통해 기존 설정 hook을 변경 없이 복사할 수 있습니다.
hook의 환경, ${CLAUDE_PLUGIN_ROOT}의 인용, 플러그인의 자신의 MCP 도구에 대한 매처는 다음과 같이 작동합니다:
환경: 모든 hook 프로세스는 환경에서 CLAUDE_PLUGIN_ROOT와 CLAUDE_PLUGIN_DATA를 받고, 각 사용자 구성 값에 대해 CLAUDE_PLUGIN_OPTION_<KEY>를 받으므로, 스크립트는 거기서 이들을 읽을 수 있습니다
인용: command에 args가 없으면, 셸을 통해 실행되므로, ${CLAUDE_PLUGIN_ROOT} 경로를 큰따옴표로 감싸십시오, Hooks 아래의 hooks/hooks.json 예제처럼, 확장된 경로를 하나의 셸 단어로 유지하려면. args를 대신 전달하면, 각 요소는 셸 없이 하나의 인수로 전달되고 인용이 필요하지 않습니다. exec 형식과 셸 형식을 참조합니다
플러그인의 자신의 MCP 도구 일치: 이 플러그인이 선언하는 MCP 서버의 도구는 mcp__plugin_<plugin>_<server>__<tool>로 이름 지정되므로, 매처에 전체 이름을 작성합니다. 서버 이름만의 매처는 발생하지 않습니다. MCP 도구 일치를 참조합니다
MCP 서버
MCP 서버는 Claude에 외부 시스템의 도구를 제공합니다. 플러그인 루트의 .mcp.json에서 선언하고, 프로젝트 .mcp.json과 동일한 형태로 선언합니다. 이 .mcp.json은 db라는 하나의 서버를 선언합니다:
mcpServers manifest 키는 인라인 서버 맵, JSON 파일 경로, 또는 이들의 배열을 사용합니다. manifest 서버가 .mcp.json의 것과 동일한 이름을 가지면, manifest 서버가 이를 대체합니다.
claude.ai 및 Cowork의 사용자에게 도달
db 서버 아래의 MCP 서버와 같은 로컬 stdio 서버는 Claude Code에서 실행되고 Claude Desktop 앱에서 머신에서 실행되는 Cowork 세션에서 실행되지만, claude.ai에서는 실행되지 않습니다. 거기에도 사용자에게 도달하려면, https:// URL로 원격 서버를 참조하십시오, 이는 claude.ai와 Cowork이 사용자에게 커넥터로 제공합니다.
서버 이름, 도구 이름, 재로드
서버의 이름, 변수 대체, 재로드 동작은 다음 규칙을 따릅니다:
서버 이름: plugin:<plugin>:<server>, 따라서 my-plugin의 db 서버는 /mcp에서 plugin:my-plugin:db입니다. mcp_tool hook에서 서버를 이름 지정할 때 동일한 형식을 사용합니다
도구 이름: mcp__plugin_<plugin>_<server>__<tool>, 따라서 해당 db 서버의 query 도구는 mcp__plugin_my-plugin_db__query입니다. 이것은 권한 규칙과 hook 매처에서 사용할 이름입니다
대체: ${CLAUDE_PLUGIN_ROOT}와 다른 경로 변수는 command, args, env에서 대체됩니다. args에서는 각 요소가 하나의 인수로 전달되므로 인용이 필요하지 않습니다
재로드: 사용자가 /reload-plugins를 실행하고 재로드가 적용되면, 구성이 변경되지 않은 서버는 연결을 유지합니다. 구성이 변경된 서버는 재연결되고, 제거한 서버는 연결을 끊습니다
패키지된 MCPB 서버 포함
mcpServers 키는 또한 MCPB 파일로 패키지된 서버를 수용하며, 확장자는 .mcpb 또는 이전 .dxt입니다. 키를 파일로 가리키십시오, 플러그인 내부의 경로 또는 https:// URL:
파일은 각 서버 이름을 직접 구성에 매핑하며, 맵 주위에 래퍼 객체가 없습니다. command는 바이너리의 이름이고, 인수는 args에 있습니다. extensionToLanguage는 최소한 하나의 확장이 필요하며, 각각은 .로 시작합니다.
claude plugin validate는 이 파일을 읽지 않습니다. 항목이 유효하지 않으면, 전체 파일은 로드 시 건너뛰고 Invalid LSP server config for ".lsp.json"이 /pluginErrors 탭에 나타납니다.
플러그인은 연결을 구성하지만 서버 바이너리를 설치하지 않으며, 각 파일 확장자는 하나의 서버를 가집니다:
누락된 바이너리: Claude Code는 사용자의 PATH에서 이름으로 command를 시작합니다. 바이너리가 없으면, 서버는 시작하지 못하고 claude --debug는 LSP server <name> failed to start를 로깅합니다
확장자 충돌: 두 개의 활성화된 서버가 동일한 확장자를 주장하면, 처음 등록된 것이 해당 파일을 처리하고 다른 것은 이들에 대해 사용되지 않습니다, 서버가 하나의 플러그인에서 오든 두 개에서 오든. /pluginErrors 탭은 경고 LSP server "<name>" is not used for <ext> files를 표시합니다
lspServers manifest 키는 동일한 맵을 인라인으로, JSON 파일 경로로, 또는 이들의 배열로 사용하며, 서버는 .lsp.json의 것에 추가됩니다. manifest 서버가 .lsp.json의 것과 동일한 이름을 가지면, manifest 서버가 이를 대체합니다.
transport, 타임아웃, 재시작, 다른 필드의 경우, lspServers를 참조합니다.
로그 출력을 stdout이 아닌 stderr로 보냅니다. Claude Code는 서버의 stdout을 프로토콜 메시지로만 읽고, 메시지 헤더는 최대 64 KiB, 메시지 본문은 최대 32 MiB를 수용합니다.
Claude Code는 어느 한계를 초과하거나 stdout에 비프로토콜 출력을 작성하는 서버를 연결 해제하고, restartOnCrash와 maxRestarts에 대해 연결 해제를 충돌로 계산합니다. --debug로 실행하면, Claude Code는 원인을 이름 지정하는 오류를 디버그 로그에 작성합니다.
실행 파일
플러그인 루트의 bin/ 파일은 플러그인이 활성화되어 있는 동안 Bash 도구의 셸의 PATH에 있으므로, Claude는 이들을 베어 명령으로 실행할 수 있습니다. 실행 가능한 스크립트를 추가합니다:
#!/bin/bashecho"hello from my-plugin"
chmod +x bin/hello-plugin으로 실행 가능하게 만들고 플러그인을 로드합니다. Claude에 hello-plugin을 실행하도록 요청하면, Bash 도구 결과는 스크립트의 출력을 표시합니다.
플러그인 bin/ 디렉토리는 사용자의 자신의 PATH 항목 뒤에 오므로, 플러그인은 git, ls, 또는 다른 시스템 명령을 섀도우할 수 없습니다.
claude.ai와 Cowork은 최상위 bin/ 디렉토리를 가진 플러그인을 설치하지 않습니다, claude.ai 조직 설정을 통해 배포하는 것을 포함합니다.
기본 설정
플러그인이 활성화되어 있는 동안 적용되는 기본값을 설정하려면, 플러그인 루트에 settings.json을 추가하거나, 동일한 객체를 settings manifest 키에 인라인으로 넣습니다. 두 개의 키가 효과를 발휘합니다, agent와 subagentStatusLine, 다른 모든 키는 삭제됩니다.
플러그인의 자신의 agents 중 하나를 주 스레드로 실행하도록 agent를 설정합니다:
{"agent": "security-reviewer"}
플러그인을 로드하고 세션을 시작합니다. Claude는 주 대화에서 security-reviewer 에이전트의 시스템 프롬프트와 모델로 응답합니다.
채널은 채팅 앱과 같은 외부 시스템이 메시지를 세션으로 보낼 수 있게 합니다. 플러그인에서, 채널은 MCP 서버 중 하나와 이를 바인딩하고 자신의 구성을 프롬프트할 수 있는 channels 항목입니다. 이 manifest는 채널을 telegram 서버에 바인딩하고 봇 토큰을 요청합니다:
대화형 세션만: 플러그인 모니터는 대화형 세션에서 시작되고 -p 플래그를 사용한 비대화형 모드에서는 시작되지 않습니다. 또한 Monitor 도구가 사용 가능한 곳에서만 시작됩니다
사용자 구성 없음: command는 경로 변수와 환경의 ${ENV_VAR}을 가져오지만, ${user_config.*}는 절대 가져오지 않습니다. 하나을 참조하는 모니터는 시작되지 않으며, 모니터 프로세스는 CLAUDE_PLUGIN_OPTION_<KEY>도 받지 않습니다
세션 중 비활성화: 세션 중에 플러그인을 비활성화하면, Claude Code는 이미 실행 중인 모니터를 중지하지 않습니다. 세션이 끝날 때 중지됩니다
experimental.monitors manifest 키는 동일한 배열을 인라인으로 또는 JSON 파일 경로로 사용하고, monitors/monitors.json 대신 읽습니다.
플러그인이 사용자로부터 필요로 하는 값을 userConfig manifest 키에서 선언하여, 사용자가 settings.json을 자신들이 편집하지 않도록 합니다. 각 옵션은 title을 레이블로 하고 description을 아래에 가진 대화 상자에 나타납니다.
토큰이나 비밀번호의 경우 "sensitive": true를 설정합니다. 대화 상자는 입력을 마스크하고, 값은 settings.json이 아닌 보안 저장소에 저장됩니다.
이 manifest는 엔드포인트와 토큰을 요청합니다:
{"name": "my-plugin",
"userConfig": {"api_url": {"type": "string",
"title": "API URL",
"description": "Base URL of your team's API"},
"api_token": {"type": "string",
"title": "API token",
"description": "Token for your team's API",
"sensitive": true
}}}
구성 대화 상자가 나타날 때
대화 상자는 대화형 /plugin 인터페이스에서만 나타납니다. 사용자가 다음 중 하나를 수행할 때 아직 설정되지 않은 옵션에 대해 열립니다:
/plugin에서 플러그인을 설치합니다
세션 내에서 /plugin install <plugin>@<marketplace>를 실행합니다
/plugin의 Installed 탭에서 플러그인을 활성화합니다
언제든지 동일한 대화 상자를 열려면, 사용자는 /plugin configure <plugin>@<marketplace>를 실행합니다.
claude plugin install 셸 명령은 userConfig 값을 프롬프트하지 않습니다. 셸에서 값을 설정하려면, 각각을 --config KEY=VALUE로 전달합니다. 옵션이 설정되지 않으면, 명령은 userConfig options not yet set 라인을 인쇄하여 둘 다 설정하는 방법을 이름 지정합니다. The userConfig dialog never appears는 라인을 인용합니다.
옵션 필드, 각 값이 저장되는 위치, 컴포넌트가 저장된 값을 참조하는 방법, ${user_config.*}를 거부하는 필드의 경우, 사용자 구성을 참조합니다.
플러그인 경로 참조 및 데이터 저장
플러그인이 어디에 설치될지 모르므로, 고정 경로보다는 이 변수를 통해 파일과 데이터를 참조합니다. 이들은 skill, 명령, agent 콘텐츠에서, hook과 모니터 명령에서, MCP와 LSP 서버 구성에서 대체됩니다. 또한 hook, MCP, LSP 프로세스로 내보내집니다:
${CLAUDE_PLUGIN_ROOT}: 플러그인의 설치 디렉토리. 각 버전은 자신의 캐시 디렉토리를 가지므로, 플러그인이 업데이트될 때 경로가 변경됩니다. 거기에 상태를 작성하지 마십시오
${CLAUDE_PLUGIN_DATA}: 업데이트를 생존하는 디렉토리, node_modules, 가상 환경, 캐시용. ~/.claude/plugins/data/<id>/로 해석되고 처음 참조될 때 생성됩니다
${CLAUDE_PROJECT_DIR}: 프로젝트 루트, hooks가 받는 동일한 값
데이터 디렉토리 경로에서, <id>는 문자, 숫자, _, - 이외의 모든 문자가 -로 대체된 플러그인 식별자이므로, my-plugin@my-marketplace는 my-plugin-my-marketplace가 됩니다.
마켓플레이스 설치 플러그인의 경우, Claude Code는 플러그인을 캐시할 때 적격 Node.js 패키지 종속성을 자동으로 설치하므로, 자신이 설치할 필요가 없을 수 있습니다. 할 때, 이 SessionStart hook은 첫 실행 시 ${CLAUDE_PLUGIN_DATA}에 node_modules를 설치하고 업데이트가 package.json을 변경한 후 다시 설치합니다:
첫 번째 세션 후, ~/.claude/plugins/data/<id>/node_modules이 존재합니다. MCP 서버는 그 다음 NODE_PATH를 ${CLAUDE_PLUGIN_DATA}/node_modules로 설정할 수 있습니다. 어느 필드가 어느 변수를 대체하는지의 경우, 환경 변수를 참조합니다.
953플러그인은 색상 테마와 출력 스타일을 포함할 수 있습니다. 둘 다 사용자의 자신의 것과 동일한 선택기에 나타납니다. 둘 중 하나의 경우, manifest 키를 설정하면 폴더 스캔을 대체합니다.953플러그인은 색상 테마와 출력 스타일을 포함할 수 있습니다. 둘 다 사용자의 자신의 것과 동일한 선택기에 나타납니다. 둘 중 하나의 경우, manifest 키를 설정하면 폴더 스캔을 대체합니다.
954954
955| 컴포넌트 | 다음으로 저장 | 형식 | 다음에 나타남 | Manifest 키 |955| 컴포넌트 | 다음으로 저장 | 형식 | 다음에 나타남 | Manifest 키 |
957| 테마 | `themes/<slug>.json` | 사용자가 `~/.claude/themes/`에 작성하는 [사용자 정의 테마 파일](/docs/ko/terminal-config#create-a-custom-theme) 형식 | `/theme`, 파일의 `name` 아래 | `experimental.themes` |957| 테마 | `themes/<slug>.json` | 사용자가 `~/.claude/themes/`에 작성하는 [사용자 정의 테마 파일](/docs/ko/terminal-config#create-a-custom-theme) 형식 | `/theme`, 파일의 `name` 아래 | `experimental.themes` |
958| 출력 스타일 | `output-styles/<name>.md` | [사용자 정의 출력 스타일](/docs/ko/output-styles#create-a-custom-output-style) 형식, `name`과 `description` frontmatter 포함 | `/output-style`, `<plugin>:<name>`으로 | `outputStyles` |958| 출력 스타일 | `output-styles/<name>.md` | [사용자 정의 출력 스타일](/docs/ko/output-styles#create-a-custom-output-style) 형식, `name`과 `description` frontmatter 포함 | `/output-style`, `<plugin>:<name>`으로 | `outputStyles` |