# 고칠 때마다 자동 포맷하기
id: claude-code-format-hook · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/claude-code-format-hook
기준일: 2026-11-21 (여기서 고친 날)
도구: Claude Code
걸리는 시간: 약 15분
평가 점수: 32/100 (확인 없음 · 검수 대기)

Claude Code가 파일을 고칠 때마다 포맷터와 린트가 저절로 돌아서, 사람이 따로 정리 명령을 돌리거나 리뷰에서 스타일을 지적할 일이 줄어듭니다.

설명: PostToolUse 훅을 Edit·Write에 걸어 고친 파일 경로를 받아 Prettier를 돌립니다. 린트 오류처럼 Claude가 알아야 할 결과는 종료 코드 2로 돌려보내 바로 고치게 하고, /hooks로 걸린 훅을 확인합니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

준비물: Claude Code 설치와 로그인

단계:
1. [명령 실행 · Claude Code] jq와 포맷터 준비 — 훅은 표준 입력으로 JSON을 받으므로 jq가 필요합니다. 프로젝트에 Prettier가 있는지도 확인합니다.
   프롬프트:
   > jq --version && npx prettier --version
   기대 결과: 두 버전 번호
   확인 방법: 명령이 오류 없이 버전을 출력하는지 확인
2. [사람이 · Claude Code] 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. [명령 실행 · Claude Code] 걸린 훅 확인 — /hooks로 훅 목록을 엽니다. 어느 설정 파일에서 왔는지도 표시됩니다.
   프롬프트:
   > /hooks
   기대 결과: PostToolUse 아래 Edit|Write 훅
   확인 방법: 목록에 방금 넣은 훅이 보이는지 확인
4. [사람이 · Claude Code] 린트 결과를 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. [AI에게 · Claude Code] 시험하기 — Claude에게 파일 하나를 고치게 하고 결과 파일이 포맷됐는지 봅니다. 성공한 훅은 대화에 아무것도 보이지 않습니다.
   프롬프트:
   > src 아래 아무 파일에서 들여쓰기를 일부러 흐트러뜨려 저장해 줘.
   기대 결과: 저장 직후 다시 정리된 파일
   확인 방법: git diff에 들여쓰기 흐트러짐이 남지 않았는지 확인

주의:
- 훅은 내 계정 권한으로 그대로 실행되는 명령. 남이 만든 훅은 내용을 읽고 넣기
- 종료 코드 2가 아닌 다른 오류 코드는 막지도 전달하지도 않고 지나감
- 포맷이 큰 파일마다 돌면 편집이 느려짐. 매처를 필요한 도구로 좁히기

출처:
- Claude Code 문서: 훅 시작하기 https://code.claude.com/docs/en/hooks-guide
- Claude Code 문서: 훅 레퍼런스 https://code.claude.com/docs/en/hooks