클로드 코드 플러그인 설치하는 법: /plugin 으로 깔고 끄고 지우기, 직접 만들기까지

이 글 순서

1. 플러그인이 뭔가요
2. 처음이라면: 하나 깔기
3. 끄기·켜기·지우기
4. 익숙해졌다면: 범위
5. 다른 마켓플레이스 더하기
6. 업데이트
7. 더 깊이: 켜 둔 값
8. 믿어도 되나
9. 직접 만들어 보기
10. 막힐 때
11. 코덱스·안티그래비티는
12. 한국에서 되나
13. 다음에 볼 글
14. 참고한 자료

클로드 코드에 스킬·훅·MCP 서버 같은 것을 하나씩 붙이다 보면, 남이 잘 만들어 둔 설정을 통째로 받아 쓰고 싶어질 때가 있어요. 플러그인이 그 일을 해 줘요. 여러 설정을 한 패키지로 묶어 두고, 명령 한 줄로 깔고, 필요 없으면 끄거나 지우는 방식이에요. 휴대폰에서 앱 스토어를 열어 앱을 받는 것과 비슷하다고 보면 돼요.

클로드 코드 공식 문서의 플러그인 쪽(plugins 개요·설치·Anthropic 마켓플레이스·보안·만들기·문제 해결)을 2026년 10월 8일에 읽고 옮겼어요. 캡처는 한국어 문서 화면이고, 명령 이름과 버전 번호는 영어 문서와 맞춰 봤어요. 터미널 그림은 클로드 코드 2.1.292 가 깔린 윈도우 PC 에서 같은 날 돌린 출력이에요. 이 PC 의 실제 설정을 건드리지 않으려고, 설정이 들어가는 폴더를 따로 만든 테스트 폴더로 돌려 놓고 돌렸어요. 그 안에서 공식 마켓플레이스를 더하고 플러그인 하나를 깔았다가 지웠고, 끝난 뒤 테스트 폴더는 지웠어요. 출력은 그대로 옮기고 창 모양만 PowerShell 로 그렸어요. 로그인한 대화 창 안에서만 열리는 /plugin 창은 보지 못해서 문서에 적힌 대로 옮겨요.

플러그인이 뭔가요

클로드 코드는 내가 말로 요청한 일을 Claude 라는 AI 가 대신 하는 프로그램이에요. 그냥 써도 파일을 읽고 고치고 명령을 돌리지만, 여기에 내 방식이나 바깥 도구를 더할 수 있어요. 더하는 것은 크게 넷이에요.

• 스킬: “이런 일을 할 땐 이 순서로 해”라고 적어 둔 지침 파일(SKILL.md)이에요. /이름 으로 직접 호출할 수도 있어요.
• 에이전트(서브에이전트): 큰 일을 나눠 맡기는 작은 작업자예요. 따로 일하고 결과만 돌려줘요.
• 훅: 파일을 고친 뒤처럼 정해진 때마다 자동으로 도는 명령이에요.
• MCP 서버: 노션·브라우저 같은 바깥 프로그램을 클로드 코드에 붙이는 연결이에요.

플러그인은 이것들을 한 폴더에 묶어 하나로 깔고 지우게 만든 패키지예요. 문서는 “스킬, 에이전트, 훅, MCP 서버 등의 디렉터리를 클로드 코드가 하나로 설치하고 불러오는 것”이라고 적었어요. 디렉터리는 폴더와 같은 말이에요.

플러그인을 어디서 받느냐가 두 번째 단어인 마켓플레이스(marketplace)이에요. 마켓플레이스라고 해서 돈을 내는 가게는 아니고, “이런 플러그인이 있고 여기서 받으면 된다”고 적어 둔 목록 파일이에요. 마켓플레이스를 한 번 더해 두면 그 목록에 있는 플러그인을 이름으로 깔 수 있어요. 문서가 플러그인 폴더 안을 그림으로 보여 준 부분을 캡처했어요.

그림 왼쪽이 플러그인 폴더, 오른쪽이 깐 뒤에 생기는 것이에요. 맨 위 plugin.json 은 매니페스트(manifest)라고 부르는데, 플러그인 정보를 적는 파일이에요. 이름·설명·버전 번호가 들어 있어요. 플러그인 안 스킬은 /플러그인이름:스킬이름 형식으로 불러요. 그림의 my-plugin 에 든 review 스킬이면 /my-plugin:review 예요. 이름 앞에 플러그인 이름이 붙어서, 두 플러그인에 같은 이름의 스킬이 있어도 섞이지 않아요.

헷갈리기 쉬운 이름이 둘 있어요. VS Code 확장이나 JetBrains 플러그인은 클로드 코드를 편집기 안에서 쓰게 해 주는 별도 프로그램이고, 이 글의 플러그인이 아니에요. claude.com/marketplace 라는 웹 페이지도 있는데, 문서는 이것을 둘러보는 웹사이트라고 적었어요. 클로드 코드에 더하는 마켓플레이스와는 다른 것이에요.

스킬 하나, 훅 하나만 쓴다면 플러그인이 꼭 필요하지는 않아요. 문서도 스킬·훅·MCP 서버는 각각 따로 둬도 돌고, 여러 개를 한 묶음으로 공유하거나 남이 만든 묶음을 받을 때 플러그인을 쓰라고 적었어요. 하나씩 붙이는 법은 스킬 만들기 글, 훅 글, MCP 글에 있어요.

