muaco Tech Note

Claude Codecode.claude.com

Claude Code 플러그인 설치와 사용/plugin으로 찾고 켜고 끄기

Claude Code에서 /plugin 한 줄로 공식 마켓플레이스의 플러그인을 찾아 설치하고, 켜고 끄고 지우는 방법까지 차례로 따라 합니다.

안녕하세요, muaco입니다.

이 글로 할 수 있는 일

이 글을 끝까지 따라 하면 Claude Code에 플러그인 하나를 설치하고 새로 생긴 명령을 직접 불러 볼 수 있습니다. 필요 없어지면 끄거나 지우는 방법까지 다룹니다.

플러그인은 여러 기능을 한 상자에 담은 묶음입니다. 상자 안에는 다음 네 가지가 들어갈 수 있습니다.

  • 스킬: 필요할 때 Claude가 꺼내 읽는 작업 설명서
  • 에이전트: 일을 나눠 맡기는 보조 AI
  • 훅: 정해진 순간마다 자동으로 도는 명령
  • MCP 서버: Claude에게 새 도구를 붙여 주는 연결 장치

예제로는 Anthropic 공식 마켓플레이스의 commit-commands를 씁니다. 커밋, 푸시, 풀 리퀘스트 열기 같은 명령을 더해 주는 플러그인입니다. 설명은 2026년 9월 공식 문서 기준입니다.

시작 전에 갖출 것

  • Claude Code가 설치된 컴퓨터. 터미널(글자로 명령을 쳐서 컴퓨터를 다루는 창)에서 claude를 쳤을 때 대화 화면이 떠야 합니다.
  • 터미널에서 여는 대화형 세션. /plugin 패널은 터미널 안에서만 그려집니다. 데스크톱 앱과 VS Code에는 각자의 설치 화면이 따로 있습니다.
  • 인터넷 연결. 플러그인 목록과 파일을 GitHub 같은 곳에서 받아 옵니다.

요금제에 따른 제한은 문서에 나와 있지 않습니다. 위 세 가지가 갖춰졌다면 바로 시작해도 됩니다.

먼저 알아 둘 마켓플레이스

도서관에 가면 책을 찾기 전에 도서 목록부터 봅니다. 목록에는 책 제목과 꽂혀 있는 서가가 적혀 있을 뿐, 책 자체는 없습니다. 플러그인에도 이런 목록이 있고 이를 마켓플레이스라고 부릅니다.

그래서 설치 명령은 플러그인이름@마켓플레이스이름 모양입니다. 어느 목록에서 찾을지까지 함께 알려 주는 셈입니다. 공식 마켓플레이스의 이름은 claude-plugins-official이고 터미널에서 대화형 세션을 처음 열 때 Claude Code가 알아서 등록합니다.

하나 헷갈리기 쉬운 곳이 있습니다. 웹사이트 claude.com/marketplace는 둘러보는 가게이고 Claude Code에 추가하는 마켓플레이스와는 다릅니다.

따라 하기: 설치부터 확인까지

준비

따라 하기
  1. 작업할 폴더에서 터미널을 열고 claude를 입력합니다. 입력 칸이 있는 대화 화면이 뜨면 세션이 열린 상태입니다.
  2. 대화 입력 칸에 /plugin을 치세요. 패널이 열리고 Discover 탭에 플러그인 목록이 보이면 공식 마켓플레이스가 제대로 등록된 상태입니다.

설치

따라 하기
  1. 입력 칸에 /plugin install commit-commands@claude-plugins-official을 입력합니다. 바로 설치되지는 않고 그 플러그인의 상세 창이 열립니다. 설치 전에 한 번 살펴보라는 뜻입니다.
  2. 상세 창의 Will install 항목에서 무엇이 더해지는지 읽으세요. 공식 마켓플레이스 플러그인이라면 Context cost에 토큰 추정치 두 개가 보입니다. Every turn은 메시지를 보낼 때마다 더해지는 양이고, When invoked는 스킬이나 에이전트를 불러 쓸 때 더해지는 양입니다.
  3. 출처를 모르는 마켓플레이스의 플러그인이라면 이 창을 끝까지 읽고 설치 여부를 정하세요. 플러그인은 설치한 사람의 권한으로 명령을 실행합니다.
  4. 설치 범위를 셋 중 하나로 고릅니다. 혼자 모든 프로젝트에서 쓰려면 Install for you (user scope)를 누르세요. 이 폴더에서만 쓰려면 Install for you, in this repo only (local scope)입니다.
  5. 팀 저장소에서 project scope를 고르면 동료에게도 켜집니다. 공유 설정 파일 .claude/settings.json에 기록되고 커밋하면 동료 쪽에서도 켜집니다. 다만 파일까지 받아 주지는 않으므로 동료가 각자 claude plugin install commit-commands@claude-plugins-official --scope project를 한 번 실행해야 합니다.
  6. 설치 요약의 마지막 문장을 확인합니다. Plugin is now active.면 바로 쓸 수 있습니다. Run /reload-plugins to activate.가 보이면 Claude Code가 다시 불러오기를 대신 실행해 줍니다. 단, 다시 불러오면 프롬프트 캐시(앞서 읽은 내용을 재사용하는 저장 공간)가 무효화되는 상황이라면 경고만 띄우고 보류합니다. 이때는 /reload-plugins --force를 직접 치세요.

확인과 관리

