2025-12-15

UE × AIコーディング (ClaudeCode) 半年間試してみた

概要

Unreal Engine (UE) Advent Calendar 2025 の15日目の記事です
他の人の開発手法が気になる今日このごろなので
まずは自分が半年間試行錯誤した上で行っている開発手法を公開してみようと思いました！

現在の開発環境の構成

Windows11
Rider 2025.2.5
- Riderは非商用利用であれば無料なのでまじおすすめ
ClaudeCode 2.0.69
- メインのコーディング
Codex
- コードレビュー用
PlasticSCM
UnrealEngine 5.5

Copilot使ったり、Cursor試したり色々してましたが
ここ3ヶ月くらいはこれで開発して結構快適！

▶ 代替可能そうな構成

ClaudeCode → Codex
- 色んな記事見る限り今ならCodexのがいいかも？
Rider → VisualStudio

▶ ClaudeCodeのセットアップ（必要だったら見てね）

Claudeのインストール

npm install -g @anthropic-ai/claude-code@latest

claude

npm使えないならnode.js入れてね

RiderのClaudePluginの追加

設定から追加できます

プロジェクトルートに CLAUDE.md を配置

プロジェクトの構造、ビルドコマンド、アーキテクチャ情報をまとめたファイルを用意することで、ClaudeCodeがプロジェクトの文脈を理解できます。

初回に自動で作ってくれますが、追記しても良いかも
VLSPluginDev/
├── CLAUDE.md
├── VLSPluginDev.uproject
├── Source/
├── Plugins/
│   ├── VLS/
│   └── VLS_CGToolKit/
└── Content/
ちなみに自分のはこんな感じ Claude.md · GitHub

基本の開発方法

設計を考えて依頼、作ってもらったものを動作確認してレビューを行う人になってます

作りたい機能のタスク化、1タスクで1つのことを実装する粒度で
タスクをClaudeCodeに実装してもらう
ClaudeCodeでビルド＆デバッガでの起動を行う
動作確認を行う
→ 修正が必要であれば5へ、不要であれば6へ
修正内容をClaudeCodeに投げる、3に戻る
ClaudeCodeでバージョン管理を行う
→ 完成であれば終わり、必要なタスクが残っていれば2へ

UE × Rider × ClaudeCode を使う上でのTips

▶ uprojectを開くこと

ソリューションファイル（sln）の再生成が不要になります
VS2022でもそうなってるね
Visual Studio で Unreal Engine プロジェクトを開く | Microsoft Learn

Unityから移行した時はこの作業のせいでUE嫌いだったなぁ～

▶ ClaudeはwindowsならGitBash上で動かすこと

公式ドキュメントにも書かれてるのですがPowershellと相性よくありません

Shell: Works best in Bash, Zsh or Fish

Set up Claude Code - Claude Code Docs

ClaudeがBashコマンドを実行しようとしてコマンドが使えないってエラーを吐いて Powershell用に書き換えて実行し直してることないですか？それが無くなります
実行速度やコンテキストにも影響すると思います

▶ JetBrainsのMCPServerのPluginを使う

Riderの機能を一部Claudeから呼び出せるようになります
一番便利なのはコード修正→ビルド→UE起動の一連の流れをClaudeで行えるようになること

▶ ModelをSonnet1Mにする

コード量やSessionがある程度の大きさになってくるとContext量が足りずConversationCompactの頻度が高くなってイラつきますよね
/model からModelをこれに変えると解消されます
使用量も上がるので気をつけて

▶ ターミナルタブから「エディタに移動」させる

ターミナルタブでいじってるとESCがフォーカスを外すボタン扱いになっていたり色々使いづらいので一つのタブにしちゃいましょう

▶ ctrl + J で改行

これはどのAIコーディングツールでも一緒なんですがCLIで指示する場合 ctrl + J で改行できます

実例

今回実装した機能

LevelSnapshotのようなPluginであるActorSerializationを自作しました
指定したActorのその時の状態をバイナリとして保存、復元でき、外部にJSONとして出力できる機能です
その時の開発の流れを書いていきます
Projectに一部依存しているところを修正して記事にしているので実際の入出力とは違いますがご了承ください

▶ Phase0: 記事を書くために履歴を取得

この記事を書くことをタスク実装時は考えていなかったのでどういうやり取りをしていたか思い出すためにこの作業を行いました

/resumeで見れる履歴ってどこに保存されてるの？

