Logo
본문으로 이동
초급5분 소요pluginsdiscovermarketplace

읽는 시간: 5분 | 난이도: 초급자

플러그인은 Claude Code를 스킬, 에이전트, 훅, MCP 서버로 확장합니다. 플러그인 마켓플레이스는 직접 구축하지 않아도 이러한 확장 기능을 발견하고 설치할 수 있는 카탈로그입니다.

마켓플레이스의 작동 방식

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

1단계: 마켓플레이스 추가 카탈로그를 Claude Code에 등록하여 사용 가능한 것들을 탐색할 수 있게 합니다. 아직 플러그인은 설치되지 않습니다.

2단계: 개별 플러그인 설치 카탈로그를 탐색하고 원하는 플러그인을 설치합니다.

앱 스토어를 추가하는 것과 비슷합니다. 스토어를 추가하면 컬렉션을 탐색할 수 있지만, 다운로드할 앱은 개별적으로 선택합니다.

공식 Anthropic 마켓플레이스

공식 Anthropic 마켓플레이스(claude-plugins-official)는 Claude Code를 시작할 때 자동으로 사용 가능합니다. /plugin을 실행하고 Discover 탭으로 이동하여 사용 가능한 것들을 탐색하세요.

공식 마켓플레이스에서 플러그인 설치:

/plugin install plugin-name@claude-plugins-official

코드 인텔리전스 플러그인

코드 인텔리전스 플러그인은 Claude Code의 내장 LSP 도구를 활성화하여 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

코드 인텔리전스 플러그인이 설치되면 Claude는 두 가지 기능을 갖습니다:

  • 자동 진단: Claude가 파일 편집 후 언어 서버가 변경 사항을 분석하고 오류와 경고를 자동으로 보고합니다. 타입 오류, 누락된 임포트, 문법 오류를 컴파일러를 실행하지 않고도 확인합니다.
  • 코드 탐색: 정의로 이동, 참조 찾기, 호버 타입 정보, 심볼 목록, 구현 찾기, 호출 계층 추적 기능을 사용할 수 있습니다.

외부 통합 플러그인

사전 설정된 MCP 서버를 번들로 제공하여 수동 설정 없이 Claude를 외부 서비스에 연결합니다:

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

개발 워크플로우 플러그인

일반적인 개발 작업을 위한 명령어와 에이전트를 추가합니다:

  • commit-commands: 커밋, 푸시, PR 생성을 포함한 Git 커밋 워크플로우
  • pr-review-toolkit: PR 검토를 위한 전문 에이전트
  • agent-sdk-dev: Claude Agent SDK로 빌드하기 위한 도구
  • plugin-dev: 자체 플러그인 생성을 위한 툴킷

데모 마켓플레이스 시작하기

Anthropic은 플러그인 시스템으로 가능한 것을 보여주는 예제 플러그인이 포함된 데모 플러그인 마켓플레이스(claude-code-plugins)도 유지 관리합니다.

1단계: 마켓플레이스 추가

Claude Code 내에서 다음 명령어를 실행합니다:

/plugin marketplace add anthropics/claude-code

이 명령어는 마켓플레이스 카탈로그를 다운로드하고 플러그인을 사용 가능하게 만듭니다.

2단계: 사용 가능한 플러그인 탐색

/plugin을 실행하여 플러그인 관리자를 엽니다. Tab (또는 뒤로 이동하려면 Shift+Tab)으로 사이클할 수 있는 네 개의 탭이 있는 인터페이스가 열립니다:

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

Discover 탭으로 이동하여 방금 추가한 마켓플레이스의 플러그인을 확인합니다.

3단계: 플러그인 설치

플러그인을 선택하여 세부 정보를 보고 설치 스코프를 선택합니다:

  • User scope: 모든 프로젝트에서 직접 사용 가능
  • Project scope: 이 저장소의 모든 협업자에게 설치
  • Local scope: 이 저장소에서만, 본인만 사용

커맨드라인에서 직접 설치할 수도 있습니다:

/plugin install commit-commands@anthropics-claude-code

4단계: 새 플러그인 사용하기

설치 후 플러그인 명령어를 즉시 사용할 수 있습니다. 플러그인 명령어는 플러그인 이름으로 네임스페이스가 지정됩니다. commit-commands 플러그인은 /commit-commands:commit 같은 명령어를 제공합니다:

/commit-commands:commit

이 명령어는 변경 사항을 스테이징하고, 커밋 메시지를 생성하고, 커밋을 만듭니다.