처음이라면: 하나 깔기

준비물은 둘이에요.

• 클로드 코드가 깔려 있고 로그인돼 있을 것. 아직이라면 윈도우 설치 글부터 보세요.
• 터미널을 열 줄 알 것. 터미널은 마우스 대신 글자로 컴퓨터에 일을 시키는 까만 창이고, 윈도우에서는 PowerShell 이에요. 시작 버튼을 누르고 PowerShell 을 치면 나와요.

먼저 내 클로드 코드에 플러그인 명령이 있는지 봐요. 이 PC 에서 돌린 화면이에요.

claude plugin --help

claude plugin 아래에 어떤 명령이 있는지 보여 달라는 줄이에요. 아무것도 바뀌지 않아요. 앞으로 쓸 것은 install(깔기), list(목록), details(들여다보기), disable·enable(끄기·켜기), uninstall(지우기), marketplace(마켓플레이스 다루기)예요.

클로드 코드를 터미널에서 한 번이라도 켰다면 마켓플레이스는 따로 더하지 않아도 돼요. 문서는 대화형 터미널 세션을 처음 시작할 때 Anthropic 공식 마켓플레이스(claude-plugins-official)이 자동으로 더해진다고 적었어요. 한 번도 안 켰다면 아래 “방법 둘”의 첫 줄을 보세요. 공식 마켓플레이스에는 Anthropic 이 직접 관리하는 플러그인과, 다른 회사·개발자가 낸 플러그인이 같이 있어요. 이 PC 에서 10월 8일에 받은 공식 마켓플레이스 목록 파일에는 플러그인이 315개 적혀 있었어요. 목록은 자주 바뀐다고 문서에 적혀 있어요.

문서가 연습용으로 드는 것은 commit-commands 예요. 깃(git, 파일이 바뀐 기록을 남기는 프로그램)에 저장 기록을 남기고 올리는 일을 돕는 명령 묶음이에요. 깃을 안 쓰는 분이라도 깔고 지우는 순서를 익히는 데는 그대로 따라 하면 돼요. 길은 둘이에요.

방법 하나: 대화 창에서

PowerShell 에서 작업할 폴더로 가서 claude 를 쳐 클로드 코드를 켠 뒤, 대화 창에 이렇게 쳐요.

/plugin install commit-commands@claude-plugins-official

@ 앞이 플러그인 이름, 뒤가 마켓플레이스 이름이에요. 문서에 따르면 이 명령은 바로 깔지 않고 /plugin 창을 그 플러그인의 자세히 보기 화면으로 열어요. 문서의 단계 설명을 캡처했어요.

• Will install: 이 플러그인이 더하는 명령·에이전트·스킬·훅·MCP 서버가 적힌 곳이에요. 깔기 전에 여기를 꼭 읽어요.
• Context cost: 공식 마켓플레이스 플러그인이면 토큰 숫자 두 개가 나와요. 토큰은 AI 가 글을 세는 단위로, 한도를 이걸로 계산해요. Every turn 은 메시지마다 더해지는 양, When invoked 는 스킬을 실제로 쓸 때 더해지는 양이에요. 문서에 따르면 위처럼 이름@마켓플레이스 로 열거나 Marketplaces 탭에서 열 때만 나오고, Discover 목록에서 들어가면 안 나와요.
• 범위: “나만 모든 프로젝트에서(user)”, “이 저장소의 모두에게(project)”, “나만 이 저장소에서(local)” 가운데 하나를 골라요. 처음이라면 첫째를 고르면 돼요. 범위는 아래 “익숙해졌다면”에서 더 다뤄요.

이름을 모르면 /plugin 만 쳐요. Discover(둘러보기) 탭이 열리고, 글자를 치면 찾아 줘요. Enter 를 누르면 자세히 보기로 들어가요.

범위를 고르면 깔고 나서 요약이 나와요. 요약의 마지막 문장이 지금 바로 쓸 수 있는지 알려 줘요.

• Plugin is now active: 바로 쓸 수 있어요.
• Run /reload-plugins to apply: 다시 불러와야 한다는 뜻이에요. 창이 닫히면서 클로드 코드가 대신 돌려 줘요.
• The plugin couldn’t be loaded: 불러오지 못했어요. /plugin 의 Errors 탭에 이유가 적혀 있어요.

방법 둘: 터미널에서 바로

클로드 코드를 켜지 않고 PowerShell 에서 바로 깔 수도 있어요. 다만 공식 마켓플레이스가 자동으로 더해지는 건 대화형 세션을 처음 켤 때뿐이에요. 문서의 문제 해결 쪽에 “claude plugin 셸 명령은 절대 등록하지 않습니다”라고 적혀 있어요. 클로드 코드를 아직 한 번도 켜지 않았거나 VS Code 확장으로만 써 온 컴퓨터라면 아래 첫 줄로 공식 마켓플레이스부터 더해요.

claude plugin marketplace add anthropics/claude-plugins-official

깃허브에 있는 공식 마켓플레이스 목록을 내 클로드 코드에 더하라는 줄이에요. Successfully added marketplace: claude-plugins-official 이 나오면 된 거예요. 이미 더해져 있다면 건너뛰어도 돼요. 그다음 깔아요.

