Claude Code で Unity ゲーム開発を加速する — C# 生成・MCP 連携・実機検証

Unity MCP サーバーで「シーン操作」まで自動化する

Unity 公式の Unity MCP（Model Context Protocol）サーバーを導入すると、Claude Code から直接 Unity Editor の操作ができるようになります。具体的には次のような操作です。

• アクティブなシーンの GameObject 一覧の取得
• 新しい GameObject の生成、コンポーネントの追加
• Inspector フィールドの設定、Prefab 化
• メニューコマンドの実行（File > Build Settings 等）
• Console ログのリアルタイム取得

導入手順は次の通りです（Unity Package Manager 経由）。

# 1. Unity プロジェクトのルートで package.json を編集
# Packages/manifest.json に以下を追加:
{
  "dependencies": {
    "com.unity.mcp.server": "1.x.x"
  }
}
 
# 2. Claude Code 側の設定
claude mcp add unity-editor \
  --command "node" \
  --args "/path/to/unity-mcp-bridge/index.js" \
  --env UNITY_PROJECT_PATH=/path/to/your/project

私が特に重宝しているのは「シーン内のオブジェクト名を一覧して、その中の特定のコンポーネント設定を読む」ためのツールです。これがあると、Claude にシーン構造を説明する手間がほぼゼロになります。

実際の使用例を一つ。「プレイヤーの移動速度を 5.0 から 7.5 に変えて、その変更を加速度センサーで微調整できるようにしたい」と頼むと、Claude Code は次の流れで作業を進めます。

1. unity_get_scene_objects を呼んで Player GameObject を特定
2. 既存の PlayerMovement スクリプトを Read
3. moveSpeed フィールドを 7.5 に書き換え
4. IAccelerometerInput インターフェースを新規作成
5. PlayerMovement を編集して新インターフェース対応に
6. Inspector で SerializeField の参照を Wire-up
7. PlayMode テストを起動して挙動確認

ここまでを人間の介入なしで完了します。これは Web 開発の感覚で言えば、「テキスト指示→実装→ステージング環境で動作確認」までを通しで AI に任せられるということです。

C# スクリプト生成の精度を上げるための小技

MonoBehaviour ライフサイクルを明示する

Unity の MonoBehaviour には Awake、Start、OnEnable、Update、FixedUpdate、LateUpdate など多くのライフサイクルメソッドがあります。Claude Code は Web 開発寄りの学習データの影響で、何でも Start に書きがちです。

依頼時に「初期化は Awake、有効化のたびのリスナー登録は OnEnable、解除は OnDisable」のようにライフサイクル方針を伝えると、出力の質が大きく上がります。

名前空間を必ず指定する

using UnityEngine; だけ書かれて、UnityEngine.UI や UnityEngine.InputSystem の追加 using が抜けているケースがよくあります。CLAUDE.md に「UI Toolkit を使う」「Input System を使う」と明示しておくと、必要な using を揃えてくれる確率が上がります。

ScriptableObject 経由の設定値を提案させる

ゲームバランス調整に関わる数値（ジャンプ力、敵の HP、アイテムの効果時間など）は、コード内のリテラルで持つよりも ScriptableObject で外出しする方が後の調整が楽です。Claude Code は明示的に頼まないと数値をハードコードしがちなので、「数値パラメータは ScriptableObject に分離してください」と最初に伝えてください。

実機ビルドの検証まで自動化する

Unity MCP の execute_menu_item を使うと、File > Build And Run までを Claude Code から実行できます。実機（iOS/Android）への転送は Xcode や Android Studio に渡る部分が残るため完全自動化はまだ難しいですが、ビルドが通るかどうかの確認 までは AI に任せられます。

私が回しているフローは次の通りです。

1. Claude Code に新機能を実装してもらう
2. PlayMode テストを書いて、エディタ内で動作確認
3. unity_execute_menu_item で「Player Settings の検証」を呼ぶ
4. ビルドエラーがあれば Console ログを取得して Claude に修正依頼
5. 通ったら Build And Run

このサイクルで、人間がチェックするのは「実機での操作感」だけになります。「コードがビルドエラーを起こさないか」を AI に任せられるだけで、開発体験は別物になります。

エディタ拡張（Editor Window）の生成は意外と得意

Unity 開発で地味に時間を取られるのが、自作のエディタウィンドウ（バランス調整パネル、ステージエディタ、デバッグ用ツールなど）の作成です。EditorWindow を継承して OnGUI を書く、というおなじみの作業ですが、Claude Code はこれを驚くほどきれいに書きます。

たとえば「敵パラメータを ScriptableObject から読み込んで一覧表示し、その場で編集して保存できるエディタウィンドウを作って」と頼むと、SerializedObject と EditorGUILayout を駆使した適切な実装が返ってきます。Web 開発で「管理画面を作って」と頼むのと同じ感覚で、Unity 内ツールを生成できると考えるとイメージしやすいでしょう。

やってはいけないこと

