Claude CodeをUnity Engineで使う方法

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

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プロジェクトにプラグインを追加するために使用します。

# 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サーバーを検出できるよう、正しい設定ファイルを書き込みます。

# 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」を選択すると開けます。

# 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を使うこともできます。

# 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パイプラインに便利です。

# 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の起動、接続の待機、ツールの実行まで。以下は、すべてをゼロからセットアップする完全なスクリプトです。

# 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 のクイックスタートガイドを参照してください。

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