Claude Code v2.1.157 — プラグインの自動ロードと、会話中のワークツリー切り替え

このリリースで何ができるようになるか

Claude Code v2.1.157は、プラグインを.claude/skillsディレクトリに置くだけで自動的に読み込まれるようになり、claude plugin init <name>で新規プラグインの雛形をその場で作れるようになり、さらにEnterWorktreeが会話の途中でClaude管理ワークツリー間を切り替えられるようになった、プラグイン開発と並列ワークツリー運用の両方で摩擦を抜きにいった版です。番号上の直前のv2.1.156は、Opus 4.8の思考ブロックが書き換わってAPIエラーになる問題だけを修正したホットフィックスでした。直前の機能追加版はv2.1.154(Opus 4.8登場・動的ワークフロー導入・Fast mode値下げを同時に載せた大型版)になります。

本版で読者の開発フローに直接効くのは、次の3点です。

1点目は、プラグイン配布の「マーケットプレース前提」が崩れる挙動変更です。これまではプラグインを使うために、リポジトリをマーケットプレースに登録するか、claude plugin marketplace addでローカル/Gitソースを足してから/pluginで有効化する手順が必要でした。本版以降は、.claude/skillsディレクトリ配下に置かれたプラグインがマーケットプレースを介さずそのまま自動ロードされます。同じ.claude/skillsにSkillsと並べる形で配置できるため、Skillsの「ディレクトリに置くだけで読まれる」流儀と、プラグインの流儀が同じ場所に揃います。あわせて、claude plugin init <name>を打つと、.claude/skills配下に新規プラグインのスキャフォールドが生成されます。/pluginコマンドの引数も補完されるようになり、プラグイン名や操作名のタイポでつまずく場面が減ります。

2点目は、EnterWorktreeの会話中ワークツリー切り替えです。これまでのEnterWorktreeは、現在のセッションにワークツリーを切り出して入る一方向の動きで、Claudeが複数のワークツリーを管理している状況でも、別のワークツリーに移るには一旦そのセッションを抜けてから入り直す必要がありました。本版以降は、EnterWorktreeを会話の途中で打つだけで、別のClaude管理ワークツリーへ切り替えられるようになります。あわせて、Claudeが管理するワークツリーはエージェントが処理を終えたあとロックされずに残るようになりました。これまではClaudeのワークツリーが一定期間ロックされ、ホスト側のIDEや別ツールから直接編集しようとすると意図しない競合になる場面がありましたが、本版でその制約がなくなります。

3点目は、長時間会話・再開会話の体感性能改善と、IDE統合ターミナルでのGPU加速オフです。長時間のセッションや--resumeで再開した会話の処理性能が改善されました。/terminal-setupを実行すると、VS Code・Cursor・Windsurfの統合ターミナルでGPU加速が無効化されるようになります。IDE統合ターミナルでテキスト描画やスクロールが詰まる、カーソル位置がずれる、ターミナルがブラックアウトするといった問題に当たっていたチームでは、/terminal-setupの再実行で改善が見込めます。

これら3点に加えて、本版ではclaude agentsでsettings.jsonのagentフィールドがディスパッチセッションで尊重されるようになる挙動変更、tool_decisionテレメトリイベントにtool_parametersが含まれるようになる監査強化、/terminal-setup関連以外のターミナル描画の不具合修正、画像処理不可・サンドボックスネットワーク権限・バックグラウンドセッション・ターミナルレンダリングの複数件の修正など、運用に効く変更が幅広く入っています。

あなたの開発フローはどう変わるか

プラグインを書いて配布しているチーム

プラグインを公開・配布する側にいるチームには、本版が配布フローの組み直しを促す変更になります。これまでのClaude Codeでプラグインを使ってもらうには、GitHub・Gitリポジトリ・ローカルパス・URL(--plugin-url)・.zipアーカイブのいずれかをユーザーに案内し、claude plugin marketplace addまたは/pluginからインストールしてもらう手順を踏む必要がありました。

本版以降は、ユーザーが自分の.claude/skillsディレクトリにプラグインを置けば、その時点で読み込まれます。社内配布や、自分のプロジェクトの.claude/skillsにコミットして共有するパターンが、マーケットプレースを介さずに成立します。Skillsとプラグインがどちらも同じ.claude/skills配下に置けるため、SKILL.mdを持つプラグインをSkillとしても露出させる挙動(v2.1.142)と組み合わせると、社内テンプレや独自手順を「Skill 1ファイル+補助プラグイン」の単位で揃えて配布する流れが取りやすくなります。

