Claude Code、プラグイン依存解決と worktree 削除時の rm -rf 廃止を導入

概要

プラグインを多数組み合わせて依存解除順に悩む利用者と、background セッションが再起動で設定を失っていた開発者は、Claude Code v2.1.143 の依存関係強制と各種フラグ保持により、安全な無効化と設定維持が可能になる。

Claude Code v2.1.143 がリリースされ、プラグインの依存関係チェック、claude agents コマンドの dispatch 用オプション、background セッションの状態保持、worktree 削除時の rm -rf フォールバック廃止、macOS の保護ディレクトリ読み取り問題の修正などが含まれる。Windows・WSL・macOS にまたがる複数のバグ修正も同梱されている。

変更点

プラグインの依存関係を尊重した有効化と無効化

claude plugin disable は、他の有効プラグインが対象に依存している場合にコマンドを拒否し、貼り付け可能な解除チェーンのヒントを表示する。claude plugin enable は推移的な依存を強制有効化する。さらに /plugin マーケットプレイスのブラウズ画面には、ターン毎と呼び出し毎の トークン消費見込み(projected context cost) が表示されるようになった。

claude agents に dispatch 用オプションが追加

claude agents が --add-dir、--settings、--mcp-config、--plugin-dir を受け取り、ダッシュボードと dispatch 先 background セッションへ反映する。加えて --permission-mode、--model、--effort、--dangerously-skip-permissions も受け付け、dispatch 既定値として設定できる。--allow-dangerously-skip-permissions 指定時に bypass モードを既定にせず、Shift+Tab のサイクル候補へ加える挙動に修正された。

background セッションの状態が wake 後も保持

idle から復帰した background セッションが、設定済みのモデルと effort レベルを保持するようになった。/bg および ←-detach は --mcp-config、--settings、--add-dir、--plugin-dir、--strict-mcp-config、--fallback-model、--allow-dangerously-skip-permissions を保持する。claude --bg --dangerously-skip-permissions も retire→wake を跨いで保持される。claude agents から起動した background セッションは settings.json の permissions.defaultMode を尊重するようになった(従来は auto モードに上書きされていた)。

worktree 削除での rm -rf フォールバックを廃止

worktree のクリーンアップは git worktree remove 失敗時に rm -rf へフォールバックしなくなり、gitignored ファイルや作業中ファイルの消失を防ぐ。worktree が現実的でないリポジトリ向けに、新設定 worktree.bgIsolation: "none" が追加され、EnterWorktree を経由せずに background セッションが作業コピーを直接編集できる。

macOS の保護ディレクトリ読み取り問題が解消

フルディスクアクセスを付与していても、background ジョブのセッションが ~/Documents、~/Desktop、~/Downloads 配下のファイル読み取りで "Operation not permitted" を返していた問題が修正された。また host sleep や macOS App Nap 後に worker-stall を誤検知する storm も解消された。

credentials 破損ハングと stop hooks 無限ループを修正

.credentials.json の scopes が配列でない場合に CLI が起動時にハングするか OAuth トークンリフレッシュが無言で中断する問題を修正した。stop hooks が繰り返しブロックして無限ループする問題は、8 回連続ブロックで警告と共にターンを終了する挙動に変更された。上限は CLAUDE_CODE_STOP_HOOK_BLOCK_CAP で上書きできる。/goal evaluator が background shell や delegated subagent 実行中に発火する誤動作、/loop 待機中に Esc/Ctrl+C が効かない問題、5xx エラーが status.claude.com を案内していた(設定済みゲートウェイ/クラウドプロバイダ名を表示するように変更)なども修正対象。

主な環境変数によるオプトアウト挙動は次のとおり。

開発者への影響

本リリースは破壊的変更を含まず、プラグイン依存解決と background セッションの設定保持により日常運用が安定化する。特に worktree 削除時の rm -rf フォールバック廃止はデータ消失リスクを下げるため、worktree を多用する環境ではアップデート推奨度が高い。Windows・WSL・macOS の細かな不具合修正も多く、対象プラットフォームの利用者は更新する価値がある。

使い方の一例

複数プラグインを連携させている環境では、claude plugin disable <name> を実行して依存チェーンの解除手順ヒントを確認し、claude plugin enable <name> で推移的依存を一括有効化する。background を多用するなら claude agents --mcp-config ./mcp.json --settings ./settings.json --model <name> のように渡すと、dispatch 先セッションへ同じ構成と既定値が適用される。

出典

• https://github.com/anthropics/claude-code/releases/tag/v2.1.143