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

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 が書かれていて、その時点の最新と一致していました）。

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

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

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つの方法に書きました。

31個のうち4個が読み込まれない問題（スキル定義の YAML が壊れている）については、同じ記事の後半で触れています。

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