Anthropic, Claude Code 커스터마이징을 지원하는 플러그인(plugin) 기능 공개

9bow · 10월 16, 2025, 9:00오전

Claude Code 소개

Claude Code는 Anthropic이 개발한 AI 기반 개발 지원 도구로, 개발자가 코드 작성, 리뷰, 디버깅, 배포 등 다양한 작업을 AI와 협업하는 방식으로 수행할 수 있게 하는 통합 개발 환경입니다. 최근 Anthropic은 Claude Code에 플러그인(Plugin) 시스템을 도입하여, 사용자가 직접 기능을 확장하고 자신만의 개발 환경을 손쉽게 구성할 수 있도록 지원하고 있습니다.

플러그인은 단순한 기능 추가 도구가 아니라, Claude Code의 구조를 사용자가 원하는 방향으로 재구성할 수 있는 핵심 확장 프레임워크입니다. 기존에는 개별 명령어나 에이전트를 따로 설정해야 했지만, 이제는 한 줄의 명령어(/plugin)로 필요한 기능을 패키지 형태로 설치하고 관리할 수 있습니다.

Anthropic은 이를 통해 “AI가 함께 일하는 개발 환경”을 한층 더 개방적이고 유연하게 만들고자 합니다. 특히 이번 플러그인 시스템은 Slash Command, Agent, MCP Server, Hook 등의 확장 포인트를 하나의 커스터마이징 세트로 묶을 수 있도록 설계되어, 팀 단위의 개발 문화에까지 영향을 미치는 구조적 변화를 가능하게 합니다.

Claude Code 플러그인 구조

Claude Code의 플러그인은 크게 네 가지 확장 포인트(extension points)를 기반으로 구성됩니다. 이들은 각각 Claude Code의 기능을 세밀하게 제어하고 확장할 수 있게 하는 요소입니다.

슬래시 명령어(Slash Commands): Slash Command 기능은 Claude Code 내부에서 자주 사용하는 작업을 명령어 단축키처럼 등록해두는 기능입니다. 예를 들어 /build, /test, /deploy 등의 명령을 미리 정의해두면, 개발자가 반복적으로 수행해야 하는 작업을 단 한 줄로 실행할 수 있습니다.
또한, 팀 단위로 동일한 명령어 세트를 공유하면, 개발 환경의 일관성을 유지하면서 생산성을 크게 높일 수 있습니다.
서브에이전트(Subagents): Subagent는 특정 개발 목적에 최적화된 작업 전용 AI 에이전트입니다. 예를 들어 “보안 점검용 에이전트”, “테스트 자동화용 에이전트”, “API 문서 생성용 에이전트” 등 각기 다른 목적을 가진 에이전트를 필요에 따라 설치하고 실행할 수 있습니다. 이는 Claude Code를 단순한 코드 어시스턴트가 아닌, 멀티에이전트 기반 개발 플랫폼으로 발전시키는 핵심 기능입니다.
MCP 서버(Model Context Protocol Servers): MCP 서버는 외부 데이터 소스나 툴을 Claude Code와 연결해주는 프로토콜 서버 입니다. 이를 통해 사내 데이터베이스, CI/CD 파이프라인, 클라우드 인프라, 또는 외부 API와 Claude를 직접 연결할 수 있습니다.
예를 들어, MCP 서버를 통해 Claude Code가 자동으로 Pull Request의 테스트 상태를 확인하거나, 특정 리포지토리의 이슈 데이터를 불러올 수 있습니다. 이 기능은 기업 내부 시스템과 AI 도구를 자연스럽게 통합하는 데 매우 유용합니다.
훅(Hooks): Hook은 Claude Code의 워크플로우에서 특정 시점에 사용자 정의 코드를 실행하도록 하는 트리거 기능 입니다. 예를 들어 “코드 커밋 시 자동 보안 점검 실행”, “PR 생성 시 코드 스타일 검사 수행”, “빌드 성공 후 배포 명령어 자동 실행”과 같은 자동화를 구현할 수 있습니다. 이는 특히 팀 단위의 협업 환경에서 표준화된 품질 관리 절차를 유지하는 데 매우 효과적입니다.

Claude Code Plugin의 설치 및 관리

플러그인은 현재 **공개 베타(Public Beta)**로 제공되며, /plugin 명령어를 통해 Claude Code 내부에서 직접 설치할 수 있습니다. 실제로 다음과 같은 방식으로 간단히 설치 및 관리가 가능합니다:

/plugin install <plugin-name>

설치된 플러그인은 필요할 때만 활성화하거나 비활성화할 수 있습니다. 이를 통해 불필요한 기능으로 인한 시스템 프롬프트 컨텍스트의 복잡성을 최소화하면서, 필요한 기능만 온디맨드로 사용할 수 있습니다. 이러한 경량화된 구조 덕분에 Claude Code는 사용자별, 프로젝트별로 최적화된 개발 환경을 손쉽게 구축할 수 있습니다.

플러그인 활용 사례 (Use Cases)

