WindowsでAIにUnityを操作させて踏んだ落とし穴14個

Unity 6.6 と AI エージェントでゲームを1本作りました。作業自体は速いのですが、時間を溶かしたのはゲームの中身ではなく環境のほうでした。

気になるものから飛んでください。「痛い」は失った時間が大きかったものです。

コマンドの渡し方

Error: eval の引数が無効です: --timeout には Int32 が必要ですが、
UnityEditor); var m = … が指定されました。
eval が受け取る位置指定値は 2 個ですが、3 個が指定されました

$ unity command eval 'return UnityEngine.Application.unityVersion;'
6000.6.0f1

eval 'UnityEngine.Application.unityVersion'
→ Compilation Failed「; expected」

eval 'return UnityEngine.Application.unityVersion;'

テストと動作確認

$ unity command run_tests --mode PlayMode --async_tests true
{"result":"running","StatusPath":"Temp/pipeline_test_status.json"}

grep '"status":"completed"'

grep -E '"status":\s*"completed"'

"optionalUnityReferences": ["TestAssemblies"]

"overrideReferences": true,
"precompiledReferences": ["nunit.framework.dll"],
"defineConstraints": ["UNITY_INCLUDE_TESTS"]

詳しい再現条件はテストが「0件」で通る記事にまとめました。

ビルドとエディター

AI エージェント側

The 'gpt-5.6-sol' model requires a newer version of Codex.
Please upgrade to the latest app or CLI and try again.

おまけ：ポート 7800 は LAN から届くことがある

Unity の Pipeline は、AI から命令を受けるためのローカル HTTP API を持っています。実測すると、127.0.0.1 ではなく 0.0.0.0:7800 で待ち受けていました。

$ curl http://127.0.0.1:7800/health
{"error":"Unauthorized","errorDetails":"Missing or invalid authentication token"}

認証は効いていて、トークンなしはすべて 401 でした。この環境ではファイアウォールも受信を止めていました。ただしドメイン参加の PC や、許可ダイアログで Private を許可した場合は LAN から届く状態になります。 この口は任意の C# を実行できるので、共有のネットワークで作業する人は確認しておいたほうがいいと思います。

Unity 側の導入の手順と選択肢は、UnityをAIに触らせる5つの方法にまとめました。作ったゲームと、作業ごとの実測値はブロック崩しのページにあります。