雛形作成はclaude plugin init <name>で行えます。空の.claude/skills/<name>/ディレクトリと、必要なplugin.json、命名規約に沿ったエントリポイントが一度に書き出されます。これまで「最小構成のプラグインを書き始めるサンプルがない」という詰まりに当たっていた場合は、本版で初稿の生成自体が1コマンドに収まります。/pluginの引数補完も付いたため、/plugin enable・/plugin marketplace remove --scope・/plugin details <name>といったサブコマンドと引数の組み合わせを毎回正確に書く負担も減ります。

すでにclaude plugin marketplace addを中心にプラグイン配布フローを組んでいるチームでは、本版以降に新しいユーザー向けの案内を「.claude/skillsに置くだけ」に切り替えるかどうかが、配布動線の選択になります。マーケットプレースに依存しないぶん、バージョン更新の通知やプラグインの依存関係管理は手動になるため、配布規模が大きい場合は引き続きマーケットプレース経由を残す判断もあります。

Claudeのワークツリー運用を会話中に組み立てたいチーム

並列に複数のブランチを進める運用、たとえばリファクタ・新機能・修正をそれぞれ別ワークツリーで進めるパターンには、本版で2つの改善が同時に効きます。

1つ目は、EnterWorktreeの会話中切り替えです。これまでは別のClaude管理ワークツリーに入りたいときに、一度/exit(またはCtrl+D)でセッションを抜けて入り直す必要がありました。本版以降は、EnterWorktreeを打つだけで、Claudeが管理している別ワークツリーへ会話を続けたまま切り替えられます。「いまの会話の文脈を保ったまま、別ブランチで一手だけ確認する」「メインワークツリーで議論したあとで、結論を反映するワークツリーに移って実装する」という、会話の流れに沿った操作がやりやすくなります。

2つ目は、Claudeが管理するワークツリーがエージェント終了後にロックされずに残るようになったことです。これまでは、エージェントの処理が終わってもワークツリーが一定時間ロックされ、git worktree removeやgit worktree pruneでクリーンアップしようとしてもロックされたまま消せない、ホスト側のIDEや別ターミナルから編集しようとするとロックエラーや意図しない競合が出る、といった場面がありました。本版以降は、エージェント終了時点でロックが解放されるため、git worktree remove/pruneで素直に片付けられるようになり、ホスト側のIDEから続きを編集する、別ツールでgrepする、PRレビュー前に手で差分を整える、といった作業もスムーズに引き継げます。

バックグラウンドセッションを組み合わせて並列にエージェントを走らせている運用でも、ワークツリー周辺の摩擦は減ります。あわせて、画像処理不可・サンドボックスネットワーク権限・バックグラウンドセッション・ターミナル描画の複数修正が同じ版でまとめられているため、バックグラウンドエージェントとワークツリーを並列に組み合わせて長時間運用しているチームほど、本版の効きは大きくなります。

IDE統合ターミナルで描画が崩れていたチーム

VS Code・Cursor・Windsurfの統合ターミナルでClaude Codeを動かしていて、文字描画のちらつき・カーソル位置のずれ・スクロール時の残像・ブラックアウト・特殊文字の崩れに当たっていたチームには、/terminal-setupの挙動変更がそのまま効きます。

/terminal-setupはもともと、ターミナルエミュレータの種類を検出して、Claude Codeに最適化された設定(キーバインド・色設定・カーソル形状など)を書き込むコマンドでした。本版以降は、これらの統合ターミナル(VS Code/Cursor/Windsurf)を検出したときにGPU加速を無効化する設定をあわせて書き込むようになります。これらのIDE内蔵ターミナルは、GPU加速を有効にしていると一部のグラフィックドライバや仮想ディスプレイ環境(リモートデスクトップ・WSL越しのVS Code Remote・xpra経由のXフォワーディングなど)で描画問題を起こすケースがあり、Claude Codeの長時間出力やストリーミング描画と相性が悪い場面がありました。

すでに/terminal-setupを一度実行済みの環境でも、本版に上げてからもう一度/terminal-setupを実行することで、GPU加速無効化を含む最新の最適化が反映されます。普通のターミナルアプリ(iTerm2・Terminal.app・Alacritty・kitty・Windows Terminal等)を使っているチームには本変更の影響はありません。

claude agentsでディスパッチセッションを多用するチーム

