고칠 때마다 자동 포맷하기
Claude Code가 파일을 고칠 때마다 포맷터와 린트가 저절로 돌아서, 사람이 따로 정리 명령을 돌리거나 리뷰에서 스타일을 지적할 일이 줄어듭니다.
PostToolUse 훅을 Edit·Write에 걸어 고친 파일 경로를 받아 Prettier를 돌립니다. 린트 오류처럼 Claude가 알아야 할 결과는 종료 코드 2로 돌려보내 바로 고치게 하고, /hooks로 걸린 훅을 확인합니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.
준비
- Claude Code 설치와 로그인
1. jq와 포맷터 준비
훅은 표준 입력으로 JSON을 받으므로 jq가 필요합니다. 프로젝트에 Prettier가 있는지도 확인합니다.
jq --version && npx prettier --version결과: 두 버전 번호
확인: 명령이 오류 없이 버전을 출력하는지 확인
2. PostToolUse 훅 걸기
.claude/settings.json에 아래 훅을 넣습니다. Edit나 Write가 끝날 때마다 tool_input.file_path를 꺼내 그 파일만 포맷합니다.
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }
]
}
]
}
}결과: .claude/settings.json의 hooks
확인: 설정 파일이 JSON으로 읽히는지 확인(jq . .claude/settings.json)
3. 걸린 훅 확인
/hooks로 훅 목록을 엽니다. 어느 설정 파일에서 왔는지도 표시됩니다.
/hooks결과: PostToolUse 아래 Edit|Write 훅
확인: 목록에 방금 넣은 훅이 보이는지 확인
4. 린트 결과를 Claude에게 돌려주기
린트 오류를 Claude가 바로 고치게 하려면 스크립트가 오류를 표준 오류로 쓰고 종료 코드 2로 끝나게 합니다. PostToolUse에서는 이미 편집이 끝났으므로 막지는 않고 내용만 전달됩니다.
#!/bin/sh
f=$(jq -r '.tool_input.file_path')
out=$(npx eslint "$f" 2>&1) || { echo "$out" >&2; exit 2; }결과: 린트 오류가 대화에 나타나는 훅
확인: 일부러 린트 오류를 만들게 하고 Claude가 그 오류를 읽고 고치는지 확인
5. 시험하기
Claude에게 파일 하나를 고치게 하고 결과 파일이 포맷됐는지 봅니다. 성공한 훅은 대화에 아무것도 보이지 않습니다.
src 아래 아무 파일에서 들여쓰기를 일부러 흐트러뜨려 저장해 줘.결과: 저장 직후 다시 정리된 파일
확인: git diff에 들여쓰기 흐트러짐이 남지 않았는지 확인
주의
- 훅은 내 계정 권한으로 그대로 실행되는 명령. 남이 만든 훅은 내용을 읽고 넣기
- 종료 코드 2가 아닌 다른 오류 코드는 막지도 전달하지도 않고 지나감
- 포맷이 큰 파일마다 돌면 편집이 느려짐. 매처를 필요한 도구로 좁히기
댓글