ここまで効果的な使い方を紹介してきましたが、避けた方がよいパターンも共有します。

シェーダー（HLSL）の生成は要注意

URP の Shader Graph 経由ではなく、生の HLSL を Claude に書かせると、シェーダーのバージョン違い・パイプライン違いで動かないコードが出ることが多いです。シェーダーは Shader Graph で組んで、Custom Function Node 内のコードだけ Claude に頼むのが安全です。

アセットの import 設定を一括変更させない

AssetImporter を経由したテクスチャ圧縮設定の一括変更などを Claude に頼むと、想定外のアセットまで巻き込んで圧縮形式が変わることがあります。バッチ処理は必ず対象を絞ってからお願いしてください。

シーン.unity ファイルの直接編集は避ける

.unity ファイルは YAML ですが、人間が直接編集してもよい構造ではありません。Claude が「このシーンファイルを編集します」と言い出したら止めて、Unity Editor 内での操作に切り替えてください。

次に試すこと

このガイドの内容のうち、まず一つだけ試すなら Unity MCP の導入 です。CLAUDE.md の整備は後からでも追加できますが、エディタ操作が AI から呼べるようになると、Claude Code との対話の質そのものが変わります。「シーン内に何があるか」を毎回テキストで説明する手間がなくなるだけで、Unity 開発における AI ペアプログラミングは現実的なものになります。

そこまで来たら、CLAUDE.md を自分のプロジェクト固有の規約で埋めて、いつもの C# コーディング規約・命名規則・利用ライブラリを書き出してみてください。Claude Code の出力品質は、この設計図の精度にほぼ比例します。

なぜ Claude Code が Unity 開発に向いているのか

Claude は以下の理由で Unity 開発に適しています。

C# と Unity API の深い理解

Claude は C# 言語とそのデザインパターンに精通しており、Unity の GameObject、Component、Transform、Physics などの主要 API も熟知しています。単なるコード生成ではなく、Unity の設計思想に沿った実装を提案できます。

複雑なロジックの構造化設計

ゲーム開発では、PlayerController、Enemy AI、パーティクルエフェクト、UI 管理など、多くのクラスが相互作用します。Claude は複数クラス間の設計を統合的に考え、疎結合で保守性の高いアーキテクチャを提案します。

時間単価が高い作業を優先

開発者の貴重な時間は、仕様検討やゲームバランス調整に割くべきです。Claude はコーディングと初期デバッグを引き受け、開発者が創造的な仕事に集中できるようにします。

セットアップ：Claude Code を Unity プロジェクトで使い始める

前提条件

• Unity 2022 LTS 以上（最新は推奨）
• Claude Code がインストール済み（claude.com でアクセス可能）
• Git リポジトリ初期化済みの Unity プロジェクト
• Claud Code CLI ツール（npm install -g @anthropic-ai/claude-code-cli でインストール）

Step 1: CLAUDE.md を Unity 向けに初期化

プロジェクトルートに CLAUDE.md を作成し、以下の情報を記載します：

# [Game Title] — Claude Code Setup
 
## Project Context
 
- **Unity Version**: 2023.2.0f1
- **Target Platform**: Windows/Mac/Android
- **Project Type**: 2D Puzzle / 3D Action / etc.
- **Team Size**: Solo / Small Team
 
## Folder Structure
 

Assets/ ├── Scripts/ │ ├── Player/ → PlayerController, Movement, Input │ ├── Enemy/ → AI, Behavior, Health │ ├── UI/ → Canvas, Menus, HUD │ ├── Core/ → GameManager, Audio, Events │ ├── Data/ → ScriptableObjects (configs) │ └── Tools/ → Editor extensions, Utilities ├── Scenes/ ├── Prefabs/ ├── Resources/ └── Plugins/

## Code Style & Conventions

- **Namespace**: `[GameTitle].[Category]` (e.g., `MyGame.Player`)
- **Class Naming**: PascalCase (e.g., `PlayerController`)
- **Private Fields**: `_camelCase` with `[SerializeField]` for inspector access
- **Properties**: Auto-property or public property for external access
- **Methods**: PascalCase, keep functions under 50 lines
- **Comments**: Only for "why", not "what" (code explains itself)
- **Async**: Use coroutines or async/await with UniTask

## Known Issues & Workarounds

- Physics precision: Set gravity to Y: -9.81, timestep: 0.02
- UI sorting: Use Canvas > Render Mode with proper sorting orders

これにより、Claude が Unity プロジェクトの構造とルールを理解し、一貫した実装ができます。

Step 2: Claude Code CLI で会話を開始

claude-code init --project-root . --language csharp

これで Claude Code が Git の状態を監視し、ファイル変更を自動追跡します。

実践：よくある Unity 開発タスクを Claude Code に任せる

タスク1：PlayerController スクリプト生成

指示例：

