Claude Code hooksシステム完全ガイド｜PreToolUse/PostToolUse/Notificationの使い方と実践例

{
 "hooks":{
   "PreToolUse":[...],
   "PostToolUse":[...],
   "Notification":[...],
   "Stop":[...]
 }
}

{
 "hooks":{
   "PreToolUse":[
     {
       "matcher":"Bash",
       "hooks":[
         {
           "type":"command",
           "command":"/usr/local/bin/my-pre-bash-check.sh"
         }
       ]
     }
   ],
   "Notification":[
     {
       "matcher":"*",
       "hooks":[
         {
           "type":"command",
           "command":"echo '$CLAUDE_NOTIFICATION' >> ~/.claude/notifications.log"
         }
       ]
     }
   ]
 }
}

#!/bin/bash
# ~/.claude/hooks/block-dangerous-bash.sh

# 標準入力からツール入力を受け取る
INPUT=$(cat)

# 危険なコマンドを検出
ifecho"$INPUT"|grep-qE'(rm -rf|git push --force|git reset --hard|DROP TABLE)';then
 echo"危険なコマンドをブロックしました:$INPUT">&2
 exit2 # 終了コード2でブロック
fi

exit0

{
 "hooks":{
   "PreToolUse":[
     {
       "matcher":"Bash",
       "hooks":[
         {
           "type":"command",
           "command":"bash ~/.claude/hooks/block-dangerous-bash.sh"
         }
       ]
     }
   ]
 }
}

#!/bin/bash
# ~/.claude/hooks/auto-format.sh

INPUT=$(cat)
FILE_PATH=$(echo"$INPUT"|python3-c"import sys,json; d=json.load(sys.stdin); print(d.get('file_path',''))"2>/dev/null)

if[-z"$FILE_PATH"];then
 exit0
fi

# 拡張子で分岐
case"$FILE_PATH"in
 *.py)
   black"$FILE_PATH"2>/dev/null
   ;;
 *.js|*.ts|*.jsx|*.tsx)
   npxprettier--write"$FILE_PATH"2>/dev/null
   ;;
esac

exit0

{
 "hooks":{
   "PostToolUse":[
     {
       "matcher":"Edit",
       "hooks":[{"type":"command","command":"bash ~/.claude/hooks/auto-format.sh"}]
     },
     {
       "matcher":"Write",
       "hooks":[{"type":"command","command":"bash ~/.claude/hooks/auto-format.sh"}]
     }
   ]
 }
}

#!/bin/bash
# ~/.claude/hooks/slack-notify.sh

WEBHOOK_URL="https://hooks.slack.com/services/YOUR/WEBHOOK/URL"
MESSAGE=${CLAUDE_NOTIFICATION:-"Claude Codeの作業が完了しました"}

curl-s-XPOST"$WEBHOOK_URL"\
 -H'Content-type: application/json'\
 -d"{\"text\": \"$MESSAGE\"}"

{
 "hooks":{
   "Notification":[
     {
       "matcher":"*",
       "hooks":[
         {
           "type":"command",
           "command":"bash ~/.claude/hooks/slack-notify.sh"
         }
       ]
     }
   ]
 }
}

{
 "hooks":{
   "PostToolUse":[
     {
       "matcher":"*",
       "hooks":[
         {
           "type":"command",
           "command":"cat >> ~/.claude/audit.jsonl"
         }
       ]
     }
   ]
 }
}

#!/bin/bash
# ~/.claude/hooks/auto-commit.sh

cd"$CLAUDE_PROJECT_DIR"2>/dev/null||exit0

ifgitdiff--quiet&&gitdiff--staged--quiet;then
 exit0 # 変更なし
fi

gitadd-A
gitcommit-m"chore: auto-save by Claude Code$(date'+%Y-%m-%d %H:%M')"

{
 "hooks":{
   "Stop":[
     {
       "matcher":"*",
       "hooks":[
         {
           "type":"command",
           "command":"bash ~/.claude/hooks/auto-commit.sh"
         }
       ]
     }
   ]
 }
}

chmod750~/.claude/hooks/
chmod640~/.claude/hooks/*.sh