【Claude Code 公式プラグイン】claude-code-setup 完全ガイド — Anthropic がひっそり出した 5カテゴリ自動診断ツールの正体

本サイトは Google AdSense による広告が表示される場合があります。本記事は Anthropic 公式が提供する Claude Code 用プラグイン claude-code-setup について、公式マーケットプレイス（anthropics/claude-plugins-official）、プラグイン公式ページ（claude.com/plugins/claude-code-setup）、および Claude Code 公式ドキュメント（code.claude.com/docs/en/plugins）を精読し、運営者（現役 IT エンジニア）が日本語で解説したものです。仕様は 2026 年 5 月時点。最新情報は 公式ドキュメント をご確認ください。

Tech Notes · Claude Code · 2026.05

公式が、ひっそりと出した。Claude Code を「なんとなく使ってる」段階から、本気の AI 開発環境へ引き上げる Anthropic 公式プラグイン claude-code-setup。SNS では「インストールするとまったく別物になる」と話題だが、実態は あなたのコードベースを読んで、最適な拡張を 5 カテゴリで“推奨”してくれる診断ツール だ。自動でファイルを書き換えるわけではない。それでも、ほとんどの人が「バニラ」のまま放置している Claude Code に、確かな最初の一歩を与えてくれる。本記事では公式情報のみを根拠に、機能・インストール・5 つの推奨カテゴリ・誤解されがちな点までを 13 章でまとめる。読了 10 分。

user@sinyblog:~/article ❯ 01_tldr.md90 秒で全部わかる：claude-code-setup とは何か

細かい話は次章以降に回し、全体像から押さえる。公式が出しているのは、ざっくり次の 5 点だ^[1][2]。

1. 提供元は Anthropic 公式 — マーケットプレイス claude-plugins-official（GitHub: anthropics/claude-plugins-official）で「Anthropic Verified」バッジ付きで配布。
2. 正体は「コードベース診断＋推奨エンジン」 — 公式説明文は「Claude Code Setup analyzes your codebase and recommends tailored Claude Code automations（コードベースを解析し、最適な Claude Code 拡張を推奨する）」。
3. 推奨は 5 カテゴリ — MCP servers / Skills / Hooks / Subagents / Slash commands。バズツイートで「automations」と書かれているものは、この slash commands に対応する。
4. 読み取り専用 — プラグインがあなたの settings.json や .claude/ を書き換えるわけではない。提案を眺めて、あなた自身が必要な物を入れる。
5. 121,428 インストール超（2026 年 5 月時点）— 公式ページが Anthropic Verified バッジと共に表示する数値。同マーケット内では最大級の人気プラグイン。

user@sinyblog:~/article ❯ 02_what-is-plugin.md前提：Claude Code の「プラグイン」って何？

本題に入る前に「そもそも Claude Code のプラグインって何？」を片付けたい。ここを押さえないと、5 カテゴリの意味が見えてこない。

プラグイン＝拡張パッケージ

Claude Code の プラグイン とは、スキル・エージェント・フック・MCP 設定などを .claude-plugin/plugin.json マニフェストで束ねた拡張パッケージのことだ^[3]。.claude/ 直下に置く「個人用カスタマイズ」と違い、マーケットプレイス経由で配布でき、バージョン管理が効き、チームで共有できるのが特徴。

スキル名が /プラグイン名:スキル名 という名前空間付きになっているのは、複数プラグインの衝突を防ぐためだ^[3]。

マーケットプレイスとは

マーケットプレイスは複数のプラグインをまとめた配布元のこと。今回紹介する claude-plugins-official は、Anthropic 自身が運営する公式マーケットプレイスで、GitHub リポジトリとして公開されている^[1]。Anthropic 開発の内部プラグインは /plugins 配下、コミュニティ／パートナー製は /external_plugins 配下に分かれて格納されている。

user@sinyblog:~/article ❯ 03_official-source.mdプラグインの正体：Anthropic 公式マーケットプレイスにある「診断ツール」

では claude-code-setup の素性を 1 次ソースで確認する。情報源は次の 2 つで、両方 Anthropic 公式だ。

• GitHub：anthropics/claude-plugins-official — README には「Official, Anthropic-managed directory of high quality Claude Code Plugins（Anthropic が管理する公式の高品質プラグインディレクトリ）」と明記されている^[1]。
• プラグイン公式ページ：claude.com/plugins/claude-code-setup — 「Made by Anthropic」「Anthropic Verified」のバッジ付きで掲載され、インストール数は 121,428（執筆時点）^[2]。

つまりこれは公式の「お墨付き」プラグイン。「ひっそりと出た」とはいえ、出どころと検証は明確だ。

公式が書いている機能説明（原文ベース）

Claude Code Setup analyzes your codebase and recommends tailored Claude Code automations to supercharge your development workflow.

claude.com/plugins/claude-code-setup（公式ページ）/ [2]

