my-first-plugin

Claude Code 완전 정복: 커맨드, 훅, 에이전트, 스킬, 플러그인 가이드

claude code란 Anthropic에서 만든 개발자용 AI 어시스턴트 입니다.

클로드 코드는 agent, skill, hook, command 등을 통해 보다 확장성 있는 LLM 워크플로우를 구축할 수 있도록 도와줍니다.

시작하며

이 글을 통해 클로드 코드를 활용하여 코드 생산 뿐 아니라, 나만의 개발 워크플로우를 자동화하고 싶은 개발자 또는 LLM을 터미널 환경에 깊숙이 통합하고 싶은 DevOps 엔지니어가 읽기 적합합니다.

주로 다루는 내용은 다음과 같습니다.

1. slash commands

2. hooks

3. sub agent

4. skill

5. plugin

해당 내용을 실행하기 위해선 claude code 2.x 이상의 버전이 필요합니다.

만약, 1.x라면 2.x로 업데이트 해야합니다.

참고로 본문 내용에서는 2가지 형태의 코드 블록이 있습니다.

$ shell 명령어

> 클로드 코드 프롬프트

slash commands

클로드 코드는 이미 정의된 명령어 또는 사용자 정의 슬래시 명령어를 다음과 같이 사용이 가능 합니다.

사용자 정의 슬래시는 ~/.claude/commands 또는 .claude/commands 경로에 마크다운 파일로 관리됩니다.

> /[command-name] [arguments]

또는 네임스페이스를 다음과 같이 지정할 수 있습니다.

~/.claude/[NAMESPACE]/commands 또는 .claude/[NAMESPACE]/commands

> /[NAMESPACE]:[command-name] [arguments]

사용자 정의 명령어 생성

$ echo "Analyze this code for performance issues and suggest optimizations:" > .claude/commands/optimize.md

$  echo "Review this code for security vulnerabilities:" > .claude/commands/security-review.md 

$ echo 'Fix issue #$ARGUMENTS following our coding standards' > .claude/commands/fix-issue.md

$ echo 'Review PR #$1 with priority $2 and assign to $3' > .claude/commands/review-pr.md

---

> /fix-issue 123 high-priority 

/fix-issue is running… 123 high-priority 

⏺ I'll fix issue #123 with high priority following your coding standards.

  Let me start by fetching the issue details from GitHub.

⏺ Bash(gh issue view 123 --json title,body,labels,state,comments)
  ⎿  Running…

──────────────────────────────────────────────────────────────────────────────────────
 Bash command

   gh issue view 123 --json title,body,labels,state,comments
   Fetch issue #123 details from GitHub

 Do you want to proceed?
 ❯ 1. Yes
   2. Yes, and don't ask again for gh issue view commands in
   /Users/jeongtae/Desktop/claude-code-advanced-guide
   3. No, and tell Claude what to do differently (esc)

> /review-pr 456 high alice 

/review-pr is running… 456 high alice 

⏺ I'll review PR #456 with high priority and prepare it for assignment to alice.

  Let me start by fetching the PR information using the GitHub CLI.

⏺ Bash(gh pr view 456 --json
      title,body,author,state,headRefName,baseRefName,files,commits)
  ⎿  Interrupted · What should Claude do instead?

파일 참조

@를 이용하면 파일을 참조할 수 있습니다.

$ echo 'Compare @src/need_debugger.py with @src/need_review.py' > .claude/commands/referrence-file.md 

> /referrence-file

/referrence-file is running…

⏺ I'll compare these two Python files for you. Let me read both files first.

⏺ Read(src/need_debugger.py)
  ⎿  Error reading file

⏺ Read(src/need_review.py)
  ⎿  Error reading file

⏺ The files don't exist at those paths. Let me search for them in the repository.

⏺ Search(pattern: "**/need_debugger.py")
  ⎿  Found 1 file (ctrl+o to expand)

⏺ Search(pattern: "**/need_review.py")
  ⎿  Found 1 file (ctrl+o to expand)

⏺ Found them! They're in the root directory. Let me read both files now.

⏺ Read(need_debugger.py)
  ⎿  Read 12 lines

⏺ Read(need_review.py)
  ⎿  Read 7 lines

⏺ Comparison of need_debugger.py vs need_review.py

  need_debugger.py (need_debugger.py:1-12)

  def main() -> None:
      student = {
          "name": "Alice",
          "age": 21,
          "courses": ["Math", "Science", "Art"]
      }

      print(student["a"])  # BUG: KeyError


  if __name__ == "__main__":
      main()

  Issues:
  - Bug at line 8: Attempts to access student["a"] which doesn't exist, causing a
  KeyError
  - Should likely be student["age"] or student["name"]

  need_review.py (need_review.py:1-7)

  def main() -> None:
      print("Hello, World!")


  if __name__ == "__main__":
      main()

  Characteristics:
  - Simple "Hello, World!" program
  - No bugs, but basic implementation
  - Could potentially benefit from code review for production standards

  Key Differences:

  1. Complexity: need_debugger.py has more complex logic with a dictionary
  structure, while need_review.py is minimal
  2. Purpose: need_debugger.py clearly has a bug that needs debugging, while
  need_review.py is functional but basic
  3. Error state: need_debugger.py will crash at runtime, need_review.py runs
  successfully

  The naming suggests these files are examples for testing specialized agents -
  one needs the debugger agent (has a bug), while the other needs the
  code-reviewer agent (works but could be reviewed for quality).

Bash 명령어 실행

커맨드 정의를 위한 마크다운 파일에 !배시 명령어 형태로 배시 명령어를 추가할 수 있습니다.

• 구조

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
argument-hint: [message]
description: Create a git commit
model: claude-3-5-haiku-20241022
---

Create a git commit with message: $ARGUMENTS

allowed-tools: 명령어가 사용할 수 있는 도구 목록

argument-hint: 슬래시 명령어에 필요한 인수

description: 명령어의 간단한 설명