strictPluginOnlyCustomization.hooks

settings.json型string記述場所管理者設定のみ

hooks サーフェスをロックする。

既定値ロックされていない。

記述例

{
  "strictPluginOnlyCustomization": ["hooks"]
}

使い方・用途

  • hooks の提供元をプラグインだけに限定し、プラグイン以外のソースが登録する hooks を動かないようにしたいとき
  • plugins のみから hooks を許可するポリシーを適用し、それ以外の hooks 差し込みを防ぎたいとき
英語原文

Lock the hooks surface:

関連する変更履歴

v2.1.319(2件)

セルフホストランナーの問題を修正した。--trust-workspace false が、リポジトリの設定ファイルやスキルに含まれるフックの実行も停止するようになった
英語原文を表示
Fixed self-hosted runners: --trust-workspace false now also stops hooks in the repository's settings files and skills from running
PostToolUse フックを変更した:新しいメッセージがターンに割り込んだ後に終了するツール呼び出しでも、完了まで最大 10 秒をかけて実行されるようになる
英語原文を表示
Changed PostToolUse hooks to run, with up to 10 seconds to finish, on tool calls that finish after a new message interrupts the turn

変更後

新しいメッセージでターンが中断されても、すでに終わったツール呼び出しに対して PostToolUse フックが確実に実行されるようになり、割り込み後もフックによる後処理やログ記録が途切れない。フックには最大 10 秒の実行時間が与えられるため、中断時でも完了処理を安定して行える。

関連ドキュメント

v2.1.316(1件)

コマンドが型キャスト、param、using または属性で始まる場合に、PowerShell フックが終了コード 2 でブロックしない問題を修正した
英語原文を表示
Fixed PowerShell hooks not blocking on exit code 2 when the command begins with a type cast, param, using or an attribute

関連ドキュメント

v2.1.314(2件)

Bash にマッチするフックが Monitor ツールで開始された shell コマンドに対して実行されない問題を修正した。そのようなフックは該当コマンドに対して block や ask はできるが、approve や書き換えはできない
英語原文を表示
Fixed hooks matching Bash not running on shell commands started by the Monitor tool; such hooks can block or ask, but not approve or rewrite those commands

関連ドキュメント

[VSCode] キューに入ったメッセージのフックが実行されている間、スピナーと停止ボタンが表示されない問題を修正した
英語原文を表示
[VSCode] Fixed missing spinner and Stop button while a queued message's hooks run

v2.1.312(1件)

prompt および agent フックが、セッションごとにサブエージェントを含めて同時に最大 24 個まで、さらに各イベントのタイムアウトより長く待機しているものは最大 12 個まで実行されるように変更した。1 秒未満の timeout は 1 秒として扱われる
英語原文を表示
Changed prompt and agent hooks to run at most 24 at a time per session, sub-agents included, plus at most 12 that have waited longer than their event's timeout; a timeout under 1 second now counts as 1 second

変更後

プロンプトフックやエージェントフックが多数あるセッションでも、同時実行数が制限されることでフックの暴走によるリソース競合を避けられ、各フックが安定して完了するようになる。また、1秒未満のタイムアウトが1秒として扱われるため、極端に短いタイムアウトを設定した場合の意図しない動作を心配せずに済む。

v2.1.311(2件)

SubagentStop フックが、サブエージェントの終了時に 1 回ではなく、実行中の各サブエージェントについて約 2 分おきに実行される問題を修正した
英語原文を表示
Fixed SubagentStop hooks running about twice a minute for each running subagent instead of once when it finishes

関連ドキュメント

[VSCode] 遅い UserPromptSubmit フックのために「UserPromptSubmit フックを実行中」のスピナー状態とスクリーンリーダー向けアナウンスを追加しました。
英語原文を表示
[VSCode] Added a "Running UserPromptSubmit hooks" spinner status and screen reader announcement for slow UserPromptSubmit hooks

変更後

時間のかかる UserPromptSubmit フックの実行中でも、スピナー表示で処理中であることが分かり、スクリーンリーダー利用者にも状況が読み上げられるようになる。

関連ドキュメント

v2.1.310(1件)

Windows: Git Bash が存在せず、フックのコマンドが引用符で囲まれた文字列のみ(引用符付きパスなど)の場合に、PreToolUse フックと PermissionRequest フックがツール呼び出しを通過させてしまう問題を修正した
英語原文を表示
Windows: Fixed PreToolUse and PermissionRequest hooks letting a tool call through when Git Bash is missing and the hook's command is only quoted strings, such as a quoted path

変更後

Git Bash がインストールされていない Windows 環境でも、引用符で囲んだパスだけで構成された PreToolUse や PermissionRequest フックが正しく評価され、意図したとおりにツール実行を制御できるようになる。

関連ドキュメント

v2.1.309(3件)

ctrl+enter(今すぐ送信)が、応答が開始する前に押したときのみメッセージをキューに入れるという問題と、フックの実行中に押すとメッセージをキューに入れたままプロンプトのフックを再起動してしまう問題を修正した
英語原文を表示
Fixed ctrl+enter (send now) only queuing a message when pressed before the response had started, and restarting a prompt's hooks while leaving the message queued when pressed while those hooks were running
PowerShell で実行されるフックが、フックのプログラムが終了コード 2 で終了してもブロックされない問題を修正した。また、Windows において Git for Windows がインストールされていない場合に、'shell': 'powershell' を指定した PreToolUse および PermissionRequest フックがフェイルオープンする問題を修正した。
英語原文を表示
Fixed hooks that run in PowerShell not blocking when the hook's program exits with code 2, and on Windows PreToolUse and PermissionRequest hooks with "shell": "powershell" failing open when Git for Windows isn't installed

関連ドキュメント

フックモジュールが読み込めないほど深くネストされている場合のエラーを改善した。スタックオーバーフローの素のメッセージの代わりに、該当ファイル名を表示するようになった。
英語原文を表示
Improved the error when a hooks module is nested too deep to load: it now names the file instead of showing a bare stack-overflow message

変更後

フックスモジュールのネストが深すぎて読み込めない場合に、原因となったファイル名が表示されるようになり、問題の箇所をすばやく特定して修正できる。

関連ドキュメント

v2.1.307(1件)

Self-hosted runner: チェックアウトフックがデフォルトで 30 分後に停止し、セッションのセットアップが失敗するように変更した。より長い時間が必要な場合は、--checkout-hook-timeout-min を引き上げるか 0 に設定する
英語原文を表示
Self-hosted runner: Changed checkout hooks to be stopped after 30 minutes by default, failing the session's setup; if yours needs longer, raise --checkout-hook-timeout-min or set it to 0

変更後

checkout フックがハングしてもセッションのセットアップが 30 分で打ち切られ、失敗が早く検知できるようになる。30 分以上かかるフックを使う場合は --checkout-hook-timeout-min で待ち時間を延ばせる。

v2.1.305(1件)

[VSCode] SessionStart または Setup フックの実行中に、スクリーンリーダー向けアナウンス付きの「Running start-up hooks」スピナー状態を追加した。
英語原文を表示
[VSCode] Added a "Running start-up hooks" spinner status, with a screen reader announcement, while SessionStart or Setup hooks run

変更後

VSCode 拡張で SessionStart や Setup フックの実行中に、画面にスピナーの状態が表示され、スクリーンリーダーにも読み上げが通知されるため、視覚に頼らず処理の進行状況を把握できる。

関連ドキュメント

v2.1.304(5件)

先に実行されるプラグインがあなたの mod の hook をスキップした際に、そのイベント名とプラグイン名を記した transcript 行を追加した。
英語原文を表示
Added a transcript line when a plugin that runs first skips one of your mod's hooks, naming the event and the plugin

変更後

自分の mod のフックが別のプラグインにスキップされても、トランスクリプト上でどのイベントがどのプラグインにスキップされたかを即座に確認できる。デバッグログを出さずに、mod が期待どおりに動かない原因を切り分けやすくなる。

mod の settings.read フックを変更し、各設定レイヤーを受け取ってマージ済み設定を書き換えるようにした。これにより、管理対象 mod が組織の設定を上限として設定できる(保持期間のクリーンアップで使用される cleanupPeriodDays を含む)
英語原文を表示
Changed mods' settings.read hooks to receive each settings layer and rewrite the merged settings, so a managed mod can make an organization's setting a ceiling, including the cleanupPeriodDays the retention sweep uses

変更後

管理対象の mod がユーザーやプロジェクト側の設定より短い保持期間など、組織の設定を上限として強制できるようになる。これにより、ユーザーが任意の設定値で上書きしても、cleanupPeriodDays のような保持期間の制御が組織のポリシーどおりに動作する。

スキルフックを変更:1 つのソース(リポジトリ、個人のフォルダ、またはプラグイン)のスキルは、セッションごとに最大 1,024 個のフックと 16,384 文字のマッチャーを登録できる
英語原文を表示
Changed skill hooks: the skills of one source (a repo, your own folder, or a plugin) can register at most 1,024 hooks and 16,384 matcher characters per session

変更後

スキルフックの登録数に上限が設けられ、1つのソースが大量のフックや長大なマッチャーを登録してもセッションが不安定になったり処理が遅くなったりしにくくなる。

プラグインの hooks のみを許可するポリシーのもとで skills の挙動を変更した:メインの会話で使われた skill の hooks が除外される場合、その skill は allowed-tools を受け取らなくなる
英語原文を表示
Changed skills under a policy that allows hooks from plugins only: a skill used in the main conversation whose hooks are kept out no longer gets its allowed-tools

変更後

フックをプラグインからのみ許可するポリシーが有効な環境で、スキルの allowed-tools による事前承認がポリシーに従って適切に制限されるようになる。フックが除外されたスキルがツール権限を握り続けて権限回避の抜け穴になることを防ぎ、管理者のセキュリティポリシーが一貫して適用される。

関連ドキュメント

mod の hooks がどこで実行されるかを予測して表示していた claude plugin validate の notes を削除した
英語原文を表示
Removed the notes from claude plugin validate that predicted where a mod's hooks would run

v2.1.302(1件)

プロンプトとエージェントのフックを変更し、1 つのイベントに対して同時に最大 12 個まで実行するようにした。残りは順番を待つ
英語原文を表示
Changed prompt and agent hooks so that at most 12 of one event run at a time; the rest wait their turn

v2.1.301(2件)

引数が多数のプレースホルダーを埋める際に、スキル・コマンド・フックが非常に大量のメモリを消費する問題を修正した。
英語原文を表示
Fixed skills, commands and hooks using very large amounts of memory when their arguments fill many placeholders
プロバイダーが Bedrock でないにもかかわらず、application-inference-profile を名前に含むモデルへ切り替えると awsAuthRefresh コマンドが実行され、モデル切り替えフックが遅延する問題を修正した。
英語原文を表示
Fixed switching to a model whose name contains application-inference-profile running your awsAuthRefresh command and delaying model-switch hooks when the provider is not Bedrock

関連ドキュメント

v2.1.300(5件)

バックグラウンドコマンドの実行中に終了した場合、SessionEnd フックが実行されないことがある問題を修正した
英語原文を表示
Fixed SessionEnd hooks sometimes not running when you exit while a background command is still running
Claude Code が --worktree 付きで起動した場合にプラグインの WorktreeCreate と WorktreeRemove フックが実行されない問題を修正した(--tmux ではまだ未対応)
英語原文を表示
Fixed plugin WorktreeCreate and WorktreeRemove hooks not running when Claude Code starts with --worktree (not yet with --tmux)