플러그인은 단순한 기능 확장뿐 아니라, 팀 전체의 개발 표준과 워크플로우를 통합적으로 관리하는 수단으로 사용할 수 있습니다. 대표적인 활용 사례는 다음과 같습니다:

표준 강제 (Enforcing Standards): 엔지니어링 리더나 테크 리드는 플러그인을 활용하여 코드 리뷰, 테스트, 배포 등 주요 워크플로우에서 특정 Hook이 자동 실행되도록 설정할 수 있습니다. 이를 통해 팀 내의 코드 품질, 테스트 정책, 보안 점검 절차 등을 일관성 있게 유지할 수 있습니다.
사용자 지원 (Supporting Users): 오픈소스 유지보수자나 패키지 개발자는 Slash Command 기반의 가이드 플러그인을 제공하여, 다른 개발자들이 자신의 라이브러리를 올바르게 사용할 수 있도록 도울 수 있습니다. 예를 들어 /init-package, /run-example 같은 명령어를 추가해 초보 사용자의 초기 설정 과정을 단축시킬 수 있습니다.
워크플로우 공유 (Sharing Workflows): 개발자들은 자신이 구축한 디버깅, 테스트, 배포 파이프라인 등 생산성을 높이는 워크플로우를 하나의 플러그인으로 패키징하여 팀원이나 커뮤니티와 쉽게 공유할 수 있습니다. 이를 통해 조직 내에서 검증된 모범 사례를 빠르게 확산시킬 수 있습니다.
도구 연결 (Connecting Tools): 사내 시스템과 Claude Code를 연결해야 하는 경우, MCP 서버 기반 플러그인을 이용하면 동일한 보안 및 설정 프로토콜을 통해 안전하게 통합할 수 있습니다. 예를 들어 사내 Jenkins, Jira, GitHub Actions 등을 MCP 서버로 등록해, Claude Code가 해당 데이터에 접근하거나 명령을 실행하도록 할 수 있습니다.
커스터마이징 번들링 (Bundling Customizations): 프레임워크 제작자나 기술 리더는 여러 개의 설정과 Hook, 에이전트를 하나의 통합 플러그인 번들로 묶어 특정 목적에 맞는 개발 환경을 자동으로 구성할 수 있습니다. 예를 들어 “React 프론트엔드 프로젝트용 플러그인 세트”나 “MLOps 전용 플러그인 세트”처럼 특정 분야에 특화된 환경 구성이 가능합니다.

플러그인 마켓플레이스 (Plugin Marketplaces)

Anthropic은 플러그인을 더 쉽게 배포하고 공유할 수 있도록 플러그인 마켓플레이스 개념을 도입했습니다. 누구나 GitHub 저장소나 웹 URL을 통해 자신만의 마켓플레이스를 개설할 수 있으며, 다른 개발자들이 그곳에서 플러그인을 검색하고 설치할 수 있습니다.

마켓플레이스를 구성하려면 .claude-plugin/marketplace.json 파일이 포함된 Git 저장소나 URL만 있으면 됩니다. 사용자는 다음 명령어로 마켓플레이스를 추가할 수 있습니다:

/plugin marketplace add user-or-org/repo-name

이후 /plugin 명령을 통해 마켓 내의 플러그인을 탐색하고, 원하는 항목을 즉시 설치할 수 있습니다. 이러한 구조를 통해 조직 내부용 마켓플레이스를 만들어 검증된 플러그인만 배포하거나, 커뮤니티 중심의 공개 마켓플레이스를 운영하는 등 다양한 활용이 가능합니다.

새로운 마켓플레이스 탐색 (Discover New Marketplaces)

플러그인 마켓플레이스는 커뮤니티가 만들어낸 모범 사례를 빠르게 확산시키는 역할을 합니다. 이미 여러 개발자들이 독자적인 마켓플레이스를 구축하여 커뮤니티 생태계를 확장하고 있습니다.

Dan Ávila의 AITMPL 마켓플레이스는 DevOps 자동화, 문서 생성, 프로젝트 관리, 테스트 스위트 등 다양한 플러그인을 제공합니다.
Seth Hobson은 GitHub 저장소에서 80개 이상의 전문화된 Subagent를 제공하여, Claude Code 사용자들이 다양한 기능을 즉시 사용할 수 있게 했습니다.
Anthropic의 공식 GitHub 저장소에서는 PR 리뷰, 보안 가이드, Claude Agent SDK 개발, 그리고 새로운 플러그인을 생성하기 위한 메타 플러그인(meta-plugin) 등의 예제도 확인할 수 있습니다.

Claude Code 플러그인 시작하기 (Getting Started)

Claude Code 플러그인은 현재 **모든 사용자에게 공개 베타(Public Beta)**로 제공되고 있습니다. 플러그인은 VS Code와 터미널 양쪽 환경에서 작동하며, 다음과 같은 명령어로 설치할 수 있습니다:

/plugin marketplace add anthropics/claude-code
/plugin install feature-dev

플러그인 개발을 시작하고 싶다면 다음 문서를 참고하세요:

Claude Code Plugins 블로그

Claude Code GitHub 저장소

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~