Claude Code 완벽 가이드 (2) - 커스텀 명령어부터 고급 활용까지

지난 글에서는 Claude Code의 설치와 기본 기능을 다뤘습니다.

Claude Code 완벽 가이드 (1) - 설치부터 기본 기능까지

이번 글에서는 Claude Code를 더 강력하게 만들어주는 중급 기능들을 알아보겠습니다. 마지막에는 Claude Code를 만든 보리스 체르니(Boris Cherny)가 직접 공개한 활용법도 소개해 드릴게요.

---

중급 기능

커스텀 슬래시 명령어

반복적으로 사용하는 프롬프트가 있다면, 커스텀 명령어로 만들어두면 편합니다.

설정 방법

프로젝트 루트에 .claude/commands/ 폴더를 만들고, 마크다운 파일을 추가합니다.

.claude/
└── commands/
    ├── review.md
    ├── test.md
    └── commit.md

예시: review.md

# Code Review

방금 수정한 파일들을 검토해줘.

## 확인 사항
1. 보안 취약점은 없는지
2. 에러 핸들링이 제대로 되어 있는지
3. 성능 이슈는 없는지
4. 코드 스타일이 일관적인지

문제가 있으면 수정해줘.

예시: commit.md

# Commit and Push

1. 변경된 파일들을 확인해줘
2. 의미 있는 커밋 메시지를 작성해줘 (한국어)
3. 커밋하고 현재 브랜치에 푸시해줘

 

이렇게 만들어두면 /review, /commit으로 바로 호출할 수 있습니다.

예시: cm.md (Commit 을 위한 메시지 만들기)

# commit message

Generate a concise one-line commit message in English.
1. Run `git diff --cached --stat` to check staged files
2. If no staged files, run `git diff --stat` to check unstaged changes
3. Analyze the changes and generate a commit message following this format:
   - Start with a verb (Add, Fix, Update, Remove, Refactor, etc.)
   - Keep it under 50 characters
   - Be specific but concise
4. Output ONLY the commit message, nothing else

인자 받는 명령어

명령어에 인자를 전달할 수도 있습니다.

# API Endpoint 생성

$ARGUMENTS에 대한 API 엔드포인트를 생성해줘.

## 포함 사항
- 타입 정의
- 에러 핸들링
- 미들웨어 적용

사용할 때

/api-endpoint 사용자 프로필 조회

그러면 $ARGUMENTS 자리에 "사용자 프로필 조회"가 들어갑니다.

서브에이전트 (Sub-agents)

서브에이전트는 특정 역할에 특화된 별도의 Claude 인스턴스입니다.

왜 필요한가요?

• 메인 Claude의 컨텍스트를 오염시키지 않음
• 각 서브에이전트가 독립적인 컨텍스트를 가짐
• 병렬로 여러 작업을 동시에 처리 가능

서브에이전트 만들기

방법 1: /agents 명령어 사용

/agents
→ Create new agent 선택
→ Project 또는 Personal 선택
→ Generate with Claude 선택
→ 원하는 에이전트 설명 입력

 

방법 2: 직접 파일 생성

.claude/agents/ 폴더에 마크다운 파일을 만듭니다.

.claude/
└── agents/
    ├── code-reviewer.md
    ├── test-writer.md
    └── ui-checker.md

예시: code-reviewer.md

# Code Reviewer

당신은 시니어 개발자로서 코드 리뷰를 담당합니다.

## 역할
- 방금 작성된 코드를 검토
- 버그 가능성 체크
- 성능 이슈 확인
- 보안 취약점 검토

## 규칙
- 문제가 있으면 구체적으로 지적
- 개선 방안도 함께 제시
- 칭찬할 부분은 칭찬

예시: ui-checker.md

# UI/UX Checker

당신은 UI/UX 전문가입니다.

## 역할
- Playwright MCP를 사용하여 브라우저에서 앱 확인
- UI 컴포넌트의 디자인과 사용성 평가
- 접근성 이슈 체크

## 도구
- Playwright MCP 사용 가능

서브에이전트 호출

@code-reviewer 방금 수정한 파일들 검토해줘
@ui-checker 로그인 페이지 UI 확인해줘

 

병렬 실행

서브에이전트의 진짜 힘은 병렬 실행에서 나옵니다.

4개의 서브에이전트를 띄워서 각각 다음 작업을 병렬로 처리해줘:
1. @code-reviewer - 코드 리뷰
2. @test-writer - 테스트 코드 작성
3. @ui-checker - UI 확인
4. @doc-writer - 문서화

 

Hooks - 자동 실행 스크립트

Hooks는 특정 이벤트가 발생했을 때 자동으로 실행되는 스크립트입니다.

설정 위치: .claude/settings.json

사용 가능한 이벤트

이벤트	설명
stop	Claude가 응답을 완료했을 때
afterToolUse	도구(파일 수정 등)를 사용한 후
beforeToolUse	도구를 사용하기 전

예시 1: 작업 완료 알림

