Claude Code 입문 강의 요약 #4

Anthropic SkillJar의 Claude Code 강의를 듣고 정리한 내용입니다.
https://anthropic.skilljar.com/claude-code-in-action

---

Custom Command란?

자주 반복하는 작업을 마크다운 파일로 정의해두면, /커맨드명 형태로 빠르게 실행할 수 있습니다.
매번 긴 지시문을 입력할 필요 없이, 커맨드 한 줄로 동일한 작업을 재현할 수 있는 것이 핵심입니다.

---

Custom Command 만들기

.claude/commands/ 경로에 커맨드로 사용할 마크다운 파일을 생성합니다.
파일명이 곧 커맨드명이 되며, 생성 후에는 Claude를 재시작해야 적용됩니다.

예를 들어 audit.md를 생성하면 /audit으로 실행할 수 있습니다.

재시작 후 /audit을 입력하면 정의한 작업이 실행됩니다.

---

$ARGUMENTS로 동적 입력 받기

커맨드 실행 시 인자를 전달하고 싶다면 파일 내용에 $ARGUMENTS를 추가하면 됩니다.

예를 들어 .claude/commands/summary_file.md를 아래와 같이 작성합니다.

Show me the summary for: $ARGUMENTS
Showing conventions:

Place summary file in a summary directory in the same folder as the source file
Name files as [filename].summary

실행할 때는 커맨드 뒤에 원하는 인자를 붙여서 입력합니다.
/summary_file the files in @src/ directory.

💡 $ARGUMENTS에는 파일 경로뿐만 아니라 어떤 텍스트든 전달할 수 있습니다.
@파일명 형태로 특정 파일을 참조하는 것도 가능합니다.

---

정리

항목	내용
파일 위치	.claude/commands/파일명.md
실행 방법	/파일명
동적 입력	파일 내 $ARGUMENTS 사용, 실행 시 커맨드 뒤에 인자 입력
적용 시점	파일 생성 후 Claude 재시작 필요