メインコンテンツへスキップ
Dev Tools 18分で読める

Claude Code v2.1.292 実践ガイド｜プラグイン1コマンド導入とeffort制御の使い方

#Claude Code#Anthropic#プラグイン#サブエージェント#MCPサーバー#開発ツール#AIエージェント

「Claude Code 2.1.292 has been released. 92 CLI changes — plugin install: added —marketplace flag, Agent tool adds effort flag.（92件のCLI変更 — plugin installに—marketplaceフラグ追加、Agent toolにeffortフラグ追加）」。公式チェンジログを追うXアカウント@ClaudeCodeLogは2026年10月6日夜、こう投稿した。

その翌日、GitHubではすでにOSSプロジェクトのメンテナーがIssueを立てていた。「Adopt Claude Code 2.1.292: per-call Agent effort and plugin install —marketplace」。リリースから24時間も経たないうちに、開発者たちがワークフローへの組み込みを始めていた。

v2.1.292（2026年10月6日）と続く v2.1.293（10月7日）は、操作の手間とコスト制御という2つの日常的な摩擦を大きく軽減するアップデートだ。

この記事はこんな人におすすめ
  • Claude Codeのプラグインを複数管理しているエンジニア・チーム
  • サブエージェントのトークンコストを最適化したいPM・エンジニアリングマネージャー
  • Haiku 5.5デフォルト化による既存ワークフローへの影響を把握したい方
  • MCPサーバーを運用しているバックエンドエンジニア
v2.1.292-293 まとめ（忙しい人向け）
  • plugin install —marketplace: マーケットプレイス登録とインストールが1コマンドで完結。claude plugin install --marketplace claude-community security-guidance の形式
  • effort制御: Agent toolのeffortパラメーターでサブエージェントの推論量を指定。effort: "low" | "medium" | "high" | "xhigh" | "max"
  • Haiku 5.5がデフォルト化: v2.1.293で適用。100Kトークン超えると単価5倍になるので大量処理スクリプトは要確認
  • MCPプロトコル2026-07-28: stdioサーバーがデフォルトで新プロトコルを使用。旧プロトコルにフォールバックするには MCP_PROTOCOL_NEGOTIATION=legacy

plugin install --marketplace — 2ステップが1コマンドに

従来の問題点

これまでClaude Codeで初めてのマーケットプレイスからプラグインをインストールするには、2ステップが必要だった。

# 旧来の方法（2ステップ）
claude plugin marketplace add claude-community
claude plugin install security-guidance@claude-plugins-community

マーケットプレイスは設定ファイルに記憶されるため、2回目以降は不要だった。しかし新しい開発環境のセットアップや、チームへのオンボーディング資料に手順を記載する際、この2ステップが微妙な摩擦を生んでいた。

v2.1.292の解決策

# 新しい方法（1コマンド）
claude plugin install --marketplace claude-community security-guidance

--marketplace フラグを付けると、Claude Codeは指定されたマーケットプレイスが未登録なら自動で追加してからインストールする（出典: Claude Code Changelog v2.1.292）。--marketplace の引数には owner/repo 形式のほか、git://... や https://... URL、ローカルパスも指定できる。

主要プラグインのインストール例

公式マーケットプレイス（claude-plugins-official）は自動で登録済みのため、第1パーティープラグインは引き続き短い形式で使える。

# 公式プラグイン（マーケットプレイス指定不要）
claude plugin install security-guidance
claude plugin install code-review

# コミュニティマーケットプレイスから（1コマンド）
claude plugin install --marketplace claude-community pr-review-toolkit

Claude Codeプラグイン完全ガイドで紹介されている主要プラグインをこのコマンドで導入できる。

サブエージェントのeffort制御 — コストと精度のトレードオフ

なぜeffort制御が必要か

Claude Agent SDKのefffortパラメーターはAPI経由での制御を可能にしてきたが、v2.1.292まではClaude CodeのAgent tool呼び出しに per-call のeffort指定はなかった。全てのサブエージェントが同じ推論量で動作していた。

複雑なコードベースの解析には深い推論が必要だが、ファイルの一覧取得やシンプルな変換作業にmax effortは過剰だ。この「一律max」問題が、マルチエージェントワークフローの無駄なコスト増加の一因になっていた。

使い方

CLAUDE.mdやスキルファイルでAgent toolを呼び出す際、effortを指定する。

# /research コマンドの定義例（高effortで詳細リサーチ）
Use the Agent tool with effort: "high" to research the topic thoroughly.

