メインコンテンツへスキップ

Claude Code でゲームエンジン開発を回す環境|Godot・Unreal Engine の失敗記録 153 件、82% は終了コードもテストも失敗を示さなかった【2026年11月】

並列に回した Godot の計測スクリプト 40 本は、終了コードがすべて 0 で合格と出ました。ログには、集計の関数が毎回止まったエラーが出ていました。Claude Code に Godot と Unreal Engine の開発を任せた編集部の失敗記録 153 件を読み直すと、125 件(82%)は終了コードもテストの合否も失敗を示さず、処理も止まっていませんでした。Unity のエディ...

編集部では 2026年6月から、Claude Code(Anthropic の、コードを書いて実行までする AI エージェント)に、ゲームエンジンでの開発を任せてきました。Godot の4本と Unreal Engine の2本は、画面の無い Linux サーバーでビルド・テスト・キャプチャまで回しています。Unity の1本は、Windows で開いたエディタを外から操作しました。最初に、終了コードだけで合否を決めていた時に起きたことを示します(図1)。

図1:並列に回した計測 40 本は、終了コードがすべて 0 で合格と出た。ログには、集計の関数が毎回止まったエラーが出ていた

Godot の計測スクリプトを、ヘッドレスで 40 本並列に回した

並列実行のスクリプトが見た結果40 本とも合格

終了コードはすべて 0。スクリプトは終了コードだけで合否を決めていた。

ログの中身毎回、エラーで止まっていた

SCRIPT ERROR: Invalid call. Nonexistent 'String' constructor. 新しく追加した集計の関数が毎回ここで抜け、数えるはずの値は 0 のまま残っていた。

2026年10月、編集部の開発記録から。関数の中で、Godot 4 には無いコンストラクタ(整数から String を作る)を呼んでいた。関数が途中で抜けても、プロセスは最後まで走って終了コード 0 で終わる。「挑戦が 0 回なのに、撃破数は 0 より大きい」という食い違いで気づいた。

Claude Code は、こうした失敗のたびに、起きたこと・原因・避け方を1件1ファイルで記録しています。すぐに直せた誤りは記録しないため、残っているのは時間を取られた失敗です。Godot と Unreal Engine の開発で残った153件を1件ずつ読み直すと、125件(82%)は、終了コードもテストの合否も失敗を示さず、処理も止まっていませんでした。エンジンの API の使い方の誤りでも、24件中20件です。

AI に任せる範囲を広げるには、コードを書かせる前に、エンジンをヘッドレスで回すスクリプトと、終了コード以外で合否を決める検査を用意することを勧めます。 要点は次のとおりです。根拠は後の節にあります。

  • 合否は終了コードだけで決めない:Godot は、スクリプトエラーが出ても、C# のアセンブリを作らないエクスポートでも、終了コード 0 で終わりました。
  • キャプチャは出荷と同じレンダラーで:テスト用の Compatibility で 0.5 前後に写るキャラクターが、出荷用の Forward+ では 0.73 の明るさに写りました。
  • 待ち時間を、速さの変わる回数で数えない:Unreal Engine のキャプチャのスクリプトは、エディタの更新回数で待っていたため、4分かかったシェーダーのコンパイルの間に待ちを使い切り、1枚もキャプチャせずにエディタを閉じました。
  • 無人で回す前に、エンジンの既定の送信を止める:スクリプトから起動した Unreal Editor は、クラッシュレポートを確認のダイアログなしで Epic へ送っていました。
  • 自動プレイで負けたら、ボットの欠陥から疑う:全滅の原因は、ボットが回避するタイミングでした。

実測表:Godot の4本では、commit の81%が Claude Code との共同だった

表1:Godot の 4 本では、commit の 81% が Claude Code との共同だった