claude plugin install commit-commands@claude-plugins-official

공식 마켓플레이스에서 commit-commands 를 깔라는 줄이에요. 범위를 안 적으면 user(나만, 모든 프로젝트)로 깔려요. 마켓플레이스가 없는 채로 이 줄부터 치면 실패해요. 문서는 그때 나오는 글을 Marketplace “claude-plugins-official” not found 로 적었는데, 대화형 세션을 한 번도 켜지 않은 이 PC 의 새 테스트 폴더에서 10월 9일에 다른 플러그인으로 해 보니 Plugin “typescript-lsp” not found in marketplace “claude-plugins-official” 이 나왔어요. 어느 쪽이든 위의 marketplace add 한 줄을 치고 다시 깔면 돼요. 아래는 테스트 폴더에서 깔고, 이어서 목록을 본 화면이에요.

claude plugin list

깔린 플러그인 목록을 보여 달라는 줄이에요. Status 가 enabled(켜짐)면 다음에 클로드 코드를 켤 때 같이 불러와요. 이미 켜 둔 대화가 있다면 그 안에서 /reload-plugins 를 치면 바로 불러와요.

써 보기

클로드 코드 대화 창에서 / 를 치면 목록에 플러그인 이름이 붙은 스킬이 보여요. commit-commands 라면 /commit-commands:commit 이 나와요. 문서는 이게 보이면 제대로 깔린 것이라고 적었어요. 이 스킬은 바뀐 파일을 살펴 깃 저장 기록을 남겨 주는 쪽이라, 깃으로 관리하는 폴더에서 써야 뜻이 있어요.

안 보이면 아래 “막힐 때”를 보세요. 대부분 다시 불러오기(/reload-plugins)나 이름 오타예요.

끄기·켜기·지우기

잠깐 안 쓸 플러그인은 지우지 말고 꺼 두면 돼요. 꺼 두면 깔린 채로 남고, 대화에는 실리지 않아요. 테스트 폴더에서 끄고, 목록을 보고, 다시 켜고, 지운 화면이에요.

claude plugin disable commit-commands@claude-plugins-official
claude plugin enable commit-commands@claude-plugins-official
claude plugin uninstall commit-commands@claude-plugins-official

첫 줄은 끄기, 둘째 줄은 다시 켜기, 셋째 줄은 지우기예요. uninstall 대신 remove 라고 써도 같다고 문서에 적혀 있어요.

대화 창 안에서는 /plugin 을 열고 Tab 을 눌러 Installed(깔린 것) 탭으로 가요. 문서에 적힌 키는 이래요. 글자를 치면 이름으로 필터링해 주고, Space 는 켜기·끄기, Enter 는 자세히 보기예요. 자세히 보기에는 Disable plugin(끄기)·Update now(지금 업데이트)·Uninstall(지우기)이 있어요. 오래 안 쓴 플러그인은 Not used recently(최근에 안 씀) 아래로 모인다고 해요. 정리할 때 여기부터 보면 돼요.

저장소 설정으로 팀 모두에게 켜 둔 플러그인을 지우려 하면 하나를 더 물어요. y 를 누르면 나만 끄고(내 settings.local.json 에 false 를 적음), u 를 누르면 팀 공용 설정에서 빼요. 남의 설정까지 바꾸지 않으려면 y 예요.

익숙해졌다면: 범위

범위는 “누구에게, 어느 프로젝트에서 켤까”를 정하는 설정이에요. 고른 범위에 따라 켜짐 표시가 적히는 설정 파일이 달라요.

• user: 나만, 이 컴퓨터의 모든 프로젝트. 홈 폴더의 .claude\settings.json 에 적혀요. 혼자 쓰는 도구는 이쪽이에요.
• project: 이 저장소에서 일하는 모두. 프로젝트 안 .claude\settings.json 에 적히고, 이 파일을 깃에 올려 나눠요. 문서는 이 파일을 받는다고 플러그인이 다운로드되지는 않으니, 받는 사람도 claude plugin install 이름@마켓플레이스 --scope project 를 한 번씩 돌리라고 적었어요.
• local: 나만, 이 저장소에서만. 프로젝트 안 .claude\settings.local.json 에 적혀요. 이 파일은 보통 깃에 올리지 않아요.

터미널에서 범위를 고르려면 끝에 --scope 를 붙여요.

claude plugin install commit-commands@claude-plugins-official --scope project

이 저장소의 공용 설정에 켜 두라는 줄이에요. 같은 플러그인이 여러 범위에 적혀 있으면 local 이 project 보다, project 가 user 보다 우선 적용돼요. 터미널·데스크톱 앱의 로컬 세션·VS Code 확장은 같은 설정 파일을 읽어서, user 범위로 한 번 깔면 셋 다에서 보인다고 문서에 적혀 있어요. 데스크톱 앱에서는 입력 칸 옆 + 버튼의 Plugins, VS Code 에서는 /plugins 로 여는 Manage plugins 창에서 깔아요(데스크톱 앱 글, VS Code 글).

만든 사람이 처음엔 꺼진 채로 깔리게(defaultEnabled) 해 둔 플러그인도 있어요. 그런 건 깐 뒤 enable 로 직접 켜야 해요.

다른 마켓플레이스 더하기

