나만의 커맨드 만들기 (6화)

여기까지 오면 매번 똑같이 치는 부탁이 생깁니다. "오늘 뭐 바뀌었는지 정리해줘", "커밋하기 전에 이것저것 확인해줘" 같은 것들이요.

이런 건 파일 하나로 저장해두면 커맨드가 됩니다. 그리고 이게 클로드 코드를 "내 도구"로 만드는 방법이에요.

어떻게 만드나요#

프로젝트 폴더 안에 .claude/commands/ 를 만들고, 그 안에 마크다운 파일을 하나 두면 끝입니다. 파일 이름이 곧 커맨드 이름이 됩니다.

.claude/commands/오늘정리.md   →   /오늘정리 로 실행

파일 안에는 평소에 하던 부탁을 한국어로 적으면 됩니다. 코드가 아니에요.

---
description: 오늘 작업한 내용 정리해서 기록 남기기
---
 
오늘 바뀐 파일들:
!`git diff --stat`
 
위 변경사항을 읽고 다음을 해줘:
1. 무슨 작업이었는지 한 문단으로 요약
2. 빠뜨린 것 같은 게 있으면 지적

백틱 안에 든 git diff --stat 은 터미널 명령입니다. 4화에서 도장(커밋)을 찍은 뒤로 뭐가 얼마나 바뀌었는지 목록을 뽑아주는 명령이에요. 외울 필요 없습니다 — 아래 실습에서 AI에게 만들어달라고 하면 알아서 넣어줍니다.

파일 안에서 쓸 수 있는 것#

일반 문장 말고 세 가지를 더 쓸 수 있습니다. 3화에서 본 @ 와 ! 가 여기서 다시 나오는데, 입력창에 칠 때와 문법이 조금 다릅니다.

첫 번째가 핵심입니다. 위 예시의 !`git diff --stat` 는 "오늘 뭐가 바뀌었는지" 목록을 커맨드가 실행될 때마다 자동으로 가져옵니다. 내가 매번 복사해서 붙여넣지 않아도 돼요.

어디에 두느냐가 범위를 정합니다#

혼자 쓰는 편의 도구는 두 번째, 팀이 같은 방식으로 일하게 하려면 첫 번째입니다.

만들 만한 것 고르기#

아무거나 만들면 안 씁니다. 기준은 이겁니다.

세 번 이상 똑같이 타이핑했으면 커맨드로 만들 때.

한두 번은 그냥 치는 게 빠릅니다. 세 번째부터는 만들어두는 게 이득이에요. 실제로 자주 만들어지는 것들입니다.

• 작업 마무리 점검 — 바뀐 파일 훑고 빠진 것 지적
• 커밋 준비 — 변경 내용 요약하고 비밀값 섞였는지 확인
• 새 화면 만들기 — 우리 프로젝트 규칙에 맞춘 기본 틀
• 오류 진단 — 화면에 찍힌 오류 메시지 가져와서 원인 추정

실습 — 점검 커맨드 만들기#

claude-test 폴더에서 합니다. AI에게 커맨드를 만들어달라고 시키는 것이 가장 빠릅니다.

4화에서 커밋을 해뒀다면 그대로 이어가면 됩니다. 안 했다면 먼저 지금까지 작업한 걸 커밋해줘 를 한 번 시키세요.

cd ~/claude-test
claude

1. 이렇게 시킵니다.

자주 쓸 커맨드를 하나 만들어줘.
 
- 이름은 /점검
- 하는 일: 지금 폴더에서 바뀐 파일을 훑고, 빠뜨린 것 같은 게 있으면 지적
- 바뀐 파일 목록은 명령 실행 결과로 자동으로 가져오게 해줘
- 만든 뒤에 실제로 한 번 실행해서 결과를 보여줘

마지막 줄을 빼면 파일만 만들어 놓고 "완성했습니다"로 끝나는 경우가 많습니다.

2. 만들어진 파일을 열어봅니다.

@.claude/commands/점검.md 이 파일 내용 보여줘

.claude 는 숨김 폴더라 @ 자동완성 목록에 안 뜰 수 있습니다. 그럴 땐 위처럼 경로를 직접 쳐도 됩니다.

3. 직접 실행해봅니다.

/점검

4. 마음에 안 드는 부분이 있으면 파일을 고치라고 하면 됩니다.

@.claude/commands/점검.md 여기에 "비밀번호나 API 키가 섞여 있으면 경고해줘" 항목도 추가해줘

커맨드는 한 번 만들고 끝이 아니라 쓰면서 다듬는 것입니다. 쓸 때마다 아쉬운 걸 한 줄씩 추가하면 됩니다.

이 화에서 얻어야 할 것#

• 커맨드는 마크다운 파일 하나고, 파일 이름이 커맨드 이름이 된다
• !`명령어` 로 결과를 자동으로 끌어올 수 있다 — 복붙이 사라진다
• 프로젝트 폴더에 두면 팀과 공유, 내 사용자 폴더에 두면 모든 프로젝트에서
• 세 번 이상 똑같이 쳤으면 만들 때다

다음 화가 마지막입니다. 클로드 코드가 기본으로 못 하는 일을 붙이는 방법 — 브라우저를 열어 직접 확인하게 하거나, 최신 문서를 읽어오게 하는 것들을 다룹니다.

→ 7화: 못 하는 일을 붙이기