エンジンバージョン期間commit
Godot(4 本)4.4〜4.7(1 本は C#)2026年6月〜7,878(うち共同 6,358、81%)
Unreal Engine(2 本)5.8.42026年11月〜66(うち共同 63、95%)
Unity(1 本)6(6000.0。2018 から移行)2026年6月の約 1 週間数えていない(git で管理していない)
2026-11-18 時点。commit は全ブランチから重複を除いて数え、本文に「Co-Authored-By: Claude」を含むものを共同とした。共同の数は Claude Code が関わった印で、どちらが何行書いたかは表さない。AI の操作方法は表2。Unreal Engine の 1 本は、ブラウザの 3D の試作と同じリポジトリにあり、Unreal Engine のフォルダだけを数えた。

Godot の4本は、2026年6月から11月までの5か月で7,878 commit になり、そのうち6,358が Claude Code との共同の commit です(表1)。Unreal Engine は11月に始めた2本で66 commit です。Unity では6月の約1週間で、VR の訓練教材を Unity 2018 から Unity 6 へ移行し、訓練の採点機能を追加しました。

作業量は Godot に大きく偏っています。このあとの失敗の件数も Godot が139件、Unreal Engine が14件です。作業量が違うため、この件数からエンジンの難しさは比べられません。

失敗記録153件のうち125件は、終了コードもテストも失敗を示さなかった

図2:失敗記録 153 件のうち 125 件(82%)は、終了コードもテストの合否も失敗を示さず、処理も止まらなかった。エンジンの API の使い方の誤りでも 24 件中 20 件

01020304050どれも失敗を示さなかった終了コード・テスト・停止で分かった対象外(設計の記録)作る物の中身(マップ・見た目・ゲームデザイン)作る物の中身(マップ・見た目・ゲームデザイン):どれも失敗を示さなかった 42件(48件中)作る物の中身(マップ・見た目・ゲームデザイン):終了コード・テスト・停止で分かった 6件(48件中)42/48検証の方法(計測・テスト結果の読み違い)検証の方法(計測・テスト結果の読み違い):どれも失敗を示さなかった 27件(31件中)検証の方法(計測・テスト結果の読み違い):終了コード・テスト・停止で分かった 4件(31件中)27/31エンジンの API の使い方エンジンの API の使い方:どれも失敗を示さなかった 20件(24件中)エンジンの API の使い方:終了コード・テスト・停止で分かった 3件(24件中)エンジンの API の使い方:対象外(設計の記録) 1件(24件中)20/24共有サーバー(ディスク・プロセス・通信)共有サーバー(ディスク・プロセス・通信):どれも失敗を示さなかった 8件(17件中)共有サーバー(ディスク・プロセス・通信):終了コード・テスト・停止で分かった 9件(17件中)8/17アセットのインポートとエクスポートアセットのインポートとエクスポート:どれも失敗を示さなかった 9件(11件中)アセットのインポートとエクスポート:終了コード・テスト・停止で分かった 2件(11件中)9/11ヘッドレス描画ヘッドレス描画:どれも失敗を示さなかった 8件(10件中)ヘッドレス描画:終了コード・テスト・停止で分かった 2件(10件中)8/10ストアと配布ストアと配布:どれも失敗を示さなかった 6件(7件中)ストアと配布:終了コード・テスト・停止で分かった 1件(7件中)6/7待機の方法待機の方法:どれも失敗を示さなかった 3件(3件中)3/3終了コードとログ終了コードとログ:どれも失敗を示さなかった 2件(2件中)2/2
Godot と Unreal Engine の開発で、失敗のたびに Claude Code が 1 件 1 ファイルで書いた記録 153 件(Godot 139 件、Unreal Engine 14 件)。棒の右の数は「どれも失敗を示さなかった件数/その種類の件数」。ログにエラーや警告の行が出ていても、処理が止まらず合格と扱われた物は「示さなかった」に数えた。種類は AI が記録のタイトルと冒頭の約 450 字から付けた。失敗が分かったかは 2 人の AI の担当が記録の全文から別々に付け、食い違った 9 件などをこの記事をまとめた AI が原文で決めた。人による確認はしていない。

失敗記録を種類に分けると、エンジンの API の使い方の誤りは24件(16%)でした。多かったのは、作る物の中身(48件)と検証の方法(31件)、そして共有サーバーやヘッドレス描画など、エンジンを回す環境(合わせて50件)です(図2)。種類ごとの例は次のとおりです。

  • 作る物の中身(48件):マップの投影を少し変えると、道路の組と、町を通る川の側が入れ替わった。地形のくぼみで色を付ける計算が、丘の頂上の外側を谷と判定し、城の下に暗い輪が出た。ゲームデザインと見た目の問題で、どのエンジンでも起きます。
  • 検証の方法(31件):対局ログの「draw」を引き分けと読んだが、実際は「決着が付かなかった」の意味だった。描画の数が増えた原因を 3D のオブジェクトに探したが、画面上の名札の 2D 描画も数に入っていた。
  • エンジンの API の使い方(24件):GDScript の @rpc の行と関数の間に別の関数を差し込むと、注釈は差し込んだ関数に付き、元の関数は RPC でなくなる。横に並べた行の Label に、自動の折り返し・切り取り(clip)・省略記号・最大2行を同時に設定すると、長い名前の行だけ文字が1字も出なかった(原因は確かめていない)。
  • エンジンを回す環境(50件):共有サーバー(17件)、アセットのインポートとエクスポート(11件)、ヘッドレス描画(10件)、ストアと配布(7件)、待機の方法(3件)、終了コードとログ(2件)。

どの記録にも、失敗がその場で分かったかを付けました。基準は、終了コード、テストの合否、処理の停止(クラッシュ・ハング・タイムアウト)、操作した画面のエラー表示のどれかが、失敗が起きた時に失敗を示したかです。どれも示さなかったのは125件で、後でキャプチャを見たり数字を突き合わせたりして初めて気づいた失敗です。ログにエラーや警告の行が出ていても、処理が止まらず合格と扱われた物はこちらに数えました。図1もその1件です。どれかで分かったのは27件で、残る1件はツールの失敗ではない設計の記録でした。上の @rpc の注釈では、1台で回す試験が全部通り、差分を読み直して初めて気づきました。Label の設定でも、終了コードと例外と ERROR の行は0のままで、画面の検査も指摘を出しませんでした。終了コード・テスト・停止で分かった割合が一番高かったのは共有サーバー(17件中9件)で、ディスクが一杯になる、プロセスが戻らないといった、止まって分かる失敗です。

エラーが出る失敗はすぐ直せるため、記録に残りにくい面もあります。それでも、時間を取られた失敗の大半は、ツールの上では成功していました。編集部の見立てでは、AI は合格と出れば次の作業へ進むため、こうした失敗ほど気づくのが遅れます。

Godot と Unreal Engine は画面の無い Linux で回せた。Unity はエディタを外から操作した

表2:Godot と Unreal Engine は画面の無い Linux サーバーで回せた。Unity は、開いたエディタを外から操作した

段階Godot 4Unreal Engine 5.8Unity 6
ビルド--import、--export-releaseBuild.sh(UnrealBuildTool)uloop compile(ドキュメントの方法は -batchmode -executeMethod)
テスト自前のテストスクリプトを --headless --script で-ExecCmds="Automation RunTests ..."自前のテストを uloop execute-dynamic-code で(ドキュメントの方法は -runTests)
ヘッドレスでゲームを動かす--headless-game -nullrhiPlay モード(入力を強制し、物をスクリプトで動かす)
描画してキャプチャ仮想ディスプレイ(Xvfb)か、CPU の Vulkan 実装(lavapipe)-RenderOffScreen -graphicsadapter=<番号>uloop screenshot
シーンとアセットを作るテキストの .tscn を直接編集エディタの Python(-ExecutePythonScript)execute-dynamic-code でエディタを操作
動かしたマシン画面の無い Linux サーバー画面の無い Linux サーバーWindows の PC(エディタを開いたまま)
編集部が実際に使った方法。Linux サーバーは H200(データセンター向けの GPU)を載せた社内のもの。Unity の「ドキュメントの方法」は Unity 6.6 の公式マニュアルにある方法で、編集部はこのプロジェクトでは使っていない。Unity の -batchmode は、同じプロジェクトをエディタで開いている間は使えない(公式マニュアル)。

Godot は、1つの実行ファイルに、アセットのインポート(--import)、エクスポート(--export-release)、スクリプトの実行(--script)、ヘッドレス起動(--headless)がそろっています(Godot 4.7 の公式ドキュメント「Command line tutorial」)。シーンファイル(.tscn)はテキストで、公式ドキュメントも「人が読めて、バージョン管理で扱いやすい」と説明しています。AI はシーンをコードと同じように直接編集できます。編集部の Godot の作業は、主にこの形で回しました(表2)。

Unreal Engine は、ビルドを UnrealBuildTool、テストを Automation のテスト、ゲームの起動を -game -nullrhi(描画しない)で回しました。キャプチャは -RenderOffScreen(ウィンドウを出さずに描画)で、使う GPU の番号も指定します。アセット(.uasset)はバイナリでテキストとして読めないため、敵や設定のデータアセットは、エディタの Python スクリプトから作りました。スクリプトを直せばアセットを作り直せるので、AI が直すのはスクリプトです。

Unity では、Windows で開いたエディタを、uLoopMCP(エディタの中で動く操作用のツール。現在の名前は unity-cli-loop)の CLI で操作しました。再コンパイル(uloop compile)は、ドメインリロードの完了を待つ指定(--wait-for-domain-reload true)で回し、テストはエディタの中でコードを実行する機能(execute-dynamic-code)から自前のテスト14件を呼びました。公式の -batchmode は、同じプロジェクトをエディタで開いている間は使えません(Unity 6.6 の公式マニュアル)。エディタを開いたまま AI に操作させるか、閉じて無人で回すかは、最初に決める必要があります。

Unity のプロジェクトの CLAUDE.md(Claude Code が毎回読む指示ファイル)には、AI が踏んだ環境の罠が4つ残っています。

  • プロジェクトのパスに日本語があると、エディタの中でコードを実行する機能が、文字列の変換で失敗した。英数字だけのパスへ移した。
  • エディタの中で実行するコードは、リフレクション(型を名前で探す機能)を禁止されていた。テストの本体を通常のスクリプトの側に置き、そこから呼んだ。
  • ライトマップを GPU でベイクすると、GTX 1080 Ti でメモリ不足になりクラッシュした。CPU の低い設定でベイクした。
  • エディタがクラッシュすると、操作用ツールのサーバーも止まる。自動では再起動できず、人がエディタとサーバーを起動し直した。

AI エージェントをエディタにつなぐ MCP(Model Context Protocol)の公式の対応は、2026年11月時点でどちらも実験的な段階です。Unity は AI の機能を公開ベータとしています(2026年5月11日の公式ブログ)。Unreal Engine 5.8 では MCP プラグイン(Unreal MCP)がエンジンの Experimental のフォルダに入っており、2026年11月時点で表示される 5.9 の公式ドキュメントも「API とデータの形式はいつでも変わりうる」としています。

終了コード 0 でも、中身は失敗していることがある

図1の計測では、新しく追加した集計の関数が、Godot 4 には無いコンストラクタ(整数から String を作る)を呼んでいました。関数は毎回途中で抜けますが、プロセスは最後まで走り、終了コード 0 で終わります。並列実行のスクリプトは終了コードだけを見ていたので、40本すべてが合格と出ました。気づいたきっかけは「挑戦が0回なのに、撃破数は0より大きい」という数字の食い違いです。

エクスポートでも同じことが起きました。C# を使う Godot のプロジェクトでソリューションファイルが無いと、--export-release は警告を154行出し、C# のアセンブリを作らないまま終了コード 0 で終わります。最後の行は「completed with warnings」でした。

編集部では、ビルドとテストのスクリプトに次の3つを足しています。

  • ログの SCRIPT ERROR と ERROR の行を数え、0でなければ結果を使わない。
  • 生成されるはずの成果物(エクスポートなら C# のアセンブリのフォルダ)が無ければ止める。
  • タイムアウトを必ず付ける。逆の失敗もあるためです。読み込んだテストのスクリプトに構文エラーがあると、Godot は終了の命令に届かないまま動き続けました。

ヘッドレス描画は、出荷するレンダラーと同じ絵を出さない

Godot を --headless --script で動かすと、ゲームのウィンドウは64×64になります。レイアウトの検査を回すと、文字の高さが実際のウィンドウの33から66に測れ、ボタンが縦に重なるという誤った結果が出ました。今は検査スクリプトの最初でウィンドウを基準の大きさ(1280×720)にし、「はみ出した」と出たら仮想ディスプレイ(Xvfb)上の実際のウィンドウで測り直してから直します。

レンダラーの違いで、色の較正が狂いました。サーバーでキャプチャするテストは OpenGL の Compatibility で描き、プレイヤーの PC は Vulkan の Forward+ で描きます。2つは同じシェーダーから違う色を出します。色の値を0.5にしたキャラクターは、Compatibility では0.5前後に写り、Forward+ では0.73に写りました。影になった壁は、Compatibility の0.31が Forward+ では0.08まで暗くなりました。Compatibility で合わせた色が、出荷する版では合っていなかったことになります。CPU で動く Vulkan 実装(lavapipe)を使えば、GPU の無いサーバーでも Forward+ で描けます。影の面の明るさは、開発者の PC(GTX 1080 Ti)の0.18に対して、lavapipe は0.19、Compatibility は0.37でした。見た目に関わるテストは、出荷と同じレンダラーでも1本回しています。

Unreal Engine では、エディタの Python スクリプトで新しく作ったマップが、-game でキャプチャすると真っ黒に写りました。エンジン付属のマテリアル(BasicShapeMaterial)に入れた色も付きません。同じスクリプトでも、エンジンの既定のテンプレートから作ったマップは写りました。どちらもキャプチャした画面を見て初めて気づきました(真っ黒な方は、HUD 以外のピクセル値がすべて0でした)。

待ち時間を、速さの変わる回数で数えない

Unreal Editor でキャプチャするスクリプトは、エディタの画面更新のたびに呼ばれる関数の回数を数え、決めた回数になったらキャプチャしていました。重いマップを開くと、シェーダーのコンパイルに4分かかります。その間、エンジンのフレームは151で止まったまま、エディタの更新回数だけが進みました。スクリプトは待ちを使い切り、キャプチャを要求し、エディタを閉じました。キャプチャできた画像は0枚です。待ちは、エンジンが実際に描いたフレーム数(get_frame_count())の差で数えるように直しました。

Godot のマルチプレイのゲームでは、ホストが参加者の登録を120フレームだけ待っていました。60 fps なら2秒ですが、240 Hz のディスプレイなら0.5秒、フレームレートの上限が無いヘッドレスのホストではさらに短くなります。接続の負荷テストの115ルームのうち4ルームで、プレイヤー一覧には居るのにキャラクターが生成されない参加者が出ました。相手を待つ時は、秒数か「相手が接続している間」で待つように直しています。

秒数で待つ場合も、待ち時間は相手の動きの周期より長くします。CPU キャラクターが動くかを3.5秒だけ見るテストは、CPU キャラクターが1か所で最大4秒止まるため、6回に1回「動かない」と失敗しました。観察時間を9秒にすると、8回続けて合格しました。

無人で回すと、エンジンの既定の動作が外部と他の作業に届く

スクリプトから起動した Unreal Editor のログを読み返すと、Epic の使用状況データの送信先への送信の行が並んでいました。CPU の Vulkan 実装で2回クラッシュした時には、クラッシュレポート(プロジェクトのパス・サーバーのユーザー名・ログの一部を含む)が、確認のダイアログを出さずに送られていました。クラッシュしなかった時も、終了のたびに使用状況データ(テレメトリ)を送っています。エディタの既定の設定が、無人の起動ではクラッシュレポートと使用状況データを送るようになっているためです。人がダイアログで断る機会がありません。編集部では起動のたびに次の3つの引数を付け、ログに送信の行が0行であることを確認しています。

1
2
3
-ini:EditorSettings:[/Script/UnrealEd.CrashReportsPrivacySettings]:bSendUnattendedBugReports=False
-ini:EditorSettings:[/Script/UnrealEd.AnalyticsPrivacySettings]:bSendUsageData=False
-nocrashreports

3つ目の -nocrashreports は公式のコマンドライン引数の一覧には載っていません。3つを合わせて付けた状態で、送信の行が0行になることを確かめています。

Unreal MCP のプラグインも、使用状況データの送信が既定で有効でした(ModelContextProtocol.EnableAnalytics=0 で止まります)。待ち受けはローカル(127.0.0.1)だけですが、認証はありません。外部に公開しないように使っています。

Godot の録画機能(Movie Maker モード)では、共有のディスクを埋めました。8本を並列に録画したところ、3本が終了処理で止まったまま41GB・137GB・285GBに膨らみ、3.5TB の共有ディスクの空きが0になりました。同じ時間に書き込んでいた別の作業が失敗した可能性があります。今は録画と同時に、ファイルサイズの上限と空き容量の下限で止める監視プロセスを、同じサーバーの上で動かしています。手元の PC から監視すると、往復が遅くて間に合いません。

自動プレイで負けたら、ボットの欠陥から疑う

Unreal Engine で作っている4人協力アクションの試作で、4人ともボットに遊ばせ、難易度を測りました。1フロアだけの周回(通常の部屋5つを抜けて、最後にボス部屋)は、ボットの立ち位置を散らす変更を入れた後でも、4周中1回しかクリアできません。

そこで、被弾を1回ずつ記録するログの行を、1戦ごとに出すようにしました。被弾ごとに、回避が使える状態だったか、敵3体以上に囲まれていたか、ボスの攻撃かを残します。ボスの部屋で全滅した3回では、被弾は15・19・16回で、どれも回避のクールダウン(0.9秒)の最中でした。ボットは、敵の攻撃の予備動作が始まった瞬間に回避していました。回避の無敵時間は0.35秒、ボスの予備動作は0.7秒なので、無敵が切れてから被弾していたことになります。予備動作の残りが0.245秒を切ってから回避するように直すと、1フロアだけの周回は8周ともクリアしました(図3)。

図3:ボットの回避のタイミングを直すと、1 フロアだけの周回のクリアは 4 周中 1 回から 8 周中 8 回になった

0%50%100%1 フロアだけの周回・直す前1 フロアだけの周回・直す前:4 周中 1 回クリア1/41 フロアだけの周回・直した後1 フロアだけの周回・直した後:8 周中 8 回クリア8/8
4 人ともボットが遊ぶ協力アクションの試作。1 フロアは通常の部屋 5 つのあとにボス部屋。直す前はシード 7〜10 の 4 周(立ち位置を散らす変更を入れた後)、直した後はシード 7〜14 の 8 周。直す前のボットは、敵の攻撃の予備動作が始まった瞬間に回避し、無敵時間(0.35 秒)が切れてから被弾していた。

直したボットはどの予備動作も最後の瞬間に避けます。人はそうは遊ばないため、予備動作に反応する割合を下げられるようにし、割合ごとのクリアの回数で難易度を測りました。全部に反応しても、5フロア通しのクリアは3周中1回です。被弾の94%は敵3体以上に囲まれた時で、回避が使える状態での被弾は1%もありませんでした。回避の間隔より短い間隔で、別の敵の予備動作が続いていたためです。敵の数は減らさず、1人を同時に攻撃する敵を2体までに絞る制限を足すと、クリアは増えました(表3)。

表3:1 人を同時に攻撃する敵を 2 体までにすると、5 フロア通しのクリアは、全部に反応するボットで 3 周中 1 回から 3 回に増えた

予備動作に反応する割合制限なし1 人に 2 体まで囲まれての被弾の割合(制限なし)
100%3 周中 1 回3 周中 3 回94%
60%3 周中 0 回3 周中 1 回90%
30%3 周中 0 回3 周中 0 回83%
同じシード 7〜9 の 3 周ずつ。反応する割合は、ボットが敵の予備動作に回避で応じる割合で、人の腕の代わりに使った。囲まれての被弾は、敵 3 体以上が 600 uu(約 6 m)以内に居る時の被弾。この表はシード 7〜9 の 1 組で、10〜12 の組の結果は本文に書いた。どの差も 1〜2 周なので、傾向として読む。

別のシードの組(10〜12)でも、2体までの制限で反応60%は3周中1回、30%は3周中0回で、7〜9と同じ結果でした。1人に1体までにすると、60%と30%のどちらも3周中2回クリアしています。

ボットの欠陥はそのままゲームの難易度の数字に表れます。負けた理由を1戦ごとのログに出して数えてから直すと、ボットの欠陥とゲーム側の作りを分けられました。

Unity の VR 教材では、ヘッドセットを着けずに Play モードで動かしました。手に持つ道具をスクリプトで動かし、コントローラーのトリガー入力を強制して、実際の当たり判定から採点までを通します。操作の感触・見た目・面白さ・感覚に頼るしきい値は AI に完了とさせず、差分と結果を示して人が承認するルールにしていました。

AI に任せる前に入れた仕組みは5つ。どれも合否を終了コードだけで決めない

表4:AI に任せる前に入れた仕組みは 5 つ。どれも、合否を終了コードだけで決めない

段階合否の決め方きっかけになった失敗
ビルド終了コードに加え、ERROR 行の数と、生成されるはずの成果物の有無C# のアセンブリを作らないまま 0 で終わったエクスポート
テスト終了コードに加え、SCRIPT ERROR の行が 0 で、テストの数が想定どおり40 本が合格と出た計測
キャプチャ出荷と同じレンダラーでキャプチャし、ピクセル値を比べる。待機はエンジンが描いたフレーム数で数える色の較正のずれ、1 枚もキャプチャせずに閉じたスクリプト
自動プレイ1 戦ごとのログを出し、負けた理由を数えるボットの回避の欠陥を、難易度と読みかけた
共有サーバーディスクの上限で止める監視プロセス、外部への送信を止める起動引数、プロセスグループごとの停止共有ディスクを埋めた録画、Epic へ送られたクラッシュレポート
編集部の 3 つのエンジンの開発で、失敗のあとに足していったもの。毎回回す物から順に並べた。

最初に入れるなら、ビルドとテストのスクリプトに、ERROR 行の数と成果物の有無の検査を足すことです(表4)。数行で済み、毎回の作業で効きます。次に、出荷と同じレンダラーでキャプチャしてピクセル値を比べる検査、最後に1戦ごとのログを出す自動プレイの順に足しました。

失敗記録は、作業の前に AI が自分で検索します。セッションの始めに記録のタイトル一覧を読み込み、エラーが出た時や新しい作業の前に、キーワードで検索して該当する記録だけを開く形です。153件のうち24件は複数のプロジェクトで使う共通の記録として置いています。Unreal Editor の送信を止める3つの引数は、最初に踏んだ作業で書いた共通の記録から、Unreal Engine の2本のスクリプトが同じ物を使っています。

この記録の限界

  • 1つの編集部の記録です。表1の Godot の4本と Unreal Engine の2本に加え、Unreal Engine のアセット集とテンプレートの制作、Godot の別の試作1本で書いた記録を含みます。Godot が139件と大半を占め、Unreal Engine は14件です。Unity の失敗は CLAUDE.md の4項目だけで、図の件数には入れていません。
  • 記録は失敗に気づいて書いた物だけです。すぐ直した誤りと、気づかなかった失敗は入っていません。エラーが出る失敗はすぐ直せるため、記録しないまま直した物が多い可能性があります。この記事の割合は「時間を取られた失敗」の内訳として読んでください。
  • ラベルの確認と決定に、人は加わっていません。種類は AI の担当が記録の冒頭から付け、この記事をまとめた AI(Claude)が10件を全文と照らしました。種類の境目にある記録もあります。
  • 「その場で分かったか」は、2人の AI の担当が記録の全文から別々に付けました。2人の判定が一致したのは153件中144件です。食い違った9件と、2人の判定が前のラベルと違った15件は、この記事をまとめた AI が原文を読んで決めました(2人の一致を採らなかったのは2件)。決めた側は前のラベルを見ており、食い違った9件と採らなかった2件は、どれも前のラベルと同じ向きに決まりました。2人の担当の判定だけで数えると、示さなかったのは122件と123件で、どちらも80%です。1件に複数の失敗が書かれた記録は、最初に書かれた失敗で数えています。
  • 自動プレイの比較はどの条件も3周ずつです。シードの組は7〜9と10〜12の2つで、条件どうしの差は1〜2周です。1人に1体までのシード7〜9と、制限なしのシード10〜12は測っていません。傾向として読んでください。
  • Unity と Unreal Engine の MCP の公式の対応は実験的な段階で、この記事の内容は2026年11月時点のものです。
測定の条件

commit の数え方:各リポジトリの全ブランチの commit を重複なしで数え(git log --all)、本文に「Co-Authored-By: Claude」を含むものを Claude Code との共同とした。2026年11月18日までの commit。Unreal Engine の1本はブラウザの 3D(Three.js)の試作と同じリポジトリにあり、Unreal Engine のフォルダを変えた commit だけを数えた。Unity のプロジェクトは git で管理していない。

失敗記録:Claude Code が失敗のたびに書いた Markdown の記録。共通の置き場の記録と、各プロジェクトの置き場の記録を合わせて166件あり、ブラウザの 3D の試作の9件とストアの登録画面の4件を除いた153件を数えた。種類は次の9つ。作る物の中身、検証の方法(計測・テスト結果の読み違い)、エンジンの API の使い方、共有サーバー(ディスク・プロセス・通信)、アセットのインポートとエクスポート、ストアと配布、ヘッドレス描画、待機の方法、終了コードとログ。1件に1つを、AI(Claude)がタイトルと冒頭の約450字から付けた。この記事をまとめた AI(Claude)が無作為に10件を抜き出して全文と照らし、10件とも付いた種類を残した(1件は検証の方法と API の境目)。

その場で分かったか:基準は、終了コード(0以外)、テストの不合格、処理の停止(クラッシュ・ハング・タイムアウト)、操作した画面のエラー表示のどれかが、失敗が起きた時に失敗を示したか。その変更のために書いてすぐ回したテストの不合格は「示した」に、後の工程や後で書いた検査で見つかった物は「示さなかった」に数えた。ログのエラーや警告の行、通信の中のエラーだけで、処理が止まらず合格と扱われた物も「示さなかった」に数えた。1件に複数の失敗が書かれた記録は、最初に書かれた失敗で数えた。最初は AI の担当(Claude)が冒頭の約1,500字から付け、基準を1つに揃えて8件を直した。そのあと別の AI による独立の評価で、まだ基準に合わないラベルが見つかったため、全153件を付け直した。153件を77件と76件に分け、それぞれ2人の担当(Claude)が記録の全文を読んで別々に付けた(1人は後ろの記録から順に)。2人の判定が一致したのは144件。食い違った9件と、2人の判定が前のラベル(8件を直した後の物)と違った15件は、この記事をまとめた AI(Claude)が記録の原文を読んで決めた。人は加わっていない。前のラベルから13件が変わった(6件が「示した」へ、7件が「示さなかった」へ。後者のうち6件は、前に設計の記録として分けていた物)。ツールの失敗ではない設計の記録(1件)は分けた(シェーダーの重さの最適化の記録)。

自動プレイ:Unreal Engine 5.8.4、ゲームを描画なし(-game -nullrhi)で起動し、4人ともボット。回避の無敵時間0.35秒、回避のクールダウン0.9秒、ボスの予備動作0.7秒。「囲まれての被弾」は、敵3体以上が600 uu(約6 m)以内に居た時の被弾。5フロア通しはシード7〜9、1フロアだけの周回(通常の部屋5つとボス部屋)は直す前がシード7〜10、直した後がシード7〜14。同時攻撃の制限は、1人を狙う敵のうち直近1秒以内に予備動作を始めた敵が2体未満の時だけ、次の敵が予備動作を始める(ボスは除く)。

マシン:Godot と Unreal Engine は、H200(データセンター向けの GPU)を載せた社内の Linux サーバー。Unity は Windows の PC(GTX 1080 Ti)で、Unity 6000.0.77f1。

出典は次のとおりです(2026年11月19日に確認)。

よくある質問

Claude Code で扱いやすいゲームエンジンはどれですか。

同じゲームを3つのエンジンで作って比べてはいないため、優劣は測っていません。編集部の経験では、ビルドからテスト・キャプチャまで画面の無い Linux サーバーで回したのは Godot と Unreal Engine です。Unity はこのプロジェクトでは Linux での無人実行を試していません。Godot はシーンファイル(.tscn)がテキストで、AI が直接編集できます。Unreal Engine は C++ とエディタの Python で回せましたが、アセット(.uasset)はバイナリなので、エディタの Python スクリプトから作りました。Unity は Windows で開いたエディタを外から操作し、エディタがクラッシュした時は人が再起動しました。

MCP(Model Context Protocol)は必要ですか。

編集部は Godot では MCP を使わず、コマンドラインとテキストの編集で回しました。Unity では、エディタの中で動く uLoopMCP を、MCP の接続ではなく CLI から呼びました。Unreal Engine では、5.8 の実験的な MCP プラグインをヘッドレスで動かしました。公式の対応は、Unity が公開ベータ(2026年5月の公式ブログ)、Unreal Engine が Experimental で、どちらも仕様が変わる可能性があります。エディタを開いたまま AI に操作させるかどうかで、要否が分かれます。

AI が書いたコードの合否は、どう決めればよいですか。

終了コードだけで決めないことを勧めます。編集部の失敗記録 153 件のうち 125 件は、終了コードもテストの合否も失敗を示していませんでした。Godot では、スクリプトエラーが出ても、C# のアセンブリを作らないエクスポートでも、終了コード 0 で終わりました。ログの ERROR 行の数、生成されるはずの成果物の有無、出荷と同じレンダラーでキャプチャした画面のピクセル値、自動プレイの1戦ごとのログを合わせて判定しています。操作の感触や面白さのような主観の判断は AI に完了とさせず、人が承認します。

GPU の無いサーバーでも、ゲームの画面をキャプチャできますか。

Godot ではできました。CPU で動く Vulkan 実装(lavapipe)で出荷と同じ Forward+ レンダラーが動き、影の面の明るさは開発者の PC(GTX 1080 Ti)の 0.18 に対して 0.19 でした。ただし遅く、1920×1080 で1フレームに約 0.4 秒かかりました。Unreal Engine は GPU(H200)でキャプチャし、lavapipe では2回クラッシュしました。

社内のサーバーで無人で回す時に、注意することは何ですか。

エンジンの既定の動作が、外部と、同じサーバーの別の作業に届く点です。スクリプトから起動した Unreal Editor は、クラッシュレポート(プロジェクトのパス・サーバーのユーザー名・ログの一部を含む)と使用状況データを、確認のダイアログを出さずに Epic へ送っていました。起動引数で毎回止めています。共有のディスクでは、Godot の録画が終了処理で止まり、3本が 41GB・137GB・285GB に膨らんでディスクを埋めました。ファイルサイズの上限で止める監視プロセスを、録画と同時に動かしています。

関連する取り組み

このテーマのガイド 2件