공식 마켓플레이스에 없는 플러그인은 그 플러그인이 든 마켓플레이스를 먼저 더해야 깔 수 있어요. Anthropic 이 내는 일반 마켓플레이스만 셋이에요.

• 공식(claude-plugins-official): 대화형 세션을 처음 켤 때 자동으로 더해져요.
• 커뮤니티(claude-community): 다른 사람이 만들어 Anthropic 에 낸 플러그인이에요. 직접 더해야 해요.
• 데모(claude-code-plugins): 플러그인에 무엇이 들어갈 수 있는지 보여 주는 예제 몇 개예요. 문서는 여기 든 것 대부분이 공식 마켓플레이스에도 같은 이름으로 있으니 공식 쪽에서 깔라고 적었어요. 두 벌이 깔리지 않게요.

마켓플레이스를 더하는 명령은 이 형식이에요. 깃허브 저장소면 “소유자/저장소” 형식으로 적어요.

/plugin marketplace add anthropics/claude-plugins-community

클로드 코드 대화 창에서 커뮤니티 마켓플레이스를 더하라는 줄이에요. 터미널에서는 앞을 claude plugin marketplace add 로 바꾸면 돼요. 더한 뒤 그 마켓플레이스의 플러그인은 이름@claude-community 로 깔아요. 마켓플레이스 이름이 저장소 이름과 다를 수 있다는 점을 문서가 따로 짚었어요.

깃허브 말고도 다른 깃 주소, 내 컴퓨터 폴더, 인터넷에 올린 marketplace.json 파일 주소를 받아요. 내 컴퓨터 폴더는 ./ 나 ../ 로 시작해야 해요. 그냥 “이름/이름”이라고 쓰면 깃허브 저장소로 알아듣기 때문이에요. 대화 창을 켠 적 없는 테스트 폴더라 공식 마켓플레이스를 직접 더한 화면이에요. 공식 마켓플레이스가 빠져 있을 때도 이렇게 더하면 돼요.

claude plugin marketplace list

더해 둔 마켓플레이스와 그 출처를 보여 달라는 줄이에요. 이 PC 에서는 공식 마켓플레이스 말고 anthropic-plugin-directory 라는 줄이 Built in(처음부터 있음)으로 하나 더 나왔어요. 문서에는 이 이름이 Anthropic 전용으로 묶어 둔 “플러그인 디렉터리” 이름이라는 것만 적혀 있고, 이 줄이 무엇을 보여 주는지는 찾지 못했어요.

마켓플레이스 더하기와 깔기를 한 번에 하는 방법도 있어요. 2.1.275 버전부터 된다고 적혀 있어요.

/plugin install 플러그인이름 --marketplace 소유자/저장소

아직 안 더한 마켓플레이스면 출처를 보여 주고 더할지 물은 뒤, 그 플러그인의 자세히 보기를 열어요. 이때는 이름 뒤에 @마켓플레이스 를 붙이지 않아요.

비밀번호가 걸린 저장소(회사 안 마켓플레이스 등)는 내 컴퓨터에 이미 있는 깃 로그인 정보로 받아요. 클로드 코드는 따로 묻지 않아서, 처음 가는 곳이면 묻는 대신 실패한다고 해요. 그럴 땐 깃에서 먼저 로그인해 둬요.

업데이트

플러그인은 마켓플레이스마다 자동 업데이트가 켜져 있으면 자동으로 새 버전으로 바뀌어요. 공식 마켓플레이스는 처음부터 켜져 있고, 커뮤니티 마켓플레이스와 다른 사람의 마켓플레이스는 꺼져 있어요(공식 이름 가운데 knowledge-work-plugins·first-party-plugins 도 꺼짐). 문서는 대화 창에서 첫 메시지를 보낸 뒤 최대 10분 안의 아무 때나 마켓플레이스를 새로 받아 디스크의 플러그인을 바꾼다고 적었어요. 켜 둔 대화는 원래 버전을 그대로 쓰고, “Plugin updated” 알림이 뜨면 /reload-plugins 로 바로 바꾸거나 다음에 켤 때 바뀌어요.

직접 올리려면 이래요.

claude plugin update commit-commands@claude-plugins-official

그 플러그인 하나를 지금 새 버전으로 바꾸라는 줄이에요. 한 번에 전부 올리는 명령은 없다고 문서에 적혀 있어요. 한 마켓플레이스에서 깐 것을 한꺼번에 올리려면 /plugin 의 Marketplaces 탭에서 그 마켓플레이스를 고르고 Update marketplace 를 눌러요. 자동 업데이트를 켜고 끄는 것도 같은 위치예요.

계정 쪽에서 오는 플러그인도 있어요. claude.ai 계정에서 켜 둔 플러그인(회사가 켜 준 것 포함)은 같은 계정으로 로그인한 터미널 세션에 따라와요. 목록에는 이름@synced 로 보이고, 2.1.273 버전부터라고 적혀 있어요. 반대로 클로드 코드에서 깐 플러그인은 claude.ai 계정에 올라가지 않아요.

더 깊이: 켜 둔 값

켜 둔 플러그인은 쓰는 대화에만 실리는 게 아니라 모든 대화에 같이 실려요. 문서가 깔기 전에 알아 둘 점으로 꼽은 부분이에요.