마켓플레이스 추가하기

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

GitHub에서 추가

owner/repo 형식을 사용하여 .claude-plugin/marketplace.json 파일이 포함된 GitHub 저장소를 추가합니다:

/plugin marketplace add anthropics/claude-code

다른 Git 호스트에서 추가

GitLab, Bitbucket, 자체 호스팅 서버를 포함한 모든 Git 저장소에서 추가할 수 있습니다:

# HTTPS 사용
/plugin marketplace add https://gitlab.com/company/plugins.git

# SSH 사용
/plugin marketplace add git@gitlab.com:company/plugins.git

# 특정 브랜치 또는 태그
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

로컬 경로에서 추가

.claude-plugin/marketplace.json 파일이 포함된 로컬 디렉터리를 추가합니다:

/plugin marketplace add ./my-marketplace

원격 URL에서 추가

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

/plugin marketplace add https://example.com/marketplace.json

플러그인 관리

설치된 플러그인 관리

/plugin을 실행하고 Installed 탭으로 이동하여 플러그인을 보기, 활성화, 비활성화, 제거합니다.

# 플러그인 비활성화 (제거 없이)
/plugin disable plugin-name@marketplace-name

# 비활성화된 플러그인 재활성화
/plugin enable plugin-name@marketplace-name

# 플러그인 완전 제거
/plugin uninstall plugin-name@marketplace-name

--scope 옵션으로 특정 스코프를 대상으로 합니다:

claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project

마켓플레이스 관리

# 마켓플레이스 목록 보기
/plugin marketplace list

# 마켓플레이스 플러그인 목록 새로고침
/plugin marketplace update marketplace-name

# 마켓플레이스 제거
/plugin marketplace remove marketplace-name

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

자동 업데이트 설정

Claude Code는 시작 시 마켓플레이스와 설치된 플러그인을 자동으로 업데이트할 수 있습니다. 자동 업데이트를 설정하려면:

  1. /plugin을 실행하여 플러그인 관리자 열기
  2. Marketplaces 선택
  3. 마켓플레이스를 목록에서 선택
  4. Enable auto-update 또는 Disable auto-update 선택

Claude Code 자동 업데이트는 비활성화하면서 플러그인 자동 업데이트는 유지하려면:

export DISABLE_AUTOUPDATER=true
export FORCE_AUTOUPDATE_PLUGINS=true

팀 마켓플레이스 설정

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

문제 해결

/plugin 명령어가 인식되지 않는 경우

  1. 버전 확인: claude --version 실행. 플러그인에는 버전 1.0.33 이상이 필요합니다.
  2. Claude Code 업데이트:
    • Homebrew: brew upgrade claude-code
    • npm: npm update -g @anthropic-ai/claude-code
  3. Claude Code 재시작: 업데이트 후 터미널을 재시작하고 claude를 다시 실행합니다.

일반적인 문제

  • 마켓플레이스가 로딩되지 않음: URL이 접근 가능하고 .claude-plugin/marketplace.json이 경로에 존재하는지 확인
  • 플러그인 설치 실패: 플러그인 소스 URL이 접근 가능하고 저장소가 공개되어 있는지(또는 접근 권한이 있는지) 확인
  • 플러그인 스킬이 나타나지 않음: rm -rf ~/.claude/plugins/cache로 캐시를 지우고, Claude Code를 재시작하고, 플러그인을 다시 설치

코드 인텔리전스 문제

  • 언어 서버가 시작되지 않음: 바이너리가 설치되어 있고 $PATH에서 사용 가능한지 확인. /plugin Errors 탭에서 세부 정보 확인.
  • 높은 메모리 사용량: rust-analyzer와 pyright 같은 언어 서버는 대형 프로젝트에서 상당한 메모리를 소비할 수 있습니다. 메모리 문제가 발생하면 /plugin disable <plugin-name>으로 플러그인을 비활성화하세요.

다음 단계

관련 가이드

슬래시 명령어중급

슬래시 명령어로 자주 사용하는 작업을 단축키로 만드는 방법을 알아봅니다.

스킬 시스템 (Skills)중급

SKILL.md 파일로 Claude Code의 기능을 확장하는 스킬 시스템을 배웁니다.

Hooks 시스템고급

Claude Code의 Hooks로 워크플로우를 자동화하세요

플러그인 탐색 | Claude Code 가이드 | GodDaeHee | GodDaeHee