# Claude CodeをUnity Engineで使う方法 — AI Game Dev

AI Game Developerを使ってClaude CodeをUnity Engineに接続。インストール、設定、そして最初のAIによるシーン検査までを順を追って解説します。

このページは英語から機械翻訳されています。[英語の原文を読む](https://ai-game.dev/blog/claude-code-unity-tutorial)。

[ブログ](https://ai-game.dev/ja/blog)

AI Game Developerを使ってClaude CodeをUnity Engineに接続。インストール、設定、そして最初のAIによるシーン検査までを順を追って解説します。

Ivan Murzak · 2026年1月12日 · 読了時間 5分 ·

**2026年10月17日に更新。** Unity-MCP 1.0.0以降、エージェントは操作ごとに1つのツールを使うのではなく、RQL（rql-query、rql-mutate、rql-schema）を通じてシーン、GameObjects、コンポーネント、アセットを読み取り・編集します。以下のセットアップ手順は変わっておらず、CLIの例は現在のツール名を使用しています。詳細は ai-game.dev/docs/rql を参照してください。

Claude Codeは、Opus 4.5などのモデルを搭載した、利用可能な中でも最高クラスのAIエージェントの1つです。このチュートリアルでは、これをUnity Engineに直接接続し、ターミナルからシーンの読み取り、Unity APIの呼び出し、プロジェクトの変更を行えるようにします。

## 必要なもの

- Unity 2021.3以降
- Node.js ^20.19.0 または >=22.12.0（CLI用）
- Claude Codeがインストール済み（ターミナルベースのAIエージェント）
- AI Game Developer — AIエージェントとUnityをつなぐブリッジ: [github.com/IvanMurzak/Unity-MCP](https://github.com/IvanMurzak/Unity-MCP)

## AI Game Developerのインストール

AI Game Developerは、高度なAIエージェントやモデルとUnity Engineの間のブリッジとして機能します。Unityエディタから手動でインストールするか、CLIを使って完全に自動でセットアップできます。

### オプションA: 手動インストール（Unityエディタ）

1. AI Game DeveloperのGitHubページからインストーラーをダウンロードします
2. インストーラーファイルをダブルクリックしてUnityで開きます
3. Unityのインポートウィンドウで「Import」をクリックします
4. Unityのコンパイルが完了するまで待ちます

### オプションB: CLIインストール（推奨）

unity-mcp-cliツールは、コマンドラインからセットアップ全体を自動化します — 手動のクリックは不要です。グローバルにインストールし、任意のUnityプロジェクトにプラグインを追加するために使用します。

Bash ターミナル

```bash
# Install the CLI globally
npm install -g unity-mcp-cli

# Install the AI Game Developer plugin into your Unity project
unity-mcp-cli install-plugin ./MyUnityProject
```

install-pluginコマンドはプロジェクトのPackages/manifest.jsonを直接変更します — OpenUPMのスコープ付きレジストリとプラグインの依存関係を追加します。既存のインストールをダウングレードすることはありません。実行後、Unityでプロジェクトを開いてパッケージのインストールを完了してください。

## 接続の設定

パッケージをインポートすると、AI Game Developerウィンドウが表示されます。下にスクロールしてClaude Codeセクションを見つけ、「Configure」をクリックします — 必要な設定はこれだけです。次に「Connect」をクリックして接続プロセスを開始します。Claude Codeがまだ実行されていないため、最初はエラーが表示されますが、これは想定どおりです。

### CLI: Claude Code用にMCPをセットアップする

CLIはClaude CodeのMCP連携を自動で設定できます — UnityエディタのUIは不要です。Claude Codeが起動時にAI Game Developerサーバーを検出できるよう、正しい設定ファイルを書き込みます。

Bash ターミナル

```bash
# Configure Claude Code MCP integration
unity-mcp-cli setup-mcp claude-code ./MyUnityProject

# Generate skill files so Claude Code knows about available tools
unity-mcp-cli setup-skills claude-code ./MyUnityProject
```

## Claude Codeの起動

Claude CodeはVisual Studio Codeから、またはターミナルから直接起動できます。このチュートリアルではターミナルの方法を使います。Unityプロジェクトのフォルダでターミナルを開きます — UnityのAssetsフォルダを右クリックして「Show in Explorer」を選び、その後右クリックして「Open in Terminal」を選択すると開けます。

Bash ターミナル

```bash
# Navigate to your Unity project folder and start Claude Code
cd /path/to/your/unity/project
claude
```

Claude Codeが起動すると、AI Game Developerウィンドウのステータスが「Connected」に切り替わります。すべてが動作していることを確認するには、Claude Codeで/mcpと入力します — 「AI Game Developer」が一覧に表示され、接続済みになっているはずです。

## UnityシーンでAIを試す

接続が確立したら、「Unityプロジェクトのこのシーンには何が見えますか？」のような質問をAIにしてみてください。AIはAI Game Developerが提供するMCPツールを使ってシーン階層を読み取り、GameObjectsを検査し、見つけた内容を報告します。シーンデータを読み、ネストしたオブジェクトを調べ、プロジェクト全体像を組み立てるというように、段階的に処理を進めます。

Claude Codeがツールの使用許可を求めてきたら、オプション2を選ぶことで許可し、同じツールに対する今後の確認をスキップできます。その後AIはシーンを読み取り、メッシュ、ライト、ネストした階層などのオブジェクトを特定し、見つけたすべてについて詳細な説明を返します。

## コンテキストの最適化

AI Game Developerは多くのMCPツールをAIに公開します。重要なコツは、不要なツールを無効にすることです。有効なツールはすべてAIのコンテキストを消費するため、コンテキストをきれいに保つことでAIはより効率的に動作し、より良い結果を出せます。ツールのオン・オフはAI Game Developerウィンドウで切り替えられます — CLIを使うこともできます。

Bash ターミナル

```bash
# List current tool/prompt/resource configuration
unity-mcp-cli configure ./MyUnityProject --list

# Enable only the tools you need
unity-mcp-cli configure ./MyUnityProject \
  --enable-tools rql-query,rql-mutate,rql-schema,script-update-or-create \
  --disable-all-prompts

# Or enable everything at once
unity-mcp-cli configure ./MyUnityProject \
  --enable-all-tools \
  --enable-all-prompts
```

- 使わないツールは無効にしてAIのコンテキストを軽量に保つ
- 必要ない場合はResourcesを無効にすることを検討する
- プロンプトはスラッシュコマンドです — Claude Codeで/を入力すると、「set up an animation」や「add a component」などの利用可能なコマンドが表示されます
- Connectedステータスインジケーターを確認して、リンクが有効であることを確かめる

## ここからできること

Claude CodeをUnityに接続すれば、MCPツールが対応するあらゆることをAIに依頼できます — シーンの検査、GameObjectsの作成、コンポーネントの変更、アニメーションの生成、UIの構築など、多岐にわたります。AIは包括的なツールセットにアクセスでき、自然言語のプロンプトに応じてそのいずれも呼び出すことができます。

AIを介さずにコマンドラインから直接MCPツールを実行することもでき、スクリプトやCIパイプラインに便利です。

Bash ターミナル

```bash
# Check connection status at a glance
unity-mcp-cli status ./MyUnityProject

# Run an MCP tool directly from the CLI
unity-mcp-cli run-tool rql-query ./MyUnityProject --input '{"query":"objects | where name == \"Player\" | select $ref name transform.position"}'

# Run Unity tests via MCP
unity-mcp-cli run-tool tests-run ./MyUnityProject --input '{"testMode":"EditMode"}'
```

### 完全自動化: ゼロから接続まで

CLIはワークフロー全体を自動化できます — プロジェクトの作成、プラグインのインストール、Claude Codeの設定、Unityの起動、接続の待機、ツールの実行まで。以下は、すべてをゼロからセットアップする完全なスクリプトです。

Bash full-setup.sh

```bash
# 1. Create a new Unity project
unity-mcp-cli create-project ./MyAIGame --unity 6000.3.1f1

# 2. Install the AI Game Developer plugin
unity-mcp-cli install-plugin ./MyAIGame

# 3. Enable all MCP tools
unity-mcp-cli configure ./MyAIGame --enable-all-tools

# 4. Configure Claude Code MCP integration
unity-mcp-cli setup-mcp claude-code ./MyAIGame

# 5. Open the project with MCP connection
unity-mcp-cli open ./MyAIGame --keep-connected

# 6. Wait for Unity and MCP server to be ready
unity-mcp-cli wait-for-ready ./MyAIGame

# 7. Generate Claude Code skills
unity-mcp-cli setup-skills claude-code ./MyAIGame

# 8. Verify by running a tool
unity-mcp-cli run-tool tests-run ./MyAIGame --input '{"testMode":"EditMode"}'
```

## はじめに

AI Game Developerはオープンソースです。Unityパッケージをインストールし、Claude Codeを設定して、プロンプトを送り始めましょう。CLIツールは自動化ワークフロー向けにnpmで公開されています。詳しいセットアップ手順は [ai-game.dev/docs/quickstart](https://ai-game.dev/docs/quickstart) のクイックスタートガイドを参照してください。

- AI Game Developer（Unity-MCP）: [github.com/IvanMurzak/Unity-MCP](https://github.com/IvanMurzak/Unity-MCP)
- AI Animation Extension: [github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md](https://github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md)
- CLIツール: [npmjs.com/package/unity-mcp-cli](https://npmjs.com/package/unity-mcp-cli)
- ダウンロード: [ai-game.dev/download](https://ai-game.dev/download)
- 次へ: AIでアニメーションを生成する — [ai-game.dev/blog/generating-unity-animations-with-ai](https://ai-game.dev/blog/generating-unity-animations-with-ai)

## ブログのその他の記事

[すべての記事](https://ai-game.dev/ja/blog)

### [参照画像からゲームで使える3Dモデルへ — AI Game Developer に搭載された Tripo AI](https://ai-game.dev/ja/blog/tripo-ai-3d-models-from-reference-images)

2026年10月26日

AI Game Developer の Tripo で2〜4枚の参照ビューから1つの3Dモデルを作り、同じチャットでテクスチャ、メッシュ調整、リグ、アニメーションまで行えます。

Ivan Murzak 読了時間 7分

### [まず計画、それから変更 — ゲーム開発におけるAIエージェントのプランモード](https://ai-game.dev/ja/blog/plan-mode-ai-agent-game-development)

2026年10月26日

AI Game Developer のプランモード、確認質問、メッセージキュー、コードレビューカードを使って、大きなゲームタスクでもAIエージェントを制御下に保つ方法を紹介します。

Ivan Murzak 読了時間 6分

---

Source (HTML): https://ai-game.dev/ja/blog/claude-code-unity-tutorial

Machine-translated (ja) from the English page: https://ai-game.dev/blog/claude-code-unity-tutorial