新機能 / v2.1.317
SDK hookのonFailure block追加
CHANGELOG 原文(英語)
Added onFailure: "block" for Agent SDK hook callbacks, so a callback that fails blocks the action instead of letting it run 公式の変更履歴を開く ↗ 日本語での補足
Agent SDK hookコールバックにonFailure: "block"を追加。失敗したコールバックがアクションをそのまま実行させず、ブロックするように。
ドキュメント
ドキュメントの抜粋(参考訳)
HTTP フック
type: "http" のフックを使うと、シェルコマンドを実行する代わりに、イベントデータを HTTP エンドポイントに POST できます。このエンドポイントは、コマンドフックが stdin で受け取るのと同じ JSON を受け取り、同じ JSON 形式を使って HTTP レスポンスのボディで結果を返します。
HTTP フックは、Web サーバー、クラウドファンクション、外部サービスにフックのロジックを任せたい場合に便利です。たとえば、チーム全体の監査サービスなどです。以下の設定では、成功したすべてのツール呼び出しをローカルのロギングサービスに POST します。
{
"hooks": {
"PostToolUse": [
{
"hooks": [
{
"type": "http",
"url": "http://localhost:8080/hooks/tool-use",
"headers": {
"Authorization": "Bearer $MY_TOKEN"
},
"allowedEnvVars": ["MY_TOKEN"]
}
]
}
]
}
}
エンドポイントは、コマンドフックと同じ出力形式の JSON ボディで応答し、Claude Code はレスポンスのステータスも確認します。
- 2xx ステータス:ツール呼び出しをブロックするには、ボディに適切な
hookSpecificOutputフィールドを返します。 - それ以外のステータス、またはリクエストが失敗した場合:Claude Code はブロックしないエラーを報告し、処理を続行させます。ただし、そのフックが失敗時にアクションをブロックするものである場合は除きます。失敗したエンドポイントにアクションをブロックさせるには、そのフックに
onFailure: "block"を設定してください。
ヘッダーの値では、$VAR_NAME または ${VAR_NAME} 構文による環境変数の展開を使用できます。解決されるのは allowedEnvVars 配列に列挙された変数のみで、それ以外の $VAR 参照はすべて空のままになります。
設定オプションの全体とレスポンスの処理については、リファレンスのHTTP フックを参照してください。
取得日 · 2026-11-20