• 컨텍스트와 사용량: 컨텍스트는 AI 가 지금 대화에서 한 번에 기억하는 내용의 크기예요. Claude 가 스스로 호출할 수 있는 스킬·에이전트는 이름과 설명이 매번 컨텍스트에 실려요. 그만큼 사용량에 들어가고, 아무것도 안 쓴 대화에서도 그래요. 본문은 실제로 쓸 때만 불러와요.
• 프로세스: 플러그인 속 MCP 서버는 켜 둔 동안 대화마다 같이 돌고, 훅은 정해진 때마다 돌아요.
• 권한: 플러그인이 돌리는 것은 내 이름으로 돌아요. 아래 “믿어도 되나”에서 다뤄요.

얼마나 드는지는 터미널에서 볼 수 있어요. 테스트 폴더에서 commit-commands 를 들여다본 화면이에요.

claude plugin details commit-commands

깔린 플러그인에 무엇이 들었고 토큰이 얼마나 드는지 보여 달라는 줄이에요. Component inventory 는 든 것 목록이에요. 이 플러그인은 스킬 셋뿐이고 에이전트·훅·MCP 서버는 0 이에요. Always-on 은 켜 두기만 해도 대화마다 더해지는 양으로, 약 71 토큰이라고 나왔어요. on-invoke 는 그 스킬을 실제로 쓸 때 더해지는 양이에요. 출력 끝에도 적혀 있듯 추정값이에요.

한 플러그인은 작아도 여러 개를 켜 두면 쌓여요. 제 생각에는 깔기 전에 Context cost 를, 깐 뒤에는 details 를 한 번 보고, 한 달에 한 번쯤 Not used recently 에 모인 것을 꺼 두는 정도면 충분해요. 한도를 얼마나 썼는지는 사용량 확인 글, 대화 중에 플러그인을 켜고 끄면 캐시가 깨질 수 있는 이유는 프롬프트 캐시 글에 있어요. 문서도 다시 불러오기가 캐시를 깨는 경우엔 경고하고 미뤄 둔다고 적었어요(--force 로 바로 적용).

믿어도 되나

문서의 보안 쪽 첫 줄은 “설치한 플러그인은 사용자 권한으로 머신에서 임의의 코드를 실행할 수 있다”예요. 내 컴퓨터에서 내가 할 수 있는 일은 플러그인도 할 수 있다는 뜻이에요.

네 가지만 기억하면 돼요.

• 내 권한으로 돈다: 훅·모니터(세션이 켜질 때 뒤에서 도는 명령)·MCP 서버는 내 사용자 권한으로 돌아요.
• 권한 설정 밖이다: 클로드 코드의 권한 규칙과 샌드박스(바깥에 손대지 못하게 가둔 환경)는 Claude 가 호출하는 도구에 걸리는 장치예요. 플러그인의 훅·서버가 스스로 돌리는 것은 샌드박스 밖에서 돈다고 적혀 있어요. 권한 규칙은 권한 설정 글에 있어요.
• 바뀔 수 있다: 자동 업데이트가 켜진 마켓플레이스면, 내가 읽어 본 파일이 나중에 다른 내용으로 바뀔 수 있어요.
• 마켓플레이스 이름은 만든 곳만 알려 준다: 공식·커뮤니티 이름은 github.com/anthropics/ 저장소에서 온 마켓플레이스만 쓸 수 있어서, 남이 공식인 척할 수는 없어요. 하지만 문서는 마켓플레이스 이름이 “카탈로그를 누가 게시하는지만 알려 줄 뿐” 플러그인 하나하나가 무엇을 하는지는 알려 주지 않는다고 적었어요.

깔기 전에 볼 순서도 문서에 있어요.

1. claude plugin marketplace list 로 그 마켓플레이스가 어디서 왔는지 봐요.
2. /plugin 의 자세히 보기에서 Will install 을 읽어요. 훅이 있다는 것까지만 보이고, 무슨 명령을 돌리는지는 안 보여요.
3. Open homepage·View on GitHub 로 원본을 열어 hooks\hooks.json(훅이 돌리는 명령), .mcp.json(서버가 켜는 명령이나 주소), bin 폴더(실행 파일)를 읽어요.
4. 저장소를 다운로드했다면 claude --plugin-dir 폴더 plugin details 이름 으로, 깔지 않고 든 것 목록을 뽑아 볼 수 있어요.

깔기 전에는 이런 경고 문구가 나온다고 문서에 적혀 있어요. “Make sure you trust a plugin before installing, updating, or using it.” Anthropic 은 플러그인에 든 MCP 서버·파일·소프트웨어를 다스리지 않고, 뜻대로 돌거나 바뀌지 않으리라고 보증하지 못한다는 내용이 이어져요.

믿지 못하게 된 플러그인은 깔 때 고른 범위로 uninstall 해요. 문서에 따르면 다운로드한 파일은 홈 폴더의 .claude\plugins\cache 아래에 14일 동안 남았다가 지워지고, 바로 없애려면 그 폴더를 직접 지우면 돼요. 마켓플레이스 소유자까지 못 믿겠으면 마켓플레이스를 지워요(claude plugin marketplace remove 이름). 마켓플레이스를 지우면 거기서 깐 플러그인도 모두 지워져요.

