ツール実行失敗時にフックを実行したい
11. フックコマンド / 機能
PostToolUseFailureツール失敗後のフック
概要
PostToolUseFailure はツール実行が失敗した時に発火するフックイベントです。エラーのログ記録や通知、リトライ処理などに活用できます。
設定例
// .claude/settings.json
{
"hooks": {
"PostToolUseFailure": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "echo 'Bash失敗: $TOOL_NAME' >> ~/.claude/errors.log"
}
]
}
]
}
}こんな時に使う
- ツール失敗を記録・通知したい時
- エラー発生時に自動でリカバリ処理を行いたい時
使い方
- 1hooks.PostToolUseFailure にフックを定義
- 2matcher でどのツールの失敗を検知するか指定
- 3command で実行するスクリプトを指定
Tips
- PostToolUse との違いは失敗時のみ発火する点
- エラーの詳細は JSON の tool_response から取得可能