---
name: opencurrent-code-format-hook
description: "Claude Code가 파일을 고칠 때마다 포맷터와 린트가 저절로 돌아서, 사람이 따로 정리 명령을 돌리거나 리뷰에서 스타일을 지적할 일이 줄어듭니다. 이럴 때 사용: PostToolUse 훅을 Edit·Write에 걸어 고친 파일 경로를 받아 Prettier를 돌립니다. 린트 오류처럼 Claude가 알아야 할 결과는 종료 코드 2로 돌려보내 바로 고치게 하고, /hooks로 걸린 훅을 확인합니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다. 도구: Claude Code."
metadata:
  source: "https://opencurrent.ai/w/claude-code-format-hook"
  opencurrent-id: "claude-code-format-hook"
  verification: "pending"
  exported-at: "2026-11-21T11:04:30.287Z"
---

# 고칠 때마다 자동 포맷하기

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

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/claude-code-format-hook
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("claude-code-format-hook")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

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

## 준비물

- Claude Code 설치와 로그인

## 단계

### 1. jq와 포맷터 준비 (명령 실행 · Claude Code)

훅은 표준 입력으로 JSON을 받으므로 jq가 필요합니다. 프로젝트에 Prettier가 있는지도 확인합니다.

프롬프트:

```text
jq --version && npx prettier --version
```

기대 결과: 두 버전 번호

확인 방법: 명령이 오류 없이 버전을 출력하는지 확인

### 2. PostToolUse 훅 걸기 (사람이 · Claude Code)

.claude/settings.json에 아래 훅을 넣습니다. Edit나 Write가 끝날 때마다 tool_input.file_path를 꺼내 그 파일만 포맷합니다.

프롬프트:

```text
{
  "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로 훅 목록을 엽니다. 어느 설정 파일에서 왔는지도 표시됩니다.

프롬프트:

```text
/hooks
```

기대 결과: PostToolUse 아래 Edit|Write 훅

확인 방법: 목록에 방금 넣은 훅이 보이는지 확인

### 4. 린트 결과를 Claude에게 돌려주기 (사람이 · Claude Code)

린트 오류를 Claude가 바로 고치게 하려면 스크립트가 오류를 표준 오류로 쓰고 종료 코드 2로 끝나게 합니다. PostToolUse에서는 이미 편집이 끝났으므로 막지는 않고 내용만 전달됩니다.

프롬프트:

```text
#!/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에게 파일 하나를 고치게 하고 결과 파일이 포맷됐는지 봅니다. 성공한 훅은 대화에 아무것도 보이지 않습니다.

프롬프트:

```text
src 아래 아무 파일에서 들여쓰기를 일부러 흐트러뜨려 저장해 줘.
```

기대 결과: 저장 직후 다시 정리된 파일

확인 방법: git diff에 들여쓰기 흐트러짐이 남지 않았는지 확인

## 주의할 점

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

## 출처

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

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/claude-code-format-hook 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
