커스텀 명령어

커스텀 명령어 만들기

⚠️ 중요한 업데이트: 영상에서는 새 명령어를 만든 뒤 Claude Code를 재시작해야 한다고 안내하지만, 현재는 재시작이 필요 없습니다. Claude Code가 명령어 파일을 자동으로 감지합니다.

Claude Code를 실행한 상태에서 /를 입력하면 기본으로 내장된 여러 명령어를 볼 수 있습니다.

여러분은 이 기본 명령어들 외에도 나만의 커스텀 명령어를 손쉽게 추가해 사용할 수 있습니다. 커스텀 명령어는 자주 반복하는 작업을 자동화하는 데 매우 유용합니다.

---

1. 커스텀 명령어 만드는 법

커스텀 명령어를 만들려면 프로젝트에 특정 폴더 구조를 설정해야 합니다.

1. 프로젝트 디렉터리에서 .claude 폴더를 찾습니다.
2. 그 안에 commands 라는 새 디렉터리를 만듭니다.
3. 그 안에 원하는 명령어 이름의 마크다운 파일을 생성합니다. (예: audit.md)

💡 포인트: 파일 이름이 곧 명령어 이름이 됩니다. 즉, audit.md를 만들면 /audit 명령어가 만들어집니다.

명령어 파일을 생성하면 Claude Code가 자동으로 인식합니다. 영상의 안내와 달리 재시작할 필요가 없습니다.

---

2. 예시: /audit 명령어

프로젝트 의존성의 취약점을 점검하는 실용적인 명령어 예시를 봅시다. 이 명령어의 목표는 다음과 같습니다.

1. 프로젝트에 설치된 모든 의존성을 점검 (npm audit)
2. 취약점이 있으면 업데이트 (npm audit fix)
3. 업데이트로 인해 문제가 생기지 않았는지 테스트 실행

audit.md 파일을 만든 뒤, Claude Code에서 /audit을 입력하면 방금 만든 명령어가 표시됩니다.

실행하면 Claude는 정확히 우리가 요청한 대로 동작합니다. 취약한 패키지를 찾아 필요 시 수정하고, 테스트를 돌려 확인합니다.

---

3. 명령어에 인자(Argument) 전달하기

커스텀 명령어는 $ARGUMENTS placeholder를 통해 인자를 받을 수 있습니다. 인자를 사용하면 명령어를 훨씬 유연하고 재사용 가능하게 만들 수 있습니다. 예를 들어, 프로젝트 내 특정 파일에 대한 테스트를 생성하는 write_tests.md 명령어를 만든다고 합시다. 명령어 본문 안에 $ARGUMENTS를 넣어두면, 명령어 실행 시 전달한 문자열이 그 위치에 삽입됩니다.

write_tests.md 예시

Write comprehensive tests for: $ARGUMENTS

Testing conventions:
* Use Vitest with React Testing Library
* Place test files in a __tests__ directory in the same folder as the source file
* Name test files as [filename].test.ts(x)
* Use @/ prefix for imports

Coverage:
* Test happy paths
* Test edge cases
* Test error states

실행 예시

/write_tests the use-auth.ts file in the hooks directory

💡 유연성: 인자는 반드시 파일 경로일 필요는 없습니다. 어떤 문자열이든 전달할 수 있습니다. 예를 들어 "어떤 폴더의 파일에 대한 테스트"처럼 자연어로 가볍게 방향만 알려줘도, Claude가 어디를 봐야 할지 단서를 잡게 됩니다.

---

4. 커스텀 명령어의 장점

---

5. 어떤 워크플로우에 적용하면 좋을까?

커스텀 명령어는 특히 다음과 같은 프로젝트별 워크플로우에 매우 유용합니다.

• 테스트 스위트 실행
• 코드 배포
• 팀 컨벤션에 맞춘 보일러플레이트 생성
• 의존성 보안 점검 (위 /audit 예시)
• 코드 리뷰 체크리스트 자동 적용

---

핵심 요약