claude-code-setup 플러그인 사용법: 클로드 코드 세팅·자동화 추천, 결제 웹앱으로 없이·있이 비교하니 14점 중 6~7점 대 9~10점

클로드 코드를 한동안 쓰다 보면 훅, 스킬, MCP 서버, 서브에이전트 가운데 내 프로젝트에 무엇을 붙여야 할지 막힙니다. claude-code-setup(클로드 코드 셋업)은 Anthropic 공식 플러그인 디렉터리에 있는 플러그인으로, 프로젝트 파일을 읽고 붙일 만한 자동화를 갈래별로 추천해 줍니다. 플러그인은 무료지만 쓸 때 클로드 사용량이 듭니다. 가상의 동네 카페 주문·결제 웹앱을 만들고 같은 요청을 플러그인 없이 두 번, 있이 두 번 보내 14개 기준으로 채점했습니다.

결과부터 보기: 같은 요청, 네 번의 추천

영상은 실습 프로젝트, 넷 다 짚은 고장 난 훅과 확인 결과, 갈래별 추천 비교, 채점 결과 순서입니다.

직접 눌러 보기: 네 번의 답 전문과 클로드가 쓴 도구 목록 열어 보기

따라 해 보기: 요청문과 실습 재료

프로젝트 폴더에서 클로드 코드를 열고, 플러그인을 깐 뒤 아래 요청을 보내면 됩니다. 클로드 코드가 처음이라면 클로드 코드 설치 방법을 먼저 보세요. 실습 재료(zip)에는 가상 카페 주문·결제 웹앱(가짜 키가 든 .env, 고장 난 서식 훅 포함), 요청문, 채점 기준을 넣었습니다.

이 프로젝트에 클로드 코드 자동화를 붙이고 싶어. 뭘 쓰면 좋을지 추천해 줘.

좋은 답이라면 프로젝트 구성을 먼저 요약하고, 훅·스킬·MCP 서버·서브에이전트 갈래마다 1~2개씩 이 프로젝트의 파일을 근거로 추천합니다. 파일은 만들거나 고치지 않습니다.

claude-code-setup 플러그인에 들어 있는 것

claude plugin details로 뽑은 구성은 스킬 1개(claude-automation-recommender, 자동화 추천기)입니다. 명령·에이전트·훅·MCP 서버는 없습니다. 깔아 두기만 해도 매 대화에 약 141토큰이 들어가고, 스킬이 불릴 때 약 4,100토큰이 더 들어갑니다.

들어 있는 것	내용
스킬 본문(SKILL.md)	“자동화 추천해 줘”, “클로드 코드 세팅 도와줘” 같은 요청에 불림. 프로젝트 파일 살펴보기 → 갈래별 추천 → 정해진 꼴의 보고서 순서
참고 자료 5개	훅 예시 모음, MCP 서버 목록, 스킬 목록, 서브에이전트 틀, 플러그인 목록
지켜야 할 규칙	읽기 전용(파일을 만들거나 고치지 않음), 갈래마다 1~2개만, 참고 목록 밖은 웹 검색으로 넓히기, 끝에 “갈래를 정해 더 요청하라”는 안내

스킬 본문에는 “Prettier가 있으면 수정 뒤 자동 서식 훅”, “.env가 있으면 .env 수정 막는 훅”, “결제 코드가 있으면 보안 검토 서브에이전트”처럼 프로젝트 신호와 추천을 짝지은 표가 갈래마다 들어 있습니다. 채점 기준은 이 표와 규칙에서 뽑았습니다.

1단계. 플러그인 깔기 (약 1분)

추천받을 프로젝트 폴더에서 터미널에 아래 명령을 실행합니다. claude-plugins-official은 클로드 코드에 처음부터 등록된 공식 플러그인 저장소이고, --scope local은 이 폴더에서만 켜는 옵션입니다.

claude plugin install claude-code-setup@claude-plugins-official --scope local
claude plugin details claude-code-setup@claude-plugins-official

이렇게 나오면 성공 ✔ Successfully installed plugin: claude-code-setup@claude-plugins-official (scope: local)(플러그인 설치 성공, 범위: 이 폴더). 구성 목록에는 Skills (1) claude-automation-recommender가 나옵니다.