関連ドキュメント

エージェントフックが model を無視する問題を修正した。haiku のようなエイリアスが解決されるようになり、サブエージェントのモデルがオーバーライドしなくなり、利用不可のモデルではアクションを許可する代わりに呼び出し元のモデルへフォールバックする
英語原文を表示
Fixed agent hooks ignoring their model: aliases like haiku now resolve, a subagent's model no longer overrides it, and an unavailable model falls back to the caller's instead of allowing the action
Cowork クラウドセッションの PermissionRequest フックを変更した: フックの allow 内での setMode 更新は現在無視され、承認の残りの部分は引き続き適用される
英語原文を表示
Changed PermissionRequest hooks in Cowork cloud sessions: a setMode update in a hook's allow is now ignored; the rest of the approval still applies

変更後

Cowork のクラウドセッションでも、PermissionRequest フックによる権限更新が通常の Claude Code と同じ一貫した挙動に揃い、フックの allow 内の setMode は適用されず、承認内容が意図どおり反映されるようになった。

関連ドキュメント

フックを変更した: PreToolUse および PermissionRequest フックからの updatedInput が Claude 自身の入力と同様に検証されるようになり、未知のキーは破棄され、ツールが拒否する入力はその呼び出しを拒否する
英語原文を表示
Changed hooks: updatedInput from PreToolUse and PermissionRequest hooks is now validated like Claude's own input: unknown keys are dropped, and input the tool rejects denies the call

変更後

フックが返す updatedInput が、Claude 本体のツール入力と同じ検証を受けるようになり、不正な引数が権限評価前に弾かれて、予期しない入力でツールが実行されるのを防げる。

v2.1.299(12件)

claude self-hosted-runner orchestrator に --shutdown-drain-sec を追加した。SIGTERM 受信時にポーリングを停止し、実行中のポーリングと起動済みの spawn フックに最大その秒数の完了猶予を与える。
英語原文を表示
Added --shutdown-drain-sec to claude self-hosted-runner orchestrator: on SIGTERM it stops polling and gives the poll in flight and running spawn hooks up to that many seconds to finish

変更後

Kubernetes などのプラットフォームがオーケストレーターに SIGTERM を送った際、処理中のポーリングや spawn フックを猶予時間内に完了させてから終了できるようになり、デプロイやスケールダウン時にセッションのスポーン処理が中断されにくくなる。

/plugin と claude plugin validate に、組織が Claude Code を管理している環境でスキップされる mod のフック名を示す注意書きを追加した。
英語原文を表示
Added a note in /plugin and claude plugin validate naming a mod's hooks that are skipped where an organization manages Claude Code

変更後

組織が Claude Code を管理している環境で、mod の hooks がスキップされても理由が分からず悩むことがある。この変更により、/plugin や claude plugin validate の表示でスキップされた hooks が明示され、動作しない原因を素早く特定できるようになる。

関連ドキュメント

Cowork および claude.ai クラウドセッションで、UserPromptSubmit フックや mod の prompt.submit フックの実行中に停止されたメッセージに対して Edit and Retry が失敗する問題を修正した(2.1.296 でのリグレッション)。
英語原文を表示
Fixed Edit and Retry in Cowork and claude.ai cloud sessions failing on a message stopped while its UserPromptSubmit or mod prompt.submit hooks were still running (regression in 2.1.296)
Remote Control で、フックを通過済みのプロンプトが、Stop が次のキュー済みプロンプトのフックを中断した際にプロンプト履歴から失われる問題を修正した
英語原文を表示
Fixed a Remote Control prompt that had passed its hooks being dropped from prompt history when Stop interrupted the next queued prompt's hook

関連ドキュメント

非常に深くネストされたツール入力やメッセージを next() で渡すときにプラグインフックがスキップされる問題を修正した
英語原文を表示
Fixed plugin hooks being skipped when they pass a very deeply nested tool input or message on with next()

関連ドキュメント

フックが hooks モジュール形式のプラグイン(ビルトインプラグインを含む)に対して、plugin_loaded テレメトリイベントが has_hooks を false として報告する問題を修正した
英語原文を表示
Fixed the plugin_loaded telemetry event reporting has_hooks as false for plugins whose hooks are a hooks module, built-in plugins included
mod のフックに渡される値から __proto__ キーが黙って削除され、別の mod が行ったツール呼び出しに対する tool.check ガードがスキップされる可能性がある問題を修正した
英語原文を表示
Fixed mods' hooks being handed values with __proto__ keys silently removed, which could skip a tool.check guard on a tool call another mod made
ユーザーがインストールした mod の $.env.set が、managed settings のコマンドフックが起動に使う環境やシェルプレフィックスを変更してしまう問題を修正した
英語原文を表示
Fixed a user-installed mod's $.env.set changing the environment or shell prefix that command hooks from managed settings start with
Windows: Git for Windows がインストールされていない環境で、シェルを指定しない PreToolUse フックや PermissionRequest フックがフェイルオープンする問題を修正した。失敗したガードは現在呼び出しをブロックする
英語原文を表示
Windows: Fixed PreToolUse and PermissionRequest hooks that set no shell failing open when Git for Windows isn't installed; a guard that fails now blocks the call

変更後

Git for Windows がインストールされていない環境でも、シェルを指定していない PreToolUse フックや PermissionRequest フックの失敗時に、ツールの実行を確実にブロックできるようになる。

関連ドキュメント

管理対象の権限ルール、管理フック、組織の MCP ツール名に対する、ユーザーがインストールした mod への適用を強化した
英語原文を表示
Improved enforcement of managed permission rules, managed hooks and organization MCP tool names against user-installed mods

変更後

ユーザーがインストールした mod が、マネージド権限ルールやマネージドフック、組織の MCP ツール名を回避できなくなります。組織の管理コントロールが mod によって上書きされる事態を防ぎ、セキュリティポリシーを確実に適用できるようになりました。

プラグインフックとワークフロースクリプトが、28,000 段階より深くネストされた値を返すことを拒否するように変更した。上限を示すエラーが出る(ワークフロースクリプトは 100,000 段階まで許可)
英語原文を表示
Changed plugin hooks and workflow scripts to refuse values they hand back that nest deeper than 28,000 levels, with an error naming the limit (workflow scripts allowed 100,000)

変更後

プラグインのフックやワークフロースクリプトが返す値のネストが深すぎる場合に、具体的な上限値を示すエラーで通知される。これにより、無制限に深い構造の処理を試みてセッションが不安定になる前に問題を検知でき、原因の特定も容易になる。

UserPromptSubmit フックが、スキルやカスタムスラッシュコマンドの展開前に実行されるように変更した。プロンプトをブロックするフックが、埋め込まれたシェルコマンドも停止できるようになる
英語原文を表示
Changed UserPromptSubmit hooks to run before a skill or custom slash command expands, so a hook that blocks the prompt now also stops its embedded shell commands

変更後

UserPromptSubmit フックでプロンプトをブロックした際に、スキルやカスタムスラッシュコマンド内に埋め込まれたシェルコマンドまで実行されてしまう問題が解消され、フックによるブロック確実に防止できる。

関連ドキュメント

v2.1.296(7件)

有効な別のプラグインと同じ名前を持つためにフックが除外されているプラグインについて、/plugin 内に注意書きを表示するようにした
英語原文を表示
Added a note in /plugin on a plugin whose hooks are left out because another enabled plugin has the same name

変更後

同じ名前の有効なプラグインが別にあることでフックが実行されない場合に、/plugin でその旨を確認できるようになる。どちらのコピーが名前を保持していて自分のフックが無視されているのかを名前で特定できるので、競合の解消方法を判断しやすくなる。

関連ドキュメント

マネージド設定の PreToolUse フックが 'continue': false でツール呼び出しを拒否する場合や、マネージドの prompt フックがツール呼び出しをブロックする場合に、呼び出しは拒否されるもののターンまで終了してしまっていた問題を修正した
英語原文を表示
Fixed managed-settings PreToolUse hooks that deny a tool call with "continue": false, and managed prompt hooks that block one, refusing the call but not ending the turn

関連ドキュメント

一部のセッションで、マネージド設定の PostToolUse フックによる updatedMCPToolOutput の適用が行われていなかった問題を修正した
英語原文を表示
Fixed PostToolUse hooks in managed settings not applying updatedMCPToolOutput in some sessions
headless セッション開始後に読み込まれたプラグインの SessionStart フックが、同名または表記違いの別プラグインがすでに実行済みだとスキップされる問題を修正した
英語原文を表示
Fixed SessionStart hooks of a plugin loaded after a headless session starts being skipped when a different plugin with the same name, or another spelling of it, had already run

関連ドキュメント

SessionStart フックがまだ実行中の間に送信されたプロンプトが、← でセッションをバックグラウンドに移動すると消えてしまう問題を修正した。まだ送信はされないが、↑ で復元できるようになった。
英語原文を表示
Fixed a prompt sent while SessionStart hooks were still running vanishing when ← moved the session to the background; it is still not sent, but ↑ now brings it back

関連ドキュメント

フックが CLAUDE_ENV_FILE に書き込んだ変数(ファイルが単純な代入のみを含む場合)を PowerShell コマンドが参照できない問題を修正した。
英語原文を表示
Fixed PowerShell commands not seeing variables that hooks write to CLAUDE_ENV_FILE (when the file holds only plain assignments)

関連ドキュメント

hooks の --debug 出力を改善した。ツール呼び出し、プロンプト、SessionStart、Stop に対するコマンド hooks は終了時にコマンド、プラグイン、結果、所要時間をログに記録するため、遅い hook を特定できる。
英語原文を表示
Improved --debug output for hooks: command hooks on tool calls, prompts, SessionStart and Stop now log their command, plugin, outcome and duration when they finish, so a slow hook is identifiable

変更後

フックの実行結果が --debug ログにコマンド名・プラグイン・終了ステータス・所要時間付きで記録されるようになり、終了したタイミングでどのフックが遅いのかをログから特定できるようになる。

関連ドキュメント

v2.1.295(7件)

コマンドフックと HTTP フックに onFailure: 'block' を追加:起動できない、タイムアウトする、または予期しない終了コードで終わるフックがアクションを通過させずにブロックするようにした
英語原文を表示
Added onFailure: "block" for command and HTTP hooks: a hook that can't start, times out, or exits with an unexpected code blocks the action instead of letting it through

変更後

ポリシーフックのパス指定ミスやスクリプトのクラッシュ時に、本来防ぎたかった操作がそのまま実行されてしまうのを防げる。フックの起動失敗・タイムアウト・異常終了時にアクションを確実にブロックできるようになる

関連ドキュメント

