플러그인 — 기능 꾸러미 설치하기

이 사전에서 하나씩 살펴본 스킬·서브에이전트·훅·MCP(외부 도구를 클로드에 연결하는 규격)를 한 번에 설치하는 꾸러미가 플러그인(plugin)입니다. 휴대폰에 앱을 하나 깔면 새 기능이 생기듯, 플러그인을 설치하면 클로드 코드에 새 능력이 붙습니다. 클로드 코드로 회사를 세우는 일곱 조각 가운데 마지막 조각입니다(책 7장). 왜 이 기능이 필요한지, 조각이 왜 하필 일곱인지는 「왜 하필 조각이 일곱 개일까요」 페이지에서 설명합니다.

플러그인이란 — 기능 꾸러미입니다

플러그인 하나에는 여러 종류의 기능이 함께 들어 있습니다. 그중 자주 쓰이는 네 가지는 다음과 같습니다.

왜 굳이 플러그인으로 묶을까요. 한 번 잘 만들어 두면 여러 프로젝트에서 다시 쓰고, 팀원이나 커뮤니티와 그대로 나눠 쓸 수 있기 때문입니다. 버전을 붙여 관리하고 업데이트를 받기도 쉬워집니다.

폴더에 그대로 둘 때와 플러그인으로 묶을 때

클로드 코드에 기능을 더하는 방법은 두 가지입니다. 프로젝트 폴더 안 .claude/에 그냥 두는 방식과, 플러그인으로 묶는 방식입니다. 어디까지 나눠 쓸지가 판단 기준입니다.

설치하기 — /plugin 한 줄로 시작합니다

가장 손쉬운 방법은 클로드 코드 안에서 플러그인 관리 화면을 여는 것입니다. 설치·켜기·끄기를 눈으로 보며 다룰 수 있습니다.

# 클로드 코드 입력창에 — 플러그인 관리 화면 열기
/plugin

데스크톱 앱의 「Code」 탭에서 내 컴퓨터에 연 세션이라면 입력창 옆 + 단추를 누르고 Plugins를 고릅니다(클라우드 세션에는 이 메뉴가 없습니다). 설치는 Add plugin, 켜기·끄기는 Manage plugins입니다. Code 탭에서 /plugin을 치면 플러그인을 어디서 설치하고 관리하는지 알려 줍니다.

플러그인은 마켓플레이스(marketplace)라는 목록에서 골라 설치합니다. 앱을 한곳에서 찾아 설치하는 앱 스토어와 같습니다. 앤트로픽이 운영하는 공개 마켓플레이스가 두 곳 있습니다.

# 커뮤니티 마켓플레이스 등록 (한 번만 하면 됩니다)
/plugin marketplace add anthropics/claude-plugins-community

# 플러그인 설치 — 플러그인이름@마켓플레이스이름 형식
/plugin install quality-review-plugin@my-plugins

설치할 때 플러그인 이름 뒤에 @마켓플레이스이름을 붙이는 것은 “어느 가게에서 가져올지”를 지정하는 표시입니다. 위 예시의 my-plugins가 그 가게 이름 자리이고, 실제로는 위 표의 claude-plugins-official이나 내가 따로 등록해 둔 마켓플레이스 이름을 그 자리에 적습니다. 터미널에서 claude plugin install로 설치할 때는 --scope 옵션으로 설치 범위도 정합니다. 범위는 내 모든 프로젝트에서 나만 쓰는 user, 팀과 공유하는 project, 이 프로젝트에서 나만 쓰는 local 세 가지입니다. 화면에서 설치하면 이 선택도 함께 물어보니 외울 필요는 없습니다. 회사나 동료가 깃허브(코드를 올려 두는 공개 창고)에 만들어 둔 마켓플레이스도 소유자/저장소 형태만 적으면 추가됩니다.

# 다른 마켓플레이스 추가 — 소유자/저장소 형태
/plugin marketplace add owner/repo

아직 등록하지 않은 마켓플레이스의 플러그인은 아래처럼 등록과 설치를 한 줄로 끝냅니다. 이때는 플러그인 이름 뒤에 @를 붙이지 않습니다. 처음 보는 마켓플레이스면 등록할지 먼저 묻고 설치 화면을 엽니다. 터미널의 claude plugin install에도 같은 --marketplace 옵션이 있습니다.

# 마켓플레이스 등록과 플러그인 설치를 한 번에
/plugin install deploy-helper --marketplace owner/repo

설치하면 무엇이 생길까요

플러그인에 들어 있는 스킬은 이름 앞에 플러그인 이름이 붙습니다. 예를 들어 my-first-plugin이라는 플러그인의 hello 스킬은 이렇게 부릅니다.

# 플러그인이름:스킬이름 — 접두사가 붙습니다
/my-first-plugin:hello

여러 플러그인에 같은 이름의 스킬이 있어도 서로 부딪치지 않게 하려는 장치입니다. 같은 이름의 직원이 두 명이어도 소속 팀 이름표를 달면 헷갈리지 않는 것과 같습니다.