제 생각에는 처음 몇 개는 Anthropic 공식 마켓플레이스에서, 그중에서도 Will install 에 스킬만 있는 것부터 써 보는 게 마음 편해요. 훅이나 MCP 서버가 든 플러그인은 위 순서대로 파일을 한 번 열어 보고 깔아요.

직접 만들어 보기

내가 쓰는 스킬 몇 개를 동료에게 공유하거나 여러 프로젝트에 같이 쓰고 싶다면 플러그인으로 묶으면 돼요. 문서의 첫 예제는 인사 스킬 하나짜리 플러그인이에요. 개발을 몰라도 폴더 둘과 파일 둘이면 끝나요.

1. PowerShell 에서 플러그인을 둘 곳으로 가서 폴더를 만들어요.

mkdir my-first-plugin\.claude-plugin
mkdir my-first-plugin\skills\hello

플러그인 폴더(my-first-plugin)와 그 안에 매니페스트 폴더(.claude-plugin), 스킬 폴더(skills\hello)를 만드는 줄이에요. 문서는 맥·리눅스 형식(mkdir -p 와 슬래시)으로 적었는데, PowerShell 에서는 위처럼 쳐도 안쪽 폴더까지 같이 만들어져요. 이 PC 의 테스트 폴더에서 확인했어요.

2. 매니페스트 파일을 만들어요. 메모장으로 아래 내용을 my-first-plugin\.claude-plugin\plugin.json 으로 저장해요. 메모장에서 저장할 때 파일 형식을 “모든 파일”로 바꾸지 않으면 끝에 .txt 가 붙으니 조심해요.

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  }
}

name 은 꼭 있어야 하는 필드이고 띄어쓰기를 넣으면 안 돼요. 스킬 이름 앞에 붙는 그 이름이에요. description 은 /plugin 에 보이는 설명, version 은 버전 번호, author 는 만든 사람이에요.

3. 스킬 파일을 만들어요. my-first-plugin\skills\hello\SKILL.md 로 저장해요.

---
name: hello
description: Greet the user with a friendly message
disable-model-invocation: true
---

Greet the user warmly and ask how you can help them today.

위 세 줄짜리 프론트매터가 스킬의 이름과 설명이고, 아래가 Claude 에게 주는 지침이에요. disable-model-invocation: true 는 Claude 가 알아서 호출하지 말고 내가 호출할 때만 쓰라는 필드예요. 프론트매터 필드는 스킬 만들기 글에 스무 가지를 풀어 뒀어요.

위치가 중요해요. 문서의 경고대로 .claude-plugin 폴더 안에는 plugin.json 하나만 둬요. skills·agents·hooks·.mcp.json 은 그 바깥, 플러그인 폴더 바로 아래에 둬야 불러와요.

4. 검사하고 불러 봐요. 테스트 폴더에서 문서 예제를 그대로 만들어 돌린 화면이에요.

claude plugin validate ./my-first-plugin

매니페스트와 스킬 프론트매터에 틀린 곳이 없는지 검사하라는 줄이에요. Validation passed 가 나오면 통과예요.

claude --plugin-dir ./my-first-plugin

이 폴더의 플러그인을 이번 한 번만 불러서 클로드 코드를 켜라는 줄이에요. 깔지 않고 설정에도 아무것도 적지 않아요. 켜진 뒤 대화 창에 /my-first-plugin:hello 를 치면 Claude 가 인사해 준다고 문서에 적혀 있어요. 파일을 고쳤으면 /reload-plugins 로 다시 불러와요. 이 PC 에서는 대화를 켜지 않고 같은 옵션으로 details 만 뽑아 봤는데, 스킬 hello 하나가 인식되고 출처가 my-first-plugin@inline(한 번만 불러온 것)으로 나왔어요.

매번 --plugin-dir 을 붙이기 귀찮으면 claude plugin init 이름 을 쓰는 방법도 있어요. 홈 폴더의 .claude\skills 아래에 빈 플러그인을 만들어 주고, 거기 있는 플러그인은 대화마다 자동으로 불러와요. 위 그림 아래쪽처럼 author(만든 사람)가 비었다는 경고와 함께 만들어졌고, 끄는 명령과 지우는 법까지 알려 줬어요.

이미 프로젝트의 .claude 폴더에 스킬·훅을 만들어 둔 분은 문서의 “기존 .claude/ 설정 변환” 부분대로 옮기면 돼요. 옮기면 스킬 이름 앞에 플러그인 이름이 붙는다는 점만 달라요. 남에게 나눠 줄 때는 폴더나 zip 을 그대로 건네도 되고, 내 마켓플레이스(marketplace.json)을 만들어 올리거나 Anthropic 디렉터리에 낼 수도 있어요. 더 큰 플러그인은 공식 마켓플레이스의 plugin-dev 플러그인을 깔고 /plugin-dev:create-plugin 으로 Claude 와 같이 만들 수 있다고 적혀 있어요.

플러그인에는 화면에 창을 그리고 명령을 더하는 JavaScript 훅 묶음(mod)도 넣을 수 있어요. 문서에 따로 큰 항목이 있어서 이 글에서는 이름만 적어요.

막힐 때

문서의 문제 해결 쪽에서 처음 쓰는 분이 자주 만날 만한 것만 골랐어요.