claude agentsで複数セッションをディスパッチして並列に進める運用には、settings.jsonのagentフィールドがディスパッチセッションでも尊重されるようになる変更が効きます。これまでは、settings.jsonで「このプロジェクトではこのエージェント定義を既定にする」と指定していても、claude agentsから起動するセッションでは設定が拾われず、デフォルトのエージェントで起動する場面がありました。

本版以降は、settings.jsonのagentフィールドがディスパッチセッションでも反映されます。プロジェクト全体でエージェント設定を統一したい場合、settings.jsonに書いておけばclaude agentsの各セッションも同じ設定で起動します。セッション単位で別エージェントに切り替えたい場合は、--agent <name>で個別にオーバーライドできます。claude agentsから複数の並列セッションを起こすときの設定差異が抑えられるため、社内テンプレや一定の手順でClaudeを走らせる運用には、設定の二重管理が減る効果があります。

テレメトリ・監査ログを取っているチーム

エンタープライズ運用でOpenTelemetry経由のテレメトリ収集を行っているチームには、tool_decisionイベントにtool_parametersが含まれるようになった点が効きます。これまでのtool_decisionイベントは、Claudeがどのツールの実行を許可・拒否したかは追えるものの、そのツール呼び出しに渡されたパラメータは記録に入っていませんでした。

本版以降は、OTEL_LOG_TOOL_DETAILS=1を設定すると、tool_decisionの各イベントにtool_parametersが同梱されるようになります。「どのツール呼び出しを許可したか」だけでなく「そのときの引数」も含めて監査ログに残せるため、Bashツールで実際に走ったコマンド、Writeツールの書き込み先パス、WebFetchの対象URLといった情報を、テレメトリ側で集約・分析する経路ができます。Bedrock・Vertex・Foundry経由でClaude Codeを運用していて、エンタープライズコンプライアンスのために操作内容を追跡する必要がある組織では、本変更でログのレベルが1段細かくなります。OTEL_LOG_TOOL_DETAILSを有効化しない限りこれまでと同じ粒度のままなので、まずは詳細ログを取りたい監査用テレメトリでだけ環境変数を立てる運用が現実的です。

なお、tool_parametersに書き込まれる引数の中には、ユーザーの入力テキストや実行コマンドのフラグ・パス情報など、機密扱いの内容が含まれることがあります。テレメトリ収集先のアクセス権限と保管ポリシーの確認は、本変更を反映する前に検討する余地があります。

主な変更点

本版は新機能・挙動変更・修正を合わせて10件強の整備リリースです。読者の運用に効く主要なものを以下にまとめます。

.claude/skills配下のプラグインを自動ロード

.claude/skillsディレクトリ配下に置かれたプラグインが、マーケットプレースを介さずに自動的に読み込まれるようになりました。Skillsとプラグインが同じディレクトリに並ぶ構造になります。

claude plugin init <name>で新規プラグインのスキャフォールド

claude plugin init <name>で、.claude/skills配下に新規プラグインの雛形が生成されます。plugin.json・エントリポイント・命名規約に沿ったディレクトリ構造が一度に書き出されます。

/pluginの引数補完を追加

/pluginコマンドの引数(プラグイン名、サブコマンド、--scope等)が補完されるようになりました。

claude agentsでsettings.jsonのagentフィールドを尊重

claude agentsから起動するディスパッチセッションでも、settings.jsonのagentフィールドが反映されるようになりました。プロジェクト全体のエージェント設定統一が容易になります。

EnterWorktreeの会話中ワークツリー切り替え

EnterWorktreeを会話の途中で打つことで、別のClaude管理ワークツリーへ切り替えられるようになりました。これまではセッションを抜けて入り直す必要がありました。

tool_decisionテレメトリイベントにtool_parametersを追加

OpenTelemetryで取得するtool_decisionイベントに、ツール呼び出しのパラメータが含まれるようになりました。

Claude管理ワークツリーをエージェント終了後にロック解除

エージェントの処理が終わったとき、Claudeが管理しているワークツリーはロックされずに残るようになりました。ホスト側のIDEや別ツールからの編集が引き継ぎやすくなります。

画像処理不可・サンドボックスネットワーク権限・バックグラウンドセッション・ターミナル描画の修正

処理できない画像の扱い、サンドボックスからのネットワーク権限、バックグラウンドセッション、ターミナル描画について、複数の不具合が修正されました。

長時間会話・再開会話の性能改善

長時間のセッションや--resumeで再開した会話の処理性能が改善されました。