バックグラウンドセッションのコマンドとフックが FORCE_COLOR=3 を継承し、Claude が読み取る出力にカラーエスケープコードが混入する問題を修正した
英語原文を表示
Fixed commands and hooks in background sessions inheriting FORCE_COLOR=3, which put color escape codes into the output Claude reads
プラグインフックワーカーの再起動中に mod が再読み込みされながら行う呼び出しが、.catch を持つ別の mod のガードフックを通過してしまう問題を修正し、そのような呼び出しは拒否されるようにした
英語原文を表示
Fixed calls a mod makes while it reloads during a plugin hooks worker restart getting past another mod's guard hook that has a .catch; such calls are now refused
hooks モジュールが数千レベルの深さにコードをネストしているプラグインが、スタックオーバーフローの素のメッセージとともにロードや検証に失敗する問題を修正した
英語原文を表示
Fixed plugins whose hooks module nests code thousands of levels deep failing to load or validate with a bare stack-overflow message
非常に大きなインターフェースを追加するプラグインが、プラグインフックワーカーの停止時に別のプラグインをアンロードされる問題を修正した
英語原文を表示
Fixed a plugin that adds very large interfaces getting another plugin unloaded when the plugin hooks worker stalls
長時間実行されるセッションで、別のセッションがプラグインの更新を同期した後に claude.ai 同期のプラグインフックが 'Plugin directory does not exist' で失敗する問題を修正した
英語原文を表示
Fixed claude.ai-synced plugin hooks failing with "Plugin directory does not exist" in long-running sessions after another session synced a plugin update
claude plugin validate とプラグインの読み込みを改善した。再バインドされたトップレベルの var が原因でフックモジュールが拒否された際に、エラーでその再バインド行、原因、修正方法が示されるようになった
英語原文を表示
Improved claude plugin validate and plugin loading: when a hooks module is refused over a rebound top-level var, the error now names the line that rebinds it, the cause, and a fix

変更後

プラグインの検証や読み込みで、トップレベルの var による再代入が原因で hooks モジュールが拒否された場合、再代入している行と原因、修正方法がエラーメッセージに示されるようになり、問題の特定と修正がしやすくなる。

v2.1.294(2件)

「Block commands that...」のように指示として書かれた prompt および agent フックが、本来ブロックすべき内容を許可してしまう問題を修正した
英語原文を表示
Fixed prompt and agent hooks written as instructions (such as "Block commands that...") allowing what they should block
Stop および SubagentStop で「Carry on if the build is broken」のように指示として書かれた prompt フックの判定方法を改善し、Claude が早めに停止しにくくなった
英語原文を表示
Improved how prompt hooks on Stop and SubagentStop written as instructions (such as "Carry on if the build is broken") are judged, so Claude is less likely to stop early

変更後

「ビルドが壊れていたら作業を続ける」のような指示文として書かれた prompt フックを、Claude が正確に判定できるようになり、作業が未完了なのに早く止まってしまうのを防げる。

v2.1.293(1件)

プラグインフックワーカーの再起動中に、mod の classic.* イベントに対するフックがスキップされ、設定フックがそれなしで応答する問題を修正した
英語原文を表示
Fixed a mod's hooks on classic.* events being skipped while the plugin hooks worker restarts, which left settings hooks to answer without them

v2.1.292(7件)

mod がフックしてプロンプトボックスの自動補完リストに独自の行を追加できるイベント prompt.autocomplete を追加した
英語原文を表示
Added prompt.autocomplete, an event a mod hooks to add its own rows to the prompt box's autocomplete list

変更後

プラグインがプロンプトボックスの入力補完候補リストに独自の候補を追加できるようになる。ユーザーが入力中にプロンプト独自の候補を選択することで、カスタムコマンドやスニペットを素早く入力できる。

関連ドキュメント

1つのconstを通じて多数の$.state呼び出しを行うhooksモジュールを持つプラグインの読み込みや検証に数分かかる問題を修正した
英語原文を表示
Fixed plugins whose hooks module makes many $.state calls through one const taking minutes to load or validate
claude plugin validateが、エンジンが別の場所から読み込むhooksモジュールのmatcherやstate値をリスト表示する問題を修正した
英語原文を表示
Fixed claude plugin validate listing a matcher or state value for a hooks module that the engine reads from elsewhere
プラグインhooksワーカーの再起動中に実行されたプラグインインターフェース呼び出しが、他のプラグインが付けたhooksなしで実行される問題を修正した
英語原文を表示
Fixed plugin interface calls made while the plugin hooks worker restarts running without the hooks other plugins put on them
hooksワーカーの入れ替わり時に、modの起動時プロンプト、コマンド、サブエージェントが再度キューに入れられる問題を修正した
英語原文を表示
Fixed a mod's start-up prompt, command or subagent being queued a second time when the hooks worker was replaced

関連ドキュメント

プラグインhooksワーカーの再起動中に行われたツール呼び出しが、プラグインの権限hooksなしで応答される問題を修正した
英語原文を表示
Fixed tool calls made while the plugin hooks worker restarts being answered without the plugins' permission hooks
プラグインのtool.call hooksが、誤名のパラメータが修復される前に一部のツール呼び出しを参照する問題を修正した。hookは現在、ツールが実際に実行する引数を参照する
英語原文を表示
Fixed plugin tool.call hooks seeing some tool calls before misnamed parameters were repaired; a hook now sees the arguments the tool will run with

v2.1.290(9件)

プラグインフックの tool.check イベントに agentId を追加した。これにより、フックはサブエージェントの権限チェックとメインセッションのそれを区別できる
英語原文を表示
Added agentId to the tool.check event of plugin hooks, so a hook can tell a subagent's permission check from the main session's

変更後

プラグインフック内で agentId を参照することで、そのツール呼び出しがサブエージェントによるものかメインセッションによるものかを判別でき、サブエージェントに対してのみ異なる権限判定を行うようなフックを作れる。

プラグインフックの型定義に ThemeKey と Color 型を追加した。これにより、エディターは mod の描画で指定可能なテーマカラーを補完表示できる
英語原文を表示
Added ThemeKey and Color types to the plugin hooks typings, so an editor lists the theme colors a mod's drawing can name

変更後

プラグイン (mod) を開発する際に、ThemeKey 型と Color 型がフックの型定義から使えるため、エディターの補完で描画要素に指定できるテーマカラーや色の値を確認しながら正確に記述できる。

フックがプロンプトやツール呼び出しで hooks worker を占有し続けている間に、.catch 付きのプラグインフックがアンロードされ、その .catch がスキップされる問題を修正した
英語原文を表示
Fixed a plugin hook with a .catch being unloaded, and its .catch skipped, when the hook kept the hooks worker busy on a prompt or tool call
トップレベル関数と同じ名前のオプションを分割代入する hooks モジュールが、claude plugin validate やプラグインの読み込みで拒否される問題を修正した
英語原文を表示
Fixed claude plugin validate and plugin loading refusing a hooks module that destructures an option named like one of its top-level functions
auto モードでレポートを返すサブエージェントの turn.complete において、プラグインフックが空の answer を読み取る問題を修正した
英語原文を表示
Fixed plugin hooks reading an empty answer on turn.complete for a subagent that hands its report back in auto mode

関連ドキュメント

非ラテン文字を含む長い複数行テキストを mod が描画する際に、プラグインフックが各再描画でスタックする問題を修正した
英語原文を表示
Fixed plugin hooks stalling each redraw when a mod draws a long multi-line text holding non-Latin characters
Linux でサンドボックス化された Bash コマンド実行時、.claude/settings.json や .claude/settings.local.json が存在しない場合に ConfigChange フックが実行され、コマンド実行中に設定が再読み込みされる問題を修正した。
英語原文を表示
Fixed sandboxed Bash commands on Linux running ConfigChange hooks and reloading settings mid-command when .claude/settings.json or .claude/settings.local.json does not exist

関連ドキュメント

プラグインフックを変更し、長いテキストを拒否したり黙って破棄したりせず、切り詰めてログに記録するようにした。
英語原文を表示
Changed plugin hooks so long text is clipped and logged instead of being refused or dropped silently
Agent の結果におけるインプロセスのチームメイトの agent_id をそのエージェント ID に変更した(name@team アドレスは引き続き teammate_id に残る);TeammateIdle フックがそのサブエージェントやフォークから発火しなくなった。
英語原文を表示
Changed an in-process teammate's agent_id in Agent results to its agent ID (its name@team address stays in teammate_id); TeammateIdle hooks no longer fire from its subagents or forks

変更後

Agent 結果内の in-process teammate は agent_id で一意に識別できるようになり、TeammateIdle フックが teammate の subagent や fork から誤って発火しなくなる。

v2.1.288(3件)