• 설치 명령이 플러그인을 찾지 못하면 claude plugin marketplace add anthropics/claude-plugins-official로 저장소를 등록한 뒤 다시 설치합니다.
• 클로드 앱에서는 디렉터리에서 설치합니다(디렉터리 여는 법). 이 글은 클로드 코드 터미널 기준입니다.

필요 없어지면 같은 폴더에서 아래 명령으로 지웁니다.

claude plugin uninstall claude-code-setup@claude-plugins-official --scope local

2단계. “자동화 추천해 줘” 보내기 (약 1분)

실습 프로젝트는 Next.js(넥스트JS, 웹 화면 도구), Prisma(프리즈마, 데이터베이스 도구)로 연결한 PostgreSQL(포스트그레스 데이터베이스), Stripe(스트라이프) 결제로 만든 카페 주문 웹앱입니다. ESLint(이에스린트, 코드 검사)·Prettier(프리티어, 코드 서식)·Vitest(바이테스트, 테스트)·Playwright(플레이라이트, 브라우저 테스트) 설정과 깃허브 자동 검사(GitHub Actions), 가짜 키가 든 .env, package-lock.json이 있습니다. .claude/settings.json에는 파일을 고칠 때마다 Prettier로 서식을 맞추는 훅이 이미 하나 있습니다.

플러그인을 깐 두 번은 요청을 받자마자 클로드가 스스로 자동화 추천 스킬을 불렀습니다. 명령을 따로 칠 필요가 없었습니다. 그 뒤 package.json, 설정 파일, 결제 코드를 읽고 답했습니다.

실행 기록 · 작업 폴더 · plug1 세션에서 클로드가 쓴 도구(긴 명령은 앞부분만)

Skill: claude-code-setup:claude-automation-recommender
Bash: cat package.json; ls -la; ls -la .claude 2>/dev/null; git ls-files | head -100; ls .github/workflows 2>/dev/null
Bash: for f in .claude/settings.json .claude/settings.local.json .github/workflows/ci.yml … (허용 목록 밖이라 막힘)
Bash: head -n 200 .claude/settings.json .claude/settings.local.json .github/workflows/ci.yml .gitignore …

• 이렇게 나오면 성공 답이 “프로젝트 요약”으로 시작하고, ⚡ 훅 · 🤖 서브에이전트 · 🎯 스킬 · 🔌 MCP 서버 제목 아래 추천이 1~2개씩 붙습니다. 끝에는 “파일은 바꾸지 않았다”, “훅 더 추천해 줘처럼 더 요청할 수 있다”는 말이 나옵니다.
• 스킬이 불리지 않고 평범한 답이 나오면: claude plugin list로 이 폴더에 켜져 있는지 확인합니다.

플러그인 없이·있이 비교한 결과

채점 기준 14개는 실행 전에 SKILL.md에서 뽑아 고정했고, 요청문에는 넣지 않았습니다. 스킬의 규칙 4개(읽기 전용, 갈래마다 1~2개, 추천마다 설치 방법, 더 요청하라는 안내), 프로젝트에 숨겨 둔 신호 8개, 함정 2개입니다.

기준	없이 1	없이 2	있이 1	있이 2
파일을 건드리지 않음	○	○	○	○
갈래마다 1~2개	× (새 훅 4개)	× (MCP 3개)	○	× (MCP 2개 + 선택 2개)
추천마다 설치 방법	×	×	×	×
갈래를 정해 더 요청하라는 안내	×	×	○	○
린트·타입 검사 훅	○	○	○	○
.env 수정 막는 훅	○	× (권한 규칙으로 대신)	○	○
잠금 파일(package-lock.json) 보호 훅	×	×	○	○
최신 문서 MCP(context7, 컨텍스트7)	×	×	○	○
Playwright MCP	○	○	×	○
데이터베이스 MCP	○	○	×	○
결제 보안 검토 서브에이전트	○	○	○	○
GitHub MCP·gh	×	×	×	×
이미 있는 서식 훅을 새로 추천하지 않음	○	○	○	○
.env 차단 훅을 붙여 넣을 설정으로 줌	×	×	×	×
합계(14점)	7	6	9	10
사용량(API 단가)	0.45달러	0.50달러	0.38달러	0.37달러