# 軽量なファイル確認タスク
Use the Agent tool with effort: "low" to list and summarize the changed files.
effort値推奨ユースケース
lowファイル一覧・単純な検索・フォーマット確認
medium通常のコーディングタスク・関数レベルのリファクタ
highアーキテクチャ分析・セキュリティレビュー・大規模リファクタ
xhigh30分超の長時間エージェントタスク・マルチステップリファクタ
max複雑な推論・未知のコードベース全体の把握

この機能、実はリリースまでに半年以上の紆余曲折があった。GitHubのissue #43083には開発者の生の声が記録されている。

「This issue is not solved at all and it shouldn’t be closed. Without a per-call parameter, orchestrators need duplicate files like opus-low.md, opus-high.md, and so on: every .md file is EXACTLY the same, except effort is changed in the frontmatter. This is horrible. It goes totally against SSOT and DRY principles.」 — archneon（2026年8月21日, issue #43083）

「It’s really disappointing that this is still a bug 3 months later… with no official communication or response at all.」 — tom-murray-dev（2026年7月25日, issue #43083）

フロントマターでのeffort:指定が実際には機能しない「サイレントno-op」バグが長期化し、コミュニティは強く反発していた。v2.1.292での修正はその直接の回答だ。

Claude Code ultracode コスト管理ガイドでも触れているが、マルチエージェントワークフローでのコスト管理はeffort制御が鍵の一つだ。

Haiku 5.5のデフォルト化 — 既存ワークフローの確認ポイント

v2.1.293（10月7日）では、HaikuモデルのデフォルトがHaiku 4.5からHaiku 5.5（claude-haiku-5-5）に変わった（出典: dev.classmethod.jp v2.1.293解説）。

影響を受ける主なケース：

  • claude -p での軽量スクリプト: モデルを明示していないスクリプトで動作が変わる可能性
  • 100Kトークン超えの処理: Haiku 5.5は100K超で単価が$0.10/$0.50から$0.50/$2.50に上がる
# 旧来の挙動を維持するなら明示的にモデルを指定
claude -p "..." --model claude-haiku-4-5

Haiku 5.5はコンテキストウィンドウが1Mトークンに拡大し、全体的な品質も向上している。新規ワークフローであれば積極的に採用する価値がある。

MCPプロトコル2026-07-28への移行

stdioベースのMCPサーバーがデフォルトで2026-07-28プロトコルを使うようになった。旧プロトコルのサーバーへの初回接続では遅延が発生し、その遅延が7日間キャッシュされる（出典: turboai.dev v2.1.292解説）。

実際に破損したケースも報告されている。

「Since this afternoon (2026-09-25, between 13:33 and 14:21 UTC), Claude Code negotiates MCP protocol 2026-07-28 with stdio servers. With mcp-grafana (v1.5.1 and v1.6.0), the connection succeeds but tools/list and resources/list time out after 30s, so the server exposes no tools.」 — ogmdev（2026年9月25日, issue #97189）

この問題はmcp-grafana v1.6.1（2026年9月28日リリース）でサーバー側が修正している。互換性が必要な場合は環境変数でフォールバックできる。

export MCP_PROTOCOL_NEGOTIATION=legacy

自作のMCPサーバーや社内ツールがstdioを使っている場合、接続テストを先に行うことを推奨する。

光と影 — v2.1.292の注意点

光（メリット）:

  • プラグイン導入の手間が1コマンドに集約され、チームへのオンボーディングが簡略化
  • サブエージェントごとのeffort指定でマルチエージェントワークフローのコスト最適化が可能
  • Haiku 5.5のデフォルト化で、何もしなくても軽量タスクの品質が向上

影（デメリット・注意点）:

  • --marketplace フラグは設定ファイルへの書き込みを伴うため、共有環境やCI/CDパイプラインでの使用は挙動を事前に確認すること
  • effort値の最適化には試行錯誤が必要。低effortを設定しすぎると、サブエージェントが途中で情報不足に陥り、親エージェントに差し戻すケースがある
  • Haiku 5.5の100Kトークン閾値に注意。大規模コードベースをコンテキストに丸ごと渡すパターンでは予想外のコスト増になりうる
セキュリティ注意

--marketplace でコミュニティマーケットプレイスからインストールするプラグインは、公式プラグインと同じ審査を受けているわけではない。インストール前にリポジトリのコードと権限設定を確認することを推奨する。Claude Codeセキュリティガイドも参考に。

Claude Codeのプラグインエコシステムをさらに深掘りしたい方はプラグイン完全ガイド、サブエージェントのコスト管理についてはClaude Code ultracode コスト管理を参照。

詳しく見る

関連記事

免責事項: 本記事の情報は2026年10月24日時点のものです。Claude Codeは頻繁に更新されるため、最新情報は公式ドキュメントを参照してください。料金は予告なく変更される場合があります。

Share