settings.json

hooks.WorktreeCreate

型array

サブエージェント等でワークツリーが作成される際に実行されるフック。

使い方・用途

  • Git 以外の VCS(SVN等)を使用している環境や、独自の管理フローを持つプロジェクトにおいて、並行作業用のワークツリー作成処理をカスタムスクリプトで代替・自動化します。
英語原文(公式ドキュメントより)

Hooks that run when a worktree is created via --worktree or isolation: "worktree" in subagents. Command handlers only, no matchers. Hook must print absolute path to created worktree on stdout; non-zero exit fails creation. See https://code.claude.com/docs/en/hooks#worktreecreate

関連ドキュメント

関連する変更履歴

v2.1.301(1件)

Fixed
WorktreeCreate フックで作成された worktree に未プッシュのコミットが残っている可能性がある場合、確認なしに終了時に削除されてしまう問題を修正した。
英語原文を表示
Fixed quitting removing a worktree made by a WorktreeCreate hook without asking when it may hold unpushed commits

関連ドキュメント

v2.1.300(1件)

Fixed
Claude Code が --worktree 付きで起動した場合にプラグインの WorktreeCreate と WorktreeRemove フックが実行されない問題を修正した(--tmux ではまだ未対応)
英語原文を表示
Fixed plugin WorktreeCreate and WorktreeRemove hooks not running when Claude Code starts with --worktree (not yet with --tmux)

関連ドキュメント

v2.1.281(1件)

Improved
/batch を改善し、git リポジトリ内だけでなく、WorktreeCreate フックが agent の worktree を提供する場所でも実行できるようにした
英語原文を表示
Improved /batch to run where a WorktreeCreate hook provides the agent worktrees, not only inside a git repository

変更後

/batch を git リポジトリの外でも実行できるようになり、SVN や Perforce など git 以外のバージョン管理システムを使うプロジェクトでも、WorktreeCreate フックを設定すればバッチ処理を並列実行できる。

関連ドキュメント

v2.1.203(1件)

Fixed
WorktreeCreateフック設定時に、非Gitディレクトリから開始されたバックグラウンドセッションがファイル編集できない問題を修正しました。
英語原文を表示
Fixed background sessions started from a non-git directory unable to edit files when a WorktreeCreate hook was configured

変更後

SVNやPerforceなど、Git以外のバージョン管理環境でもエージェント機能が活用可能になります。

関連ドキュメント

v2.1.144(1件)

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

変更後

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

関連ドキュメント

v2.1.85(1件)

Fixed
非Gitリポジトリで--worktreeを使用した場合、WorktreeCreateフックが実行される前にエラーで終了してしまう問題を修正
英語原文を表示
Fixed --worktree exiting with an error in non-git repositories before the WorktreeCreate hook could run

変更後

Git以外のプロジェクト管理ツールを使用している開発者も、Claude Codeの強力な並行作業機能を活用できるようになります。

関連ドキュメント

v2.1.84(1件)

Added
HTTPタイプの WorktreeCreate フックで作成されたパスの返却に対応
英語原文を表示
Added WorktreeCreate hook support for type: "http" — return the created worktree path via hookSpecificOutput.worktreePath in the response JSON

変更後

独自のサーバーで管理している複雑なワークツリー作成フローをClaude Codeとシームレスに統合でき、並行作業の自動化がより強固になります。

関連ドキュメント

v2.1.69(1件)

Fixed
Fixed WorktreeCreate and WorktreeRemove plugin hooks being silently ignored

関連ドキュメント

v2.1.64(2件)

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

関連ドキュメント

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

関連ドキュメント

v2.1.50(1件)

Added
WorktreeCreateおよびWorktreeRemoveフックイベントが追加され、エージェントのワークツリー分離がワークツリーを作成または削除する際にカスタムVCSのセットアップとティアダウンが可能になりました。
英語原文を表示
Added WorktreeCreate and WorktreeRemove hook events, enabling custom VCS setup and teardown when agent worktree isolation creates or removes worktrees.

変更後

VCSのセットアップとティアダウンを自動化することで、開発者はワークツリーのライフサイクル管理にかかる手間を省き、より効率的に開発を進めることができます。

関連ドキュメント