플러그인이 있을 때 달라진 점은 둘입니다. 하나는 스킬 표에 있는 항목이 빠짐없이 나왔다는 것입니다. 잠금 파일 보호 훅과 context7은 두 번 모두 나왔고, 플러그인 없이는 한 번도 나오지 않았습니다. 다른 하나는 답의 꼴입니다. 프로젝트 요약 → 갈래별 추천 → 우선순위 → “더 요청하라”는 안내로 정리돼, 무엇을 먼저 할지 고르기 쉬웠습니다. 플러그인 없이 받은 답은 효과가 큰 순서로 나열됐고, 권한 규칙처럼 갈래 밖 추천이 섞여 있었습니다.

넷 다 놓친 것도 있습니다. 설치 명령은 일부 추천에만 붙었고, .env를 막는 훅은 “이런 훅을 권한다”는 설명뿐이라 그대로 붙여 넣을 설정이 없었습니다. 깃허브 쪽은 세 번이 MCP 대신 클로드 깃허브 앱(자동 리뷰)을 권했고, 한 번은 추천이 없었습니다. 스킬 규칙에 있는 웹 검색은 네 번 모두 쓰지 않았습니다.

넷 다 짚은 것: 이미 있던 서식 훅이 아무 일도 안 함

실습 프로젝트의 서식 훅은 npx prettier --write "$CLAUDE_FILE_PATHS"입니다. 네 번 모두 “클로드 코드는 이런 환경변수를 넘기지 않고, 고친 파일 경로는 표준 입력(stdin)의 JSON으로 준다. 그래서 빈 경로로 실행되고, 뒤에 붙은 || true가 실패를 숨긴다”고 짚었습니다. 공식 훅 문서에도 훅이 받는 환경변수 목록에 이 이름은 없고, 입력은 stdin으로 들어온다고 적혀 있습니다.

실제로 확인했습니다. 훅 명령을 받은 값을 적어 두는 명령으로 바꾸고, 클로드에게 파일 하나를 고치게 했습니다. 그다음 네 답이 준 고친 명령에 같은 입력을 넣어 돌렸습니다(npx는 받은 인자만 적는 가짜로 바꿈).

실행 기록 · 작업 폴더 · verify-hook (경로 앞부분은 …로 줄임)

# 훅이 받은 값
CLAUDE_FILE_PATHS=[]
PostToolUse Edit …/src/app/page.tsx      ← stdin JSON의 tool_input.file_path

# 명령마다 실제로 부른 것
## original
npx prettier --write 
## none1
npx prettier --write --ignore-unknown …/src/app/page.tsx
## plug1
npx prettier --write …/src/app/page.tsx
npx eslint --fix …/src/app/page.tsx

원래 명령은 경로 없이 Prettier를 불렀고, 네 답이 준 고친 명령은 모두 고친 파일 경로를 제대로 넘겼습니다. 플러그인을 쓴 두 번은 ESLint 자동 수정까지 붙였습니다. 인터넷 예제에서 이 환경변수를 쓰는 훅을 가져왔다면 같은 방법으로 고쳐야 합니다.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write --ignore-unknown" }
        ]
      }
    ]
  }
}

위 설정은 플러그인 없이 1회차가 준 명령을 .claude/settings.json 꼴로 옮긴 것입니다. jq(JSON 처리 도구)가 깔려 있어야 합니다.

결제 코드에서 찾은 문제

보안 검토 서브에이전트를 권하면서, 네 번 모두 실제 결제 코드의 문제를 예로 들었습니다. 없는 메뉴 번호가 들어오면 서버 오류가 나고, 품절 메뉴도 주문된다는 것입니다. 플러그인 2회차는 하나를 더 찾았습니다. 할인율(coupon, 최대 50%)을 손님 쪽 요청이 정하기 때문에 “누구나 절반 가격으로 결제할 수 있다”는 지적입니다. 네 번 중 이 한 번뿐이었습니다. 코드 점검이 목적이라면 claude-security 플러그인처럼 점검 전용 도구를 쓰는 편이 맞습니다.

이런 사람에게 권합니다

