Claude Codeのclaude-code-setupプラグインで自動化の推薦を受ける
claude-code-setupプラグインの導入と、claude-automation-recommenderスキルが何を調べて何を推薦するかを整理。読み取り専用の範囲と、推薦をhooksやsubagentsに落とす手順も扱います。
claude-code-setupは、リポジトリを読んで「どのhooks・skills・MCPサーバー・subagentsを入れると効くか」を教えてくれる、Anthropic製のプラグインです。中身は claude-automation-recommender という1つのスキルで、ファイルは一切書き換えません。推薦を受け取るだけのプラグインなので、導入の手間は小さく、判断材料を増やしたい新しいプロジェクトの最初の一手に向きます。
claude setup-token など名前にsetupを含むCLIコマンドとは別物で、マーケットプレイスから入れるプラグインです。
claude-code-setupプラグインは何を追加するか
マーケットプレイスの掲載ページでは、提供元がAnthropicで、「Anthropic verified」の表示が付いています。説明文は「コードベースを解析し、hooks・skills・MCPサーバー・subagentsなどClaude Codeの自動化を推薦する」というものです。
追加されるのは skills/claude-automation-recommender ディレクトリのスキル1つです。プラグインの構成は .claude-plugin(マニフェスト)、skills/、LICENSE、README.md、サンプル画像で、plugin.json のバージョンは1.0.0と書かれています。
READMEとマーケットプレイスの説明は、推薦の対象を5つの種類で示しています。
推薦される5つの種類
MCPサーバー
外部サービスとの接続です。ドキュメント参照のcontext7や、フロントエンド向けのPlaywrightが例に挙がっています。
Skills
手順や知識をまとめた単位です。READMEの例はPlanエージェントとfrontend-designです。
Hooks
ツール実行の前後で自動的に走る処理です。自動整形、自動lint、機密ファイルの編集ブロックが例です。
Subagents
役割を絞ったレビュー担当です。セキュリティ、パフォーマンス、アクセシビリティが例に挙がっています。
Slash Commands
短い定型ワークフローです。
/test、/pr-review、/explainが例です。
READMEは「各種類で上位1〜2件」を出すと説明しています。件数を絞る設計なので、長いチェックリストが出てくる使い方は想定されていません。
導入と呼び出し方
導入は、公式マーケットプレイスのプラグインと同じ形です。マーケットプレイス名は claude-plugins-official で、プラグイン名の後ろに @ で付けます。
/plugin install claude-code-setup@claude-plugins-officialシェルから入れるときは claude plugin install claude-code-setup@claude-plugins-official です。インストール直後に反映されないときは /reload-plugins を実行します。プラグイン管理の全体像はClaude Codeプラグイン完全ガイドにあります。
呼び出しはスラッシュコマンドではなく、自然文です。スキルの description に「自動化の推薦を求められたとき」「Claude Codeの初期設定を尋ねられたとき」などの条件が書かれていて、該当する依頼を受けるとClaudeがスキルを使います。READMEが示す依頼文は次の3つです。
recommend automations for this project
help me set up Claude Code
what hooks should I use?日本語で頼んでも、意図が「自動化の推薦」に当たれば使われるはずです。ただし読み込まれるかどうかは description との照合で決まります。反応しないときは、/skills で一覧にclaude-automation-recommenderが出ているかを先に見ます。一覧の見方は/skillsコマンドの使い方が詳しいです。
推薦が出るまでの3フェーズ
スキル本体には、作業の流れが3段階で書かれています。何を読んで何を返すのかが分かると、出力の読み方が変わります。
スキルが実行する流れ
- 1
コードベースを調べる
プロジェクトの種類、依存関係、既存のClaude Code設定を調べます。
- 2
推薦を組み立てる
検出した特徴を、MCP・Skills・Hooks・Subagents・Pluginsの5つの表に当てはめます。
- 3
レポートで返す
種類ごとに1〜2件に絞り、理由と置き場所を添えて出力します。
フェーズ1: 調べる対象はファイルとコマンド
最初に走らせるのは、ls と cat を使った軽い探索です。スキルのfrontmatterで使えるツールは Read, Glob, Grep, Bash に限られています。見に行く先は次のとおりです。
package.json、pyproject.toml、Cargo.toml、go.mod、pom.xmlの有無package.jsonの依存関係(react、vue、next、express、fastapi、prisma、supabase、convex、stripeなど).claude/とCLAUDE.mdの有無src/、app/、lib/、tests/、components/、pages/、api/の構成
最後から2番目の項目に注目します。既存のClaude Code設定を見に行く手順は書かれていますが、すでに入っている設定を推薦から除外するかどうかは、スキル本文に記載がありません。すでにhooksを入れているリポジトリでは、同じ種類の推薦が再び出る場合があります。出力を読むときは、手元の設定と突き合わせてください。
フェーズ2: 検出シグナルと推薦の対応
推薦の中身は、スキルと5つの参照ファイル(references/ 配下の hooks-patterns.md、mcp-servers.md、plugins-reference.md、skills-reference.md、subagent-templates.md)にある対応表で決まります。hooksとsubagentsの対応を抜き出すと、次のようになります。
| 検出するもの | 推薦されるもの | 種類 |
|---|---|---|
| Prettierの設定 | 推薦されるもの編集後の自動整形(PostToolUse) | 種類Hooks |
| ESLintまたはRuffの設定 | 推薦されるもの編集後の自動lint | 種類Hooks |
tsconfig.json | 推薦されるもの編集後に tsc --noEmit | 種類Hooks |
.env 系のファイル | 推薦されるもの.env の編集をブロック(PreToolUse) | 種類Hooks |
| ロックファイル | 推薦されるものロックファイルの直接編集をブロック | 種類Hooks |
| 認証・決済のコード | 推薦されるものsecurity-reviewer | 種類Subagents |
| APIルート | 推薦されるものapi-documenter | 種類Subagents |
| 500ファイルを超える規模 | 推薦されるものcode-reviewer | 種類Subagents |
MCPサーバーのほうは、使っているライブラリや外部サービスで決まります。Supabase・Convex・Sentry・Linearなどはそれぞれの専用MCPサーバー、GitHubリポジトリならGitHub MCPが対応づけられています。
フェーズ3: レポートの形
最終出力のテンプレートは、見出しが「Claude Code Automation Recommendations」で、次の順に並びます。
- Codebase Profile(種類・フレームワーク・主要ライブラリ)
- MCP Servers(各項目にWhyとInstall)
- Skills(Why、作成先
.claude/skills/[name]/SKILL.md、呼び出し方) - Hooks(Why、設定先
.claude/settings.json) - Subagents(Why、置き場所
.claude/agents/[name].md)
末尾には「種類ごとに追加の推薦を頼める」旨を添えるよう書かれています。たとえば「MCPサーバーをもっと見せて」と頼むと、その種類に絞って3〜5件まで広げる仕様です。
例として、Prettierとtsconfigがあり .env を持つNext.jsのリポジトリなら、hooksの欄は「整形」「型チェック」「.env の保護」が並ぶ形になるはずです。これはスキルの対応表に沿った想定の姿で、実際の出力はリポジトリごとに変わります。
推薦を実装に移す手順
推薦を受け取っただけでは何も変わりません。スキルが指す置き場所に沿って、1件ずつ取り込みます。ここではhooksを例にします。
手順の組み立て方
レポートに「Prettierがあるので編集後に自動整形する」と出たとします。実装先はレポートが示す .claude/settings.json です。設定の書き方は参照ファイルhooks-patterns.mdにあるNotification用の例に合わせた形式で、イベント名の下に matcher と hooks の配列を置きます。
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
}
]
}
]
}
}上の設定は、参照ファイルの推薦内容(PostToolUseでEdit/Write後に整形する)を具体化した例です。公式の例そのものではないので、command の書き方はClaude Code Hooks完全ガイドで入力のJSON形式を確かめてから使います。言語別のlintコマンドはPostToolUse hookのLint自動修正に早見表があります。
取り込みの順番を決める
5種類を一度に入れると、不具合が出たときに原因を切り分けにくくなります。入れやすさと効果の見えやすさで並べると、次の順が扱いやすい流れです。
| 順番 | 種類 | 理由 |
|---|---|---|
| 1 | 種類Hooks(保護系) | 理由.env の編集ブロックのように、入れた効果が明確で失敗しにくい |
| 2 | 種類Hooks(整形・lint) | 理由編集のたびに動くので、効き方をすぐ確認できる |
| 3 | 種類MCPサーバー | 理由外部接続と認証が絡むので、1つずつ足す |
| 4 | 種類Subagents | 理由役割の定義に調整が要る。使う場面が決まってから足す |
「呼び出されたとき以外は動かない」スキルやsubagentsと違い、hooksは設定した瞬間から全編集に作用します。この性質の違いはSkillsとMCPの違い、サブエージェント・hooksの使い分けが詳しいです。subagentsの作り方はSubagents完全ガイド、MCPの追加構文はMCP設定ガイドが受け持ちます。
推薦をそのまま実行させない
レポートのMCP欄には claude mcp add context7 のようにコマンド名だけが書かれた例があります。接続方式の指定が必要な場合があるので、コピーして実行する前にMCP設定ガイドの構文で補ってください。
推薦から実装までをClaudeに任せるなら、CLAUDE.mdに範囲を書いておくと安全です。
## 自動化の導入ルール
- hooks・MCP・subagentsの追加は、変更内容を提示して承認を得てから行う
- 設定ファイルは `.claude/settings.json` だけを編集対象にし、他は触らない
- 1回の作業で追加する自動化は1種類にとどめる読み取り専用のスキルから実装へ進む境目に、承認の一手を挟むための書き方です。
公式の記述同士で食い違う点
出力を読むときに引っかかる点が、READMEとスキル本文の間にいくつかあります。
- 種類の数え方: READMEとマーケットプレイスは「MCP・Skills・Hooks・Subagents・Slash Commands」の5種類としています。スキル本文の概要表は「Hooks・Subagents・Skills・Plugins・MCP Servers」で、Slash Commandsは項目になく、代わりにPluginsがあります。レポートのテンプレートに並ぶのはMCP・Skills・Hooks・Subagentsの4つです。
- 調べる手段: スキル本文は「参照リストを超えて、web searchでコードベース固有のツールの推薦を探す」ことを求めています。一方でfrontmatterのツール指定は
Read, Glob, Grep, Bashで、Web検索や取得のツールは載っていません。Web検索が実際に使われるかどうかは、セッション側で使えるツールに依存します。 - 件数: 既定は種類ごとに1〜2件、特定の種類を頼むと3〜5件です。
Slash Commandsの推薦が出なくても不具合ではなく、テンプレートにその欄がない仕様の表れです。コマンドの推薦がほしいときは、種類を指定して頼みます。
使う場面と使わない場面
| 場面 | 向き不向き | 理由 |
|---|---|---|
| 初めて触るリポジトリ | 向き不向き向く | 理由構成と依存から、足がかりの候補が一覧で得られる |
| すでにhooksやMCPを作り込んだリポジトリ | 向き不向き条件次第 | 理由既存設定の除外が明記されていないので、突き合わせが要る |
| CLAUDE.mdの品質を上げたい | 向き不向き向かない | 理由対象外。claude-md-managementプラグインが担当する |
| 推薦を自動で適用したい | 向き不向き向かない | 理由読み取り専用で、書き込みはしない |
推薦の質は、検出に使うファイルがどれだけ揃っているかに左右されます。package.json や pyproject.toml が見つからない構成(モノレポの入れ子、独自のビルド定義など)では、プロジェクトの種類を取りこぼす可能性があります。その場合は「このリポジトリはPythonのバックエンドで、テストはpytest」のように、前提を依頼文に書き添えると、推薦の足場になります。
まとめ
claude-code-setupは、書き込みをしない代わりに、導入判断を材料つきで返すプラグインです。使いどころは、新しいリポジトリでの最初の棚卸しです。レポートは1〜2件に絞られるので、そこから保護系のhooksを1つ入れ、効き方を見てから次の種類に進む流れが、事故の切り分けやすさで無理がありません。READMEとスキル本文で種類の数え方が違う点だけは、出力を読む前に頭に入れておくと迷いません。