Skip to content
← リリースに戻る · 2.1.317
新機能 / 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

変更の詳細