{
  "hooks": {
    "stop": [
      {
        "matcher": "",
        "command": "osascript -e 'display notification \"작업 완료!\" with title \"Claude Code\"'"
      }
    ]
  }
}

예시 2: 소리 알림

{
  "hooks": {
    "stop": [
      {
        "matcher": "",
        "command": "afplay /System/Library/Sounds/Glass.aiff"
      }
    ]
  }
}

예시 3: 파일 수정 후 자동 포매팅

{
  "hooks": {
    "afterToolUse": [
      {
        "matcher": "write|edit",
        "command": "npx prettier --write \"$CLAUDE_FILE_PATH\" 2>/dev/null || true"
      }
    ]
  }
}

파일을 수정할 때마다 자동으로 Prettier가 실행됩니다.

예시 4: 파일 생성 후 자동 스테이징

{
  "hooks": {
    "afterToolUse": [
      {
        "matcher": "write",
        "command": "git add \"$CLAUDE_FILE_PATH\""
      }
    ]
  }
}

MCP 서버 연동

MCP(Model Context Protocol)는 Claude에게 외부 도구를 연결해주는 방식입니다.

MCP로 할 수 있는 것들

• 데이터베이스 직접 조회/수정
• 브라우저 제어 (Playwright)
• 외부 API 호출
• 문서 검색

MCP 서버 추가 방법

claude mcp add <server-name> -- <command>

예시: Context7 (최신 문서 참조)

claude mcp add context7 -- npx -y @anthropics/context7-mcp

 

Context7을 추가하면 Claude가 최신 라이브러리 문서를 참조할 수 있습니다.

Next.js 14 App Router에서 서버 컴포넌트 만들어줘. use context7

"use context7"을 붙이면 Claude가 자동으로 최신 문서를 찾아서 참고합니다.

자주 쓰는 MCP 서버들

MCP 서버	용도
Context7	최신 라이브러리 문서 참조
Playwright	브라우저 제어, UI 테스트
Supabase	데이터베이스 조회/수정
GitHub	저장소 관리, PR 생성
Stripe	결제 관련 기능

MCP 설정 파일

프로젝트 루트에 .mcp.json 파일이 생성됩니다.

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@anthropics/context7-mcp"]
    },
    "playwright": {
      "command": "npx",
      "args": ["@anthropics/playwright-mcp"]
    }
  }
}

 

MCP 상태 확인

claude mcp status

또는 Claude Code 안에서

/mcp

 

Output Style - 응답 스타일 커스텀

Claude의 응답 스타일을 바꿀 수 있습니다.

/output-style

 

기본 제공 스타일

1. Default - 간결한 응답
2. Detailed - 부연 설명 포함
3. Learning - 학습용 (왜 이렇게 하는지 설명)

커스텀 스타일 만들기

/output-style new

응답할 때 이모지를 적극적으로 사용하고, 
친근한 말투로 설명해줘. 
코드에는 한국어 주석을 달아줘.

생성된 스타일은 .claude/output-styles/ 폴더에 저장됩니다.

권한 설정

Claude Code가 어떤 명령어를 실행할 수 있는지 제어할 수 있습니다.

설정 위치: .claude/settings.json

{
  "permissions": {
    "allow": [
      "npm run",
      "npm test",
      "git status",
      "git add",
      "git commit",
      "git push",
      "npx prettier",
      "npx eslint"
    ],
    "deny": [
      "rm -rf",
      "sudo",
      "chmod"
    ]
  }
}

 

allow에 등록된 명령어

• 확인 없이 바로 실행

deny에 등록된 명령어

• 절대 실행하지 않음

등록되지 않은 명령어

• 매번 사용자에게 확인 요청

주의: --dangerously-skip-permissions

claude --dangerously-skip-permissions

이 옵션을 쓰면 모든 권한 확인을 건너뜁니다. 편하긴 하지만 위험할 수 있어요.

쓰려면 Dev Container 안에서 쓰는 걸 추천합니다. (보리스 체르니도 이렇게 씁니다)

---

보리스 체르니의 Claude Code 활용법

여기서부터는 Claude Code를 만든 보리스 체르니(Boris Cherny)가 직접 공개한 활용법입니다. 2026년 1월 X(트위터)에 올린 글이 620만 조회를 기록하며 큰 화제가 됐어요.

1. 병렬 실행 - 5개 이상의 Claude를 동시에

보리스는 기본적으로 5개의 Claude를 로컬 터미널에서 동시에 실행합니다. 여기에 웹 세션 5~10개를 추가로 사용한다고 해요.

iTerm2 설정 (macOS)

iTerm2 → Preferences → Profiles → Terminal
✅ "Silence bell" 체크 해제
✅ "Send Notification Center alerts" 체크

 

이렇게 하면 Claude가 입력을 기다릴 때 알림이 옵니다.

창 분할

Cmd + D        # 수직 분할
Cmd + Shift + D  # 수평 분할

각 창에서 다른 작업을 시킵니다.