構造化出力を拒否する Mantle やゲートウェイの環境で、セッションタイトル、メモリーの呼び出し、プロンプトフックが失敗する問題を修正した。構造化出力を無効化する CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS を追加した。
英語原文を表示
Fixed session titles, memory recall and prompt hooks failing on Mantle or behind gateways that reject structured outputs; added CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS to turn structured outputs off
バックグラウンドエージェントが実行中の間に idle_prompt 通知フックが発火する問題を修正した(anthropics/claude-code#93672)
英語原文を表示
Fixed idle_prompt notification hooks firing while background agents are still running (anthropics/claude-code#93672)

関連ドキュメント

マッチ処理に失敗した場合やツールの入力を JSON にシリアライズできなかった場合に、PreToolUse フックと PermissionRequest フックがスキップされる問題を修正した。現在はその呼び出しをブロックする
英語原文を表示
Fixed PreToolUse and PermissionRequest hooks being skipped when matching them failed or the tool's input could not be serialized to JSON; the call is now blocked

関連ドキュメント

v2.1.287(4件)

hooks に設定された asyncRewake が、hooks のスクリプトファイルが見つからない場合に 'found issues' 通知で Claude を繰り返し起こす問題を修正しました。壊れた hook は一度だけ報告されます。
英語原文を表示
Fixed hooks configured with asyncRewake waking Claude over and over with "found issues" notifications when the hook's script file is missing; the broken hook is now reported once

関連ドキュメント

同期されたプラグインの SessionStart フックが、新しいクラウドセッションで実行されない問題を修正した
英語原文を表示
Fixed SessionStart hooks from synced plugins not running in new cloud sessions
トランスクリプトの「N hooks ran」サマリーや冗長デバッグログのマッチしたフック数に Claude Code の内部コールバックが含まれ、設定済みフック 1 つが 2 つとして表示される問題を修正した
英語原文を表示
Fixed the transcript's "N hooks ran" summary and the verbose debug log's matched-hooks count including Claude Code's internal callbacks, so one configured hook no longer shows as two
ツール全体に対する Bash の allow ルールと許可フックについて、Claude Code のファイルツールが完全に拒否するファイル(Anthropic プロファイルストア、ホストの認証情報ファイル)へのシェル書き込みを実行ではなくプロンプトで確認するように変更しました
英語原文を表示
Changed whole-tool Bash allow rules and allowing hooks to prompt for, not run, shell writes to files Claude Code's file tools refuse outright (the Anthropic profile store, the host credentials file)

変更後

Bash 全体を許可するルールや許可フックがあっても、Claude Code のファイルツールが直接書き込みを拒否するファイル(Anthropic プロファイルストアやホストの認証情報ファイル)へのシェルによる書き込みは実行されず、確認を求められるようになった。こうした機密性の高いファイルが広範な許可設定によって意図せず書き換えられるのを防げる。

v2.1.286(3件)

/hooks を改善した。フックの詳細画面の末尾の文言で 'it' の代わりに 'this hook' と表記するようになった。
英語原文を表示
Improved /hooks: the closing line of a hook's detail screen now says "this hook" instead of "it"

変更後

フックの詳細画面の締めの文言がより明確になり、どのフックについて説明されているのか分かりやすくなる。

リスト画面(/artifacts、/mcp、/skills、/hooks など)を変更し、各行の詳細を名前の後の一つの列に常に揃えるようにした。
英語原文を表示
Changed list screens (/artifacts, /mcp, /skills, /hooks and others) to always line up each row's details in one column after the names

変更後

「/artifacts」「/mcp」「/skills」「/hooks」などのリスト画面で、各項目の詳細情報が名前の後に一つの列に揃って表示されるようになる。

関連ドキュメント

/hooks を、設定済みのフックをイベントごとにまとめた 1 つのリストで開くように変更し、フックの確認が Enter 3 回から 1 回で済むようにした
英語原文を表示
Changed /hooks to open on one list of your configured hooks grouped by event, so viewing a hook takes one Enter instead of three

変更後

設定済みのすべてのフックをイベント別にグループ化した一覧で一括確認できるため、目的のフックを確認するまでの操作が3回から1回に減り、フックの見直しや動作確認が手軽になる。

v2.1.285(2件)

plan が同じレスポンス内で書き込まれた場合に、ExitPlanMode の hook や SDK 権限コールバックが、存在しない plan や古い plan を参照する問題を修正した
英語原文を表示
Fixed hooks and SDK permission callbacks seeing a missing or outdated plan on ExitPlanMode when the plan was written in the same response

関連ドキュメント

hook が起動したバックグラウンドプロセス (例: some-daemon &) が出力を開いたままにしている間、同期 hook が Claude Code をハングさせる問題を修正した。hook は現在、自身のプロセス終了後すぐに完了する
英語原文を表示
Fixed synchronous hooks hanging Claude Code while a background process the hook started (for example some-daemon &) kept its output open; the hook now finishes shortly after its own process exits

v2.1.284(4件)

フックが stdout にも出力していた場合にデバッグログが失敗したフックの stderr を落とす問題や、出力のない失敗フックで何もログされない問題を修正した。失敗したフックはステータスコードもログするようになった
英語原文を表示
Fixed the debug log dropping a failed hook's stderr when the hook also wrote to stdout, and logging nothing for a failed hook with no output; failed hooks now also log their status code
Elicitation および ElicitationResult フックが返した {'decision':'block'} が無視される問題を修正した。終了コード 2 と同様に、MCP elicitation を拒否するようになった
英語原文を表示
Fixed {"decision":"block"} returned by Elicitation and ElicitationResult hooks being ignored; it now declines the MCP elicitation, as exit code 2 does

関連ドキュメント

非同期スクリプトフックが投げるエラーに対する Workflow ツールのサンドボックス強化を改善した
英語原文を表示
Improved Workflow tool sandbox hardening for errors thrown by async script hooks
/tasks・/copy・/hooks などのリストを改善した。各名前の後の詳細が収まる場合は 1 列に揃い、収まらない場合は右端に配置される
英語原文を表示
Improved lists such as /tasks, /copy and /hooks: the details after each name now line up in one column when they fit, and otherwise sit at the right edge

変更後

/tasks や /hooks などのリストで、名前の後の詳細情報が揃って表示されるようになり、一覧性が向上して読みやすくなる

関連ドキュメント

v2.1.283(2件)

/help、/hooks、/copy、/chrome、/memory、/ide、/release-notes、/rewind、/diff、/remote-env、/plugin などの各ピッカーのリストを、ページキー、マウスホイール、クリック操作に対応させて改善した。
英語原文を表示
Improved lists in /help, /hooks, /copy, /chrome, /memory, /ide, /release-notes, /rewind, /diff, /remote-env, /plugin and other pickers with page keys, mouse wheel and clicks

変更後

/help や /plugin など各種ダイアログの一覧を、PgUp/PgDn キーやマウスホイール、クリックで操作できるようになり、項目数が多い場合でもマウスやキーボードだけでスムーズに目的の項目まで移動・選択できるようになる。

セルフホストランナー:lifecycle hooks の git がリポジトリの Git LFS pre-push フックをスキップし、書き込み可能なシステムの core.hooksPath を無視し、--configure-git がない場合はコミットに署名しないように変更した
英語原文を表示
Self-hosted runner: Changed lifecycle hooks' git to skip a repository's Git LFS pre-push hook, ignore a writable system core.hooksPath, and not sign commits without --configure-git

変更後

セルフホストランナーのライフサイクルフック内の git が、リポジトリの Git LFS の pre-push フックや書き込み可能な system の core.hooksPath を無視し、--configure-git 指定時以外はコミットに署名しないようになり、セッションが書き込んだ設定によってフックの権限で任意のコードが実行されたり、意図しない署名付きコミットが作られたりしなくなる

v2.1.281(5件)

claude --bg が、ワークスペース信頼プロンプトを通過していないディレクトリでバックグラウンドセッションを開始し、プロジェクトの hooks を実行してしまう問題を修正した。先に信頼を確認するようになり、非対話実行時は終了する
英語原文を表示
Fixed claude --bg starting a background session, and running its project hooks, in a directory that had not passed the workspace trust prompt; it now asks for trust first, or exits when not run interactively

関連ドキュメント

ブロッキングイベント(PreToolUse など)における mcp_tool hooks が、MCP サーバーの接続完了前にはスキップされる問題を修正した。MCP 接続タイムアウトまで待つようになった
英語原文を表示
Fixed mcp_tool hooks on blocking events (PreToolUse and similar) being skipped while their MCP server was still connecting; they now wait for it, up to the MCP connect timeout

関連ドキュメント

/memory、/hooks、/mcp(サーバーのサインイン画面を含む)、/export、/copy、/theme、/teleport の未コミット変更およびログインプロンプトなど、残りのダイアログやピッカーで、Ctrl+C や Ctrl+D を 2 回押すとダイアログを閉じる代わりに Claude Code が終了してしまう問題を修正した(Esc も終了していた)
英語原文を表示
Fixed Ctrl+C or Ctrl+D pressed twice quitting Claude Code instead of closing the dialog in the remaining dialogs and pickers, such as /memory, /hooks, /mcp (including a server's sign-in screen), /export, /copy, /theme, and /teleport's uncommitted-changes and login prompts (where Esc also quit)
幅の狭いターミナルで、/hooks および /mcp の詳細ビューが長い値を出力する際に、下の行に重ねて表示される問題を修正した
英語原文を表示
Fixed /hooks and /mcp detail views printing a long value over the row below it in narrow terminals
/hooks を改善した。フックの詳細画面で、settings.json だけを指す代わりにフックの種類と変更場所を表示するようになり、フック無効・セーフモード・管理対象フックのみの各通知が、何が起きているかを1文の平易な言葉で伝える
英語原文を表示
Improved /hooks: a hook's detail screen now says what kind of hook it is and where to change it, instead of always pointing at settings.json, and the hooks-disabled, safe mode and managed-hooks-only notices each say what is happening in one plain sentence

変更後

/hooks の詳細画面で、そのフックの種類と編集場所がひと目で分かるようになり、フック無効化・セーフモード・managed hooks 専用モード時の表示も、何が起きているのかを平易な一文で理解できるようになる。

関連ドキュメント

v2.1.280(4件)

セッションに渡された環境変数に NUL 文字が含まれている場合に、バックグラウンドセッション (claude --bg) が git、フック、プラグインなどのヘルパープログラムを実行できない問題を修正した
英語原文を表示
Fixed background sessions (claude --bg) being unable to run git, hooks, plugins and other helper programs when an environment variable handed to the session contained a NUL character
送信済みのプロンプトが入力欄に戻ってきた際(編集のための Esc 押下や巻き戻し、起動フック実行中の Esc 押下など)に、IDE の選択内容が失われる問題を修正した
英語原文を表示
Fixed IDE selection being dropped when a sent prompt comes back into the input, such as pressing Esc to edit it, rewinding to it, or pressing Esc while startup hooks run

関連ドキュメント

セルフホストランナー:ライフサイクルフック内の git が、ランナーの共有 git ファイルに記載されたフックフォルダやプログラムを無視するように変更した。これらのローカルパスや git:// リモートには GIT_ALLOW_PROTOCOL が必要になる
英語原文を表示
Self-hosted runner: Changed git in lifecycle hooks to ignore hook folders and programs named in the runner's shared git files; local-path and git:// remotes there now need GIT_ALLOW_PROTOCOL

変更後

ライフサイクルフック内の git が、セッションが書き込める設定ファイルに記載されたフックフォルダーやプログラムを無視するようになり、セッションが悪意ある git フックを実行してフックの権限でコードを動かすリスクを防げる。

PermissionRequest フックを変更し、エージェントタイプのフックはそこで実行されなくなった。その回答はリクエストの許可・拒否に使えないためで、現在はコマンドまたは http フックを案内するエラーを表示する
英語原文を表示
Changed PermissionRequest hooks: an agent-type hook no longer runs there, since its answer could never allow or deny the request; it now shows an error pointing to command or http hooks

変更後

PermissionRequest フックからエージェント型フックが実行されなくなり、許可・拒否の判定に反映されない無駄な実行を防げる。誤って設定している場合は、コマンド型や HTTP 型のフックを使うようエラーで案内される。

関連ドキュメント

v2.1.277(1件)

[VSCode] 「General config」メニュー行が設定を開かずに /config の使用方法テキストを表示していた問題を修正し、入力コマンドの /mcp、/hooks、/memory、/rewind などが対応するダイアログを開くようにした
英語原文を表示
[VSCode] Fixed the "General config" menu row showing /config usage text instead of opening settings, and made typed /mcp, /hooks, /memory, /rewind and similar commands open their dialogs

関連ドキュメント

v2.1.275(2件)

agent type が空の終了中サブエージェントに対して、特定の matcher を持つ SubagentStop フックがすべて発火する問題を修正した。
英語原文を表示
Fixed SubagentStop hooks with a specific matcher firing for every stopping subagent whose agent type was empty

関連ドキュメント

hooks/ や config/ という名前のプロジェクトディレクトリにサンドボックス化された Bash コマンドが書き込めない問題を修正した。
英語原文を表示
Fixed sandboxed Bash commands being unable to write to project directories named hooks/ or config/

v2.1.274(2件)

Stop プロンプトフックが会話内のすべてのブロックに対してプロンプト全体を再送する問題を修正した。繰り返しのブロックには 500 文字のラベルで条件名が示されるようになった
英語原文を表示
Fixed Stop prompt hooks re-sending their whole prompt on every block in a conversation; repeat blocks now name the condition with a 500-character label

関連ドキュメント

hooks/hooks.json のトップレベルに $schema を持つプラグインに「unknown key」の警告が表示される問題を修正した
英語原文を表示
Fixed plugins with a top-level $schema in hooks/hooks.json showing an "unknown key" notice

v2.1.273(1件)

'Running PreCompact hooks…' などの圧縮ステータス行で、スピナーが二重の省略記号('……')を表示する問題を修正する
英語原文を表示
Fixed the spinner showing a doubled ellipsis ("……") on compaction status lines such as "Running PreCompact hooks…"

関連ドキュメント

v2.1.271(1件)

__proto__ や constructor など継承されたオブジェクトプロパティと同名の hook matcher があるとき、対話的な /hooks メニューがクラッシュする問題を修正した
英語原文を表示
Fixed the interactive /hooks menu crashing when a hook matcher is named after an inherited object property such as __proto__ or constructor

関連ドキュメント

v2.1.269(1件)

[VSCode] コマンドメニューに Hooks ダイアログを追加した。ユーザー、プロジェクト、ローカル設定に対して hooks の閲覧と追加・編集・削除ができる。管理対象・プラグイン・セッションの hooks は読み取り専用のまま
英語原文を表示
[VSCode] Added a Hooks dialog to the command menu for viewing hooks and adding, editing, or removing them in user, project, and local settings; managed, plugin, and session hooks stay read-only

変更後

VSCode のコマンドメニューから Hooks ダイアログを開けるようになり、settings.json を直接編集することなく、ユーザー・プロジェクト・ローカル設定に保存されたフックの確認や追加・編集・削除を行える。管理設定やプラグイン由来のフックは参照のみに制限されるため、誤って変更してしまう心配がない。

関連ドキュメント

v2.1.268(3件)

--print モードで PermissionRequest フックが発火しない問題を修正した
英語原文を表示
Fixed PermissionRequest hooks not firing in --print mode
フックごとの timeout が設定されていない SessionEnd フックに対し、CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS が適用されない問題を修正した (従来は 1.5 秒後にキャンセルされていた)
英語原文を表示
Fixed CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS not extending SessionEnd hooks that have no per-hook timeout (they were still cancelled after 1.5 seconds)

関連ドキュメント

--continue / --resume を改善した。SessionStart フックの完了を待たずに会話が即座に表示され、最初のメッセージでトランスクリプト全体を再読み込みしなくなった
英語原文を表示
Improved --continue / --resume: the conversation appears immediately instead of waiting for SessionStart hooks, and the first message no longer re-reads the whole transcript

変更後

--continue / --resume で会話を再開したとき、SessionStart フックの完了を待たずにすぐ会話が表示され、最初のメッセージの応答も速くなる。

関連ドキュメント

v2.1.265(1件)

Remote Control からの /clear が完了前に SessionStart フックや開いているターミナルのダイアログを待ってしまう問題を修正した
英語原文を表示
Fixed /clear from Remote Control waiting on SessionStart hooks and on open terminal dialogs before completing

関連ドキュメント

v2.1.260(1件)

サーバー管理設定を変更し、管理対象の CLAUDE.md(claudeMd)がセキュリティ承認ダイアログを表示しないようにした。hooks、シェルコマンド、サンドボックス、および安全でない env 設定は引き続き承認が必要
英語原文を表示
Changed server-managed settings so a managed CLAUDE.md (claudeMd) no longer triggers the security approval dialog; hooks, shell-command, sandbox, and unsafe env settings still require approval

変更後

サーバー管理設定で管理対象の CLAUDE.md(claudeMd)を配信してもセキュリティ承認ダイアログが表示されなくなり、開発者は承認操作なしで組織の指示ファイルを利用できる。フックやシェルコマンドなど安全性に関わる設定は従来どおり承認が必要なため、セキュリティチェックも維持される。

v2.1.259(1件)

ブロックを返す Stop フックがあると、ブロック後のターンでそのターンのモデルの推論が失われ、一部のモデルではプロンプトキャッシュもヒットしなくなる問題を修正
英語原文を表示
Fixed blocking Stop hooks causing the turn after a block to lose the model's reasoning from that turn and, on some models, miss the prompt cache

関連ドキュメント

v2.1.257(1件)

シンボリックリンク経由で宣言されたコマンド、エージェント、スキル、hooks などのコンポーネントパスを通じて、プラグインが自身のディレクトリ外のファイルを読み取れる問題を修正した。そのようなパスはエラーで拒否されるようになった
英語原文を表示
Fixed plugins being able to read files outside their own directory through a declared command, agent, skill, hooks or other component path that is a symlink; such paths are now refused with an error

関連ドキュメント

v2.1.251(1件)

PreModelSwitch と PostModelSwitch フックイベントを追加した(モデル切り替えのブロック・確認・注記が可能); SessionStart の resume フックがセッションの陳腐化情報と再キャッシュの推定コストを受け取るようになった
英語原文を表示
Added PreModelSwitch and PostModelSwitch hook events (block, confirm, or annotate a model switch); SessionStart resume hooks now receive session staleness and the estimated re-cache cost

変更後

モデル切り替えの前にフックで確認・ブロックや注記ができ、意図しないモデル変更やキャッシュ再生成コストの発生を防げるようになる。また、セッション再開時にキャッシュの失効状態と再キャッシュ費用の概算が分かるため、再開コストを判断してから作業を進められる。

v2.1.248(1件)

有効な JSON ではない stdout の {…} オブジェクトがフックによって黙ってプレーンテキストとして扱われる問題を修正した。現在はパースメッセージ付きのフックエラーとして報告される
英語原文を表示
Fixed hooks silently treating a stdout {…} object that isn't valid JSON as plain text; it's now reported as a hook error with the parse message

v2.1.246(1件)

/cd を改善した。新しいディレクトリのプロジェクト設定、フック、.mcp.json のサーバー(通常の承認プロンプト経由)、スキル、エージェントが、移動直後に有効になるようになった(これまでは --resume 時に有効になっていた)
英語原文を表示
Improved /cd: the new directory's project settings, hooks, .mcp.json servers (behind the usual approval prompt), skills, and agents now take effect right after the move instead of on --resume

変更後

/cd でディレクトリを移動した直後に、移動先のプロジェクト設定・hooks・.mcp.json サーバー・skills・agents がすぐに反映されるようになり、再開コマンドを実行しなくても移動先の環境をそのまま活用できる。

v2.1.239(1件)

セッションの作業ディレクトリが削除された後に 'posix_spawn ENOENT' でフックが失敗する問題を修正した。フックはプロジェクトルートまたはホームディレクトリから実行されるようになった
英語原文を表示
Fixed hooks failing with "posix_spawn ENOENT" after the session's working directory was deleted; they now run from the project root or home directory instead

v2.1.233(1件)

Claude Desktop や VS Code 上で実行した際に、権限プロンプトに対して Notification フックが発火しない問題を修正した
英語原文を表示
Fixed Notification hooks not firing for permission prompts when running under Claude Desktop or VS Code

関連ドキュメント

v2.1.222(1件)

バックグラウンドエージェントタスク(要約、圧縮、リネーム処理など)において、PreToolUse自動承認フックがツール制限をバイパスして動作してしまう問題を修正しました。
英語原文を表示
Fixed PreToolUse auto-allow hooks bypassing tool restrictions in background agent tasks (summaries, compaction, renames)

v2.1.218(1件)

未信頼フォルダーからのエージェントフック実行を禁止し、ワークスペースの信頼が必要となりました。
英語原文を表示
Fixed agent frontmatter hooks running from untrusted folders: hooks now require the agent file's own folder to have accepted workspace trust

変更後

外部からダウンロードしたプロジェクト等で未知のコードが勝手に実行されるのを防げます。

関連ドキュメント

v2.1.216(1件)

ファイル変更フック後の @-mention が何も添付しない問題、vim のドットリピートによる操作の誤作動、再開時のステータスライン重複、再開ピッカーのハングアップを修正しました。
英語原文を表示
Fixed @-mentions silently attaching nothing after file-modifying hooks, vim dot-repeat of c-operators and paste, statusline running twice on resume, and resume-picker hangs on failure

v2.1.214(2件)

フックのstdout JSONがスキーマバリデーションに失敗した場合に、終了コード2が適切にブロックとして動作しなかった問題を修正しました。
英語原文を表示
Fixed hooks with exit code 2 not blocking as documented when the hook's stdout JSON fails schema validation

変更後

フックによる権限ポリシーの強制力が、出力形式に関わらず維持されます。

関連ドキュメント

SessionStart フックにおいて、セッションがフォークで開始された場合、ソースを resume ではなく fork と報告するように変更しました。
英語原文を表示
Changed SessionStart hooks to report source "fork" when a session begins as a fork instead of "resume"

変更後

ログやイベント監視において、セッションの発生経緯が正確に特定できます。

v2.1.207(1件)

プラグインのフック/モニター等において、シェル形式コマンドでの${user_config.*}の使用が禁止されました。シェルインジェクション対策のため、今後はexec形式(args配列)または環境変数を使用してください。
英語原文を表示
Plugin hooks/monitors/MCP headersHelper: ${user_config.*} in shell-form commands is now rejected (shell-injection fix). Hooks: use exec form (args array) or $CLAUDE_PLUGIN_OPTION_<KEY>; monitors and headersHelper: read the value inside the script (config file or the server's env block).

変更後

プラグインをより安全に利用できるようになり、セキュリティを維持しつつ便利なカスタマイズが可能になります。

関連ドキュメント

v2.1.204(1件)

ヘッドレスセッションのSessionStartフックにおいて、フックイベントがストリーミングされない問題を修正しました。これにより、フックの実行中にリモートワーカーがアイドル状態とみなされて強制終了される問題が解消されます。
英語原文を表示
Fixed hook events not streaming during SessionStart hooks in headless sessions, which could cause remote workers to be idle-reaped mid-hook

変更後

自動化されたワークフローやCI/CDパイプラインにおいて、初期化フックが途中でタイムアウトしたり中断されたりする心配がなくなり、大規模なプロジェクトのセットアップを安定して行えるようになります。

関連ドキュメント

v2.1.199(1件)

SessionStart、Setup、およびSubagentStartフックが終了コード2で終了する際、標準エラー出力(stderr)を隠してしまう問題を修正し、内容がトランスクリプトに表示されるようにしました。
英語原文を表示
Fixed SessionStart, Setup, and SubagentStart hooks silently hiding stderr when exiting with code 2 — the error is now shown in the transcript

変更後

フックの設定やスクリプトに問題がある場合でも、迅速に原因を把握して修正できます。

v2.1.191(1件)

「Bash,PowerShell」のようにカンマで区切られたフックの検索条件が適用されない不具合を修正しました
英語原文を表示
Fixed hooks with comma-separated matchers (e.g. "Bash,PowerShell") silently never firing

変更後

フックの設定漏れや予期せぬ動作を回避でき、自動化処理の信頼性が高まります。

関連ドキュメント

v2.1.183(1件)

集中モード(focus mode)の応答下部に、PostToolUseフックの実行時間に関するデバッグ行が表示される問題を修正しました。
英語原文を表示
Fixed focus mode showing "Ran N PostToolUse hooks" timing lines under each response

v2.1.178(1件)

Linux のサンドボックス環境において、スキルやフックのディレクトリがシンボリックリンクの場合に起動できない問題を修正しました。
英語原文を表示
Fixed Linux sandbox failing to start when .claude/skills or .claude/hooks is a symlink

変更後

設定ファイルを複数の場所で共有・管理している開発環境でも、セキュリティ機能を有効にしたまま安全に Claude Code を利用できます。

関連ドキュメント

v2.1.169(1件)

トラブルシューティング用に、すべてのカスタマイズ(CLAUDE.md、プラグイン、スキル、ホック、MCPサーバー)を無効にして起動する --safe-mode フラグを追加しました。
英語原文を表示
Added --safe-mode flag (and CLAUDE_CODE_SAFE_MODE) to start Claude Code with all customizations (CLAUDE.md, plugins, skills, hooks, MCP servers) disabled for troubleshooting

変更後

複雑な設定を維持したまま、問題発生時の原因究明を迅速に行えるようになります。

v2.1.163(2件)

フック:Stop および SubagentStop フックが hookSpecificOutput.additionalContext を返せるよう改善。エラー扱いせずに Claude へフィードバックを返し、ターンを継続可能
英語原文を表示
Hooks: Stop and SubagentStop hooks can now return hookSpecificOutput.additionalContext to give Claude feedback and keep the turn going without being labeled a hook error

変更後

特定のタスク終了時にカスタムの指示やフィードバックを自動で挿入できるため、より高度な自動化ワークフローが実現します。

関連ドキュメント

stdio MCP サーバーが、--resume 実行時にフックや Bash と同じ CLAUDE_CODE_SESSION_ID を受け取るよう変更
英語原文を表示
stdio MCP servers now receive the same CLAUDE_CODE_SESSION_ID as hooks/Bash on --resume

変更後

外部ツールやログの相関分析を行う際に、MCP サーバーの動作を正確に現在のセッションに紐付けることができます。

関連ドキュメント

v2.1.161(1件)

Windows 環境において、bash を明示的に呼び出すフック(例: /usr/bin/bash script.sh)が「コマンドが見つかりません」などのエラーで失敗する問題を修正。
英語原文を表示
Fixed Windows hooks that invoke bash explicitly (e.g., /usr/bin/bash script.sh) failing with "command not found" or "cannot execute binary file"

変更後

マルチプラットフォームで共有されているプロジェクトにおいて、Windows ユーザーでも共通のフックスクリプトをそのまま利用できるようになります。

v2.1.152(3件)

SessionStart フックが reloadSkills: true を返せるようになり、フックによってインストールされたスキルを同じセッションですぐに利用可能になりました。
英語原文を表示
SessionStart hooks can now return reloadSkills: true to re-scan skill directories, making skills installed by the hook available in the same session

変更後

環境構築スクリプトなどをフックに組み込んだ際、自動セットアップされたツールをすぐに Claude に使わせることができます。

関連ドキュメント

SessionStart フックが hookSpecificOutput.sessionTitle を通じて、起動時やレジューム時のセッションタイトルを設定できるようになりました。
英語原文を表示
SessionStart hooks can now set the session title via hookSpecificOutput.sessionTitle on startup and resume

変更後

多数のバックグラウンドセッションを並行して実行している場合でも、各セッションの目的を識別しやすくなります。

関連ドキュメント

MessageDisplay フックイベントを追加し、フックによってアシスタントのメッセージ表示を変換または非表示にできるようになりました。
英語原文を表示
Added a MessageDisplay hook event that lets hooks transform or hide assistant message text as it is displayed

v2.1.149(1件)

git worktree使用時のサンドボックス書き込み許可リストを修正:メインリポジトリ全体ではなく、共有の.gitディレクトリ(hooks/とconfigは除外)のみをカバーするよう制限しました
英語原文を表示
Fixed the sandbox write allowlist in git worktrees covering the entire main repository root instead of only the shared .git directory (with hooks/ and config denied)

変更後

複数のワークツリーを並行して使用する際の安全性が向上し、メインのプロジェクト設定を誤って変更される心配がなくなります。

v2.1.145(1件)

/plugin の発見・閲覧画面において、インストール前にプラグインのコマンド、エージェント、スキル、フック、MCP/LSPサーバーを確認できるように改善
英語原文を表示
/plugin Discover and Browse screens now show a plugin's commands, agents, skills, hooks, and MCP/LSP servers before installation

変更後

自分のニーズに合ったプラグインかどうかを事前に判断できるため、不要なプラグインのインストールを避け、安心して機能を拡張できます。

v2.1.144(1件)

WorktreeCreate フックが設定されている場合、git 以外の VCS ユーザーでもバックグラウンドセッションのワークツリー隔離ガードが適用されるようになりました
英語原文を表示
Background session worktree isolation guard now applies for non-git VCS users with WorktreeCreate hooks configured

変更後

どのような開発環境でも、バックグラウンドでの AI の作業が自分の手元の作業を誤って上書きしてしまうリスクが解消されます。

関連ドキュメント

v2.1.143(1件)

ループを繰り返してブロックし続けるStopフックの修正:8回連続でブロックされた場合、警告を表示してターンを終了するようになりました
英語原文を表示
Fixed stop hooks that block repeatedly looping forever — the turn now ends with a warning after 8 consecutive blocks (override via CLAUDE_CODE_STOP_HOOK_BLOCK_CAP)

変更後

バグのあるフックスクリプトによる意図しない課金の発生を防ぎ、安全に自動化を運用できます。

関連ドキュメント

v2.1.141(2件)

フックのJSON出力にterminalSequenceフィールドを追加し、制御端末がなくてもフックがデスクトップ通知、ウィンドウタイトル、ベルを送信できるように改善。
英語原文を表示
Added terminalSequence field to hook JSON output so hooks can emit desktop notifications, window titles, and bells without a controlling terminal

変更後

CI環境やバックグラウンドプロセスなどの非対話型環境で実行されるフックでも、ユーザーのデスクトップに対して重要なステータス通知を届けられるようになります。

関連ドキュメント

ワークツリー切り替え後にフックが不正なtranscript_pathを受け取ってしまう問題を修正。
英語原文を表示
Fixed hooks receiving a non-existent transcript_path after EnterWorktree switches the working directory

変更後

作業の自動化スクリプトや監視フックが、ワークツリー環境下でも途切れることなく確実に会話履歴へアクセスできるようになります。

関連ドキュメント

v2.1.140(1件)

シンボリックリンクされた設定ファイルにおいて、設定のホットリロードが誤った変更イベントを検知し、不要な ConfigChange フックをトリガーしていたデグレードを修正
英語原文を表示
Fixed a regression in settings hot-reload where symlinked settings files caused misattributed change events and spurious ConfigChange hooks

変更後

設定管理の柔軟性を保ちつつ、自動化スクリプトの誤作動を回避して安定したワークフローを維持できます。

関連ドキュメント

v2.1.139(2件)

MCP stdioサーバーが環境変数CLAUDE_PROJECT_DIRを受け取るよう変更。プラグイン設定で${CLAUDE_PROJECT_DIR}をコマンド内で参照可能になりました。
英語原文を表示
MCP stdio servers now receive CLAUDE_PROJECT_DIR in their environment, matching hooks. Plugin configs can reference ${CLAUDE_PROJECT_DIR} in commands

変更後

プロジェクトごとに異なる設定ファイルやデータにアクセスするMCPツールの開発が容易になります。

関連ドキュメント

フックの出力がターミナル表示を乱すバグを修正。フックはターミナルへの直接アクセスなしで実行されるようになります。
英語原文を表示
Fixed a bug where a hook writing to the terminal could corrupt an on-screen interactive prompt; hooks now run without terminal access

v2.1.136(2件)

キャッシュクリーンアップによって使用中のバージョンが削除された際、プラグインの Stop や UserPromptSubmit フックが失敗する問題を修正しました。
英語原文を表示
Fixed plugin Stop/UserPromptSubmit hooks failing when cache cleanup deletes a version still in use by a running session

変更後

バックグラウンドのメンテナンス処理を気にすることなく、安定してプラグインや自動化フックを利用し続けることができます。

関連ドキュメント

CLAUDE_ENV_FILE を利用した SessionStart フックによる環境変数が、セッション再開やクリア後に無効になる問題を修正しました。
英語原文を表示
Fixed env vars from CLAUDE_ENV_FILE SessionStart hooks going stale after /resume or /clear

変更後

ツール実行に必要な環境変数を一度設定すれば、セッションの状態が変わっても一貫して使い続けることができます。

関連ドキュメント

v2.1.132(1件)

Bash ツールのサブプロセス環境に CLAUDE_CODE_SESSION_ID 環境変数を追加し、フックに渡される session_id と一致させました
英語原文を表示
Added CLAUDE_CODE_SESSION_ID environment variable to the Bash tool subprocess environment, matching the session_id passed to hooks

変更後

セッションごとにログを分けたり、フックで開始した外部プロセスと Bash ツールでの操作を紐付けたりする自動化ワークフローがより確実かつ簡単に構築できるようになります。

関連ドキュメント

v2.1.128(1件)

サブプロセス(Bash、フック、MCP、LSP)が OTEL_* 環境変数を継承しなくなりました。これにより Bash ツール経由のアプリが CLI 自身の OTLP エンドポイントを拾わなくなります
英語原文を表示
Subprocesses (Bash, hooks, MCP, LSP) no longer inherit OTEL_* environment variables, so OTEL-instrumented apps run via the Bash tool no longer pick up the CLI's own OTLP endpoint

変更後

開発中のアプリケーションの動作やテストにおいて、環境変数の汚染による予期せぬ挙動を防ぐことができます。

関連ドキュメント

v2.1.122(1件)

settings.json 内の hooks 項目の記述が不正な場合に、ファイル全体が無効化されてしまう問題を修正しました
英語原文を表示
Fixed a malformed hooks entry in settings.json no longer invalidating the entire file

変更後

設定ミスによるツールの動作不能を防ぎ、一部のエラーがあっても安全にツールを使い続けることができます。

v2.1.121(1件)

PostToolUse フックが、すべてのツールにおいて hookSpecificOutput.updatedToolOutput を介してツールの出力を置換できるようになりました(以前は MCP ツールのみ対応)。
英語原文を表示
PostToolUse hooks can now replace tool output for all tools via hookSpecificOutput.updatedToolOutput (previously MCP-only)

変更後

秘匿情報のマスキングや、巨大なログ出力の要約など、Claude に渡す情報をフックでインテリジェントに制御し、コンテキストの質を高めることができます。

関連ドキュメント

v2.1.119(2件)

フック機能の改善:PostToolUse および PostToolUseFailure の入力 JSON に、ツールの純粋な実行時間を示す duration_ms が含まれるようになりました(承認待機時間は除く)
英語原文を表示
Hooks: PostToolUse and PostToolUseFailure hook inputs now include duration_ms (tool execution time, excluding permission prompts and PreToolUse hooks)

変更後

独自のメトリクス収集や、処理の重いツール呼び出しの検知など、開発プロセスの分析と最適化がより精緻に行えるようになります。

関連ドキュメント

レスポンスを返さない非同期の PostToolUse フックが、セッション履歴に空のエントリを書き込んでしまう問題を修正しました
英語原文を表示
Fixed async PostToolUse hooks that emit no response payload writing empty entries to the session transcript

変更後

/resume などで会話履歴を見返す際、不要な空白が排除され、本来の会話内容が読みやすくなります。

関連ドキュメント

v2.1.118(2件)

エージェント型フックが Stop 等の特定のイベント以外で「メッセージが必要」というエラーで失敗する問題を修正
英語原文を表示
Fixed agent-type hooks failing with "Messages are required for agent hooks" when configured for events other than Stop or SubagentStop

変更後

特定のライフサイクルイベントにおいて、エージェントによる高度な自動検証を柔軟に組み込めるようになります。

関連ドキュメント

エージェントフック内の検証用サブエージェントが実行したツール呼び出しで、再度 prompt フックが発火する問題を修正
英語原文を表示
Fixed prompt hooks re-firing on tool calls made by an agent-hook verifier subagent

変更後

フックの実行コスト(トークン使用量)が最適化され、意図しないフックの連鎖を防げます。

関連ドキュメント

v2.1.116(1件)

エージェントの frontmatter 内の hooks: が、--agent フラグを使用したメインスレッド・エージェント実行時にも発火するように修正
英語原文を表示
Agent frontmatter hooks: now fire when running as a main-thread agent via --agent

変更後

特定の役割(セキュリティ担当やレビュアーなど)を担うエージェントを直接起動した際も、自動フォーマットなどのカスタムワークフローが期待通りに動作します。

関連ドキュメント

v2.1.110(1件)

PermissionRequestフックによる入力更新後にpermissions.denyルールが再チェックされない問題、およびバイパス設定が制限を無視できる問題を修正
英語原文を表示
Fixed PermissionRequest hooks returning updatedInput not being re-checked against permissions.deny rules; setMode:'bypassPermissions' updates now respect disableBypassPermissionsMode

変更後

組織で設定したセキュリティポリシーをバイパスされるリスクが解消され、フック機能を安心して業務に組み込めます。

関連ドキュメント

v2.1.105(1件)

PreCompactフックのサポートを追加し、コード2の終了ステータスまたは特定のJSON返却によってコンパクションをブロックできるようになりました
英語原文を表示
Added PreCompact hook support: hooks can now block compaction by exiting with code 2 or returning {"decision":"block"}

変更後

重要な会話の文脈が自動圧縮で失われるのを防ぎたい自動化スクリプトや、特定のワークフローにおいて、コンテキストの整合性を維持しやすくなります。

関連ドキュメント

v2.1.101(1件)

管理設定で allowManagedHooksOnly が有効な場合でも、強制有効化されたプラグインのフックが実行されるよう改善
英語原文を表示
Improved plugin hooks from plugins force-enabled by managed settings to run when allowManagedHooksOnly is set

変更後

セキュリティを確保しつつ、組織で推奨される自動化ツールを確実に動作させることができます。

関連ドキュメント

v2.1.98(1件)

長時間セッションでのプロンプト型 Stop/SubagentStop フックの失敗、およびフック評価時の API エラーが不正確に表示される問題を修正しました。
英語原文を表示
Fixed prompt-type Stop/SubagentStop hooks failing on long sessions, and hook evaluator API errors showing "JSON validation failed" instead of the real message

変更後

ワークフローの自動化や検証をフックで行っている場合、その信頼性とメンテナンス性が大幅に向上します。

関連ドキュメント

v2.1.97(1件)

長いセッションでプロンプトタイプのStop/SubagentStopフックが失敗する問題、およびフック評価時のAPIエラーが具体的なメッセージではなく「JSON validation failed」と表示される問題を修正しました。
英語原文を表示
Fixed prompt-type Stop/SubagentStop hooks failing on long sessions, and hook evaluator API errors displaying "JSON validation failed" instead of the actual message

変更後

自動化された後処理や通知が確実に実行されるようになり、開発ワークフローの信頼性が向上します。

関連ドキュメント

v2.1.94(3件)

UserPromptSubmit フックに hookSpecificOutput.sessionTitle を追加し、フック経由でのセッションタイトルの設定に対応
英語原文を表示
Added hookSpecificOutput.sessionTitle to UserPromptSubmit hooks for setting the session title

変更後

独自の命名規則に従ってセッションを自動整理したり、特定のキーワードが含まれる場合にタイトルを即座に変更したりといった自動化が可能になります。

関連ドキュメント

YAMLフロントマテリアルで定義されたプラグインスキルのフックが無視される問題を修正
英語原文を表示
Fixed plugin skill hooks defined in YAML frontmatter being silently ignored

変更後

スキルのライフサイクルに合わせたカスタム動作を確実に行えるようになり、より高度なプラグイン開発が可能になります。

関連ドキュメント

CLAUDE_PLUGIN_ROOT が未設定の場合にプラグインのフックがファイルエラーで失敗する問題を修正
英語原文を表示
Fixed plugin hooks failing with "No such file or directory" when CLAUDE_PLUGIN_ROOT was not set

変更後

プラグインの配布形式やユーザーの実行環境を問わず、フック機能が確実に動作するようになります。

v2.1.92(1件)

Stopイベントのプロンプト型フックが特定の応答で誤って失敗する問題を修正し、継続防止セマンティクスを復元。
英語原文を表示
Fixed prompt-type Stop hooks incorrectly failing when the small fast model returns ok:false, and restored preventContinuation:true semantics for non-Stop prompt-type hooks

変更後

フックを利用した自動化プロセスの信頼性が向上し、特定の条件下で処理を確実に停止させることが可能になります。

関連ドキュメント

v2.1.90(1件)

JSON を標準出力に書き出し、終了コード 2 で終了する PreToolUse フックが、正しくツール実行をブロックできない問題を修正しました。
英語原文を表示
Fixed PreToolUse hooks that emit JSON to stdout and exit with code 2 not correctly blocking the tool call

変更後

独自に作成したフックによる実行制限(破壊的なコマンドの禁止など)が意図通りに機能し、安全性が向上します。

関連ドキュメント

v2.1.89(3件)

PreToolUse フックに permission decision `
英語原文を表示
Added "defer" permission decision to PreToolUse hooks — headless sessions can pause at a tool call and resume with -p --resume to have the hook re-evaluate

変更後

Agent SDK アプリやカスタム UI から Claude Code を呼び出す際、ツール呼び出しの時点でセッションを一時停止して自前のインターフェースで入力を収集し、-p --resume で中断箇所から再開できる。

関連ドキュメント

Write/Edit/Read ツールの実行時、PreToolUse/PostToolUse フックに file_path が絶対パスとして渡されるよう修正し、ドキュメントに記載された動作と一致させた。
英語原文を表示
Fixed PreToolUse/PostToolUse hooks to receive file_path as an absolute path for Write/Edit/Read tools, matching the documented behavior

変更後

拡張後の file_path を前提にして書かれた公式ドキュメントやガイドのフックスクリプトが、意図どおりに動くようになる。

関連ドキュメント

フックの if 条件フィルタが複合コマンド(ls && git push)や環境変数プレフィックス付きのコマンド(FOO=bar git push)にマッチしない問題を修正した。
英語原文を表示
Fixed hooks if condition filtering not matching compound commands (ls && git push) or commands with env-var prefixes (FOO=bar git push)

変更後

FOO=bar git push や npm test && git push のような一般的なシェルコマンドパターンでも、設定されたフックが確実に発火するようになり、ツール実行の監査やガードの信頼性が向上する。

関連ドキュメント

v2.1.88(2件)

フックの if 条件フィルタリングが、複合コマンド(ls && git push)や環境変数プレフィックス付きのコマンドにマッチしない問題を修正しました
英語原文を表示
Fixed hooks if condition filtering not matching compound commands (ls && git push) or commands with env-var prefixes (FOO=bar git push)

変更後

特定のコマンド実行時に自動で行いたい処理(プッシュ前のバリデーションなど)の確実性が高まり、意図しない操作の防止や自動化の信頼性が向上します。

関連ドキュメント

Write/Edit/Readツールにおいて、PreToolUse/PostToolUseフックが file_path を絶対パスで提供していなかった問題を修正しました
英語原文を表示
Fixed PreToolUse/PostToolUse hooks not providing file_path as an absolute path for Write/Edit/Read tools

変更後

自動フォーマットやバリデーションなどのフックの信頼性が高まり、複雑なプロジェクト構造でも誤作動の心配なく自動化を任せられます。

関連ドキュメント

v2.1.85(2件)

フックにパーミッションルール構文(例: Bash(git *))を使用した条件付き「if」フィールドを追加し、実行フィルタリングによるプロセス生成のオーバーヘッドを削減
英語原文を表示
Added conditional if field for hooks using permission rule syntax (e.g., Bash(git *)) to filter when they run, reducing process spawning overhead

変更後

不要なフックの実行が抑制されることで、ターミナルの応答性が向上し、特に頻繁に発生するイベントでのリソース消費を抑えることができます。

関連ドキュメント

PreToolUseフックがupdatedInputとpermissionDecision: "allow"を返すことで、AskUserQuestionに応答可能になり、ヘッドレス環境での対話をサポート
英語原文を表示
PreToolUse hooks can now satisfy AskUserQuestion by returning updatedInput alongside permissionDecision: "allow", enabling headless integrations that collect answers via their own UI

変更後

CLIを直接操作できないCI/CD環境やカスタムアプリ経由の利用において、Claudeとの対話を自動化または外部UI化することが可能になります。

関連ドキュメント

v2.1.83(2件)

サブプロセス環境(Bash ツール、フック、MCP stdio サーバー)から Anthropic やクラウドプロバイダーの認証情報を削除する CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 を追加しました
英語原文を表示
Added CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 to strip Anthropic and cloud provider credentials from subprocess environments (Bash tool, hooks, MCP stdio servers)

変更後

開発環境における機密情報の露出を最小限に抑え、信頼できないコードを分析したり、外部の MCP ツールを利用したりする際の安全性が大幅に向上します。

関連ドキュメント

アンインストールされたプラグインのフックが、次のセッションを開始するまで動作し続けてしまう問題を修正しました。
英語原文を表示
Fixed uninstalled plugin hooks continuing to fire until the next session

v2.1.81(2件)

スクリプト実行用の --bare フラグを追加しました。フック、LSP、プラグイン同期、スキルディレクトリの走査をスキップし、自動メモリ機能も完全に無効化されます。
英語原文を表示
Added --bare flag for scripted -p calls — skips hooks, LSP, plugin sync, and skill directory walks; requires ANTHROPIC_API_KEY or an apiKeyHelper via --settings (OAuth and keychain auth disabled); auto-memory fully disabled

変更後

CI/CD パイプラインや自動化スクリプトにおいて、不要なオーバーヘッドを削減し、起動速度の向上と実行の安定性を確保できます。

セッション中にプラグインディレクトリが削除された場合、プラグインのフックがプロンプトの送信をブロックしてしまう問題を修正しました。
英語原文を表示
Fixed plugin hooks blocking prompt submission when the plugin directory is deleted mid-session

v2.1.79(1件)

対話的な /resume を使ってセッションを切り替えた際、SessionEnd フックが実行されない問題を修正
英語原文を表示
Fixed SessionEnd hooks not firing when using interactive /resume to switch sessions

変更後

セッション終了時のクリーンアップ作業やログ記録などを、どのような切り替え操作を行っても確実に行うことができます。

関連ドキュメント

v2.1.78(2件)

APIエラーが stop フックを誘発し、モデルにエラーを再入力し続けてしまう無限ループを修正
英語原文を表示
Fixed infinite loop when API errors triggered stop hooks that re-fed blocking errors to the model

変更後

予期せぬエラー発生時でもリソースやトークンの浪費を防ぎ、安定した動作が保証されます。

関連ドキュメント

--worktree フラグ使用時に、ワークツリーディレクトリ内のスキルやフックが読み込まれない問題を修正
英語原文を表示
Fixed --worktree flag not loading skills and hooks from the worktree directory

変更後

複数の機能を並行して開発する際も、一貫した開発体験と自動化ツールを維持できます。

関連ドキュメント

v2.1.77(2件)

PreToolUse フックが "allow" を返した際に、管理設定などの拒否ルールをバイパスしてしまう問題を修正しました
英語原文を表示
Fixed PreToolUse hooks returning "allow" bypassing deny permission rules, including enterprise managed settings

変更後

組織レベルで設定したセキュリティポリシーが確実に適用されるため、安全にフック機能を活用できます。

関連ドキュメント

claude plugin validate でスキルやエージェントのフロントマター、およびフックの設定ファイルを検証できるようになりました
英語原文を表示
Improved claude plugin validate to check skill, agent, and command frontmatter plus hooks/hooks.json, catching YAML parse errors and schema violations

変更後

プラグイン開発のデバッグ効率が上がり、より高品質な拡張機能を短時間で作成できます。

関連ドキュメント

v2.1.76(1件)

新しいElicitationおよびElicitationResultフックを追加 — 応答が返される前に、内容をインターセプトして上書きできるようになりました
英語原文を表示
Added new Elicitation and ElicitationResult hooks to intercept and override responses before they're sent back

変更後

elicitationプロセスにおけるカスタムバリデーションの追加や、特定の入力を自動補完するなどの高度な自動化が可能になります。

関連ドキュメント

v2.1.74(1件)

終了時の SessionEnd フックが hook.timeout 設定にかかわらず1.5秒で強制終了される問題を修正 — CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS で設定可能に
英語原文を表示
Fixed SessionEnd hooks being killed after 1.5 s on exit regardless of hook.timeout — now configurable via CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS

変更後

大切な後処理や自動化スクリプトが途中で途切れる心配がなくなり、開発ワークフローの自動化がより堅牢になります。

関連ドキュメント

v2.1.73(2件)

セッションを再開した際に、SessionStart フックが2回重複して実行される問題を修正
英語原文を表示
Fixed SessionStart hooks firing twice when resuming a session via --resume or --continue

変更後

セッション開始時の待ち時間が短縮され、プロジェクト固有の環境構築がより正確に行われます。

関連ドキュメント

JSON出力形式のフックが、モデルのコンテキストに不要なシステムリマインダーを毎ターン挿入していた問題を修正
英語原文を表示
Fixed JSON-output hooks injecting no-op system-reminder messages into the model's context on every turn

変更後

フックを多用してもコンテキストウィンドウが圧迫されにくくなり、長時間の対話でも一貫した性能が維持されます。

関連ドキュメント

v2.1.72(3件)

バックグラウンドタスクやフックの応答が遅い場合に終了処理が停滞する問題を修正
英語原文を表示
Fixed slow exits when background tasks or hooks were slow to respond
フックが有効なスキルがモデルから呼び出された際、1つのイベントに対してスキルフックが2回実行される問題を修正
英語原文を表示
Fixed skill hooks firing twice per event when a hooks-enabled skill is invoked by the model
transcript_path の不備や設定保存時の prompt 消失、async フックの stdin 問題など、フック機能の複数の不具合を修正
英語原文を表示
Fixed several hooks issues: transcript_path pointing to the wrong directory for resumed/forked sessions, agent prompt being silently deleted from settings.json on every settings write, PostToolUse block reason displaying twice, async hooks not receiving stdin with bash read -r, and validation error message showing an example that fails validation

変更後

自作のフックを用いた高度なワークフロー自動化を、予期せぬエラーに悩まされることなく構築できます。

関連ドキュメント

v2.1.69(4件)

Fixed plugin hooks being silently dropped when two plugins use the same ${CLAUDE_PLUGIN_ROOT}/... command template

関連ドキュメント

Fixed TeammateIdle and TaskCompleted hooks to support {"continue": false, "stopReason": "..."} to stop the teammate, matching Stop hook behavior

関連ドキュメント

Fixed WorktreeCreate and WorktreeRemove plugin hooks being silently ignored

関連ドキュメント

v2.1.64(3件)

TeammateIdle および TaskCompleted フックにおいて、Stop フックと同様の {"continue": false, "stopReason": "..."} 形式によるチームメイトの停止をサポートしました。
英語原文を表示
Fixed TeammateIdle and TaskCompleted hooks to support {"continue": false, "stopReason": "..."} to stop the teammate, matching Stop hook behavior

変更後

チームメイトの無駄な待機時間を削減し、特定の状況下での自動化フローの制御がより正確に行えるようになります。

関連ドキュメント

プラグインによって登録された WorktreeCreate および WorktreeRemove フックが、誤って無視されてしまう問題を修正しました。
英語原文を表示
Fixed WorktreeCreate and WorktreeRemove plugin hooks being silently ignored

関連ドキュメント

プラグインや SDK 利用者によって登録された WorktreeCreate フックが無視される問題を修正しました。
英語原文を表示
Fixed WorktreeCreate hooks registered by plugins or SDK consumers being silently ignored

関連ドキュメント

v2.1.63(2件)

JSONをURLにPOSTし、JSONを受け取ることができるHTTPフックが追加されました。これにより、シェルコマンドの実行に代わる選択肢が増えました。
英語原文を表示
Added HTTP hooks, which can POST JSON to a URL and receive JSON instead of running a shell command

変更後

外部APIやWebサービスとの連携が容易になり、より多様な自動化ワークフローを構築できるようになりました。

関連ドキュメント

フック設定メニューの移動中に発生していたメモリリークが修正されました。
英語原文を表示
Fixed memory leak when navigating hooks configuration menu

v2.1.50(2件)

セッションの復旧時に作業ディレクトリにシンボリックリンクが含まれている場合、セッションストレージパスが起動時に異なるタイミングで解決されるためにセッションが見えなくなる問題を修正しました。また、グレーシャルシャットダウンシーケンスで、フックと分析の前にセッションデータをフラッシュすることでSSH切断時のセッションデータ損失も修正しました。
英語原文を表示
Fixed a bug where resumed sessions could be invisible when the working directory involved symlinks, because the session storage path was resolved at different times during startup. Also fixed session data loss on SSH disconnect by flushing session data before hooks and analytics in the graceful shutdown sequence.

変更後

セッションの可視性と信頼性が向上し、開発者は中断した作業を確実に再開できるようになります。データ損失のリスクも軽減され、安心して利用できます。

関連ドキュメント

CLAUDE_CODE_SIMPLEモードでは、MCPツール、アタッチメント、フック、CLAUDE.mdファイルの読み込みも無効になり、完全に最小限の体験を提供します。
英語原文を表示
CLAUDE_CODE_SIMPLE mode now also disables MCP tools, attachments, hooks, and CLAUDE.md file loading for a fully minimal experience.

関連ドキュメント

v2.1.49(1件)

disableAllHooks設定が管理対象設定の階層を尊重するように修正されました。非管理対象設定では、ポリシーによって設定された管理対象フックを無効化できなくなりました。(#26637)
英語原文を表示
Fixed disableAllHooks setting to respect managed settings hierarchy — non-managed settings can no longer disable managed hooks set by policy (#26637)

変更後

エンタープライズ環境でClaude Codeを利用する管理者は、組織のセキュリティポリシーやワークフローに必要なフックが常に有効であることを保証できるようになります。ユーザーが誤って重要なフックを無効化する心配がなくなり、より安全で統制の取れた開発環境を維持できます。

関連ドキュメント

v2.1.47(2件)

StopおよびSubagentStopフック入力に last_assistant_message フィールドを追加しました。これにより、フックはトランスクリプトファイルを解析することなく、最終的なアシスタントの応答テキストにアクセスできるようになります。
英語原文を表示
Added last_assistant_message field to Stop and SubagentStop hook inputs, providing the final assistant response text so hooks can access it without parsing transcript files.

変更後

フック開発者がアシスタントの最終応答に簡単にアクセスできるようになり、より効率的で堅牢なフックの作成が可能になりました。

関連ドキュメント

WindowsでGit Bashではなくcmd.exeを使用していたため、フック(PreToolUse、PostToolUse)がサイレントに実行に失敗する問題を修正しました(anthropics/claude-code#25981)。
英語原文を表示
Fixed hooks (PreToolUse, PostToolUse) silently failing to execute on Windows by using Git Bash instead of cmd.exe (anthropics/claude-code#25981)

変更後

Windows環境でのフック実行が安定し、Git Bashの利用によりPreToolUseやPostToolUseといった重要な自動化処理が正しく機能するようになりました。

v2.1.45(1件)

プラグイン提供のコマンド、エージェント、フックが、再起動なしでインストール直後から利用可能になりました。
英語原文を表示
Fixed plugin-provided commands, agents, and hooks not being available immediately after installation without requiring a restart

変更後

プラグインの追加や更新がよりスムーズになり、開発者はツールのセットアップ時間を短縮して、すぐに作業を開始できます。

v2.1.23(1件)

ヘッドレスストリーミングセッションが終了した際に保留中の非同期フックがキャンセルされない問題が修正されました。
英語原文を表示
Fixed pending async hooks not being cancelled when headless streaming sessions ended

v2.1.19(1件)

追加の権限やフックを必要としないスキルについては、承認なしで実行できるように変更しました。
英語原文を表示
Changed skills without additional permissions or hooks to be allowed without requiring approval

v2.1.9(1件)

PreToolUse フックがモデルに追加のコンテキストを返すサポートを追加しました。
英語原文を表示
Added support for PreToolUse hooks to return additionalContext to the model

変更後

これにより、フックはツールの実行前にモデルに追加のコンテキストを提供できるようになり、よりインテリジェントな意思決定や、フックによるツール実行の制御が可能になります。

関連ドキュメント

v2.1.3(1件)

ホームディレクトリから実行した場合に、トラストダイアログの承認によってセッション中にフックなどの信頼が必要な機能が有効にならない問題を修正しました。
英語原文を表示
Fixed trust dialog acceptance when running from the home directory not enabling trust-requiring features like hooks during the session

v2.1.0(6件)

PreToolUse フックで、ユーザーへの確認(ask)を返しつつ入力を書き換える(updatedInput)ことが可能になり、ユーザーの同意を得ながら動作するミドルウェアとしてフックを利用できるようになりました。
英語原文を表示
Fixed PreToolUse hooks to allow updatedInput when returning ask permission decision, enabling hooks to act as middleware while still requesting user consent

変更後

不適切なコマンド引数を自動補正しながら最終判断は人間に委ねるという、安全性と柔軟性を両立した高度なガードレールを構築できます。

関連ドキュメント

エージェントのフロントマターでフック設定が可能になり、エージェントの生存期間に限定したフックを定義できるようになりました。
英語原文を表示
Added hooks support to agent frontmatter, allowing agents to define PreToolUse, PostToolUse, and Stop hooks scoped to the agent's lifecycle
スキルおよびスラッシュコマンドのフロントマターでフック設定をサポートしました。
英語原文を表示
Added hooks support for skill and slash command frontmatter
フック設定に once: true を追加し、セッション内で一度だけ実行して削除されるフックを定義できるようになりました。
英語原文を表示
Added support for once: true config for hooks

変更後

セットアップ処理や初回限定の通知などを、無駄な繰り返しを避けてスマートに自動化できます。

関連ドキュメント

プラグインからのフックで、コマンド形式に加えてプロンプト形式およびエージェント形式をサポートしました。
英語原文を表示
Added support for prompt and agent hook types from plugins (previously only command hooks were supported)
/hooks メニューにおいて、スクロール中に誤ったフックタイプが選択されてしまう UI の不具合を修正しました。
英語原文を表示
Fixed /hooks menu selecting wrong hook type when scrolling to a different option

変更後

複雑なフックの構成を、CLI 上でミスなく直感的に行えるようになります。

関連ドキュメント

v2.0.54(1件)

Hooks: Enable PermissionRequest hooks to process 'always allow' suggestions and apply permission updates

v2.0.42(1件)

v2.0.41(3件)

Added model parameter to prompt-based stop hooks, allowing users to specify a custom model for hook evaluation

関連ドキュメント

Fixed crash when plugin command hooks timeout during execution

v2.0.35(1件)

Fixed menu navigation getting stuck on items with empty string or other falsy values (e.g., in the /hooks menu)

関連ドキュメント

v2.0.30(2件)

Added prompt-based stop hooks
Fixed hooks and plugins not executing when using --dangerously-skip-permissions flag

v2.0.12(2件)

**Plugin System Released**: Extend Claude Code with custom commands, agents, hooks, and MCP servers from marketplaces

関連ドキュメント

v2.0.10(1件)

PreToolUse hooks can now modify tool inputs

v1.0.115(1件)

Show condensed output for post-tool hooks to reduce visual clutter

v1.0.112(1件)

Hooks: Added systemMessage support for SessionEnd hooks

v1.0.59(1件)

Hooks: Exposed PermissionDecision to hooks (including "ask")

v1.0.38(1件)

Released hooks. Special thanks to community input in https://github.com/anthropics/claude-code/issues/712. Docs: https://code.claude.com/docs/en/hooks