스킬 말고 나머지는 부를 필요도 없습니다. 플러그인 안의 훅은 정해진 순간에 자동으로 실행되고, 서브에이전트는 클로드가 일을 맡길 수 있는 직원 명단에 합류하며, MCP 서버도 함께 연결됩니다. 설치 한 번으로 전부 제자리를 찾아갑니다. 클로드 코드를 쓰는 도중에 /plugin 화면에서 설치한 것은 요즘 버전에서 대개 그 자리에서 바로 켜집니다. 그래도 새 기능이 안 보이면 그때 /reload-plugins를 한 번 실행하거나 클로드 코드를 다시 시작합니다. 무엇이 설치돼 있는지 궁금하면 이것도 말로 확인합니다.

# 클로드 코드 입력창에
지금 설치된 플러그인이 뭐가 있는지, 각각 무슨 일을 하는지 설명해 줘

연결할 주소 같은 설정값이 필요한 플러그인은 /plugin 화면의 Installed 탭에서 열어 Configure options나 Configure로 값을 채웁니다. 어느 값이 아직 비어 있는지는 터미널에서 claude plugin configure 플러그인이름@마켓플레이스이름으로 확인합니다.

claude.ai 계정에서 켜 둔 플러그인은 같은 계정으로 로그인한 터미널 클로드 코드에도 저절로 따라오고, /plugin 화면에 이름@synced로 보입니다. 예전 버전에서 로그인한 경우에는 시간이 지나면 저절로 받아 오지만, 더 빨리 받으려면 /login을 한 번 다시 하고 클로드 코드를 다시 켜십시오. 다시 켤 때부터 받아 옵니다. 따라오지 않게 하려면 내 설정 파일(~/.claude/settings.json)에 "syncClaudeAiPlugins": false를 넣습니다.

모드 — 클로드 코드의 화면과 동작을 바꾸는 플러그인

플러그인 가운데에는 모드(mod)라는 종류도 있습니다. 한글로 적으면 같은 ‘모드’지만 권한 모드와는 다른 것입니다. 스킬과 훅이 클로드 코드 바깥에서 지시를 건네거나 명령을 실행한다면, 모드는 클로드 코드 안에서 직접 움직이는 작은 프로그램입니다. 그래서 대화 옆이나 입력창 위에 단추가 달린 창을 덧붙이고, 클로드 코드가 원래 그리는 화면도 바꿉니다. 클로드가 도구를 쓰려는 순간 끼어들어 사장에게 먼저 묻게 하는 것도 모드가 하는 일입니다. 터미널과 데스크톱 앱의 「Code」 탭에서 작동합니다.

모드도 말로 시켜 만듭니다. 클로드에게 “일하는 동안 도구를 몇 번 썼는지 세어서 화면에 보여 주는 모드 만들어 줘”처럼 시키면 클로드가 기본으로 들어 있는 plugin-authoring 스킬을 따라 모드를 만듭니다. 그러면 클로드 코드가 이 세션에서 켤지 묻고, 허락하면 클로드가 답을 마치는 대로 모드가 켜집니다. 만든 모드를 남과 나누려면 “다른 사람이 설치할 명령도 알려 줘”라고 덧붙이십시오. 상대가 칠 설치 명령 한 줄을 알려 주고, README(플러그인 설명서 파일)의 설치 칸에도 적어 줍니다. 다만 상대가 설치하려면 먼저 그 모드를 마켓플레이스에 올리거나 폴더를 건네야 합니다. 남이 만든 모드는 다른 플러그인과 똑같이 /plugin install로 설치합니다. 클로드가 만든 모드는 만든 그 세션에서만 켜지고 시간이 지나면 지워지니, 계속 쓰려면 “이 모드를 내 폴더로 옮기고 다음 세션에서도 켜지게 해 줘”라고 부탁합니다. 옮기기만 해서는 저절로 켜지지 않고, 그 폴더를 불러오도록 켜는 방법까지 정해야 다음 세션에서 뜹니다.

주의 — 플러그인도 결국 남이 만든 코드입니다

플러그인 안의 훅은 정해진 순간이 오면 저절로 실행되는 자동 장치입니다. 남이 만든 플러그인을 설치한다는 것은, 남이 짜 둔 동작이 내 컴퓨터에서 그대로 실행된다는 뜻입니다. 앱을 깔 때 권한 안내를 읽어 보듯, 무엇을 하는 플러그인인지 알고 나서 설치하는 것이 안전합니다. 모드는 더 조심해야 합니다. 내 권한 그대로 실행되어 내 파일을 읽고 고치고, 인터넷에 접속하고, 사장에게 묻기 전에 도구 사용을 허락해 버릴 수도 있습니다.

그리고 안 쓰는 플러그인은 /plugin 화면에서 꺼 두면 됩니다. 켜 둔 기능이 많을수록 클로드가 매번 살펴야 할 짐이 늘어납니다. 우리 회사도 쓰지 않는 플러그인은 꺼 두는 것을 원칙으로 합니다. 필요할 때 다시 켜면 그만입니다.