• 창 1: 테스트 작성
• 창 2: 리팩토링
• 창 3: 문서화
• 창 4: 버그 수정
• 창 5: 새 기능 개발

혼자서 소규모 팀처럼 일할 수 있습니다.

2. 가장 똑똑한 모델 사용 - Opus 4.5

보리스는 항상 Claude Opus 4.5를 사용합니다.

 " Sonnet보다 크고 느리긴 하지만, 직접 조작할 필요가 적고 도구 활용 능력이 뛰어나서 결과적으로 더 빠르다 " 

/config
→ Model → Claude Opus 4.5 선택
→ Thinking → 활성화

 

핵심 포인트

• 빠른 모델보다 똑똑한 모델
• AI의 병목은 토큰 생성 속도가 아니라, AI 오류를 수정하는 인간의 시간
• 처음에 좀 더 시간을 들여도 수정 비용을 줄이는 게 이득

3. CLAUDE.md 팀 공유

보리스 팀은 CLAUDE.md를 Git에 커밋해서 공유합니다.

핵심 규칙

• Claude가 실수할 때마다 CLAUDE.md에 규칙 추가
• 팀원 모두가 적극적으로 CLAUDE.md 개선에 참여
• 팀별로 각각의 CLAUDE.md 관리

# 실수 기록

## 2025-01-15
- ❌ Prisma migrate 전에 db push 먼저 해야 함
- 이유: 스키마 변경 시 데이터 손실 방지

## 2025-01-16
- ❌ API 라우트에서 try-catch 빠뜨리지 말 것
- 이유: 에러 시 500 대신 적절한 에러 메시지 반환 필요

이렇게 하면 Claude가 같은 실수를 반복하지 않습니다.

4. 커스텀 명령어와 서브에이전트 활용

보리스가 자주 쓰는 명령어

/commit-push-pr

Git 버전 관리 전체를 Claude가 자동으로 처리합니다.

서브에이전트

• code-simplifier: 코드 정리 및 최적화
• verify-app: 앱 테스트 및 검증

5. 권한 설정 - dangerously-skip-permissions 안 씀

보리스는 --dangerously-skip-permissions를 쓰지 않습니다. 대신 필요한 명령어들을 permissions 설정에 미리 등록해둡니다.

{
  "permissions": {
    "allow": [
      "npm run",
      "git status",
      "git add",
      "git commit",
      "git push",
      "prisma db push"
    ]
  }
}

그리고 이 설정을 팀과 공유합니다.

6. 검증 루프 - 가장 중요한 요소

 " 훌륭한 결과를 얻기 위한 가장 중요한 요소는 Claude가 자신의 작업을 검증할 방법을 제공하는 것 " 

보리스는 Claude에게 검증 방법을 명확히 알려줍니다.

CLAUDE.md에 추가

# 검증 규칙

모든 코드 변경 후:
1. npm run build 실행하여 빌드 확인
2. npm run test 실행하여 테스트 통과 확인
3. 실패 시 자동으로 수정 시도
4. 브라우저에서 직접 확인 필요하면 Playwright 사용

이런 피드백 루프를 갖추면 결과 품질이 2~3배 향상된다고 합니다.

---

유용한 도구들

Claude Code를 더 잘 쓸 수 있게 도와주는 도구들입니다.

ccusage - 사용량 확인

Claude Code를 얼마나 썼는지 확인할 수 있습니다.

npx ccusage@latest

일별 토큰 사용량, 비용을 시각적으로 보여줍니다.

Super Claude - 올인원 플러그인

여러 유용한 슬래시 명령어와 페르소나가 미리 구축되어 있습니다.

npm install -g @bifrost_inc/superclaude && superclaude install

 

특징

• 개발 관련 슬래시 명령어 모음
• 상황별 페르소나 자동 전환 (아키텍트, 프론트엔드, 백엔드 등)

Claude Code Templates

원하는 기능만 골라서 설치할 수 있는 템플릿 마켓플레이스입니다.

웹사이트: aitemplate.com

사용 방법

1. 웹사이트에서 원하는 템플릿 선택
2. "Add to Stack" 버튼으로 장바구니에 추가
3. 생성된 설치 명령어 복사
4. 프로젝트에서 실행

npx claude-templates install hooks/auto-format hooks/git-add commands/review

---

마무리

이번 글에서 다룬 내용을 정리하면

1. 커스텀 명령어: .claude/commands/에 마크다운 파일로 저장
2. 서브에이전트: .claude/agents/에 역할별 에이전트 정의
3. Hooks: 특정 이벤트 발생 시 자동 실행
4. MCP: 외부 도구 연결 (DB, 브라우저, API 등)
5. Output Style: 응답 스타일 커스터마이징
6. 권한 설정: allow/deny로 명령어 제어

보리스 체르니 방식:

• 여러 Claude 병렬 실행
• 가장 똑똑한 모델 사용
• 검증 루프 구축

직접 써보면서 자신만의 워크플로우를 만들어 보세요.

---

참고

• Claude Code 공식 문서
• Claude Code Templates