翻訳すると「Claude Code Setup はあなたのコードベースを解析し、開発ワークフローを強化するためのあつらえ向きの Claude Code 拡張を推奨します」。重要なのは recommends（推奨する） という動詞で、install でも configure でもないところ。あくまで「提案」に留まる、というのが公式の自己説明だ。

user@sinyblog:~/article ❯ 04_install.mdインストール手順（コピペで動く正確なコマンド）

導入は 1 コマンド。Claude Code（CLI または IDE 拡張のチャット欄）で /plugin を叩く。マーケットプレイス claude-plugins-official はデフォルトで利用可能なので、追加登録は不要だ。

# 1) 公式マーケットプレイスから claude-code-setup を導入
/plugin install claude-code-setup@claude-plugins-official

# 2) 入っていることを確認
/plugin list

# 3) 詳細を見る
/plugin info claude-code-setup

もし /plugin が見つからないと言われたら

古い Claude Code は /plugin 自体を持っていない。公式ドキュメントは「/plugin コマンドが見えない場合は Claude Code を最新版に更新せよ」と案内している^[3]。

• CLI：npm i -g @anthropic-ai/claude-code を再実行（あるいは npm update -g @anthropic-ai/claude-code）。
• VS Code / JetBrains 拡張：拡張機能タブから最新版に更新。

GUI からのインストールも可能

公式ページには「Install in Claude Code」ボタンがある^[2]。Claude Code 内では /plugin > Discover（マーケットプレイス内をブラウズ）からも辿れる^[1]。ターミナルが苦手なら、こちらでも構わない。挙動は同じだ。

user@sinyblog:~/article ❯ 05_recommend-mcp.md推奨カテゴリ①：MCP servers — 外部ツールとの接続口

ここから 5 章使って、claude-code-setup が推奨してくる 5 つのカテゴリを 1 つずつ整理する。まずは MCP servers。

MCP とは

MCP（Model Context Protocol）は、Claude 等の LLM と外部ツール／データソースを繋ぐための共通プロトコルだ^[4]。ブラウザ操作、データベース、内部 API、特定の SaaS など、世の中にあるさまざまな「実世界のツール」を MCP サーバとして起動しておけば、Claude Code がそれを呼び出して読み書きできるようになる。

claude-code-setup はどう推奨するか

公式ページは具体例として「React プロジェクトを検出したら Playwright MCP を推奨する」を挙げている^[2]。フロントエンドを書いているならブラウザ自動操作とビジュアル検証ができる Playwright MCP は確かに刺さるし、入れれば「フォームを 3 種類のブラウザでテストして」と頼めるようになる。

user@sinyblog:~/article ❯ 06_recommend-skills.md推奨カテゴリ②：Skills — Claude を「特技持ち」にする小単位

2 つめは Skills（Agent Skills とも呼ばれる）。これは Claude Code を「特技持ち」にするための最小単位だ。

Skill の正体

Skill は SKILL.md という Markdown ファイル 1 枚（＋必要なら補助ファイル）で定義する。YAML フロントマターに description を書いておくと、Claude がタスクの文脈を見て「これは使えそうだ」と自分で判断して呼び出す（model-invoked）。

---
description: Reviews code for best practices and potential issues.
  Use when reviewing code, checking PRs, or analyzing code quality.
---

When reviewing code, check for:
1. Code organization and structure
2. Error handling
3. Security concerns
4. Test coverage

明示的にも呼べる

プラグインに含めた Skill は /プラグイン名:スキル名 で明示的にも呼べる（例：/my-plugin:code-review）^[3]。claude-code-setup は、プロジェクト構造から「こういうレビュー観点を持つ Skill を入れたら？」「テストが多いから test-helper Skill はどう？」のように提案を出してくる役回り。

user@sinyblog:~/article ❯ 07_recommend-hooks.md推奨カテゴリ③：Hooks — イベントで自動実行されるシェル

3 つめは Hooks。これは「Claude Code が何かしたとき」をトリガーに シェルコマンドを自動実行 する仕組みだ。

典型例：Edit のあとに lint-fix

公式ドキュメントが Hook の例として挙げているのは、Claude がファイルを Edit / Write したあとに npm run lint:fix を走らせるパターン^[3]。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix"
          }
        ]
      }
    ]
  }
}

マッチャ（matcher）で「どのツールに反応するか」を絞り、command でフックの本体を書く。プラグイン内では hooks/hooks.json に置く。claude-code-setup は「フォーマッタが入っているのに Hook で連動していない」を見つけて「Edit 後に prettier --write を回しませんか？」と提案してくれる、というイメージ。

user@sinyblog:~/article ❯ 08_recommend-subagents.md推奨カテゴリ④：Subagents — 独立した system prompt を持つ専門家

4 つめは Subagents。これはメインの Claude とは別に、独立した system prompt・利用可能ツール・モデル を持つ「専門エージェント」を定義する仕組みだ^[3]。

典型例：security-reviewer

プラグイン公式ページが具体例として挙げているのは「認証コードを検出したら security-reviewer subagent を推奨」というパターン^[2]。OWASP 観点でレビューに特化した system prompt と、必要な tool だけに絞った権限を持つ専門家を、メインスレッドから分離して呼び出せる、というのが Subagent の旨味だ。

