discover-plugins.md +0 −651 deleted
File Deleted View Diff
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# 마켓플레이스를 통해 미리 빌드된 플러그인 발견 및 설치
6
7> 마켓플레이스에서 플러그인을 찾아 설치하여 Claude Code를 새로운 skills, agents 및 기능으로 확장합니다.
8
9플러그인은 Claude Code를 skills, agents, hooks 및 MCP servers로 확장합니다. 플러그인 마켓플레이스는 직접 빌드하지 않고도 이러한 확장 기능을 발견하고 설치할 수 있도록 도와주는 카탈로그입니다.
10
11또한 claude.ai에서 플러그인을 활성화할 수 있으며, 자신을 위해 또는 조직을 통해 활성화할 수 있습니다. Claude Code는 [claude.ai에서 동기화된 플러그인](/docs/ko/plugins-reference#synced-plugins)에서 설명하는 대로 마켓플레이스 설치 없이 이러한 플러그인을 세션으로 동기화합니다.
12
13자신의 마켓플레이스를 만들고 배포하려고 하시나요? [플러그인 마켓플레이스 만들기 및 배포](/docs/ko/plugin-marketplaces)를 참조하세요.
14
15<h2 id="how-marketplaces-work">
16 마켓플레이스 작동 방식
17</h2>
18
19마켓플레이스는 다른 사람이 만들어 공유한 플러그인의 카탈로그입니다. 마켓플레이스를 사용하는 것은 두 단계의 프로세스입니다:
20
21<Steps>
22 <Step title="마켓플레이스 추가">
23 이는 카탈로그를 Claude Code에 등록하여 사용 가능한 항목을 검색할 수 있도록 합니다. 아직 플러그인이 설치되지 않습니다.
24 </Step>
25
26 <Step title="개별 플러그인 설치">
27 카탈로그를 검색하고 원하는 플러그인을 설치합니다.
28 </Step>
29</Steps>
30
31<h2 id="official-anthropic-marketplace">
32 공식 Anthropic 마켓플레이스
33</h2>
34
35Claude Code는 처음 대화형으로 시작할 때 공식 Anthropic 마켓플레이스(`claude-plugins-official`)를 자동으로 추가합니다. Claude Code가 마켓플레이스를 추가할 수 없는 경우(예: 네트워크가 다운로드를 차단하거나 [마켓플레이스 정책](/docs/ko/plugin-marketplaces#managed-marketplace-restrictions)이 이전 시도를 차단한 경우) `/plugin marketplace add anthropics/claude-plugins-official`을 사용하여 직접 추가하십시오.
36
37사용 가능한 항목을 찾아보려면 `/plugin`을 실행하고 **Discover** 탭으로 이동하거나 [claude.com/plugins](https://claude.com/plugins)에서 카탈로그를 확인하십시오.
38
39공식 마켓플레이스에서 플러그인을 설치하려면 `/plugin install <name>@claude-plugins-official`을 사용하십시오. 예를 들어 GitHub 통합을 설치하려면:
40
41```shell theme={null}
42/plugin install github@claude-plugins-official
43```
44
45`/plugin`은 터미널 CLI에서 대화형 패널을 엽니다. Claude가 이 환경에서 `/plugin`을 사용할 수 없다고 응답하면 플러그인을 다른 방식으로 설치하십시오:
46
47* **Claude 데스크톱 앱**: [플러그인 브라우저](/docs/ko/desktop#install-plugins)를 사용하십시오.
48* **VS Code 확장**: [**플러그인 관리** 대화상자](/docs/ko/vs-code#manage-plugins)에서 설치하십시오.
49* **클라우드 세션**: 플러그인을 claude.ai 계정에 대해 활성화하여 Claude Code가 [동기화된 플러그인](/docs/ko/plugins-reference#synced-plugins)으로 로드하도록 하십시오.
50
51설치가 실패하면 Claude Code가 보고한 메시지와 일치하는지 확인하십시오:
52
53* `Marketplace "claude-plugins-official" not found`: `/plugin marketplace add anthropics/claude-plugins-official`을 사용하여 마켓플레이스를 추가한 후 설치를 다시 시도하십시오.
54* 플러그인이 [마켓플레이스에서 찾을 수 없음](#install-plugins): 플러그인 이름을 확인하십시오.
55
56<Note>
57 공식 마켓플레이스는 Anthropic에서 큐레이션하며, 포함 여부는 Anthropic의 재량입니다. 앱 내 제출 양식은 플러그인을 [커뮤니티 마켓플레이스](#community-marketplace)에 추가하며, 공식 마켓플레이스에는 추가하지 않습니다. 플러그인을 독립적으로 배포하려면 [자신의 마켓플레이스를 만들고](/docs/ko/plugin-marketplaces) 사용자와 공유하십시오.
58</Note>
59
60공식 마켓플레이스에는 여러 카테고리의 플러그인이 포함되어 있습니다:
61
62<h3 id="code-intelligence">
63 코드 인텔리전스
64</h3>
65
66코드 인텔리전스 플러그인은 Claude Code의 기본 제공 LSP 도구를 활성화하여 Claude가 정의로 이동하고, 참조를 찾고, 편집 직후 유형 오류를 볼 수 있도록 합니다. 이러한 플러그인은 [Language Server Protocol](https://microsoft.github.io/language-server-protocol/) 연결을 구성하며, 이는 VS Code의 코드 인텔리전스를 지원하는 동일한 기술입니다. [클라우드 세션](/docs/ko/claude-code-on-the-web)에서 Claude Code는 플러그인 언어 서버를 시작하지 않으므로 Claude는 그곳에서 LSP 도구를 얻지 못합니다.
67
68이러한 플러그인을 사용하기 전에 아래 표에서 언어 서버 바이너리를 설치하십시오. 플러그인이 설치해주지 않습니다. 이미 언어 서버가 설치되어 있으면 프로젝트를 열 때 Claude가 해당 플러그인을 설치하도록 요청할 수 있습니다.
69
70| 언어 | 플러그인 | 필수 바이너리 |
71| :--------- | :------------------ | :--------------------------- |
72| C/C++ | `clangd-lsp` | `clangd` |
73| C# | `csharp-lsp` | `csharp-ls` |
74| Go | `gopls-lsp` | `gopls` |
75| Java | `jdtls-lsp` | `jdtls` |
76| Kotlin | `kotlin-lsp` | `kotlin-language-server` |
77| Lua | `lua-lsp` | `lua-language-server` |
78| PHP | `php-lsp` | `intelephense` |
79| Python | `pyright-lsp` | `pyright-langserver` |
80| Rust | `rust-analyzer-lsp` | `rust-analyzer` |
81| Swift | `swift-lsp` | `sourcekit-lsp` |
82| TypeScript | `typescript-lsp` | `typescript-language-server` |
83
84또한 다른 언어를 위해 [자신의 LSP 플러그인을 만들 수](/docs/ko/plugins-reference#lsp-servers) 있습니다.
85
86<Note>
87 플러그인을 설치한 후 `/plugin` 오류 탭에서 `Executable not found in $PATH`를 보면 해당 플러그인에 대해 [코드 인텔리전스](#code-intelligence) 표에 나열된 바이너리를 설치하십시오.
88</Note>
89
90<h4 id="what-claude-gains-from-code-intelligence-plugins">
91 코드 인텔리전스 플러그인이 Claude에 제공하는 기능
92</h4>
93
94코드 인텔리전스 플러그인이 설치되고 해당 언어 서버 바이너리를 사용할 수 있으면 Claude는 두 가지 기능을 얻습니다:
95
96* **자동 진단**: Claude가 파일을 편집할 때마다 언어 서버가 오류 및 경고를 다시 보고하므로 Claude는 컴파일러나 린터를 실행하지 않고도 유형 오류, 누락된 가져오기 및 구문 문제를 봅니다. Claude가 오류를 도입하면 같은 차례에 이를 알아차리고 수정합니다.
97* **코드 네비게이션**: Claude는 언어 서버를 사용하여 정의로 이동하고, 참조를 찾고, 호버 시 유형 정보를 얻고, 기호를 나열하고, 구현을 찾고, 호출 계층을 추적할 수 있습니다. 이러한 작업은 grep 기반 검색보다 더 정확한 네비게이션을 Claude에 제공하지만, 가용성은 언어 및 환경에 따라 다를 수 있습니다.
98
99플러그인을 설치하는 것 외에 진단을 구성할 필요가 없습니다. 직접 읽으려면 Claude Code가 **Found 3 new diagnostic issues in 2 files**와 같은 표시기를 표시할 때 **Ctrl+O**를 누르십시오.
100
101문제가 발생하면 [코드 인텔리전스 문제 해결](#code-intelligence-issues)을 참조하십시오.
102
103<h3 id="external-integrations">
104 외부 통합
105</h3>
106
107이러한 플러그인은 사전 구성된 [MCP 서버](/docs/ko/mcp)를 번들로 제공하므로 수동 설정 없이 Claude를 외부 서비스에 연결할 수 있습니다:
108
109* **소스 제어**: `github`, `gitlab`
110* **프로젝트 관리**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`
111* **디자인**: `figma`
112* **인프라**: `vercel`, `firebase`, `supabase`
113* **커뮤니케이션**: `slack`
114* **모니터링**: `sentry`
115
116<h3 id="automatic-security-review">
117 자동 보안 검토
118</h3>
119
120`security-guidance` 플러그인은 Claude가 수행하는 각 변경 사항을 일반적인 취약점에 대해 검토하고 Claude에 같은 세션에서 발견한 항목을 수정하도록 지시합니다. 검사 내용 및 프로젝트별 규칙을 추가하는 방법은 [Claude가 코드를 작성할 때 보안 문제 포착](/docs/ko/security-guidance)을 참조하십시오.
121
122<h3 id="development-workflows">
123 개발 워크플로우
124</h3>
125
126일반적인 개발 작업을 위한 기술 및 에이전트를 추가하는 플러그인:
127
128* **commit-commands**: 커밋, 푸시 및 PR 생성을 포함한 Git 커밋 워크플로우
129* **pr-review-toolkit**: 풀 요청 검토를 위한 특화된 에이전트
130* **agent-sdk-dev**: Claude Agent SDK로 빌드하기 위한 도구
131* **plugin-dev**: 자신의 플러그인을 만들기 위한 도구 모음
132
133<h3 id="output-styles">
134 출력 스타일
135</h3>
136
137Claude가 응답하는 방식을 사용자 정의하십시오:
138
139* **explanatory-output-style**: 구현 선택에 대한 교육적 통찰력
140* **learning-output-style**: 기술 구축을 위한 대화형 학습 모드
141
142<h2 id="community-marketplace">
143 커뮤니티 마켓플레이스
144</h2>
145
146[`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community)의 커뮤니티 마켓플레이스는 Anthropic의 자동화된 검증 및 안전 심사를 통과한 타사 플러그인을 호스팅합니다. 각 플러그인은 카탈로그의 특정 커밋 SHA에 고정됩니다. 공식 마켓플레이스와 달리 수동으로 추가해야 합니다:
147
148```shell theme={null}
149/plugin marketplace add anthropics/claude-plugins-community
150```
151
152그런 다음 `claude-community` 마켓플레이스 이름을 사용하여 플러그인을 설치합니다:
153
154```shell theme={null}
155/plugin install <plugin-name>@claude-community
156```
157
158자신의 플러그인을 커뮤니티 마켓플레이스에 제출하려면 플러그인 생성 가이드의 [Submit your plugin to the community marketplace](/docs/ko/plugins#submit-your-plugin-to-the-community-marketplace)를 참조하세요.
159
160<h2 id="try-it-add-the-demo-marketplace">
161 시도해보기: 데모 마켓플레이스 추가
162</h2>
163
164Anthropic은 플러그인 시스템으로 가능한 것들을 보여주는 예제 플러그인이 포함된 [데모 플러그인 마켓플레이스](https://github.com/anthropics/claude-code/tree/main/plugins)(`claude-code-plugins`)를 유지 관리합니다. 공식 마켓플레이스와 달리 이 마켓플레이스는 수동으로 추가해야 합니다.
165
166<Steps>
167 <Step title="마켓플레이스 추가">
168 Claude Code 내에서 `anthropics/claude-code` 마켓플레이스에 대해 `plugin marketplace add` 명령을 실행합니다:
169
170 ```shell theme={null}
171 /plugin marketplace add anthropics/claude-code
172 ```
173
174 이 명령은 마켓플레이스 카탈로그를 다운로드하고 해당 플러그인을 사용 가능하게 만듭니다.
175 </Step>
176
177 <Step title="사용 가능한 플러그인 찾아보기">
178 `/plugin`을 실행하여 플러그인 관리자를 엽니다. 이는 **Tab**을 사용하여 순환할 수 있는 탭 인터페이스를 열거나 뒤로 이동하려면 **Shift+Tab**을 사용합니다:
179
180 * **Discover**: 모든 마켓플레이스에서 사용 가능한 플러그인 찾아보기
181 * **Installed**: 설치된 플러그인 보기 및 관리
182 * **Marketplaces**: 추가한 마켓플레이스 추가, 제거 또는 업데이트
183 * **Errors**: 플러그인 로딩 오류 보기
184 * **Stats**: [`/skill-doctor`를 사용할 수 있는 세션에서 각 스킬의 컨텍스트 비용과 사용 빈도 확인](/docs/ko/skills#find-unused-skills)
185
186 방금 추가한 마켓플레이스의 플러그인을 보려면 **Discover** 탭으로 이동합니다. 관리자가 [`pluginSuggestionMarketplaces`](/docs/ko/settings-reference#pluginsuggestionmarketplaces) 관리 설정을 통해 마켓플레이스를 허용 목록에 추가한 경우, 현재 작업 디렉토리와 관련이 있는 것으로 표시된 플러그인은 **suggested for this directory** 레이블과 함께 맨 위에 고정됩니다.
187 </Step>
188
189 <Step title="플러그인 설치">
190 플러그인을 선택하여 세부 정보를 봅니다. 세부 정보 창에는 플러그인에 포함된 내용과 비용이 표시됩니다:
191
192 * 플러그인이 매 턴마다 [컨텍스트 윈도우](/docs/ko/features-overview#understand-context-costs)에 추가할 토큰 수를 볼 수 있는 **Context cost** 예상치
193 * 플러그인의 **Last updated** 날짜
194 * 플러그인의 명령, 에이전트, 스킬, 훅 및 MCP와 LSP 서버를 나열하는 **Will install** 섹션으로, 설치 전에 정확히 무엇이 추가되는지 검토할 수 있습니다
195
196 모든 플러그인이 이러한 필드 뒤의 데이터를 제공하는 것은 아닙니다. 로컬 또는 사용자 정의 마켓플레이스의 플러그인의 경우 **Context cost** 및 **Last updated** 행이 표시되지 않을 수 있으며, **Will install** 섹션에 **Components will be discovered at installation** 대신 표시될 수 있습니다.
197
198 설치 범위를 선택합니다:
199
200 * **User scope**: 모든 프로젝트에서 자신을 위해 설치
201 * **Project scope**: 이 저장소의 모든 협력자를 위해 설치
202 * **Local scope**: 이 저장소에서만 자신을 위해 설치
203
204 예를 들어 **commit-commands**를 선택합니다. 이는 git 워크플로우 스킬을 추가하는 플러그인이며, 사용자 범위로 설치합니다.
205
206 명령줄에서 설치를 시작할 수도 있습니다:
207
208 ```shell theme={null}
209 /plugin install commit-commands@claude-code-plugins
210 ```
211
212 범위에 대해 자세히 알아보려면 [설정 파일](/docs/ko/settings#where-settings-live)을 참조하세요.
213 </Step>
214
215 <Step title="새 플러그인 사용">
216 설치 요약에서 `Run /reload-plugins to activate.`를 보고하면 Claude Code가 해당 재로드를 자동으로 실행합니다. 재로드 시 다음 메시지가 대화를 다시 읽을 것이라는 경고가 표시되면 `/reload-plugins --force`를 실행하여 플러그인을 활성화합니다.
217
218 플러그인 스킬은 플러그인 이름으로 네임스페이스되므로 **commit-commands**는 `/commit-commands:commit`과 같은 스킬을 제공합니다.
219
220 파일을 변경하고 다음을 실행하여 시도해봅니다:
221
222 ```shell theme={null}
223 /commit-commands:commit
224 ```
225
226 이는 변경 사항을 스테이징하고, 커밋 메시지를 생성하며, 커밋을 만듭니다.
227
228 각 플러그인은 다르게 작동합니다. **Discover** 탭에서 플러그인의 세부 정보를 확인하여 제공하는 명령 및 스킬을 보거나, 사용 지침을 위해 해당 홈페이지를 방문하세요.
229 </Step>
230</Steps>
231
232<h2 id="add-marketplaces">
233 마켓플레이스 추가
234</h2>
235
236`/plugin marketplace add` 명령을 사용하여 다양한 소스에서 마켓플레이스를 추가합니다.
237
238<Tip>
239 **단축키**: `/plugin marketplace` 대신 `/plugin market`을 사용할 수 있으며, `remove` 대신 `rm`을 사용할 수 있습니다.
240</Tip>
241
242* **GitHub 저장소**: `owner/repo` 형식입니다. 예를 들어 `anthropics/claude-code`
243* **Git URL**: GitLab, Bitbucket 및 자체 호스팅 서버를 포함한 모든 git 저장소 URL
244* **로컬 경로**: 디렉터리 또는 `marketplace.json` 파일에 대한 직접 경로
245* **원격 URL**: 호스팅된 `marketplace.json` 파일에 대한 직접 URL
246* **claude.ai**: claude.ai에서 호스팅되는 마켓플레이스로, 조직의 플러그인 라이브러리와 같이 소스가 아닌 [**마켓플레이스** 탭 또는 셸에서 이름으로 추가](#add-from-claude-ai)하는 계정용 마켓플레이스입니다.
247
248<h3 id="add-from-github">
249 GitHub에서 추가
250</h3>
251
252`.claude-plugin/marketplace.json` 파일을 포함하는 GitHub 저장소를 `owner/repo` 형식을 사용하여 추가합니다. 여기서 `owner`는 GitHub 사용자 이름 또는 조직이고 `repo`는 저장소 이름입니다.
253
254예를 들어 `anthropics/claude-code`는 `anthropics`가 소유한 `claude-code` 저장소를 나타냅니다:
255
256```shell theme={null}
257/plugin marketplace add anthropics/claude-code
258```
259
260<h3 id="add-from-other-git-hosts">
261 다른 Git 호스트에서 추가
262</h3>
263
264전체 URL을 제공하여 git 마켓플레이스 저장소를 추가합니다. `https://` URL의 경우 `.git` 접미사를 포함할지 여부는 호스트에 따라 다릅니다:
265
266* **`github.com` 및 `gitlab.com`**: Claude Code는 `.git` 접미사가 있거나 없는 저장소 URL을 인식하고 복제합니다. 접미사 없이 `gitlab.com` URL을 추가하려면 Claude Code v2.1.232 이상이 필요합니다. v2.1.232 이전에는 Claude Code가 이를 호스팅된 `marketplace.json` 파일에 대한 직접 링크로 취급했습니다.
267* **Azure DevOps**: 접미사를 생략합니다. Claude Code는 경로에 `/_git/`이 포함된 모든 URL을 복제합니다. `/_git/` 경로에 `.git`을 추가하면 복제가 실패합니다.
268* **자체 관리 GitLab 서버를 포함한 다른 모든 호스트**: Claude Code가 URL을 호스팅된 `marketplace.json` 파일에 대한 직접 링크로 취급하지 않고 저장소를 복제하도록 `.git` 접미사를 포함합니다. AWS CodeCommit과 같이 복제 URL에 접미사가 없는 호스트의 경우 대신 [`extraKnownMarketplaces`](/docs/ko/settings-reference#extraknownmarketplaces)의 git 항목으로 마켓플레이스를 추가합니다. Claude Code는 URL이 `.git`으로 끝나는지 여부와 관계없이 git 항목을 복제합니다.
269
270Claude Code는 `https://gitlab.com/group/subgroup/project`와 같이 중첩된 하위 그룹이 있는 `gitlab.com` URL도 복제합니다.
271
272`https://` 접두사를 포함합니다. Claude Code v2.1.196 이상은 `gitlab.com/company/plugins.git`과 같이 접두사 없이 입력된 호스트를 잘못된 GitHub `owner/repo` 단축형으로 거부하며, 오류 메시지에 접두사를 추가하도록 지시합니다. 이전 버전은 이를 GitHub 저장소 경로로 잘못 읽고 복제 시간에 실패합니다.
273
274HTTPS 사용:
275
276```shell theme={null}
277/plugin marketplace add https://gitlab.com/company/plugins.git
278```
279
280SSH 사용:
281
282```shell theme={null}
283/plugin marketplace add git@gitlab.com:company/plugins.git
284```
285
286Claude Code는 SSH 주소가 `.git`으로 끝나는지 여부와 관계없이 복제합니다.
287
288특정 분기 또는 태그를 추가하려면 `#` 뒤에 ref를 추가합니다:
289
290```shell theme={null}
291/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0
292```
293
294<h3 id="add-from-local-paths">
295 로컬 경로에서 추가
296</h3>
297
298`.claude-plugin/marketplace.json` 파일을 포함하는 로컬 디렉터리를 추가합니다:
299
300```shell theme={null}
301/plugin marketplace add ./my-marketplace
302```
303
304`marketplace.json` 파일에 대한 직접 경로를 추가할 수도 있습니다:
305
306```shell theme={null}
307/plugin marketplace add ./path/to/marketplace.json
308```
309
310<h3 id="add-from-remote-urls">
311 원격 URL에서 추가
312</h3>
313
314URL을 통해 원격 `marketplace.json` 파일을 추가합니다:
315
316```shell theme={null}
317/plugin marketplace add https://example.com/marketplace.json
318```
319
320<Note>
321 URL 기반 마켓플레이스는 Git 기반 마켓플레이스에 비해 몇 가지 제한 사항이 있습니다. URL 기반 마켓플레이스에서 플러그인 설치가 실패하면 [문제 해결](/docs/ko/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)을 참조하십시오.
322</Note>
323
324<h3 id="add-from-claude-ai">
325 claude.ai에서 추가
326</h3>
327
328[플러그인이 claude.ai 계정에서 동기화되는](/docs/ko/plugins-reference#synced-plugins) 터미널 세션에서 claude.ai는 조직의 플러그인 라이브러리 및 자신의 claude.ai 업로드와 같은 마켓플레이스를 나열할 수도 있습니다. `claude plugin marketplace list`는 `From claude.ai:` 섹션에 이들을 출력하고, `/plugin` **마켓플레이스** 탭에 이들을 나열합니다. 추가하려면 여기서 하나를 선택합니다. claude.ai에서 마켓플레이스를 추가하려면 Claude Code v2.1.273 이상이 필요합니다.
329
330셸에서 추가하려면 `--claudeai` 플래그와 목록에 표시된 이름으로 `claude plugin marketplace add`를 실행합니다:
331
332```bash theme={null}
333claude plugin marketplace add --claudeai claudeai-organization-library
334```
335
336Claude Code는 마켓플레이스를 claude.ai가 나열한 이름에서 파생된 `claudeai-`로 시작하는 로컬 이름으로 등록합니다. "Organization library"로 나열된 마켓플레이스는 `claudeai-organization-library`로 등록됩니다. 예를 들어 `claude plugin install <plugin>@claudeai-organization-library`를 사용하여 해당 이름으로 플러그인을 설치합니다.
337
338로그아웃하거나 다른 계정으로 로그인하면 마켓플레이스는 구성된 상태로 유지되지만 플러그인을 표시하지 않으며, 이미 설치한 플러그인은 계속 로드됩니다.
339
340`From claude.ai:` 섹션은 claude.ai를 통해 공유되는 git 기반 마켓플레이스도 나열할 수 있습니다. 일반 `marketplace add` 명령을 사용하여 이들을 추가하고, 목록이 출력하는 소스를 사용합니다.
341
342<h2 id="install-plugins">
343 플러그인 설치
344</h2>
345
346마켓플레이스를 추가한 후 플러그인을 이름으로 설치할 수 있습니다. 아직 추가하지 않은 마켓플레이스의 경우 대신 [한 명령어로 추가 및 설치](#add-a-marketplace-and-install-in-one-command)할 수 있습니다.
347
348이름으로 설치하려면:
349
350```shell theme={null}
351/plugin install plugin-name@marketplace-name
352```
353
354이 명령어는 플러그인의 세부 정보를 열며, 여기서 [설치 범위](/docs/ko/settings#where-settings-live)를 선택합니다. `/plugin`을 실행하고 **Discover** 탭으로 이동한 후 플러그인에서 **Enter**를 누를 때도 동일한 선택지가 표시됩니다:
355
356* **사용자 범위**: 모든 프로젝트에서 자신을 위해 설치
357* **프로젝트 범위**: 이 저장소의 모든 협력자를 위해 설치(`.claude/settings.json`에 추가)
358* **로컬 범위**: 이 저장소에서만 자신을 위해 설치(협력자와 공유되지 않음)
359
360대화형 단계 없이 설치하려면 [`claude plugin install`](/docs/ko/plugins-reference#plugin-install) 셸 명령어를 사용하세요. 이 명령어는 `--scope`를 전달하지 않으면 사용자 범위로 설치됩니다. [`command` 소스](/docs/ko/plugin-marketplaces#how-users-accept-the-command)가 있는 플러그인의 경우 `--yes`를 전달하여 표시되는 명령어를 수락합니다.
361
362**관리됨** 범위의 플러그인도 볼 수 있습니다. 이러한 플러그인은 관리자가 [관리 설정](/docs/ko/managed-settings)을 통해 설치하며 수정할 수 없습니다.
363
364Claude Code는 마켓플레이스 카탈로그의 로컬 복사본에서 플러그인을 찾습니다. 플러그인의 이름 지정 방식에 따라 Claude Code가 해당 복사본을 먼저 새로 고칠지 여부가 결정됩니다:
365
366* **마켓플레이스 이름 포함**: `plugin-name@marketplace-name`을 설치할 때, 세션에서 또는 `claude plugin install`을 사용하여 설치하면 Claude Code는 조회 전에 해당 마켓플레이스를 새로 고칩니다. Claude Code는 마켓플레이스에 대해 [자동 업데이트](#configure-auto-updates)를 비활성화했거나 `DISABLE_AUTOUPDATER`를 설정한 경우에도 새로 고침을 실행합니다. v2.1.232 이전에는 Claude Code가 조회 전에 마켓플레이스를 새로 고치지 않았습니다. Claude Code는 다음의 경우 이 새로 고침을 건너뜁니다:
367 * 마켓플레이스가 [GitHub, 다른 Git 호스트, 원격 URL에서 추가](#add-marketplaces)되지 않았거나 [Claude.ai에서 추가](#add-from-claude-ai)되지 않은 경우.
368 * [시드 디렉토리](/docs/ko/plugin-marketplaces#pre-populate-plugins-for-containers)가 마켓플레이스를 제공하는 경우.
369 * Claude Code가 지난 30초 이내에 마켓플레이스를 새로 고친 경우.
370 * [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ko/env-vars)을 설정한 경우.
371 * [관리 설정](/docs/ko/plugin-marketplaces#managed-marketplace-restrictions)이 마켓플레이스를 차단하는 경우. 이 경우 Claude Code도 설치를 거부합니다.
372* **플러그인 이름만**: 세션에서 `/plugin install plugin-name`을 실행할 때, Claude Code는 [백그라운드에서도 업데이트](#configure-auto-updates)하는 마켓플레이스만 새로 고치며, 조회가 실패한 후에만 새로 고칩니다. `claude plugin install plugin-name`을 실행할 때, Claude Code는 새로 고침 없이 캐시된 카탈로그를 읽습니다. 마지막 새로 고침 후에 게시된 플러그인을 설치하려면 세션에서 `/plugin marketplace update <marketplace-name>`을 실행하거나 셸에서 [`claude plugin marketplace update <marketplace-name>`](/docs/ko/plugin-marketplaces#plugin-marketplace-update)을 실행한 후 설치를 다시 시도하세요.
373
374명명된 설치 전 새로 고침이 실패하면(예: 오프라인 상태인 경우) Claude Code는 캐시된 카탈로그에서 플러그인을 조회합니다. `claude plugin install`은 성공 메시지에서 `marketplace not refreshed`를 보고하며, `/plugin install`은 플러그인의 세부 정보 위에 또는 찾을 수 없음 메시지에서 실패를 표시합니다.
375
376`/plugin` 인터페이스에서 설치할 때, 설치 요약은 플러그인이 현재 세션에서 활성화되어 있는지 여부를 알려줍니다:
377
378* `Plugin is now active.`: Claude Code가 설치의 일부로 플러그인을 활성화했습니다.
379* `Run /reload-plugins to activate.`: 플러그인이 아직 활성화되지 않았습니다. 활성화하면 [프롬프트 캐시가 무효화](/docs/ko/prompt-caching#enabling-or-disabling-a-plugin)되거나 활성화 시도가 실패했기 때문입니다. Claude Code가 `/reload-plugins`을 실행합니다. 해당 다시 로드가 프롬프트 캐시에 대한 경고를 표시하면 [플러그인을 어쨌든 활성화](#apply-plugin-changes-without-restarting)하려면 `/reload-plugins --force`를 실행하세요.
380* 플러그인이 로드되지 않으면 요약에서 실패를 보고하며 `/plugin` **Errors** 탭에서 세부 정보를 표시합니다.
381
382v2.1.221 이전에는 `/reload-plugins`을 실행하거나 다시 시작할 때까지 현재 세션에서 설치가 적용되지 않았습니다.
383
384`claude plugin install` 셸 명령어는 세션에서 실행되지 않으므로 Claude Code는 다음 번에 Claude Code를 시작할 때 또는 이미 열려 있는 세션에서 `/reload-plugins`을 실행할 때 설치하는 플러그인을 로드합니다.
385
386<Warning>
387 플러그인을 설치하기 전에 신뢰할 수 있는지 확인하세요. Anthropic은 플러그인에 포함된 MCP 서버, 파일 또는 기타 소프트웨어를 제어하지 않으며 의도한 대로 작동하는지 확인할 수 없습니다. 자세한 내용은 각 플러그인의 홈페이지를 확인하세요.
388</Warning>
389
390<h3 id="add-a-marketplace-and-install-in-one-command">
391 한 명령어로 마켓플레이스 추가 및 설치
392</h3>
393
394아직 추가하지 않은 마켓플레이스에서 플러그인을 설치하려면 `--marketplace`로 마켓플레이스 소스를 지정하세요. Claude Code v2.1.275 이상이 필요합니다.
395
396```shell theme={null}
397/plugin install quality-review-plugin --marketplace your-org/plugins
398```
399
400소스는 [GitHub `owner/repo`, git URL 또는 로컬 경로](#add-marketplaces)와 같이 `/plugin marketplace add`와 동일한 형식을 사용합니다. 단, 공백을 포함할 수 없습니다. 플러그인 이름을 `@marketplace` 접미사 없이 그대로 입력하세요.
401
402Claude Code는 해결된 소스를 표시하고 추가하기 전에 확인을 요청합니다. 거절하면 설치가 취소되고 아무것도 추가되지 않습니다. 마켓플레이스가 추가되면 플러그인의 세부 정보가 열리고 [설치 범위](/docs/ko/settings#where-settings-live)를 선택합니다. 소스가 이미 추가한 마켓플레이스와 일치하면 Claude Code는 확인을 건너뛰고 해당 마켓플레이스에서 플러그인의 세부 정보를 엽니다.
403
404<h2 id="manage-installed-plugins">
405 설치된 플러그인 관리
406</h2>
407
408`/plugin`을 실행하고 **Installed** 탭으로 이동하여 플러그인을 보고, 활성화하고, 비활성화하거나, 제거합니다. 목록은 범위별로 그룹화되고 문제가 먼저 표시되도록 정렬됩니다: 로드 오류 또는 해결되지 않은 종속성이 있는 플러그인이 맨 위에 나타나고, 그 다음 즐겨찾기가 나타나며, 비활성화된 플러그인은 맨 아래의 축소된 헤더 뒤에 접혀 있습니다.
409
410목록에서 다음을 수행할 수 있습니다:
411
412* `f`를 눌러 선택한 플러그인을 즐겨찾기에 추가하거나 제거
413* 입력하여 플러그인 이름 또는 설명으로 필터링
414* Enter를 눌러 플러그인의 세부 정보 보기를 열고 활성화, 비활성화 또는 제거
415
416Claude Code는 또한 **Installed** 탭에서 [claude.ai 계정에서 동기화된 플러그인](/docs/ko/plugins-reference#synced-plugins)을 나열하며, `synced`를 소스로 표시합니다. 조직에서 필수로 표시하지 않은 경우 거기서 활성화하거나 비활성화할 수 있습니다. 하나를 제거하려면 claude.ai에서 끕니다. 동기화된 플러그인은 Claude Code v2.1.273 이상의 터미널 세션에 나타납니다.
417
418프로젝트의 `.claude/settings.json`이 활성화하는 플러그인을 제거하면 Claude Code는 어느 범위를 의도했는지 묻습니다: 자신만 비활성화하면 `.claude/settings.local.json`에 재정의를 작성하고 프로젝트에 플러그인을 설치된 상태로 두거나, 모두를 위해 제거하면 공유 `.claude/settings.json`에서 제거합니다.
419
420세부 정보 보기는 플러그인이 제공하는 구성 요소를 표시합니다: commands, skills, agents, hooks, MCP servers 및 LSP servers. 동일한 인벤토리는 `claude plugin details` 명령어로 명령줄에서도 사용할 수 있습니다.
421
422Claude Code는 또한 마켓플레이스에서 직접 설치했지만 최소 2주 동안 그리고 최소 10개 세션에 걸쳐 사용하지 않은 플러그인을 **Installed** 탭의 **Not used recently** 헤더 아래에 나열합니다. 세부 정보 보기는 각 플러그인에 대한 **Last used** 줄을 표시합니다. 이를 사용하여 더 이상 사용하지 않지만 여전히 시작 및 컨텍스트 비용을 추가하는 플러그인을 찾은 다음 비활성화하거나 제거합니다.
423
424두 가지 종류의 플러그인은 사용하지 않는 것으로 나열되지 않습니다:
425
426* 조직에서 관리하거나 `--plugin-dir`로 로드하는 플러그인
427* theme, output style, monitor 또는 workflow를 제공하는 플러그인. 이들은 추적할 호출 없이 값을 제공하기 때문입니다
428
429**Not used recently** 헤더와 **Last used** 줄은 조직이 [`strictKnownMarketplaces`](/docs/ko/settings-reference#strictknownmarketplaces)로 마켓플레이스를 제한할 때 모두 숨겨집니다.
430
431플러그인의 [language server](/docs/ko/plugins#add-lsp-servers-to-your-plugin)는 진단을 제공하거나 코드 네비게이션 요청에 응답할 때 사용된 것으로 계산되므로, 서버가 세션에서 활성화된 LSP 플러그인은 사용하지 않는 것으로 나열되지 않습니다. v2.1.203 이전에는 language server 활동을 사용으로 계산할 수 없었으므로, LSP server를 제공하는 플러그인은 theme 및 output style 플러그인과 동일한 방식으로 그룹에서 제외되었습니다.
432
433첫 번째 세션은 language server 활동을 계산하는 버전에서 아직 사용 기록을 기록하지 않은 각 LSP 플러그인의 사용 기록을 재설정하므로, Claude Code는 서버 활동이 추적되기 전에 기록된 데이터를 기반으로 이전에 설치한 플러그인을 사용하지 않는 것으로 판단하지 않습니다.
434
435종속성을 선언하는 플러그인을 설치하면 설치 출력에 함께 자동 설치된 종속성이 나열됩니다.
436
437직접 명령어로 플러그인을 관리할 수도 있습니다:
438
439* `/plugin disable`, `/plugin enable` 또는 `/plugin uninstall`을 실행하면 Claude Code는 플러그인 패널을 열어 변경 사항을 적용하고 열린 상태로 둡니다. 다른 명령어를 입력하기 전에 **Esc**를 눌러 패널을 닫습니다. [재시작 없이 플러그인 변경 사항 적용](#apply-plugin-changes-without-restarting)에서 변경 사항이 세션에서 언제 적용되는지 설명합니다.
440* 스크립팅의 경우 `claude plugin` 셸 명령어를 대신 사용하면 패널을 열지 않습니다.
441
442메뉴를 열지 않고 설치된 플러그인을 나열합니다:
443
444```shell theme={null}
445/plugin list
446```
447
448`--enabled` 또는 `--disabled`를 전달하여 해당 상태의 플러그인만 표시합니다.
449
450플러그인을 제거하지 않고 비활성화합니다:
451
452```shell theme={null}
453/plugin disable plugin-name@marketplace-name
454```
455
456비활성화된 플러그인을 다시 활성화합니다:
457
458```shell theme={null}
459/plugin enable plugin-name@marketplace-name
460```
461
462이 식별자에서 `plugin-name`은 [마켓플레이스 항목](/docs/ko/plugin-marketplaces#plugin-entries)의 플러그인 `name`이며, 플러그인 자체의 `plugin.json`의 `name`과 다를 수 있습니다.
463
464Claude Code v2.1.195부터 `/plugin` 인터페이스의 **Enable** 및 **Disable**은 두 이름이 다른 플러그인에 대해 작동하며, `/plugin enable` 및 `/plugin disable`은 두 이름 중 하나를 허용합니다. 이전 버전에서 이러한 플러그인을 비활성화하면 Claude Code는 `already disabled`를 보고하고 활성화된 상태로 둡니다.
465
466플러그인을 완전히 제거합니다:
467
468```shell theme={null}
469/plugin uninstall plugin-name@marketplace-name
470```
471
472`--scope` 옵션을 사용하면 CLI 명령어로 특정 범위를 대상으로 할 수 있습니다:
473
474```shell theme={null}
475claude plugin install formatter@your-org --scope project
476claude plugin uninstall formatter@your-org --scope project
477```
478
479<h3 id="apply-plugin-changes-without-restarting">
480 재시작 없이 플러그인 변경 사항 적용
481</h3>
482
483`/plugin` 메뉴를 닫으면 Claude Code는 플러그인 설치, 활성화, 비활성화 및 제거와 같이 메뉴에서 수행한 변경 사항을 적용하기 위해 `/reload-plugins`를 실행합니다. 재로드가 [프롬프트 캐시를 무효화](/docs/ko/prompt-caching#enabling-or-disabling-a-plugin)할 경우 경고하고 변경 사항을 대기 중인 상태로 두며, 대신 `/reload-plugins --force`를 실행하여 적용합니다. Claude가 메뉴를 닫을 때 여전히 응답 중이면 응답이 완료된 후 재로드가 실행됩니다.
484
485메뉴 외부에서 발생하는 플러그인 변경 사항의 경우 `/reload-plugins`를 직접 실행합니다. 이러한 변경 사항에는 다음이 포함됩니다:
486
487* 다른 터미널에서 실행한 `claude plugin` 명령어
488* 개발 중에 [`--plugin-dir`](/docs/ko/plugins#test-your-plugins-locally)로 로드한 플러그인 편집
489* 재로드하도록 요청하는 플러그인 [자동 업데이트](#configure-auto-updates) 알림
490* [claude.ai 계정에서 동기화](/docs/ko/plugins-reference#synced-plugins)하여 플러그인을 추가, 업데이트 또는 제거했으며 재로드하도록 요청하는 알림을 표시
491* 적용하면 프롬프트 캐시를 무효화할 [`--plugin-dir` 폴더](/docs/ko/plugins#test-your-plugins-locally)의 변경 사항
492
493v2.1.268 이전에는 메뉴에서 활성화, 비활성화 또는 제거한 플러그인과 설치 중에 활성화되지 않은 설치가 `/reload-plugins`를 실행할 때까지 대기 중인 상태로 유지되었습니다.
494
495`/reload-plugins`는 또한 데스크톱 앱, Agent SDK 및 `-p`를 사용한 [non-interactive mode](/docs/ko/headless)와 같이 대화형 터미널이 없는 세션에서도 실행됩니다. Claude Code v2.1.260 이상이 필요합니다. 이러한 세션에서는 두 가지 제한이 적용됩니다:
496
497* 명령어는 `-p` 프롬프트 또는 데스크톱 앱의 프롬프트 상자와 같이 세션에 직접 입력할 때만 실행됩니다. [Remote Control](/docs/ko/remote-control) 또는 중계된 채팅 메시지와 같이 원격 연결을 통해 전송하면 명령어는 아무것도 다시 로드하지 않고 거부합니다.
498* 재로드는 플러그인 MCP servers를 연결하거나 연결 해제하지 않습니다. 이러한 변경 사항은 다음 세션에서 적용됩니다.
499
500Claude Code는 모든 활성 플러그인을 다시 로드하고 플러그인, skills, agents, hooks, 플러그인 MCP servers 및 플러그인 LSP servers의 개수를 표시하며, 대화형 터미널이 없는 세션에서는 플러그인 MCP server 개수를 생략합니다. skills 개수에서 Claude Code는 플러그인이 제공하는 모든 skill을 포함합니다: `commands/` 항목과 `SKILL.md` skills 모두입니다. v2.1.246 이전에는 Claude Code는 `commands/` 항목만 계산했으므로 플러그인의 `SKILL.md` skills를 다시 로드할 수 있었지만 여전히 요약에서 `0 skills`를 보고했습니다.
501
502재로드는 다음 요청에서 토큰 비용이 발생합니다: 새로 로드된 구성 요소는 대화에 추가된 콘텐츠에서 자신을 알리고, 기존 기록은 여전히 프롬프트 캐시에서 읽습니다. MCP servers를 제공하는 플러그인은 [tool search](/docs/ko/mcp#scale-with-mcp-tool-search)에 의해 도구가 지연되지 않을 때 더 많은 비용이 발생합니다: 변경으로 인해 캐시가 무효화되고 다음 요청이 전체 대화를 다시 읽습니다. [플러그인 활성화 또는 비활성화](/docs/ko/prompt-caching#enabling-or-disabling-a-plugin)에서 자세한 내용을 참조하세요.
503
504<h2 id="manage-marketplaces">
505 마켓플레이스 관리
506</h2>
507
508대화형 `/plugin` 인터페이스 또는 CLI 명령어를 통해 마켓플레이스를 관리할 수 있습니다.
509
510<h3 id="use-the-interactive-interface">
511 대화형 인터페이스 사용
512</h3>
513
514`/plugin`을 실행하고 **Marketplaces** 탭으로 이동하여:
515
516* 소스 및 상태와 함께 추가된 모든 마켓플레이스 보기
517* 새 마켓플레이스 추가
518* 마켓플레이스 목록을 업데이트하여 최신 플러그인 가져오기
519* 더 이상 필요하지 않은 마켓플레이스 제거
520
521<h3 id="use-cli-commands">
522 CLI 명령어 사용
523</h3>
524
525직접 명령어로 마켓플레이스를 관리할 수도 있습니다.
526
527구성된 모든 마켓플레이스 나열:
528
529```shell theme={null}
530/plugin marketplace list
531```
532
533마켓플레이스에서 플러그인 목록 새로 고침:
534
535```shell theme={null}
536/plugin marketplace update marketplace-name
537```
538
539마켓플레이스 제거:
540
541```shell theme={null}
542/plugin marketplace remove marketplace-name
543```
544
545<Warning>
546 마켓플레이스를 제거하면 해당 마켓플레이스에서 설치한 모든 플러그인이 제거됩니다.
547</Warning>
548
549<h3 id="configure-auto-updates">
550 자동 업데이트 구성
551</h3>
552
553Claude Code는 시작 후 백그라운드에서 마켓플레이스 및 설치된 플러그인을 자동으로 업데이트할 수 있습니다. 마켓플레이스에 대해 자동 업데이트가 활성화되면 Claude Code는 마켓플레이스 데이터를 새로 고치고 설치된 플러그인을 디스크의 최신 버전으로 업데이트합니다.
554
555Claude Code는 세션 시작 후 마켓플레이스 및 플러그인 업데이트를 확인하며, 최대 10분의 무작위 지연이 있으므로 실행 중인 세션은 시작 시 로드된 버전을 계속 사용합니다. 플러그인이 업데이트된 경우 `/reload-plugins`를 실행하도록 요청하는 알림이 표시되거나 다음 시작 시 새 버전이 로드됩니다.
556
557자동 업데이트는 또한 마켓플레이스 항목이 `headersHelper`를 선언하는 플러그인을 제외합니다: Claude Code는 [해당 경로에서 명령어를 실행하거나 아카이브를 다운로드하지 않습니다](/docs/ko/plugin-marketplaces#installs-and-updates-that-refuse-the-command-instead-of-asking). 해당 섹션에서는 Claude Code가 플러그인을 `/plugin` Errors 탭에 나열하는 시기를 설명하므로 자신의 보기에서 업데이트할 수 있습니다.
558
559Claude Code는 [`command` 소스](/docs/ko/plugin-marketplaces#command-sources)가 있는 플러그인을 마켓플레이스 자동 업데이트 설정 및 `DISABLE_AUTOUPDATER`와는 별도의 일정에 따라 업데이트합니다. 대신 [세션당 한 번 명령어를 다시 실행](/docs/ko/plugin-marketplaces#when-claude-code-re-runs-the-command)하고 [해시](/docs/ko/plugins-reference#version-management)가 변경된 경우 출력을 새 플러그인 버전으로 설치합니다.
560
561UI를 통해 개별 마켓플레이스에 대한 자동 업데이트를 전환합니다:
562
5631. `/plugin`을 실행하여 플러그인 관리자 열기
5642. **Marketplaces** 선택
5653. 목록에서 마켓플레이스 선택
5664. **자동 업데이트 활성화** 또는 **자동 업데이트 비활성화** 선택
567
568`claude-plugins-official`, 대부분의 다른 공식 Anthropic 마켓플레이스, 및 [claude.ai에서 추가된 마켓플레이스](#add-from-claude-ai)는 기본적으로 자동 업데이트가 활성화되어 있습니다. 타사 및 로컬 개발 마켓플레이스는 기본적으로 자동 업데이트가 비활성화되어 있습니다.
569
570관리자는 관리되는 설정에서 각 [`extraKnownMarketplaces`](/docs/ko/settings-reference#extraknownmarketplaces) 항목에 `"autoUpdate": true`를 설정하여 각 사용자가 전환하도록 요구하지 않고 조직 마켓플레이스에 대한 자동 업데이트를 활성화할 수 있습니다.
571
572Claude Code 및 마켓플레이스에서 가져온 플러그인에 대한 자동 업데이트를 비활성화하려면 `DISABLE_AUTOUPDATER` 환경 변수를 설정합니다. [`command` 소스](/docs/ko/plugin-marketplaces#command-sources)가 있는 플러그인은 자신의 세션당 한 번 재해석을 따릅니다. 자세한 내용은 [자동 업데이트](/docs/ko/setup#auto-updates)를 참조하세요.
573
574Claude Code 자동 업데이트를 비활성화하면서 플러그인 자동 업데이트를 활성화된 상태로 유지하려면 `DISABLE_AUTOUPDATER`와 함께 `FORCE_AUTOUPDATE_PLUGINS=1`을 설정합니다:
575
576```bash theme={null}
577export DISABLE_AUTOUPDATER=1
578export FORCE_AUTOUPDATE_PLUGINS=1
579```
580
581<h2 id="configure-team-marketplaces">
582 팀 마켓플레이스 구성
583</h2>
584
585팀 관리자는 `.claude/settings.json`에 마켓플레이스 구성을 추가하여 프로젝트에 대한 자동 마켓플레이스 설치를 설정할 수 있습니다. 팀 멤버가 [저장소 폴더를 신뢰](/docs/ko/permissions#what-runs-before-you-trust-a-folder)하면 Claude Code는 추가 프롬프트 없이 이러한 마켓플레이스를 추가합니다.
586
587Claude Code v2.1.195부터 마켓플레이스를 추가해도 플러그인을 로드하는 모든 경로에서 외부 소스에서 제공되는 플러그인이 설치되지 않습니다. 프로젝트의 `.claude/settings.json`만으로 활성화되고 GitHub 저장소 또는 npm 패키지와 같은 외부 소스에서 제공되는 플러그인은 팀 멤버가 설치할 때까지 로드되지 않습니다. 그때까지 Claude Code는 플러그인이 설치되지 않았다고 보고하고 실행할 `claude plugin install` 명령을 표시합니다.
588
589프로젝트의 `.claude/settings.json`에 `extraKnownMarketplaces`를 추가합니다:
590
591```json theme={null}
592{
593 "extraKnownMarketplaces": {
594 "my-team-tools": {
595 "source": {
596 "source": "github",
597 "repo": "your-org/claude-plugins"
598 }
599 }
600 }
601}
602```
603
604`extraKnownMarketplaces` 및 `enabledPlugins`를 포함한 전체 구성 옵션은 [플러그인 설정](/docs/ko/settings-reference#plugin-settings)을 참조하세요.
605
606<h2 id="security">
607 보안
608</h2>
609
610플러그인 및 마켓플레이스는 사용자 권한으로 머신에서 임의의 코드를 실행할 수 있는 매우 신뢰할 수 있는 구성 요소입니다. 신뢰할 수 있는 소스에서만 플러그인을 설치하고 마켓플레이스를 추가합니다. 조직은 [관리되는 마켓플레이스 제한](/docs/ko/plugin-marketplaces#managed-marketplace-restrictions)을 사용하여 사용자가 추가할 수 있는 마켓플레이스를 제한할 수 있습니다.
611
612<h2 id="troubleshooting">
613 문제 해결
614</h2>
615
616<h3 id="/plugin-command-not-recognized">
617 /plugin 명령어를 인식하지 못함
618</h3>
619
620"알 수 없는 명령어" 또는 `/plugin` 명령어가 나타나지 않으면:
621
6221. **버전 확인**: `claude --version`을 실행하여 설치된 항목을 확인합니다.
6232. **Claude Code 업데이트**:
624 * **Homebrew**: `brew upgrade claude-code`, 또는 해당 cask를 설치한 경우 `brew upgrade claude-code@latest`
625 * **npm**: `npm install -g @anthropic-ai/claude-code@latest`
626 * **네이티브 설치 프로그램**: [설정](/docs/ko/setup)에서 설치 명령어를 다시 실행합니다.
6273. **Claude Code 재시작**: 업데이트 후 터미널을 재시작하고 `claude`를 다시 실행합니다.
628
629<h3 id="common-issues">
630 일반적인 문제
631</h3>
632
633플러그인 skills가 나타나지 않으면 `rm -rf ~/.claude/plugins/cache`로 캐시를 지우고, Claude Code를 재시작한 후 플러그인을 다시 설치합니다.
634
635자세한 문제 해결 및 솔루션은 마켓플레이스 가이드의 [문제 해결](/docs/ko/plugin-marketplaces#troubleshooting)을 참조하세요. 디버깅 도구는 [디버깅 및 개발 도구](/docs/ko/plugins-reference#debugging-and-development-tools)를 참조하세요.
636
637<h3 id="code-intelligence-issues">
638 코드 인텔리전스 문제
639</h3>
640
641* **언어 서버가 시작되지 않음**: 바이너리가 설치되어 있고 `$PATH`에서 사용 가능한지 확인합니다. `/plugin` Errors 탭에서 세부 정보를 확인합니다.
642* **높은 메모리 사용량**: `rust-analyzer` 및 `pyright`와 같은 언어 서버는 대규모 프로젝트에서 상당한 메모리를 소비할 수 있습니다. 메모리 문제가 발생하면 `/plugin disable <plugin-name>`으로 플러그인을 비활성화하고 대신 Claude의 기본 제공 검색 도구를 사용합니다.
643* **모노레포에서 거짓 양성 진단**: 작업 공간이 올바르게 구성되지 않으면 언어 서버가 내부 패키지에 대해 해결되지 않은 import 오류를 보고할 수 있습니다. 이는 Claude의 코드 편집 능력에 영향을 주지 않습니다.
644
645<h2 id="next-steps">
646 다음 단계
647</h2>
648
649* **자신의 플러그인 빌드**: [플러그인](/docs/ko/plugins)을 참조하여 skills, agents 및 hooks를 만듭니다.
650* **마켓플레이스 만들기**: [플러그인 마켓플레이스 만들기](/docs/ko/plugin-marketplaces)를 참조하여 팀 또는 커뮤니티에 플러그인을 배포합니다.
651* **기술 참조**: [플러그인 참조](/docs/ko/plugins-reference)를 참조하여 완전한 사양을 확인합니다.