> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 마켓플레이스를 통해 미리 빌드된 플러그인 발견 및 설치

> 마켓플레이스에서 플러그인을 찾아 설치하여 Claude Code를 새로운 명령어, 에이전트 및 기능으로 확장합니다.

플러그인은 Claude Code를 skills, agents, hooks 및 MCP servers로 확장합니다. 플러그인 마켓플레이스는 직접 빌드하지 않고도 이러한 확장 기능을 발견하고 설치할 수 있도록 도와주는 카탈로그입니다.

자신의 마켓플레이스를 만들고 배포하려고 하시나요? [플러그인 마켓플레이스 만들기 및 배포](/ko/plugin-marketplaces)를 참조하세요.

## 마켓플레이스 작동 방식

마켓플레이스는 다른 사람이 만들어 공유한 플러그인의 카탈로그입니다. 마켓플레이스를 사용하는 것은 두 단계의 프로세스입니다:

<Steps>
  <Step title="마켓플레이스 추가">
    이는 카탈로그를 Claude Code에 등록하여 사용 가능한 항목을 검색할 수 있도록 합니다. 아직 플러그인이 설치되지 않습니다.
  </Step>

  <Step title="개별 플러그인 설치">
    카탈로그를 검색하고 원하는 플러그인을 설치합니다.
  </Step>
</Steps>

앱 스토어를 추가하는 것과 같다고 생각하면 됩니다. 스토어를 추가하면 해당 컬렉션을 검색할 수 있지만, 여전히 개별적으로 다운로드할 앱을 선택합니다.

## 공식 Anthropic 마켓플레이스