/terminal-setupでVS Code/Cursor/Windsurf統合ターミナルのGPU加速を無効化

/terminal-setupを実行すると、VS Code・Cursor・Windsurfの統合ターミナルでGPU加速が無効化されるようになりました。これらのIDE統合ターミナルで起きていた描画問題が緩和される見込みです。すでに/terminal-setupを実行済みの環境では、本版に上げてからもう一度実行することで反映されます。

その他のUI改善・修正

その他のUI改善とバグ修正が複数含まれます。

マーケットプレース前提からローカル配置前提へ転換するプラグイン体系

本版の中核となる変更は、プラグインの配布モデルが「マーケットプレース経由」から「.claude/skills配下に置くだけ」に重心を移した点と読めます。Claude Codeのプラグイン体系はv2.1系で段階的に組み立てられてきましたが、本版の自動ロード化とclaude plugin initは、その流れの中でも明確な転換点になります。

プラグイン関連の主な変更を、v2.1系の流れで並べると次のようになります。

v2.1.142でルートSKILL.mdを持つプラグインがSkillとしても露出するようになり、.claude/skillsを共通の置き場所として扱う土台ができました。v2.1.143で依存関係の強制適用、v2.1.152・v2.1.154で管理者向け設定(pluginSuggestionMarketplaces)とdefaultEnabled: falseが入り、配布側・管理側それぞれの境界整備が進みました。本版の自動ロード化とclaude plugin initは、その整備された土台の上に、個人開発者・社内プロジェクトの配布動線を新たに敷いた変更と読めます。

Skillsとプラグインの境界はどう動くか

Skillsとプラグインは、もともと別の機能として組み立てられてきました。Skillsは「特定の手順をClaudeに教える単一のSKILL.md」、プラグインは「マーケットプレース経由で配布されるパッケージ」という性格の違いがあります。本版で.claude/skills配下にプラグインも置けるようになり、しかもv2.1.142でプラグインのルートにSKILL.mdがあればSkillとしても露出する仕組みが入っていたため、結果として配置場所と公開方法の境界が同じディレクトリで揃う形になります。

実用上は、「単独の手順だけならSkill単体」「複数ファイルや補助スクリプトを伴う構成ならプラグイン」と使い分ける選択肢が増えます。これまでのように「プラグインを使うためにマーケットプレースに登録する必要がある」「プラグインの最小構成を自分で組む必要がある」という障壁が下がるため、これまでSkillsで書いていた手順をプラグインに移して補助ファイルを束ねる、という設計も取りやすくなります。

利用形態別の影響度

本版が自分の環境にどの程度効くかは、次の早見表で確認できます。

プラグインを自分で書いて配布する側、もしくはVS Code/Cursor/Windsurfで描画問題に悩まされていたチームは、本版で挙動が大きく動きます。claude agentsやEnterWorktreeを使う運用でも、設定統一とワークツリー切り替えの面でひとまわり扱いやすくなります。

まとめ

• プラグイン配布が「マーケットプレース前提」から「.claude/skills配置」に重心を移しました: .claude/skills配下のプラグインが自動ロードされ、claude plugin init <name>で雛形がその場で作れます。社内配布・プロジェクト単位の配布がマーケットプレースを介さず成立します
• EnterWorktreeが会話中に別ワークツリーへ切り替えられます: これまではセッションを抜けて入り直す必要があった操作が、会話の途中で完結します。Claude管理ワークツリーがエージェント終了後にロックされずに残るため、ホスト側のIDEや別ツールとの引き継ぎもやりやすくなります
• VS Code/Cursor/Windsurfの統合ターミナルで/terminal-setupがGPU加速を無効化します: IDE統合ターミナルで描画が崩れていたチームは、本版で/terminal-setupを再実行することで改善が見込めます
• テレメトリ・claude agents・長時間会話の整備: tool_decisionにtool_parametersが含まれ、claude agentsのディスパッチセッションがsettings.jsonのagentを尊重し、長時間・再開会話の性能が改善されました

v2.1.157は、直前の機能追加版v2.1.154でOpus 4.8と動的ワークフローによる実行側の表面が広がったあとに、配布側の表面(プラグインのローカル完結化)と並列運用の境界(ワークツリー切り替えとロック解除)を整える性格の版です。v2.1系のプラグイン体系の流れの中で、「マーケットプレース前提から.claude/skills配置前提へ重心が移る」転換点として読むと、本版の位置付けが追いやすくなります。