이런 글이 나오면	이유	이렇게
The term ‘/plugin’ is not recognized	/plugin 을 PowerShell 에 쳤음	claude 로 켠 뒤 대화 창에 치거나, claude plugin install 을 씀
/plugin isn’t available in this environment	claude -p·데스크톱 앱·클라우드 세션처럼 /plugin 창을 못 그리는 곳	터미널에서 claude plugin 명령, 데스크톱은 + 의 Plugins
not found in marketplace	공식 마켓플레이스를 아직 안 더함, 이름 오타, 목록이 낡음	marketplace list 에 공식 마켓플레이스가 없으면 marketplace add 부터, 있으면 marketplace update 뒤 다시
not found in any marketplace	@마켓플레이스 없이 쳤는데 더해 둔 마켓플레이스에 없음	@마켓플레이스 를 붙이거나 그 마켓플레이스부터 더함
error: unknown command ‘add’	claude plugin add 라는 명령은 없음	마켓플레이스는 marketplace add, 플러그인은 install
깔았는데 / 에 안 보임	아직 안 불러왔거나 불러오다 실패	/reload-plugins, /plugin 의 Errors 탭
claude-plugins-official 이 없음	대화형 세션을 한 번도 안 켰거나 회사 설정이 막음	claude plugin marketplace add anthropics/claude-plugins-official

출처: 클로드 코드 문서 plugins/troubleshooting·install. 10월 9일 확인.

테스트 폴더에서 일부러 두 가지를 틀려 본 화면이에요. 매니페스트의 name 에 띄어쓰기를 넣었더니 검사에서 걸렸고, 마켓플레이스에 없는 이름을 깔려 하니 not found 와 함께 목록을 새로 받아 보라는 안내가 나왔어요.

오류 문구에 나온 kebab-case 는 단어 사이를 띄어 쓰는 대신 my-plugin 처럼 하이픈으로 연결하는 형식이에요.

코덱스·안티그래비티는

다른 터미널 코딩 도구도 플러그인을 받아요. 묶는 것과 여는 창은 비슷하고, 마켓플레이스를 다루는 방법이 달라요.

무엇	클로드 코드	코덱스 CLI	안티그래비티 CLI
안에서 여는 창	/plugin	/plugins	/plugin (/plugins 도 됨)
터미널에서 깔기	claude plugin install	codex plugin add	agy plugin install
묶는 것	스킬·에이전트·훅·MCP·LSP 서버 등	스킬·MCP 서버·브라우저 확장·훅	스킬·에이전트·규칙·MCP 서버·훅
다른 마켓플레이스 더하기	claude plugin marketplace add	codex plugin marketplace add	마켓플레이스 이름은 공식(antigravity-plugins-official)만, 깃허브 주소·내 폴더로는 직접 깔기
폴더 전용으로 켜기	--scope project(.claude\settings.json)	.codex\config.toml 에 enabled(믿는 프로젝트만)	작업 폴더 .agents\plugins\ 에 두기
깐 뒤 반영	/reload-plugins 또는 다음 실행	새 세션부터	미확인
자동 업데이트	공식 마켓플레이스는 켜짐, 남의 마켓플레이스는 꺼짐	미확인(마켓플레이스를 새로 받는 upgrade 명령은 있음)	안내 없음(앱 Antigravity 2.0 에서 깐 것이 CLI 목록에 자동으로 뜬다는 안내만)

출처: 클로드 코드 문서 plugins/install·overview, OpenAI 코덱스 문서 Plugins·Command line options·Package your plugin, 안티그래비티 문서 Plugins·Marketplace·CLI features. 10월 8일 확인.

코덱스는 ChatGPT 와 코덱스가 공개 플러그인 목록 하나를 같이 쓴다고 적었어요. 그래서 ChatGPT 웹·데스크톱·휴대폰 앱에서도 플러그인을 깔 수 있고, 코덱스 CLI 에는 /plugins 창이 있어요. IDE 확장은 플러그인을 받지 않는다고 적혀 있어요. 깐 플러그인의 스킬은 새 대화나 새 CLI 세션부터 쓸 수 있어요. 개발자 안내에는 클로드 쪽 형식의 매니페스트와 .claude-plugin\marketplace.json 도 읽는다는 부분이 있는데, 이건 ChatGPT 데스크톱 앱 얘기로 적혀 있고 CLI 도 같은지는 확인하지 못했어요. 처음 쓰는 법은 코덱스 CLI 사용법 글, MCP 는 코덱스 CLI MCP 글에 있어요.

안티그래비티 CLI 문서는 깐 플러그인을 홈 폴더의 .gemini\antigravity-cli\plugins\ 아래에 둔다고 적었고, 플러그인 문서는 손으로 넣을 때의 전역 위치를 .gemini\config\plugins\ 로 적었어요(마켓플레이스 문서의 창 그림 속 경로도 이쪽). 두 위치가 어떻게 나뉘는지는 문서에서 찾지 못했어요. 마켓플레이스 이름은 공식 하나만 받는다고 적혀 있어요. 받은 프로그램 도움말에는 제미나이 CLI 나 클로드 쪽 플러그인을 가져오는 import 명령도 있었어요(안티그래비티 CLI 사용법 글). 플러그인 속 MCP 서버 얘기는 안티그래비티 CLI MCP 글에 있어요.

