settings.json

worktree.bgIsolation

型string既定値worktree記述場所どの設定ファイルでも可

バックグラウンドセッションの隔離モードです。"worktree" は EnterWorktree が呼ばれるまでメインチェックアウトでの Edit/Write をブロックし、"none" は worktree が実用的でないリポジトリ向けに、EnterWorktree なしでバックグラウンドジョブが作業コピーを直接編集できるようにします。

取りうる値

worktree既定セッションが EnterWorktree を呼び出すまで、Claude Code はメインチェックアウトでの Edit と Write をブロックします。
noneバックグラウンドジョブは作業コピーを直接編集します。

記述例

{
  "worktree": {
    "bgIsolation": "none"
  }
}

使い方・用途

  • バックグラウンドセッションの編集先を、worktree 隔離("worktree"、デフォルト)にするか作業コピーへの直接編集("none")にするかを選択する設定
  • デフォルトでは EnterWorktree が呼ばれるまでメインチェックアウトへの Edit/Write がブロックされるが、巨大なモノレポなど 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
Settings
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をサポートしていない、あるいは非効率な開発環境でも、バックグラウンドでの並列作業が可能になります。

関連ドキュメント