Claude CodeにUnity公式プラグインを入れる方法（スコープの注意点）

Unity が公式のプラグイン（Unity のスキル集）を配っています。Claude Code に入れると、UI・URP・2D・課金・広告などの作法を Unity 側が書いた指示書として読み込めます。

入れる前に1つだけ知っておいてほしいことがあります。

シェルから入れると、既定は「user」スコープ。この PC の全プロジェクトで有効になります。

Unity と関係ないリポジトリでも Unity のスキルの説明文が読み込まれ、毎ターンのトークンを消費します。私はそれが嫌だったので、プロジェクト単位で入れました。

claude plugin install unity@claude-plugins-official

claude plugin marketplace update claude-plugins-official
claude plugin install unity@claude-plugins-official --scope project

スコープは3つ

Claude Code の画面（/plugin）から入れる場合は、詳細画面でスコープを選べます。シェルから入れるときは --scope を付けない限り user です。

落とし穴：project スコープは「開いたフォルダ」でしか効かない

ここが分かりにくいところでした。公式ドキュメントにはこう書かれています。

Claude Code reads the shared .claude/settings.json from the session's primary working directory

親フォルダをさかのぼって探しません。 実測するとこうなりました。

最初、私はゲームのフォルダ（サブフォルダ）に入れていました。あとで「サイトとゲームを1つのセッションで扱いたい」となったとき、親で開くとプラグインが無効になることに気づいて入れ直しています。

ゲームが games/<名前>/ のようにサブフォルダにあるなら、親（リポジトリのルート）で入れると、そこで開いたセッションからゲームも扱えます。

本体はユーザー側に1つ、有効化だけプロジェクトで絞る

project スコープで入れても、プラグインの実体はユーザー側に置かれます。有効にする範囲だけをプロジェクトで絞る仕組みです。

そのため、こういう挙動になります。

• 別のプロジェクトで claude plugin list を実行すると、一覧には出るが disabled。「一覧に出る＝影響がある」ではありません
• 別の PC では、設定ファイルを共有していても自動では入りません。 GitHub などの外部ソースのプラグインは、各自が claude plugin install を実行するまで「未インストール」扱いです

入れ方は2通りある

Unity のプラグインは、2か所から入れられます。

中身は同じでした（公式マーケットプレイスの登録には Unity リポジトリのコミット SHA が書かれていて、その時点の最新と一致していました）。

私は公式マーケットプレイス版に切り替えました。 自動更新が効くほうが、後から出る修正を取りこぼしません。

claude plugin marketplace update claude-plugins-official

置かれたものを、実際に見てみる

「実体はユーザー側、有効化だけプロジェクト」という話は、ファイルを見るといちばん早いです。入れたあとの状態がこれです（パスは伏せています）。

# 有効化の記録（~/.claude/plugins/installed_plugins.json）
{"version": 2, "plugins": {"unity@claude-plugins-official": [
{"scope": "project",
 "version": "0.1.2-beta",
 "installedAt": "2026-09-15T10:06:44.642Z",
 "gitCommitSha": "c7055702b44e58402ee481ff408aee407bcf9483",
 "projectPath": "<リポジトリのルート>"}]}}

# リポジトリ側（.claude/settings.json）は、名前を1つ書くだけ
{"enabledPlugins": {"unity@claude-plugins-official": true}, "extraKnownMarketplaces": {}}

# 実体の置き場（~/.claude/plugins/cache/.../unity/0.1.2-beta）
3.1M	.         ファイル 229 件
2.4M	skills    スキル 31 個

見どころは3つです。

• リポジトリ側に入るのはプラグインの名前1件だけ。3.1MB の実体はユーザー側にある
• 記録にはどのフォルダで有効か（projectPath）と、取り込んだ時点のコミットが残る
• だから、リポジトリを共有しても他の PC には実体が無い。各自が入れるまで未インストール扱いになる

入れ替えるときの手順（つまずいた点つき）

Unity のリポジトリ版から公式マーケットプレイス版へ移すとき、2つ引っかかりました（手順 1 と 2）。

1. 1

   project で入れたものは --scope project で消す

   claude plugin uninstall は --scope を付けないと user を見に行く。見つからずに終わる
2. 2

   マーケットプレイスの宣言を手で消す

   アンインストールしても .claude/settings.json の extraKnownMarketplaces は残る
3. 3

   公式マーケットプレイスの一覧を更新する

   claude plugin marketplace update claude-plugins-official
4. 4

   プロジェクト単位で入れ直す

   claude plugin install unity@claude-plugins-official --scope project

なお claude plugin marketplace remove を使うと、そのマーケットプレイスから入れたプラグインも一緒に消えます。順番に注意してください。

入れたあとの確認

シェルから入れた場合、実行中のセッションには反映されません。入力欄で /reload-plugins を実行してから /context を見ます。

私の環境での実測値です。

「プラグインを入れれば AI がエディターを操作できる」わけではありません。操作の手段（Unity CLI）は別に用意します。詳しくはUnityをAIに触らせる5つの方法に書きました。

旧版0.1.2-betaで31個のうち4個が読み込まれなかったYAMLの不備は、公式のIssue #44では2026-09-18に修正済みです。2026-10-12に現行0.1.8-betaの配布32件を取得し、全件のYAML解析が成功しました。上の31個・4個という数字は当時の実測です。詳しくは同梱物と読み込みの確認記録へ。最新版の全スキルの起動までは未検証です。

インストールの前段（Unity 本体の導入）でつまずいた点はUnityを入れ直すときにWindowsで詰まる5か所にまとめています。