ゲーム開発
Claude Code で Unreal Engine C++ プロジェクト自動生成｜AI駆動ゲーム開発ワークフロー
Claude Code を使った Unreal Engine C++ プロジェクトの自動生成・セットアップ手法を解説。AI駆動でボイラープレート削減、コード品質向上を実現する実践ガイド。
約11分で読めますUnreal Engine での C++ 開発は強力だが、プロジェクトセットアップ・ボイラープレート生成・命名規則の遵守など、初期段階で多くの手作業が必要になる。特にマルチプレイヤー対応、ECS（Enhanced Input System）、GAS（Gameplay Ability System）などの高度な機能を含むプロジェクトでは、設定ミス一つがビルドエラーやランタイムクラッシュにつながる。
Claude Code は、Anthropic の Claude 4.5/4.6 モデルを統合した AI コーディング環境で、ファイル読み書き・コマンド実行・コード生成を自動化できる。本記事では、Claude Code を使って Unreal Engine C++ プロジェクトを ゼロから自動生成 し、品質とスピードを両立させるワークフローを実装する。
Claude Code が Unreal Engine 開発で解決する課題
従来の C++ プロジェクトセットアップの問題点
Unreal Engine の C++ プロジェクトは以下の手順を要する：
.uprojectファイル生成・モジュール定義Source/{ModuleName}/{ModuleName}.Build.cs作成{GameName}GameMode.h/cpp、{GameName}Character.h/cppなどのボイラープレート生成UCLASS()マクロ、UPROPERTY()記述ルールの厳守Public/Privateフォルダ構成、前方宣言の適切な配置- Enhanced Input System のマッピング・設定
Config/DefaultEngine.iniなどの設定ファイル編集
これらを手動で行うと、特に初学者は 命名規則違反（例：AMyCharacter を MyCharacter と書く）や ヘッダインクルード順序ミス でコンパイルエラーに陥る。
Claude Code による自動化の利点
| 課題 | Claude Code の解決策 |
|---|---|
| ボイラープレート生成 | テンプレートから .h/.cpp を自動生成 |
| 命名規則違反 | Epic Games のコーディング標準を事前学習済み |
| モジュール依存関係ミス | .Build.cs を正しいモジュール名で生成 |
| Enhanced Input 設定漏れ | IMC_Default.uasset と IA_Move.uasset の設定を自動化 |
| プロジェクト構成の一貫性 | CLAUDE.md でプロジェクト固有ルールを定義・強制 |
Claude Code 環境のセットアップ
前提条件
- Unreal Engine 5.3+ がインストール済み（2026年4月時点の推奨は UE 5.5）
- Claude Code CLI（
claude-code）がインストール済み - Visual Studio 2022 または Rider 2025.1+（C++ ツールチェーン）
プロジェクトルール定義（CLAUDE.md）
Claude Code は .claude/CLAUDE.md または /CLAUDE.md を読み込み、プロジェクト固有のルールを適用する。以下は Unreal Engine C++ 開発用の設定例：
# Unreal Engine C++ プロジェクト自動生成ルール
## 命名規則（Epic Games コーディング標準準拠）
- クラス名プレフィックス:
- `AActor` 継承 → `A` プレフィックス（例：`AMyCharacter`）
- `UObject` 継承 → `U` プレフィックス（例：`UMyGameInstance`）
- `UActorComponent` 継承 → `U` プレフィックス（例：`UHealthComponent`）
- `struct` → `F` プレフィックス（例：`FPlayerData`）
- `enum` → `E` プレフィックス（例：`EWeaponType`）
- `interface` → `I` プレフィックス（例：`IInteractable`）
## ファイル構成
Source/ {ProjectName}/ Public/ Characters/ Components/ GameModes/ Private/ Characters/ Components/ GameModes/ {ProjectName}.Build.cs
## 必須モジュール
新規プロジェクトには以下を `.Build.cs` に追加：
```csharp
PublicDependencyModuleNames.AddRange(new string[] {
"Core", "CoreUObject", "Engine", "InputCore", "EnhancedInput"
});コード生成時の注意
GENERATED_BODY()マクロは必ずクラス定義の最初に配置UPROPERTY()は必ずEditAnywhereまたはVisibleAnywhereを指定BlueprintCallable関数はUFUNCTION()マクロ必須
### 自動生成スクリプトの実装
以下は Claude Code のプロンプトで実行できる自動生成例：
**プロンプト例**：
Unreal Engine 5.5 用の Third Person Shooter プロジェクトを生成してください。
- プロジェクト名: MyShooter
- キャラクタークラス: AMyShooterCharacter（Enhanced Input 対応）
- 武器コンポーネント: UWeaponComponent（発射・リロード機能）
- GameMode: AMyShooterGameMode
- Config/DefaultEngine.ini に Enhanced Input 有効化設定を追加
すべてのファイルは Epic Games コーディング標準に準拠すること。
Claude Code は以下を自動実行する：
1. `MyShooter.uproject` 生成
2. `Source/MyShooter/MyShooter.Build.cs` 作成（EnhancedInput モジュール追加済み）
3. `Public/Characters/MyShooterCharacter.h` と `Private/Characters/MyShooterCharacter.cpp` 生成
4. `Public/Components/WeaponComponent.h/cpp` 生成
5. `Config/DefaultEngine.ini` に以下を追加：
```ini
[/Script/Engine.Engine]
+DefaultPlayerInputClass=/Script/EnhancedInput.EnhancedPlayerInput
+DefaultInputComponentClass=/Script/EnhancedInput.EnhancedInputComponent生成されたコード例（AMyShooterCharacter.h）
// Fill out your copyright notice in the Description page of Project Settings.
#pragma once
#include "CoreMinimal.h"
#include "GameFramework/Character.h"
#include "MyShooterCharacter.generated.h"
class UInputMappingContext;
class UInputAction;
class UWeaponComponent;
UCLASS()
class MYSHOOTER_API AMyShooterCharacter : public ACharacter
{
GENERATED_BODY()
public:
AMyShooterCharacter();
protected:
virtual void BeginPlay() override;
virtual void SetupPlayerInputComponent(class UInputComponent* PlayerInputComponent) override;
private:
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Input", meta = (AllowPrivateAccess = "true"))
UInputMappingContext* DefaultMappingContext;
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Input", meta = (AllowPrivateAccess = "true"))
UInputAction* MoveAction;
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Input", meta = (AllowPrivateAccess = "true"))
UInputAction* LookAction;
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Input", meta = (AllowPrivateAccess = "true"))
UInputAction* FireAction;
UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Components", meta = (AllowPrivateAccess = "true"))
UWeaponComponent* WeaponComponent;
void Move(const struct FInputActionValue& Value);
void Look(const struct FInputActionValue& Value);
void Fire(const struct FInputActionValue& Value);
};このコードは Epic Games コーディング標準 に完全準拠し、以下の点で手動作成を上回る：
meta = (AllowPrivateAccess = "true")による Blueprint 可視性制御- Enhanced Input 用の
FInputActionValue構造体使用 - 前方宣言による不要なインクルード削減
AI駆動コード品質チェックの実装
Claude Code によるリアルタイムレビュー
Claude Code は生成したコードを自動レビューし、以下をチェックできる：
プロンプト例：
生成した MyShooterCharacter.cpp のコードレビューを実施してください。
チェック項目:
- メモリリーク（NewObject 後の GC 対象化漏れ）
- null チェック漏れ
- Enhanced Input のバインド順序ミス
- 命名規則違反Claude Code の出力例：
## コードレビュー結果
### 🔴 重大な問題
**MyShooterCharacter.cpp:45** - WeaponComponent の初期化で nullptr チェックが不足
修正案:
```cpp
void AMyShooterCharacter::BeginPlay()
{
Super::BeginPlay();
if (APlayerController* PlayerController = Cast<APlayerController>(Controller))
{
if (UEnhancedInputLocalPlayerSubsystem* Subsystem =
ULocalPlayer::GetSubsystem<UEnhancedInputLocalPlayerSubsystem>(PlayerController->GetLocalPlayer()))
{
if (DefaultMappingContext) // ← 追加
{
Subsystem->AddMappingContext(DefaultMappingContext, 0);
}
}
}
}✅ 良好な実装
- Enhanced Input のバインド順序は正しい
- 前方宣言により
WeaponComponent.hのインクルード削減に成功
### 自動テスト生成
Claude Code は Unreal Engine の **Automation Testing Framework** を使ったテストコードも生成できる：
**プロンプト**：
UWeaponComponent::Fire() 関数の単体テストを Automation Testing Framework で生成してください。
テストケース:
- 弾薬が 0 の状態で Fire() を呼ぶと発射されない
- リロード後に Fire() を呼ぶと弾薬が 1 減る
生成例（`WeaponComponentTest.cpp`）：
```cpp
#include "Misc/AutomationTest.h"
#include "Components/WeaponComponent.h"
#include "GameFramework/Actor.h"
IMPLEMENT_SIMPLE_AUTOMATION_TEST(FWeaponComponentFireTest,
"MyShooter.Components.WeaponComponent.Fire",
EAutomationTestFlags::ApplicationContextMask | EAutomationTestFlags::ProductFilter)
bool FWeaponComponentFireTest::RunTest(const FString& Parameters)
{
UWorld* World = UWorld::CreateWorld(EWorldType::Game, false);
AActor* TestActor = World->SpawnActor<AActor>();
UWeaponComponent* WeaponComp = NewObject<UWeaponComponent>(TestActor);
// テスト 1: 弾薬 0 で発射できないことを確認
WeaponComp->CurrentAmmo = 0;
WeaponComp->Fire();
TestEqual("Ammo should remain 0 when firing with no ammo", WeaponComp->CurrentAmmo, 0);
// テスト 2: リロード後に発射すると弾薬が減る
WeaponComp->Reload();
int32 AmmoBeforeFire = WeaponComp->CurrentAmmo;
WeaponComp->Fire();
TestEqual("Ammo should decrease by 1 after firing", WeaponComp->CurrentAmmo, AmmoBeforeFire - 1);
World->DestroyWorld(false);
return true;
}このテストは Unreal Editor の Session Frontend から MyShooter.Components.WeaponComponent.Fire として実行できる。
高度な活用例：GAS（Gameplay Ability System）の自動セットアップ
Gameplay Ability System は Unreal Engine の複雑な機能の一つで、手動セットアップには以下が必要：
GameplayAbility継承クラス作成AbilitySystemComponentをキャラクターに追加GameplayEffectで属性（Health, Mana など）を定義AttributeSetクラス実装- Blueprint での Ability Grant 設定
Claude Code による GAS プロジェクト自動生成
プロンプト：
Gameplay Ability System を使った RPG プロジェクトを生成してください。
要件:
- プロジェクト名: MyRPG
- キャラクタークラス: AMyRPGCharacter（AbilitySystemComponent 保有）
- AttributeSet: UMyAttributeSet（Health, Mana, Stamina）
- GameplayAbility 例: UGA_MeleeAttack（近接攻撃）
- GameplayEffect 例: GE_Damage（ダメージ適用）
すべて C++ で実装し、Blueprint で拡張可能にすること。Claude Code は以下を自動生成：
MyRPG.Build.csにGameplayAbilities,GameplayTags,GameplayTasksモジュール追加UMyAttributeSetクラス（ATTRIBUTE_ACCESSORSマクロ使用）AMyRPGCharacterにUAbilitySystemComponentとUMyAttributeSetを追加UGA_MeleeAttack::ActivateAbility()の実装Config/DefaultGameplayTags.iniにAbility.Attack.Meleeタグ定義
生成された UMyAttributeSet.h 例：
#pragma once
#include "CoreMinimal.h"
#include "AttributeSet.h"
#include "AbilitySystemComponent.h"
#include "MyAttributeSet.generated.h"
#define ATTRIBUTE_ACCESSORS(ClassName, PropertyName) \
GAMEPLAYATTRIBUTE_PROPERTY_GETTER(ClassName, PropertyName) \
GAMEPLAYATTRIBUTE_VALUE_GETTER(PropertyName) \
GAMEPLAYATTRIBUTE_VALUE_SETTER(PropertyName) \
GAMEPLAYATTRIBUTE_VALUE_INITTER(PropertyName)
UCLASS()
class MYRPG_API UMyAttributeSet : public UAttributeSet
{
GENERATED_BODY()
public:
UMyAttributeSet();
UPROPERTY(BlueprintReadOnly, Category = "Attributes", ReplicatedUsing = OnRep_Health)
FGameplayAttributeData Health;
ATTRIBUTE_ACCESSORS(UMyAttributeSet, Health)
UPROPERTY(BlueprintReadOnly, Category = "Attributes", ReplicatedUsing = OnRep_Mana)
FGameplayAttributeData Mana;
ATTRIBUTE_ACCESSORS(UMyAttributeSet, Mana)
UPROPERTY(BlueprintReadOnly, Category = "Attributes", ReplicatedUsing = OnRep_Stamina)
FGameplayAttributeData Stamina;
ATTRIBUTE_ACCESSORS(UMyAttributeSet, Stamina)
protected:
UFUNCTION()
virtual void OnRep_Health(const FGameplayAttributeData& OldHealth);
UFUNCTION()
virtual void OnRep_Mana(const FGameplayAttributeData& OldMana);
UFUNCTION()
virtual void OnRep_Stamina(const FGameplayAttributeData& OldStamina);
virtual void GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const override;
};このコードは マルチプレイヤー対応（ReplicatedUsing による自動同期）まで含まれており、手動作成では見落としがちな GetLifetimeReplicatedProps() のオーバーライドも正しく実装されている。
パフォーマンス最適化：Claude Code による Profiling 結果解析
Unreal Engine の stat コマンドや Unreal Insights で取得したプロファイリング結果を Claude Code に解析させることもできる。
プロンプト例：
以下は `stat game` の出力です。パフォーマンスボトルネックを特定し、最適化案を提示してください。
Frame: 33.5ms (29.85 FPS) Game Thread: 28.2ms TickFunction: 18.5ms AMyShooterCharacter::Tick: 12.3ms AI: 6.7ms Render Thread: 24.1ms GPU: 16.8ms
Claude Code の出力例：
パフォーマンス分析結果
🔴 ボトルネック特定
AMyShooterCharacter::Tick が 12.3ms と異常に重い（理想は 1ms 以下）。
考えられる原因:
- Tick 内で高コストな処理（LineTrace, ForEach ループなど）を毎フレーム実行
- Blueprint の Event Tick から呼ばれる重い処理
最適化案
- Tick 頻度の削減
AMyShooterCharacter::AMyShooterCharacter()
{
PrimaryActorTick.bCanEverTick = true;
PrimaryActorTick.TickInterval = 0.1f; // 100ms ごとに Tick（10 FPS）
}- LineTrace を Timer で非同期化
Before:
void AMyShooterCharacter::Tick(float DeltaTime)
{
Super::Tick(DeltaTime);
PerformLineTrace(); // 毎フレーム実行
}After:
void AMyShooterCharacter::BeginPlay()
{
Super::BeginPlay();
GetWorldTimerManager().SetTimer(TraceTimerHandle, this,
&AMyShooterCharacter::PerformLineTrace, 0.2f, true);
}期待効果: Game Thread を 28.2ms → 15ms 以下 に削減（60 FPS 達成）
## まとめ：Claude Code で変わる Unreal Engine C++ 開発
Claude Code を Unreal Engine 開発に導入することで、以下の効果が得られる：
- **セットアップ時間 80% 削減**: 手動で 2-3 時間かかるプロジェクト構築が 10 分で完了
- **コード品質の標準化**: Epic Games コーディング標準を自動適用、レビュー漏れゼロ
- **学習曲線の緩和**: GAS や Enhanced Input など高度な機能を AI がサポート
- **パフォーマンス最適化の自動化**: Profiling 結果から最適化案を即座に生成
- **継続的改善**: `CLAUDE.md` でプロジェクト固有ルールを蓄積し、次回開発で再利用
特に **個人開発者** や **小規模チーム** では、C++ エンジニアの不足がボトルネックになりがちだが、Claude Code により Blueprint 開発者でも C++ プロジェクトを立ち上げられるようになる。
2026 年以降のゲーム開発は、AI がボイラープレート・テスト・最適化を担当し、人間はゲームデザインと創造的な実装に集中する時代に移行する。Claude Code はその先駆けとなるツールだ。