공식 Anthropic 마켓플레이스(`claude-plugins-official`)는 Claude Code를 시작할 때 자동으로 사용 가능합니다. `/plugin`을 실행하고 **Discover** 탭으로 이동하여 사용 가능한 항목을 검색하거나 [claude.com/plugins](https://claude.com/plugins)에서 카탈로그를 확인합니다.

공식 마켓플레이스에서 플러그인을 설치하려면 `/plugin install <name>@claude-plugins-official`을 사용합니다. 예를 들어 GitHub 통합을 설치하려면:

```shell theme={null}
/plugin install github@claude-plugins-official
```

<Note>
  공식 마켓플레이스는 Anthropic에서 유지 관리합니다. 공식 마켓플레이스에 플러그인을 제출하려면 다음 앱 내 제출 양식 중 하나를 사용하세요:

  * **Claude.ai**: [claude.ai/settings/plugins/submit](https://claude.ai/settings/plugins/submit)
  * **Console**: [platform.claude.com/plugins/submit](https://platform.claude.com/plugins/submit)

  플러그인을 독립적으로 배포하려면 [자신의 마켓플레이스를 만들고](/ko/plugin-marketplaces) 사용자와 공유하세요.
</Note>

공식 마켓플레이스에는 여러 카테고리의 플러그인이 포함되어 있습니다:

### 코드 인텔리전스

코드 인텔리전스 플러그인은 Claude Code의 기본 제공 LSP 도구를 활성화하여 Claude가 정의로 이동하고, 참조를 찾으며, 편집 직후 타입 오류를 볼 수 있도록 합니다. 이러한 플러그인은 [Language Server Protocol](https://microsoft.github.io/language-server-protocol/) 연결을 구성하며, 이는 VS Code의 코드 인텔리전스를 지원하는 동일한 기술입니다.

이러한 플러그인은 언어 서버 바이너리가 시스템에 설치되어 있어야 합니다. 이미 언어 서버가 설치되어 있으면 프로젝트를 열 때 Claude가 해당 플러그인을 설치하도록 요청할 수 있습니다.

| 언어         | 플러그인                | 필요한 바이너리                     |
| :--------- | :------------------ | :--------------------------- |
| C/C++      | `clangd-lsp`        | `clangd`                     |
| C#         | `csharp-lsp`        | `csharp-ls`                  |
| Go         | `gopls-lsp`         | `gopls`                      |
| Java       | `jdtls-lsp`         | `jdtls`                      |
| Kotlin     | `kotlin-lsp`        | `kotlin-language-server`     |
| Lua        | `lua-lsp`           | `lua-language-server`        |
| PHP        | `php-lsp`           | `intelephense`               |
| Python     | `pyright-lsp`       | `pyright-langserver`         |
| Rust       | `rust-analyzer-lsp` | `rust-analyzer`              |
| Swift      | `swift-lsp`         | `sourcekit-lsp`              |
| TypeScript | `typescript-lsp`    | `typescript-language-server` |

[다른 언어를 위한 자신의 LSP 플러그인을 만들](/ko/plugins-reference#lsp-servers) 수도 있습니다.

<Note>
  플러그인을 설치한 후 `/plugin` Errors 탭에서 `Executable not found in $PATH`를 보면 위 표에서 필요한 바이너리를 설치하세요.
</Note>

#### 코드 인텔리전스 플러그인이 Claude에 제공하는 것

코드 인텔리전스 플러그인이 설치되고 해당 언어 서버 바이너리를 사용할 수 있으면 Claude는 두 가지 기능을 얻습니다:

* **자동 진단**: Claude가 파일을 편집할 때마다 언어 서버는 변경 사항을 분석하고 오류 및 경고를 자동으로 보고합니다. Claude는 컴파일러나 린터를 실행할 필요 없이 타입 오류, 누락된 import 및 구문 문제를 봅니다. Claude가 오류를 도입하면 같은 턴에서 문제를 알아차리고 수정합니다. 이는 플러그인 설치 이상의 구성이 필요하지 않습니다. "진단 발견됨" 표시기가 나타날 때 **Ctrl+O**를 눌러 진단을 인라인으로 볼 수 있습니다.
* **코드 네비게이션**: Claude는 언어 서버를 사용하여 정의로 이동하고, 참조를 찾으며, 호버 시 타입 정보를 얻고, 기호를 나열하고, 구현을 찾으며, 호출 계층을 추적할 수 있습니다. 이러한 작업은 Claude에게 grep 기반 검색보다 더 정확한 네비게이션을 제공하지만, 가용성은 언어 및 환경에 따라 다를 수 있습니다.

문제가 발생하면 [코드 인텔리전스 문제 해결](#code-intelligence-issues)을 참조하세요.

### 외부 통합

이러한 플러그인은 미리 구성된 [MCP servers](/ko/mcp)를 번들로 제공하므로 수동 설정 없이 Claude를 외부 서비스에 연결할 수 있습니다:

* **소스 제어**: `github`, `gitlab`
* **프로젝트 관리**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`
* **디자인**: `figma`
* **인프라**: `vercel`, `firebase`, `supabase`
* **커뮤니케이션**: `slack`
* **모니터링**: `sentry`

### 개발 워크플로우

일반적인 개발 작업을 위한 명령어 및 에이전트를 추가하는 플러그인:

* **commit-commands**: commit, push 및 PR 생성을 포함한 Git commit 워크플로우
* **pr-review-toolkit**: pull request 검토를 위한 특화된 에이전트
* **agent-sdk-dev**: Claude Agent SDK로 빌드하기 위한 도구
* **plugin-dev**: 자신의 플러그인을 만들기 위한 도구 모음

### 출력 스타일

Claude가 응답하는 방식을 사용자 정의합니다:

* **explanatory-output-style**: 구현 선택에 대한 교육적 통찰력
* **learning-output-style**: 기술 습득을 위한 대화형 학습 모드

## 시도해보기: 데모 마켓플레이스 추가

Anthropic은 또한 플러그인 시스템으로 가능한 것을 보여주는 예제 플러그인이 있는 [데모 플러그인 마켓플레이스](https://github.com/anthropics/claude-code/tree/main/plugins)(`claude-code-plugins`)를 유지 관리합니다. 공식 마켓플레이스와 달리 이 마켓플레이스는 수동으로 추가해야 합니다.

<Steps>
  <Step title="마켓플레이스 추가">
    Claude Code 내에서 `anthropics/claude-code` 마켓플레이스에 대해 `plugin marketplace add` 명령어를 실행합니다:

    ```shell theme={null}
    /plugin marketplace add anthropics/claude-code
    ```

    이는 마켓플레이스 카탈로그를 다운로드하고 해당 플러그인을 사용 가능하게 합니다.
  </Step>

  <Step title="사용 가능한 플러그인 검색">
    `/plugin`을 실행하여 플러그인 관리자를 엽니다. 이는 **Tab**(또는 뒤로 가려면 **Shift+Tab**)을 사용하여 순환할 수 있는 네 개의 탭이 있는 탭 인터페이스를 엽니다:

    * **Discover**: 모든 마켓플레이스에서 사용 가능한 플러그인 검색
    * **Installed**: 설치된 플러그인 보기 및 관리
    * **Marketplaces**: 추가된 마켓플레이스 추가, 제거 또는 업데이트
    * **Errors**: 플러그인 로딩 오류 보기

    방금 추가한 마켓플레이스의 플러그인을 보려면 **Discover** 탭으로 이동합니다.
  </Step>

  <Step title="플러그인 설치">
    플러그인을 선택하여 세부 정보를 보고 설치 범위를 선택합니다:

    * **User scope**: 모든 프로젝트에서 자신을 위해 설치
    * **Project scope**: 이 저장소의 모든 협력자를 위해 설치
    * **Local scope**: 이 저장소에서만 자신을 위해 설치

    예를 들어 **commit-commands**(git 워크플로우 명령어를 추가하는 플러그인)를 선택하고 사용자 범위에 설치합니다.

    명령줄에서 직접 설치할 수도 있습니다:

    ```shell theme={null}
    /plugin install commit-commands@anthropics-claude-code
    ```

    범위에 대해 자세히 알아보려면 [구성 범위](/ko/settings#configuration-scopes)를 참조하세요.
  </Step>

  <Step title="새 플러그인 사용">
    설치 후 `/reload-plugins`를 실행하여 플러그인을 활성화합니다. 플러그인 명령어는 플러그인 이름으로 네임스페이스되므로 **commit-commands**는 `/commit-commands:commit`과 같은 명령어를 제공합니다.

    파일을 변경하고 다음을 실행하여 시도해보세요:

    ```shell theme={null}
    /commit-commands:commit
    ```

    이는 변경 사항을 스테이징하고, commit 메시지를 생성하며, commit을 만듭니다.

    각 플러그인은 다르게 작동합니다. **Discover** 탭의 플러그인 설명이나 해당 홈페이지를 확인하여 제공하는 명령어 및 기능을 알아보세요.
  </Step>
</Steps>

이 가이드의 나머지 부분에서는 마켓플레이스를 추가하고, 플러그인을 설치하며, 구성을 관리하는 모든 방법을 다룹니다.

## 마켓플레이스 추가

`/plugin marketplace add` 명령어를 사용하여 다양한 소스에서 마켓플레이스를 추가합니다.

<Tip>
  **바로가기**: `/plugin marketplace` 대신 `/plugin market`을 사용할 수 있으며, `remove` 대신 `rm`을 사용할 수 있습니다.
</Tip>

* **GitHub 저장소**: `owner/repo` 형식(예: `anthropics/claude-code`)
* **Git URL**: 모든 git 저장소 URL(GitLab, Bitbucket, 자체 호스팅)
* **로컬 경로**: 디렉토리 또는 `marketplace.json` 파일에 대한 직접 경로
* **원격 URL**: 호스팅된 `marketplace.json` 파일에 대한 직접 URL

### GitHub에서 추가

`.claude-plugin/marketplace.json` 파일을 포함하는 GitHub 저장소를 `owner/repo` 형식을 사용하여 추가합니다. 여기서 `owner`는 GitHub 사용자 이름 또는 조직이고 `repo`는 저장소 이름입니다.

예를 들어 `anthropics/claude-code`는 `anthropics`가 소유한 `claude-code` 저장소를 나타냅니다:

```shell theme={null}
/plugin marketplace add anthropics/claude-code
```

### 다른 Git 호스트에서 추가

전체 URL을 제공하여 모든 git 저장소를 추가합니다. 이는 GitLab, Bitbucket 및 자체 호스팅 서버를 포함한 모든 Git 호스트에서 작동합니다:

HTTPS 사용:

```shell theme={null}
/plugin marketplace add https://gitlab.com/company/plugins.git
```

SSH 사용:

```shell theme={null}
/plugin marketplace add git@gitlab.com:company/plugins.git
```

특정 브랜치 또는 태그를 추가하려면 `#` 뒤에 ref를 추가합니다:

```shell theme={null}
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0
```

### 로컬 경로에서 추가

`.claude-plugin/marketplace.json` 파일을 포함하는 로컬 디렉토리를 추가합니다:

```shell theme={null}
/plugin marketplace add ./my-marketplace
```

`marketplace.json` 파일에 대한 직접 경로를 추가할 수도 있습니다:

```shell theme={null}
/plugin marketplace add ./path/to/marketplace.json
```

### 원격 URL에서 추가

URL을 통해 원격 `marketplace.json` 파일을 추가합니다:

```shell theme={null}
/plugin marketplace add https://example.com/marketplace.json
```

<Note>
  URL 기반 마켓플레이스는 Git 기반 마켓플레이스에 비해 몇 가지 제한 사항이 있습니다. 플러그인 설치 시 "경로를 찾을 수 없음" 오류가 발생하면 [문제 해결](/ko/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)을 참조하세요.
</Note>

## 플러그인 설치

마켓플레이스를 추가한 후 플러그인을 직접 설치할 수 있습니다(기본적으로 사용자 범위에 설치됨):

```shell theme={null}
/plugin install plugin-name@marketplace-name
```

다른 [설치 범위](/ko/settings#configuration-scopes)를 선택하려면 대화형 UI를 사용합니다: `/plugin`을 실행하고 **Discover** 탭으로 이동한 후 플러그인에서 **Enter**를 누릅니다. 다음 옵션이 표시됩니다:

* **User scope**(기본값): 모든 프로젝트에서 자신을 위해 설치
* **Project scope**: 이 저장소의 모든 협력자를 위해 설치(`.claude/settings.json`에 추가)
* **Local scope**: 이 저장소에서만 자신을 위해 설치(협력자와 공유되지 않음)

**managed** 범위의 플러그인도 볼 수 있습니다. 이는 관리자가 [관리되는 설정](/ko/settings#settings-files)을 통해 설치하며 수정할 수 없습니다.

`/plugin`을 실행하고 **Installed** 탭으로 이동하여 범위별로 그룹화된 플러그인을 확인합니다.

<Warning>
  플러그인을 설치하기 전에 신뢰할 수 있는지 확인하세요. Anthropic은 플러그인에 포함된 MCP servers, 파일 또는 기타 소프트웨어를 제어하지 않으며 의도한 대로 작동하는지 확인할 수 없습니다. 자세한 내용은 각 플러그인의 홈페이지를 확인하세요.
</Warning>

## 설치된 플러그인 관리

`/plugin`을 실행하고 **Installed** 탭으로 이동하여 플러그인을 보고, 활성화하고, 비활성화하거나, 제거합니다. 플러그인 이름 또는 설명으로 목록을 필터링하려면 입력합니다.

직접 명령어로 플러그인을 관리할 수도 있습니다.

플러그인을 제거하지 않고 비활성화합니다:

```shell theme={null}
/plugin disable plugin-name@marketplace-name
```

비활성화된 플러그인을 다시 활성화합니다:

```shell theme={null}
/plugin enable plugin-name@marketplace-name
```

플러그인을 완전히 제거합니다:

```shell theme={null}
/plugin uninstall plugin-name@marketplace-name
```

`--scope` 옵션을 사용하면 CLI 명령어로 특정 범위를 대상으로 할 수 있습니다:

```shell theme={null}
claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project
```

### 재시작 없이 플러그인 변경 사항 적용

세션 중에 플러그인을 설치, 활성화 또는 비활성화할 때 `/reload-plugins`를 실행하여 재시작 없이 모든 변경 사항을 선택합니다:

```shell theme={null}
/reload-plugins
```

Claude Code는 모든 활성 플러그인을 다시 로드하고 플러그인, skills, agents, hooks, 플러그인 MCP servers 및 플러그인 LSP servers의 개수를 표시합니다.

## 마켓플레이스 관리

대화형 `/plugin` 인터페이스 또는 CLI 명령어를 통해 마켓플레이스를 관리할 수 있습니다.

### 대화형 인터페이스 사용

`/plugin`을 실행하고 **Marketplaces** 탭으로 이동하여:

* 소스 및 상태와 함께 추가된 모든 마켓플레이스 보기
* 새 마켓플레이스 추가
* 마켓플레이스 목록을 업데이트하여 최신 플러그인 가져오기
* 더 이상 필요하지 않은 마켓플레이스 제거

### CLI 명령어 사용

직접 명령어로 마켓플레이스를 관리할 수도 있습니다.

구성된 모든 마켓플레이스 나열:

```shell theme={null}
/plugin marketplace list
```

마켓플레이스에서 플러그인 목록 새로 고침:

```shell theme={null}
/plugin marketplace update marketplace-name
```

마켓플레이스 제거:

```shell theme={null}
/plugin marketplace remove marketplace-name
```

<Warning>
  마켓플레이스를 제거하면 해당 마켓플레이스에서 설치한 모든 플러그인이 제거됩니다.
</Warning>

### 자동 업데이트 구성

Claude Code는 시작 시 마켓플레이스 및 설치된 플러그인을 자동으로 업데이트할 수 있습니다. 마켓플레이스에 대해 자동 업데이트가 활성화되면 Claude Code는 마켓플레이스 데이터를 새로 고치고 설치된 플러그인을 최신 버전으로 업데이트합니다. 플러그인이 업데이트된 경우 `/reload-plugins`를 실행하도록 요청하는 알림이 표시됩니다.

UI를 통해 개별 마켓플레이스에 대한 자동 업데이트를 전환합니다:

1. `/plugin`을 실행하여 플러그인 관리자 열기
2. **Marketplaces** 선택
3. 목록에서 마켓플레이스 선택
4. **자동 업데이트 활성화** 또는 **자동 업데이트 비활성화** 선택

공식 Anthropic 마켓플레이스는 기본적으로 자동 업데이트가 활성화되어 있습니다. 타사 및 로컬 개발 마켓플레이스는 기본적으로 자동 업데이트가 비활성화되어 있습니다.

Claude Code 및 모든 플러그인에 대해 모든 자동 업데이트를 완전히 비활성화하려면 `DISABLE_AUTOUPDATER` 환경 변수를 설정합니다. 자세한 내용은 [자동 업데이트](/ko/setup#auto-updates)를 참조하세요.

Claude Code 자동 업데이트를 비활성화하면서 플러그인 자동 업데이트를 활성화된 상태로 유지하려면 `DISABLE_AUTOUPDATER`와 함께 `FORCE_AUTOUPDATE_PLUGINS=1`을 설정합니다:

```bash theme={null}
export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1
```

Claude Code 업데이트를 수동으로 관리하지만 여전히 자동 플러그인 업데이트를 받으려는 경우에 유용합니다.

## 팀 마켓플레이스 구성

팀 관리자는 `.claude/settings.json`에 마켓플레이스 구성을 추가하여 프로젝트에 대한 자동 마켓플레이스 설치를 설정할 수 있습니다. 팀 멤버가 저장소 폴더를 신뢰하면 Claude Code는 이러한 마켓플레이스 및 플러그인을 설치하도록 요청합니다.

프로젝트의 `.claude/settings.json`에 `extraKnownMarketplaces`를 추가합니다:

```json theme={null}
{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}
```

`extraKnownMarketplaces` 및 `enabledPlugins`를 포함한 전체 구성 옵션은 [플러그인 설정](/ko/settings#plugin-settings)을 참조하세요.

## 보안

플러그인 및 마켓플레이스는 사용자 권한으로 머신에서 임의의 코드를 실행할 수 있는 매우 신뢰할 수 있는 구성 요소입니다. 신뢰할 수 있는 소스에서만 플러그인을 설치하고 마켓플레이스를 추가합니다. 조직은 [관리되는 마켓플레이스 제한](/ko/plugin-marketplaces#managed-marketplace-restrictions)을 사용하여 사용자가 추가할 수 있는 마켓플레이스를 제한할 수 있습니다.

## 문제 해결

### /plugin 명령어를 인식하지 못함

"알 수 없는 명령어" 또는 `/plugin` 명령어가 나타나지 않으면:

1. **버전 확인**: `claude --version`을 실행하여 설치된 항목을 확인합니다.
2. **Claude Code 업데이트**:
   * **Homebrew**: `brew upgrade claude-code`
   * **npm**: `npm update -g @anthropic-ai/claude-code`
   * **네이티브 설치 프로그램**: [설정](/ko/setup)에서 설치 명령어를 다시 실행합니다.
3. **Claude Code 재시작**: 업데이트 후 터미널을 재시작하고 `claude`를 다시 실행합니다.

### 일반적인 문제

* **마켓플레이스가 로드되지 않음**: URL에 액세스할 수 있고 `.claude-plugin/marketplace.json`이 경로에 있는지 확인합니다.
* **플러그인 설치 실패**: 플러그인 소스 URL에 액세스할 수 있고 저장소가 공개되어 있거나(또는 액세스 권한이 있는지) 확인합니다.
* **설치 후 파일을 찾을 수 없음**: 플러그인은 캐시에 복사되므로 플러그인 디렉토리 외부의 파일을 참조하는 경로는 작동하지 않습니다.
* **플러그인 skills가 나타나지 않음**: `rm -rf ~/.claude/plugins/cache`로 캐시를 지우고, Claude Code를 재시작한 후 플러그인을 다시 설치합니다.

자세한 문제 해결 및 솔루션은 마켓플레이스 가이드의 [문제 해결](/ko/plugin-marketplaces#troubleshooting)을 참조하세요. 디버깅 도구는 [디버깅 및 개발 도구](/ko/plugins-reference#debugging-and-development-tools)를 참조하세요.

### 코드 인텔리전스 문제

* **언어 서버가 시작되지 않음**: 바이너리가 설치되어 있고 `$PATH`에서 사용 가능한지 확인합니다. `/plugin` Errors 탭에서 세부 정보를 확인합니다.
* **높은 메모리 사용량**: `rust-analyzer` 및 `pyright`와 같은 언어 서버는 대규모 프로젝트에서 상당한 메모리를 소비할 수 있습니다. 메모리 문제가 발생하면 `/plugin disable <plugin-name>`으로 플러그인을 비활성화하고 대신 Claude의 기본 제공 검색 도구를 사용합니다.
* **모노레포에서 거짓 양성 진단**: 작업 공간이 올바르게 구성되지 않으면 언어 서버가 내부 패키지에 대해 해결되지 않은 import 오류를 보고할 수 있습니다. 이는 Claude의 코드 편집 능력에 영향을 주지 않습니다.

## 다음 단계

* **자신의 플러그인 빌드**: [플러그인](/ko/plugins)을 참조하여 skills, agents 및 hooks를 만듭니다.
* **마켓플레이스 만들기**: [플러그인 마켓플레이스 만들기](/ko/plugin-marketplaces)를 참조하여 팀 또는 커뮤니티에 플러그인을 배포합니다.
* **기술 참조**: [플러그인 참조](/ko/plugins-reference)를 참조하여 완전한 사양을 확인합니다.