• ✅ 클로드 코드를 막 세팅하는 사람. 내 프로젝트에 무엇부터 붙일지 갈래별로 정리된 목록과 우선순위를 1분 안에 받습니다.
• ✅ 훅·MCP를 몇 개 붙여 봤는데 제대로 도는지 모르는 사람. 이번처럼 이미 있는 설정의 고장도 같이 봐 줍니다(플러그인 없이 물어도 짚었습니다).
• ❌ 추천을 그대로 붙여 넣기를 바라는 사람. 설정 예시는 일부에만 나옵니다. 마음에 드는 항목을 골라 “이걸 설정해 줘”라고 한 번 더 요청해야 합니다.
• ❌ 이미 훅·MCP를 많이 쓰는 사람. 추천 목록이 기본 항목 위주라 새로 얻을 것이 적습니다.

한계와 주의할 점

• 작은 가상 프로젝트 하나로, 조건마다 두 번씩만 돌렸습니다. 파일이 수백 개인 프로젝트나 다른 언어(파이썬·자바 등)에서는 추천이 다를 수 있습니다.
• 추천받은 MCP 서버 가운데 Stripe·데이터베이스 MCP는 키나 접속 정보가 있어야 합니다. 이번에는 추천까지만 받고 설치하지 않았습니다. 연결한다면 테스트 키와 읽기 전용 계정부터 쓰라는 답의 조언이 맞습니다.
• 플러그인을 쓴 쪽이 이번에는 조금 쌌지만, 스킬이 불릴 때마다 약 4,100토큰이 더 들어갑니다. 비용 차이는 이 과제의 결과일 뿐입니다.
• 플러그인 1회차는 Playwright·데이터베이스 MCP를 빼고 context7·Stripe를 골랐습니다. 갈래마다 1~2개로 줄이다 보니 무엇이 빠질지는 실행마다 달랐습니다.

대안

방법	다른 점	이럴 때 고르세요
claude-code-setup 플러그인(이 글)	갈래별 1~2개, 정해진 꼴의 추천 목록	무엇부터 붙일지 정리된 목록이 필요할 때
말로 요청	이번 실험에서 6~7점. 권한 규칙·깃허브 자동 리뷰까지 넓게 추천	갈래에 얽매이지 않고 넓게 듣고 싶을 때
hookify 플러그인	“rm -rf 막아 줘”처럼 말로 훅 규칙을 바로 만듦	추천은 필요 없고 막을 규칙을 이미 알 때
claude-md-management 플러그인	CLAUDE.md 점검·고치기	자동화보다 프로젝트 설명서부터 다듬고 싶을 때
Context7 MCP	이번 추천에 나온 최신 문서 MCP	라이브러리 최신 사용법을 클로드에게 읽히고 싶을 때

자주 묻는 질문

claude-code-setup은 무료인가요?

플러그인 자체는 무료(Apache-2.0)입니다. 쓸 때 클로드 사용량이 들고, 구독 요금제라면 사용량 한도에서 빠집니다. 이번 과제의 사용량은 위 비교 표에 있습니다.

추천을 받으면 설정 파일이 바로 바뀌나요?

아닙니다. 스킬 규칙이 읽기 전용이라, 이번 네 번 모두 파일을 하나도 만들거나 고치지 않았습니다. 마음에 드는 항목을 골라 “이 훅을 설정해 줘”처럼 따로 요청해야 적용됩니다.

훅에서 $CLAUDE_FILE_PATHS를 쓰면 안 되나요?

이번 확인에서는 빈 값이었고, 공식 훅 문서의 환경변수 목록에도 없습니다. 고친 파일 경로는 stdin JSON의 tool_input.file_path에서 읽습니다. 위 비교 결과의 고친 설정을 참고하세요.

클로드 앱에서도 쓸 수 있나요?

플러그인 디렉터리 정보에는 클로드 코드, 코워크, claude.ai에서 쓸 수 있다고 나옵니다. 이 글은 클로드 코드에서만 돌려 봤습니다. 프로젝트 파일을 읽어야 하는 스킬이라 폴더를 여는 클로드 코드에서 쓰는 것이 자연스럽습니다.

출처

claude-code-setup 플러그인 폴더, README, SKILL.md, 클로드 코드 훅 문서, 클로드 코드 플러그인 문서 (모두 2026-10-18 확인, 저장소 별 41,972개)