Claude Code 플러그인 마켓플레이스

Claude Code 플러그인 마켓플레이스 (관리형 스킬)

LiteLLM AI Gateway를 Claude Code 플러그인의 중앙 레지스트리로 사용하는 방법을 알려드릴게요. 관리자는 조직 전체에서 사용 가능한 플러그인을 통제할 수 있고, 엔지니어는 단일 소스에서 승인된 플러그인을 발견하고 설치할 수 있어요.

출처: 문서

본문

사전 요구 사항

  • 데이터베이스가 연결된 LiteLLM Proxy 실행

  • LiteLLM UI에 대한 관리자 접근

  • GitHub, GitLab 또는 git으로 접근 가능한 URL에 호스팅된 플러그인

관리자 가이드: 마켓플레이스 관리하기

1단계: Claude Code 플러그인으로 이동

LiteLLM Admin UI에서 왼쪽 탐색 메뉴의 Claude Code Plugins를 클릭해요.

2단계: 플러그인 목록 보기

등록된 모든 플러그인 목록이 표시돼요. 여기에서 플러그인을 추가, 활성화, 비활성화, 삭제할 수 있어요.

3단계: 새 플러그인 추가

+ Add New Plugin을 클릭해 마켓플레이스에 플러그인을 등록해요.

4단계: 플러그인 세부 정보 입력

플러그인 정보를 입력해요.

  • Name: 플러그인 식별자(kebab-case, 예: my-plugin)

  • Source Type: GitHub, Git URL 또는 Git Subdir 중에서 선택해요

  • Repository/URL: git 소스(예: GitHub의 org/repo)

  • Version: 시맨틱 버전(선택 사항)

  • Description: 플러그인이 하는 일에 대한 설명

  • Category: 정리를 위한 플러그인 카테고리

  • Keywords: 검색어

5단계: 플러그인 제출

세부 정보를 입력한 뒤 Add Plugin을 클릭해 등록해요.

6단계: 플러그인 활성화/비활성화

공용 마켓플레이스에 표시할 항목을 제어하려면 플러그인을 켜거나 꺼요. 활성화된 플러그인만 엔지니어에게 보여요.

엔지니어 가이드: 플러그인 설치하기

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

회사의 LiteLLM 마켓플레이스를 Claude Code에 추가해요.

claude plugin marketplace add http://your-litellm-proxy:4000/claude-code/marketplace.json

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

마켓플레이스에서 사용 가능한 모든 플러그인을 나열해요.

claude plugin search @litellm

3단계: 플러그인 설치

마켓플레이스에서 원하는 플러그인을 설치해요.

claude plugin install my-plugin@litellm

4단계: 설치 확인

이제 플러그인이 설치되어 사용할 준비가 됐어요.

API 참조

공용 엔드포인트 (인증 불필요)

GET /claude-code/marketplace.json

Claude Code 발견을 위한 마켓플레이스 카탈로그를 반환해요.

curl http://localhost:4000/claude-code/marketplace.json

응답:

{  "name": "litellm",  "owner": {    "name": "LiteLLM",    "email": "[email protected]"  },  "plugins": [    {      "name": "my-plugin",      "source": {        "source": "github",        "repo": "org/my-plugin"      },      "version": "1.0.0",      "description": "My awesome plugin",      "category": "productivity",      "keywords": ["automation", "tools"]    }  ]}

관리자 엔드포인트 (인증 필요)

POST /claude-code/plugins

새 플러그인을 등록해요.

curl -X POST http://localhost:4000/claude-code/plugins \  -H "Authorization: Bearer ***" \  -H "Content-Type: application/json" \  -d '{    "name": "my-plugin",    "source": {"source": "github", "repo": "org/my-plugin"},    "version": "1.0.0",    "description": "My awesome plugin",    "category": "productivity",    "keywords": ["automation", "tools"]  }'

GET /claude-code/plugins

등록된 모든 플러그인을 나열해요.

curl http://localhost:4000/claude-code/plugins \  -H "Authorization: Bearer ***"

POST /claude-code/plugins/{name}/enable

플러그인을 활성화해요.

curl -X POST http://localhost:4000/claude-code/plugins/my-plugin/enable \  -H "Authorization: Bearer ***"

POST /claude-code/plugins/{name}/disable

플러그인을 비활성화해요.

curl -X POST http://localhost:4000/claude-code/plugins/my-plugin/disable \  -H "Authorization: Bearer ***"

DELETE /claude-code/plugins/{name}

플러그인을 삭제해요.

curl -X DELETE http://localhost:4000/claude-code/plugins/my-plugin \  -H "Authorization: Bearer ***"

플러그인 소스 형식

  • GitHub
  • Git URL
  • Git Subdir
{  "name": "my-plugin",  "source": {    "source": "github",    "repo": "organization/repository"  }}

{  "name": "my-plugin",  "source": {    "source": "url",    "url": "https://github.com/org/repo.git"  }}

이 형식은 GitLab, Bitbucket 또는 자체 호스팅 git 저장소에 사용해요.

{  "name": "my-plugin",  "source": {    "source": "git-subdir",    "url": "https://github.com/org/repo.git",    "path": "plugins/my-plugin"  }}

플러그인이 git 저장소의 하위 디렉터리에 있을 때 이 형식을 사용해요. path 필드는 슬래시로 구분된 세그먼트의 상대 경로여야 해요(영숫자, 점, 하이픈, 밑줄만 허용).

예시: 내부 플러그인 마켓플레이스 설정하기

1. 내부 플러그인 만들기

플러그인 저장소를 구성해요.

my-company-plugin/├── plugin.json          # Plugin manifest├── SKILL.md            # Main skill file├── skills/             # Additional skills│   └── helper.md└── README.md

2. API로 플러그인 등록하기

# Register your internal tools plugincurl -X POST http://localhost:4000/claude-code/plugins \  -H "Authorization: Bearer $LITEL..._KEY" \  -H "Content-Type: application/json" \  -d '{    "name": "internal-tools",    "source": {"source": "github", "repo": "mycompany/internal-tools"},    "version": "1.0.0",    "description": "Internal development tools and utilities",    "author": {"name": "Platform Team", "email": "[email protected]"},    "category": "internal",    "keywords": ["internal", "tools", "utilities"]  }'

3. Claude Code에서 사용하기

엔지니어에게 마켓플레이스 URL을 알려 주세요.

# One-time setup for each engineerclaude plugin marketplace add http://litellm.internal.company.com/claude-code/marketplace.json# Install company pluginsclaude plugin install internal-tools@litellm

문제 해결

마켓플레이스에 플러그인이 표시되지 않는 경우:

  • 관리자 UI에서 플러그인이 활성화되어 있는지 확인해요

  • 플러그인에 유효한 source 필드가 있는지 확인해요

설치가 실패하는 경우:

  • 엔지니어의 머신에서 git 저장소에 접근 가능한지 확인해요

  • 비공개 저장소의 경우 엔지니어에게 적절한 git 자격 증명이 구성되어 있는지 확인해요

데이터베이스 오류:

  • LiteLLM 프록시가 데이터베이스에 연결되어 있는지 확인해요

  • 자세한 오류 메시지는 프록시 로그를 확인해요

더 알아보기 (Learn more)