プラグインに同梱する書き方

プラグイン側に agents/ ディレクトリを置き、その中に Subagent の定義ファイルを入れる^[3]。プラグインがインストールされた環境で /agents コマンドを開くと、その Subagent が一覧に並ぶ。さらにプラグインが settings.json で "agent": "security-reviewer" を指定すると、有効化と同時にメインスレッド自体を Subagent モードで起動 できる。

user@sinyblog:~/article ❯ 09_recommend-commands.md推奨カテゴリ⑤：Slash commands — その場で呼べる作業テンプレ

5 つめは Slash commands。/deploy、/code-review のように、スラッシュで叩いて起動する作業テンプレートだ。SNS のバズツイートで言われている「automations」は、おおむねこのカテゴリに対応する。

位置づけ

公式ドキュメントは「commands/ はフラットな Markdown ファイル群、skills/ は <name>/SKILL.md 形式」と定義しており、新規プラグインでは skills/ の利用が推奨 されている^[3]。とはいえ「ボタン一発で叩くお決まり手順」は今でも slash command が分かりやすい。

例：プロジェクト固有のリリース手順を /release に

「リリース前に走らせるチェックリストが README の奥にある」というプロジェクトはどこにでもある。claude-code-setup はそういう「定型作業の存在」を匂わせる兆候（RELEASE.md、scripts/release.sh、CI ワークフロー）を読んで、「/release としてプラグイン化したら？」 と推してくる、という想定だ。

user@sinyblog:~/article ❯ 10_misunderstandings.mdよくある誤解：「自動セットアップ」ではない

ここまで読めば気づくと思うが、本記事の冒頭に置いたバズツイートの表現には、誇張気味のところがある。公式ソースに基づいて整理すると以下のとおりだ。

user@sinyblog:~/article ❯ 11_plugin-commands.md/plugin サブコマンド早見表（list / info / remove ほか）

プラグインを使い倒すために覚えておきたい /plugin 系コマンドをまとめておく。公式ドキュメントと公式マーケットプレイス README から引いた組み合わせだ^[1][3]。

# インストール
/plugin install <plugin-name>@<marketplace-name>

# マーケットプレイス内をブラウズ（GUI）
/plugin
# > Discover

# 入っているプラグインの一覧
/plugin list

# 特定プラグインの詳細を見る
/plugin info <plugin-name>

# 削除
/plugin remove <plugin-name>

# 開発中のローカルプラグインを差し込んで起動（再起動なし）
claude --plugin-dir ./my-first-plugin

# プラグインを差し替えたらホットリロード
/reload-plugins

開発中のプラグインを試したいときは --plugin-dir でローカルディレクトリを直接マウントできる^[3]。.zip アーカイブ（Claude Code v2.1.128 以降）や --plugin-url でリモートの zip を読ませる手もある。

user@sinyblog:~/article ❯ 12_security.md入れる前に知っておくべき注意：Anthropic は中身を保証しない

最後に、見落とされがちだが大事な公式の 注意書き を引いておく。claude-plugins-official リポジトリの README には次の警告が出ている^[1]。

プラグインをインストール、更新、使用する前に、必ずそのプラグインを信頼できることを確認してください。Anthropic はプラグインに含まれる MCP サーバ、ファイル、その他ソフトウェアを管理しておらず、意図通りに動作することを保証できません。

anthropics/claude-plugins-official README / [1]

claude-code-setup 自体は Anthropic 製・Verified 済みなので最も信用できる部類だが、マーケットプレイス全体は外部プラグインも含むことを忘れない。Hook はあなたのマシンでシェルコマンドを実行するし、MCP サーバは外部に通信するし、Subagent は権限を持ってファイルを触る。「公式ストアに並んでいる ≠ Anthropic がコード一行ずつ保証している」 という距離感を持っておくとよい。

user@sinyblog:~/article ❯ 99_summary.mdまとめ：明日からの導入ルーチン

claude-code-setup は派手な自動セットアップツールではない。むしろ 「自分のプロジェクトに、Claude Code のどの拡張が効くのかを言語化してくれる相棒」と捉えるのが正しい。バニラ卒業の第一歩としては十分すぎる価値がある。

1. まずは入れる — /plugin install claude-code-setup@claude-plugins-official。リスクは小さく、提案を見るだけでも学びが多い。
2. 提案を 5 カテゴリで読む — MCP / Skills / Hooks / Subagents / Slash commands。「なぜそれを勧めているのか？」を 1 つずつ自分のプロジェクト事情に重ねて評価する。
3. 必要なものだけ採用する — 全部入れる必要はない。1 つの Hook、1 つの Subagent、1 つの MCP から始めて、有効だと感じたものをチームでも共有していく。

Anthropic が「これ入れとくと幸せになりますよ」と提示してくる地図は、最初の一歩としては最良の地図だ。あとはあなた自身が、自分のリポと向き合って導入の判断を下せばいい。