{"id":"claude-code-format-hook","kind":"workflow","testedWith":[],"durationMin":15,"url":"https://opencurrent.ai/w/claude-code-format-hook","title":"고칠 때마다 자동 포맷하기","summary":"Claude Code가 파일을 고칠 때마다 포맷터와 린트가 저절로 돌아서, 사람이 따로 정리 명령을 돌리거나 리뷰에서 스타일을 지적할 일이 줄어듭니다.","category":"개발","categoryId":"dev","domain":"dev","domainLabel":"개발","capabilities":[{"id":"code","label":"코드 작성"}],"topics":[{"id":"dev","label":"개발"}],"tools":["Claude Code"],"whenToUse":"PostToolUse 훅을 Edit·Write에 걸어 고친 파일 경로를 받아 Prettier를 돌립니다. 린트 오류처럼 Claude가 알아야 할 결과는 종료 코드 2로 돌려보내 바로 고치게 하고, /hooks로 걸린 훅을 확인합니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.","prerequisites":["Claude Code 설치와 로그인"],"inputs":[],"howToFollow":"1. 준비물이 갖춰졌는지 먼저 확인할 것.\n2. 단계를 순서대로 진행할 것. kind가 \"ai\"면 프롬프트를 실행하고, \"command\"면 사용자의 허락을 받고 명령을 실행하고, \"human\"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.\n3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.\n4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.\n5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"command","title":"jq와 포맷터 준비","body":"훅은 표준 입력으로 JSON을 받으므로 jq가 필요합니다. 프로젝트에 Prettier가 있는지도 확인합니다.","prompt":"jq --version && npx prettier --version","expected":"두 버전 번호","check":"명령이 오류 없이 버전을 출력하는지 확인","tool":"Claude Code"},{"n":2,"kind":"human","title":"PostToolUse 훅 걸기","body":".claude/settings.json에 아래 훅을 넣습니다. Edit나 Write가 끝날 때마다 tool_input.file_path를 꺼내 그 파일만 포맷합니다.","prompt":"{\n  \"hooks\": {\n    \"PostToolUse\": [\n      {\n        \"matcher\": \"Edit|Write\",\n        \"hooks\": [\n          { \"type\": \"command\", \"command\": \"f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \\\"$f\\\"\" }\n        ]\n      }\n    ]\n  }\n}","expected":".claude/settings.json의 hooks","check":"설정 파일이 JSON으로 읽히는지 확인(jq . .claude/settings.json)","tool":"Claude Code"},{"n":3,"kind":"command","title":"걸린 훅 확인","body":"/hooks로 훅 목록을 엽니다. 어느 설정 파일에서 왔는지도 표시됩니다.","prompt":"/hooks","expected":"PostToolUse 아래 Edit|Write 훅","check":"목록에 방금 넣은 훅이 보이는지 확인","tool":"Claude Code"},{"n":4,"kind":"human","title":"린트 결과를 Claude에게 돌려주기","body":"린트 오류를 Claude가 바로 고치게 하려면 스크립트가 오류를 표준 오류로 쓰고 종료 코드 2로 끝나게 합니다. PostToolUse에서는 이미 편집이 끝났으므로 막지는 않고 내용만 전달됩니다.","prompt":"#!/bin/sh\nf=$(jq -r '.tool_input.file_path')\nout=$(npx eslint \"$f\" 2>&1) || { echo \"$out\" >&2; exit 2; }","expected":"린트 오류가 대화에 나타나는 훅","check":"일부러 린트 오류를 만들게 하고 Claude가 그 오류를 읽고 고치는지 확인","tool":"Claude Code"},{"n":5,"kind":"ai","title":"시험하기","body":"Claude에게 파일 하나를 고치게 하고 결과 파일이 포맷됐는지 봅니다. 성공한 훅은 대화에 아무것도 보이지 않습니다.","prompt":"src 아래 아무 파일에서 들여쓰기를 일부러 흐트러뜨려 저장해 줘.","expected":"저장 직후 다시 정리된 파일","check":"git diff에 들여쓰기 흐트러짐이 남지 않았는지 확인","tool":"Claude Code"}],"pitfalls":["훅은 내 계정 권한으로 그대로 실행되는 명령. 남이 만든 훅은 내용을 읽고 넣기","종료 코드 2가 아닌 다른 오류 코드는 막지도 전달하지도 않고 지나감","포맷이 큰 파일마다 돌면 편집이 느려짐. 매처를 필요한 도구로 좁히기"],"sources":[{"title":"Claude Code 문서: 훅 시작하기","url":"https://code.claude.com/docs/en/hooks-guide"},{"title":"Claude Code 문서: 훅 레퍼런스","url":"https://code.claude.com/docs/en/hooks"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-21T10:00:00+00:00","basis":"updated"},"updatedAt":"2026-11-21T10:00:00+00:00","goals":[{"id":"dev","title":"개발"}],"uses":0,"likes":0}