제 생각에는 마켓플레이스를 여럿 다뤄야 한다면 클로드 코드와 코덱스가 편하고, 공식 목록 안에서 고르기만 할 거라면 셋 다 비슷해요. 세 도구 모두 플러그인 속 훅·서버가 내 컴퓨터에서 돈다는 점은 같으니, 어느 쪽이든 깔기 전에 든 것을 한 번 보는 습관이 제일 중요해요. 세 도구를 한 번에 비교한 글은 클로드 코드·코덱스·제미나이 CLI 비교 글이에요.

한국에서 되나

질문	답
한국에서 되나	됨(Anthropic 지원 국가 목록에 South Korea)
무슨 요금제	클로드 코드를 쓰는 요금제. 플러그인만 따로 막는 요금제 안내는 문서에 없음
한국어 문서	있음(code.claude.com/docs/ko/plugins/overview 등)
클라우드 세션(claude.ai/code)	내 컴퓨터에 깐 플러그인·저장소 설정의 플러그인을 읽지 않음
버전 번호	마켓플레이스 더하며 깔기(--marketplace) 2.1.275, claude.ai 에서 오는 플러그인 2.1.273 부터

출처: 클로드 코드 문서 plugins/install, anthropic.com 지원 국가 목록. 10월 8일 확인.

플러그인 속 MCP 서버가 붙는 바깥 서비스가 한국에서 되는지, 그 서비스에 따로 가입이나 요금이 필요한지는 서비스마다 봐야 해요. 회사 계정이라면 관리자가 마켓플레이스를 막거나 정해 둔 플러그인을 강제로 켤 수 있다고 문서에 적혀 있어요.

다음에 볼 글

플러그인 없이 스킬 하나부터 만들어 보려면 스킬 만들기 글, 플러그인 속 훅이 무엇을 하는지 읽으려면 훅 글, 서브에이전트는 서브에이전트 글이에요. 클로드 앱의 스킬은 클로드 스킬 글에 따로 있어요. 클로드 코드를 아직 깔지 않았다면 윈도우 설치 글, 처음 쓰는 법은 클로드 코드 사용법 글부터 보면 돼요. 나머지 요령은 사용량 아끼는 법 모음에 차례로 있어요.

이 글의 내용은 2026년 10월 8일, 클로드 코드 2.1.292 기준이에요. 플러그인 쪽은 버전마다 명령과 문구가 자주 늘고 있어요. 글과 다르게 보이면 공식 문서의 지금 내용을 먼저 보세요.

같이 보면 좋은 글: 클로드 코드 MCP 서버 연결하는 법: claude mcp add 부터 .mcp.json 까지

같이 보면 좋은 글: 클로드 코드 사용량 아끼는 법: 대화·캐시·서브에이전트부터 스킬·훅·권한 설정까지

같이 보면 좋은 글: AI 비교 2026: 클로드·챗GPT·제미나이 요금제·한도·기능 표

같이 보면 좋은 글: 클로드 코드 깃 커밋·PR 맡기는 법: 연습 폴더부터 /diff·push 막기·서명 줄까지

같이 보면 좋은 글: 클로드 코드 플러그인 마켓플레이스 만들기: marketplace.json 쓰고 팀에 공유하기, 버전·이름 바꾸기까지

같이 보면 좋은 글: 클로드 코드 LSP 플러그인 사용법: 고친 코드 오류 바로 보기, 설치부터 .lsp.json 까지

같이 보면 좋은 글: 클로드 코드 /security-review 사용법: 보안 검토 한 줄부터 깃허브 PR 자동 검사까지

참고한 자료

2026년 10월 8일에 확인했어요. 클로드 코드 문서는 영어 문서와 한국어 문서(/docs/ko/)를 같이 봤어요.

• Plugins overview (클로드 코드 공식 문서, 플러그인이 뭔지·켜 둔 플러그인이 더하는 것·마켓플레이스 등급·설치 범위)
• Install and manage plugins (클로드 코드 공식 문서, 깔기 단계·범위·마켓플레이스 더하기·관리·업데이트)
• Anthropic’s marketplaces (클로드 코드 공식 문서, 공식·커뮤니티·데모 마켓플레이스)
• Plugin security and trust (클로드 코드 공식 문서, 플러그인이 할 수 있는 것·검토 순서·지우기)
• Create a Claude Code plugin (클로드 코드 공식 문서, 첫 플러그인·폴더 구조·--plugin-dir·plugin init)
• Plugin loading reference (클로드 코드 공식 문서, 자동 업데이트 때)
• Marketplace reference (클로드 코드 공식 문서, 묶어 둔 이름)
• Troubleshoot plugins (클로드 코드 공식 문서, 오류 문구)
• Supported countries (Anthropic, South Korea)
• Plugins (OpenAI 코덱스 공식 문서, /plugins 창·새 세션부터·IDE 확장 안 됨)
• Command line options (OpenAI 코덱스 공식 문서, codex plugin·codex plugin marketplace)
• Package your plugin (OpenAI 개발자 문서, 마켓플레이스 파일 위치·저장소별 켜기)
• Plugins (안티그래비티 공식 문서, 폴더 구조·손으로 넣는 위치)
• Marketplace (안티그래비티 공식 문서, /plugin 창·agy plugin)
• Antigravity CLI features (안티그래비티 공식 문서, 깐 플러그인 위치)