settings.json

bgIsolation

バックグラウンドセッションの隔離モードを、独立した作業ツリーを使用するか、直接作業コピーを編集するかで設定します。

使い方・用途

  • 巨大なモノレポなど、git worktree の作成に時間がかかりすぎて実用的でない環境で "none" を指定してパフォーマンスを改善します。
  • worktree をサポートしていない開発環境でも、バックグラウンドでの並列作業を可能にします。
英語原文(公式ドキュメントより)

Isolation mode for background sessions. "worktree" blocks Edit/Write in main checkout until EnterWorktree is called; "none" lets background jobs edit the working copy directly without EnterWorktree, for repos where worktrees are impractical. See https://code.claude.com/docs/en/settings#worktree-settings

関連する変更履歴

v2.1.143(1件)

Added
worktree.bgIsolation: "none" 設定を追加し、worktreeの利用が現実的でないリポジトリでバックグラウンドセッションが作業コピーを直接編集できるようにしました
英語原文を表示
Added worktree.bgIsolation: "none" setting to let background sessions edit the working copy directly without EnterWorktree, for repos where worktrees are impractical

変更前

バックグラウンドセッションは常に独立したgit worktreeを必要としていましたが、巨大なモノレポなどworktree作成に時間がかかる環境では不便でした。

変更後

設定によりworktreeをスキップし、現在のディレクトリを直接編集できるようになります。

ユーザーへの恩恵

worktreeをサポートしていない、あるいは非効率な開発環境でも、バックグラウンドでの並列作業が可能になります。

関連ドキュメント