Claude Codeを使ったUE5開発手順

【結論】Unreal Engine開発を安全に進める

Claude CodeはUnreal EngineのC++、Build.cs、Editor Python、テストコードの作成を支援できます。

UEのバージョン、モジュール名、Target、Plugin、Enhanced Inputなどの採用状況を確認してから編集します。

C++ Class Wizardで作られた構造を基準にし、generated.h、APIマクロ、UCLASS、UPROPERTY、UFUNCTIONの整合を確認します。

# Unrealプロジェクトで実行：対象モジュールを確認
find Source -maxdepth 3 -name '*.Build.cs' -o -name '*.Target.cs'
# ターミナルで実行：変更前のGit状態を確認
git status --short
# ターミナルで実行：Planモードで起動
claude --permission-mode plan
# ターミナルで実行：変更差分を確認
git diff -- Source Config

具体的な手順・設定方法

1. Engine版、プロジェクト名、モジュール名、親クラス、Blueprint公開範囲を定義します。

2. ヘッダー、実装、Build.csへの影響を計画し、人間がレビューします。

3. EditorまたはUnrealBuildToolでビルドし、UHT、Linker、Hot Reloadのエラーを切り分けます。

実践プロンプト / 活用テクニック

# 起動後のセッション内で入力
このUEプロジェクトのEngine版とモジュール名を確認してください。
AActor派生のInventoryItem追加計画を作成し、必要なUPROPERTY、APIマクロ、generated.h、テスト方法を示してください。
承認までSource、Config、uproject、Build.csを変更しないでください。

注意点・よくあるエラーと対処法

プロジェクト名からAPIマクロを推測するとLinkerエラーになる場合があります。

Live Codingだけでは反映できないヘッダー変更やモジュール変更があります。

Content、Config、uproject、Pluginをまとめて自動変更させず、Gitで復元可能にしてください。