● Claude Codeの履歴保存場所について、公式ドキュメントを確認します：
● Fetch(https://code.claude.com/docs/en/claude_code_docs_map.md)
⎿ Received 25.7KB (200 OK)
～～～～～～
● 見つかりました！
履歴の保存場所
~/.claude/history.jsonl (約189KB)
このファイルに会話履歴が保存されています。

履歴ファイル見つけた！ありがとう！
俺からのチャットしか載ってないけどResumeするとClaudeからの回答もちゃんと戻るよね
これってどこか別のところに保存されているの？

● history.jsonlの中身を確認して、どのような形式で保存されているか見てみましょう：
● Bash(head -20 ~/.claude/history.jsonl)
… +125 lines (ctrl+o to expand)
～～～～～
Claude側の応答はローカルには保存されていない可能性が高いです。代わりに：
1. サーバー側に保存: sessionIdをキーにAnthropicのサーバーに保存
2. /resumeの動作:
- ローカルのhistory.jsonlからsessionIdを取得
- サーバーにsessionIdを送信
- サーバーから完全な会話履歴（Claude側の応答含む）を取得

見てもらえると分かると思うんですけど友達みたいに会話してますｗ
AIとのやり取り見せるのちょっと恥ずいっすよね

▶ Phase1: ブランチ作成

今回はバージョン管理も含めAIで任せようと思うのでここも任せます

指示内容

「レベル上に存在するActorをSerializeDeserialize出来る機能を作ろうとしています。
PlasticSCMでcmコマンドを使い、現在のブランチから、ブランチを切って始めてください。
ブランチ名はfeature_serialize_dataとかでいいです。」

出力
ブランチの作成と移動

▶ Phase2: 初期実装

指示内容１
「Level上に存在するActorをDataTableにシリアライズとデシリアライズする機能を作りたいです。シリアライズしたデータは今後JSONとして使用する予定があるのでその点も考慮してください。」

動作確認
ビルドエラーだったり細かいところを修正後、SerializeとDeserializeは一旦動作確認が取れた。

指示内容２
PlasticSCMで現在の変更内容を見て、適切なコミットメッセージを日本語で書いてCheckinして。

コミット履歴
Serializationフォルダと3つのファイルを新規作成  
- ActorSerializationStructs.h: FVLS_SerializedActorData構造体  
- ActorSerializationBPFL.h/.cpp: シリアライズ/デシリアライズ関数  
- ActorSerialization_Usage.md: 使い方ドキュメント  

実装機能  
✓ バイナリシリアライズ/デシリアライズ  
✓ JSON形式でのTransform/Component/Property抽出  
✓ DataTable保存・取得  
✓ CSV出力対応  

▶ Phase3: バイナリファイル分離

課題
初期実装ではバイナリデータをDataTable内に直接保存していたため、DataTableが肥大化し、エディタでの閲覧するとクラッシュするようになった。

また、ActorのAttachment情報が保存されていなかったのでComponentの親子関係が維持できていなかった。

指示内容１
DataTableがクラッシュが開くとクラッシュするようになってしまいました。ログを見ると原因としては恐らくDataTable内に書かれたバイナリをエディタ上で見ることでクラッシュしてそうです（ログを添付）。どう思いますか？

出力

原因としては合っていそう

バイナリを別データファイルにするかどうかの提案

指示内容２

バイナリデータをDataTable内ではなく、別ファイルとして保存するように変更し、そのリンクを持つようにして。保存先はSaved/にフォルダを作ってその中に。ファイル名はCut名とActorIDNameから命名するように。

出力

BinaryDataFileを.bin形式で保存するような機能の追加

バイナリパスをDataTableに保存するように変更

動作確認

バイナリデータが分離されていることを確認

DataTableが開けるようになっていることを確認

DataTableにアクターのComponentの親子情報が保存されていないことを発見、DeserializeをするとComponentが全て並列になる

BP_Person

├── SkeletalMesh
└── TextRender

指示内容３

「ActorのComponentの親子関係が保存されておらず並列になってしまっているのでAttachment情報を保存して」

出力

Attachmentを追加するために構造体を追加

動作確認

BP_Person

└── SkeletalMesh
　└── TextRender

のようにAttachment情報が付与されてDeserialize出来ることを確認

コミット履歴
✅ バイナリは別ファイルとして保存するように

変更内容:

- FActorSerializedActorDataにBinaryDataFilePathを追加
- FActorSerializedComponentData構造体を追加（アタッチメント情報含む）
- バイナリデータをSaved/ActorSerialization/{Map}_{ActorIDName}.binとして保存
- バイナリファイルパスを自動生成

Phase4: パスの相対化
Phase5: カスタムEnum対応
Phase6: JSONフォーマット修正
Phase7: 複雑なプロパティ対応
Phase8: Actor追跡とコンポーネント復元
Phase9: バッチ処理とUndo対応
Phase10: DataAsset移行

書き出すの大変すぎて途中で諦めた

所感

このPlugin作るのにコードを9割以上は書いてもらいました、すごい！

UE5.5で使えない関数を呼ぶことがほぼなくてストレスフリーでした
Engineの内容をコンテキストとして含めてるんですかね？

最後に

UEでAIコーディングを使っての開発手法が詳しく書かれている記事が
あまり見当たらなかったので書いてみました
みんなはどんな風に使ってるのかな～

概要
現在の開発環境の構成
基本の開発方法
UE × Rider × ClaudeCode を使う上でのTips
実例
- 今回実装した機能
- 所感
最後に

2024-06-02

【UnrealEngine / UE5】新しいPCで既存プロジェクト（要ビルド）を開くまでのメモ（Mac版も対応）

新しいPCにセットアップする時に毎度詰まってるのでメモ！

Windows版

EpicGameLauncherを入れる

https://store.epicgames.com/ja/download

エンジンをインストールする

EpicGameLauncherを一度終了しもう一度開く（.uprojectを関連付ける）

VisualStudioをインストールする

Optionとして必ず以下を含める（ビルドに必要）

C++ プロファイリングツール
C++ AddressSanitizer
Windows 10 SDK (10.0.18362 以降)
Unreal Engine インストーラー

バージョンはPC間で合わせて入れてる
公式の対応バージョンは以下
Unreal Engine で C++ プロジェクトの Visual Studio 開発環境をセットアップする | Unreal Engine 5.4 ドキュメンテーション | Epic Developer Community

.uprojectから「Generate Visual Studio project files」を行う

（任意）Riderをインストールする

VisualStudio（or Rider）で.slnファイルを開く

Project 'UE5' load failed / Project '[Project名]' load failed って出る場合
Explorerで [Project]/Intermediate/ProjectFiles を確認
UE5.vcxprojと[Project名].vcxprojが恐らくない

.uprojectから「Generate Visual Studio project files」を行う
生成できたら.slnを開き直す

生成できなかったらVisualStudioのOptionを入れ忘れてる
インストーラーをもう一度実行し以下を選択する

終わったらも一度.uprojectから「Generate Visual Studio project files」を行う
これで出来なかったらわからん...

ビルドして終わったら開く