따라 하기
  1. 입력 칸에 /만 쳐 보세요. 명령 목록에 /commit-commands:commit이 보이면 설치가 끝났습니다. 플러그인 명령은 /플러그인이름:스킬이름 모양으로 뜹니다.
  2. 세션 밖에서도 확인할 수 있습니다. 새 터미널에서 claude plugin list를 치면 Version, Scope, Status 줄과 함께 목록이 나옵니다.
  3. 잠시 끄고 싶다면 /plugin을 열고 Tab 키로 Installed 탭에 갑니다. 플러그인을 고르고 Space를 누르면 켜고 끄기가 바뀝니다.
  4. 아예 지우려면 같은 탭에서 Enter로 상세 창을 열고 Uninstall을 고르세요. 터미널에서는 claude plugin uninstall commit-commands@claude-plugins-official로도 됩니다. 이 명령은 기본값이 user scope라서 다른 범위로 설치했다면 끝에 --scope local이나 --scope project를 붙이세요.
  5. 팀 저장소가 켜 둔 플러그인은 바로 지우지 마세요. Uninstall을 고르면 나만 끌지(y), 모두에게서 지울지(u) 묻습니다. 나만 안 쓰려면 y를 누르세요.

막히기 쉬운 다섯 군데

zsh: no such file or directory: /plugin

보이는 것: /plugin을 쳤는데 이 문장이 뜹니다. bash라면 bash: /plugin: No such file or directory입니다.

왜: Claude Code 세션이 아니라 셸 프롬프트(터미널의 맨 처음 입력 줄)에 쳤기 때문입니다. 셸은 /plugin을 파일 경로로 읽습니다.

어떻게: 먼저 claude로 세션을 연 다음 그 안에서 다시 치세요. 세션 없이 설치하려면 셸에서 claude plugin install commit-commands@claude-plugins-official을 입력합니다.

Marketplace "claude-plugins-official" not found

보이는 것: 설치 명령을 쳤더니 그런 마켓플레이스가 없다고 나옵니다.

왜: 공식 마켓플레이스가 이 컴퓨터에 아직 등록되지 않았습니다. VS Code 확장으로만 Claude Code를 써 왔거나, 회사 정책이 막았거나, 앞선 등록이 실패해 재시도를 기다리는 경우입니다.

어떻게: 세션에서 /plugin marketplace add anthropics/claude-plugins-official을 칩니다. Successfully added marketplace: claude-plugins-official이 뜨면 설치 명령을 다시 입력하세요.

/plugin isn't available in this environment

보이는 것: 패널이 열리지 않고 Claude가 이 한 줄로 답합니다.

왜: 패널을 그릴 터미널이 없는 곳이기 때문입니다. claude -p로 돌리는 비대화형 실행, 데스크톱 앱의 Code 탭, 브라우저의 claude.ai/code가 여기에 해당합니다. VS Code 패널에서도 /plugin 뒤에 무언가를 붙여 치면 같은 답이 나옵니다.

어떻게: 데스크톱 앱이라면 입력 칸 옆 + 버튼에서 Plugins, Add plugin을 차례로 누르세요. VS Code에서는 /plugins만 치면 Manage plugins 창이 열립니다. claude.ai/code 같은 클라우드 세션에는 플러그인 브라우저가 없고 내 컴퓨터에 설치한 플러그인도 불러오지 않습니다. 터미널을 쓸 수 있는 컴퓨터에서 설치하세요.

claude: command not found

보이는 것: claude plugin ...을 쳤더니 claude라는 명령 자체를 못 찾습니다. Windows에서는 "is not recognized"로 끝나는 문장이 뜹니다.

왜: 플러그인 문제가 아닙니다. Claude Code가 설치되지 않았거나, 설치 폴더가 PATH(터미널이 명령을 찾아보는 폴더 목록)에 없습니다.

어떻게: Claude Code 설치 문서의 문제 해결 항목을 먼저 따라 하세요. claude만 쳐서 세션이 열리면 플러그인 명령을 다시 실행합니다.

설치했는데 /commit-commands:commit이 안 뜹니다

보이는 것: 설치는 끝났는데 /를 쳐도 플러그인 명령이 목록에 없습니다.

왜: 플러그인이 꺼져 있거나, 불러오다 오류가 났거나, 이번 세션에서 아직 다시 불러오지 않은 상태입니다.

어떻게: /plugin의 Installed 탭에서 켜져 있는지 보고 Errors 탭에 적힌 사유를 읽으세요. 오류가 없다면 /reload-plugins를 칩니다. Reloaded:로 시작하는 줄이 뜨면 다시 /를 쳐 보세요.

여기서 더 나아가려면

켜 둔 플러그인은 쓰지 않는 대화에서도 이름과 설명만큼 토큰을 차지합니다. 가끔 Installed 탭의 Not used recently 묶음을 열어 안 쓰는 플러그인을 꺼 두세요.

동료가 보내 준 설치 줄의 @ 뒤 이름이 공식이 아니라면 그 마켓플레이스부터 추가해야 합니다. 형식은 /plugin marketplace add 소유자/저장소입니다. Claude Code v2.1.275 이상에서는 /plugin install 이름 --marketplace 소유자/저장소 한 줄로 추가와 설치를 함께 할 수 있습니다.

이상으로 글 마치겠습니다.

출처

#Claude Code#플러그인#마켓플레이스#확장#설치 가이드#스킬#MCP

같은 분류의 글