Create a PlayerController script that:
1. Handles WASD/Arrow key input for 2D movement
2. Implements jump with configurable height and gravity
3. Animates between idle, walk, and jump states
4. Detects ground using a raycast below the player
5. Make the script inherit from MonoBehaviour
6. Expose settings (moveSpeed, jumpForce, etc) in Inspector
Place it in Assets/Scripts/Player/PlayerController.cs

Claude はこれを受けて、以下のような質の高い実装を提供します：

• キャラクターの移動、ジャンプ、アニメーション遷移がロジカルに整理されている
• タイムスケール計算が正確で、フレームレートに依存しない
• Collider、Rigidbody、Animator との相互作用が適切に設計されている
• [SerializeField] で Inspector から値を調整可能

結果として、開発者は実装の詳細を気にせず、生成されたコードをプロジェクトにドラッグ&ドロップでき、微調整だけ行えば完成です。

タスク2：バグ修正と最適化

プレイテスト中に「ジャンプ中に二重跳びできてしまう」バグが発見されたとします。

指示例：

I have a PlayerController bug: the player can double-jump.
The issue is likely in the jump detection logic.
Review this code (paste the buggy code) and fix it so:
1. Ground detection is more reliable
2. Jump can only happen when grounded
3. Suggest a more robust raycast check pattern

Claude は以下を実行します：

• バグの根本原因を特定（例：地面判定のタイミング問題）
• 修正案を複数提示（Raycast、Collider.bounds、Physics.OverlapCircle など）
• 各手法のパフォーマンス特性を説明

タスク3：エディタ拡張ツール生成

ゲームデータの管理が複雑になってきた場合：

指示例：

Create an Editor Window that:
1. Lists all ScriptableObject configs in the project
2. Allows quick preview of key properties
3. Has buttons to create new config, delete, or open in Inspector
4. Includes a search filter for quick navigation
Place in Assets/Editor/ConfigManager.cs

Claude は EditorWindow を継承した使いやすいツールを生成し、コンテンツ制作の効率が大幅に向上します。

Claude Code の /hooks 機能で Unity ビルドを自動化

Claude Code は /hooks コマンドで、ビルド前・ビルド後に自動実行されるスクリプトを設定できます。

例1: ビルド前の整合性チェック

claude-code /hooks add pre-build --cmd "npm run validate:unity"

ここで validate:unity は、以下を実行するカスタムスクリプト：

• すべての GameObject が命名規則に従っているか
• 未使用のアセットがないか
• BuildSettings が正しいプラットフォームに設定されているか

例2: ビルド後の自動テスト実行

claude-code /hooks add post-build --cmd "npm run test:unity"

Unity Test Framework と連携させることで、ビルド成功直後に自動テストが実行され、回帰バグが検出されます。

例3: リリース前のアセットサイズチェック

claude-code /hooks add pre-release --cmd "npm run check:asset-size"

ビルド後のサイズが予期値を超えていないか、未圧縮アセットがないかをチェック。これにより AppStore や Google Play への申請前に問題を発見できます。

注意点と Claude Code を使いこなすコツ

注意1：Unity バージョン情報を CLAUDE.md に必ず記載

Unity は LTS バージョンによって API が微妙に異なります。例えば、Input System の使い方、UI Toolkit 対応など。Claude が正確な実装を提供するよう、CLAUDE.md に以下を記載：

- **Unity Version**: 2023.2.0f1 (LTS)
- **Input System**: New Input System (Package) enabled
- **Rendering Pipeline**: URP or Built-in
- **Scripting Backend**: IL2CPP (Mobile) / Mono (Editor)

Claude がこれを見ることで、古い API やバージョンで非推奨の手法を避けられます。

注意2：スクリプト生成後は必ず動作確認

Claude が生成したコードは高品質ですが、プロジェクト固有の条件（カスタム Asset フォルダ構成など）によっては微調整が必要な場合があります。

必ず以下を確認：

• コンパイルエラーがないか
• Inspector で値を設定できるか
• Play モードで期待通りに動作するか

注意3：AI が苦手な領域を知る

Claude Code は論理的・構造的なコードに強い一方、以下は人間の判断が必要：

• ゲームバランス: 敵の AI 難度、報酬バランスなど。Claude は提案できますが、最終判断は開発者
• UI/UX デザイン: 美しさや直感性。Claude は構造を作りますが、デザイン感覚は必要
• アート資産との連携: 3D モデルやアニメーションのインポート。Claude はスクリプト側の対応は提供しますが、アート制作は別

注意4：段階的に信頼を構築

最初は小さなタスク（ユーティリティ関数、簡単な UI スクリプト）を Claude Code に任せ、品質と相性を確認します。信頼が築けたら、より複雑なシステム設計を任せるようにします。

Claude Code は Unity ゲーム開発の生産性を劇的に向上させます。開発者が仕様検討やゲーム面白さの追求に集中でき、実装やデバッグを AI に任せられる時代です。プロジェクトに合わせて CLAUDE.md を整備し、Claude Code を使い始めれば、開発スピードと品質が同時に向上するでしょう。