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

Claude Code に外部の素材なしでゲームの見た目を作らせた|試験は全部通ったまま、画面を撮ると欠陥が 7 件見つかった【2026年11月】

編集部は 2026年11月19〜20日の 2 日間、Claude Code に、協力型のローグライクのゲームの見た目を箱と球から作り直させました。自動の試験は 18 本から 22 本に増え、どのビルドでも全部通りました。それでも、画面を撮って見ると欠陥が 7 件あり、どれも試験では拾えませんでした。同じ瞬間を何度でも撮り直せる仕組みと、撮影に一度も写らなかった宝箱の話を記録します。

編集部は 2026年11月19日から 20日の 2 日間で、協力型のローグライク(遊ぶたびに部屋の並びが変わり、倒れると最初からやり直すゲーム)の見た目を、箱と球だけの状態から作り直しました。エンジンは Unreal Engine 5.8 で、作業は Claude Code(Anthropic の、コードを書いて実行までする AI エージェント)に任せています。外部の素材は使っていません。模様や粒の絵はプログラムで描き、キャラクターだけはエンジンのテンプレートに入っている人形を使いました。

図1:箱と球だった元の版(左)が、暗い石の部屋と光と粒子のある版(右)になった

元の版と今の版を並べた画像。左は箱と球だけの画面、右は石の床と壁、松明の光、人形のキャラクターが入った画面
左が元の版、右が今の版。同じ乱数の種で、ゲームの 18 秒の時点を撮った。自動で遊ぶボットの動きは版ごとにずれるので、位置は一致していない。

自動の試験は最後まで全部通りましたが、見た目の欠陥 7 件は、どれも画面を撮って初めて見つかりました。 同じ瞬間を何度でも撮り直せる仕組みを先に作り、撮って・見て・直すを Claude Code に回させると、外部の素材なしで図1の右まで作り直せました。ただし、良し悪しの判断は Claude Code が画像を見て行ったもので、人は全部の画像を見直していません。キャラクターもテンプレートの人形のままです。要点は次のとおりです。根拠は後の節にあります。

  • 試験は 18 本から 22 本に増え、どのビルドでも失敗は 0 本だった。欠陥 7 件は、どれも撮影で見つけた。
  • 部品をつなぐ関数が失敗を返しても、スクリプトは止まらなかった。半透明の粒が黒い四角に写った原因は、これだった。
  • 宝箱は、撮影に一度も写っていなかった。自動で遊ぶボットが、宝箱の部屋に寄らなかったため。
  • 見本に寄せる光の値は、決め打ちせずに撮り比べて選んだ。光の値を起動オプションで変えられるようにして、ビルドし直さずに 4 通りを撮った。

前回の記事「Claude Code でゲームエンジン開発を回す環境」では、終了コード(プログラムが終わる時に返す番号。0 が成功)が 0 のまま中身が失敗していた例をまとめました。今回は、見た目の仕事で同じことが起きた記録です。

5 段で作り直し、試験は段 3 から段 5 まで全部通った

作り直しは 5 段に分けました(表1)。

表1:5 段で足した物

段 足した物
1 元の版。箱と球だけ
2 人形と暗い光と石の質感。キャラクターと敵を人形に替え、歩く・攻撃する・倒れるなどの動きを付けた。部屋ごとに松明 8 本と、主人公ごとに付いて回る光を置いた。石畳と石壁の模様は、Python の numpy(数値計算のライブラリ)で描いた
3 粒子(火花・煙・火の粉など、細かい粒の演出)。命中・倒した時・回避・松明に、閃光や火花や煙を組み合わせた。粒の絵は numpy で 5 枚描き、粒は自前の C++ の部品で動かした。エンジン標準の粒子の仕組みは使っていない
4 部屋の飾り。開くと床へ沈む鉄格子の扉、角の柱、欠けた石、開くと金の光が出る木の宝箱、焚き火、出口の石の輪。敵の攻撃範囲は半透明にして縁を光らせた
5 光と画面の文字。月明かりを主にして松明を暖色の点に下げ、階(ダンジョンの階層)ごとに月の色を変えた。画面の文字を、画面の高さに合わせて広げた

材質(物の表面の色や光り方を決める設定)は、エディタを操作する Python のスクリプトで組みました。

自動の試験は、ゲームの規則や計算(攻撃範囲の形、画面の文字の倍率、階ごとの光の色の選び方など)を確かめる物で、画面に何が写るかは見ません。段 3 のビルドで 18 本、その後 20 本・21 本・22 本と増え、どのビルドでも失敗は 0 本でした。

図2は、段 1〜4 を同じ乱数の種・同じゲームの時刻で撮り、2×2 に並べた画像です。

図2:段を重ねるごとに、暗い石の部屋へ近づいた

段 1 から 4 を同じ時刻で 2×2 に並べた画像。箱と球の版から、人形・光・石、粒子、部屋の飾りが順に加わっていく
同じ乱数の種・同じゲームの時刻で撮った。ボスの場面も同じように並べたが、自動で遊ぶボットの動きが版ごとにずれ、元の版だけ早くボスに着いた。

欠陥 7 件は、どれも画面を撮って見つけた

ここでは、作った物が狙いと違って写った物を欠陥と数えました。見本との差(色合いと画面の文字の大きさ)は、「見本に寄せる光の値は、決め打ちせずに撮り比べて選んだ」の節で別に書きます。7 件は次のとおりです。

  1. 半透明の粒(煙・命中の暗い縁)が、ぼかしのない黒い四角に写った。
  2. 松明の光の輪が見えなかった。
  3. 床の焦げ跡が、縁のくっきりした黒い円盤に写った。
  4. 出口の円盤が白く飛んだ。
  5. 焚き火が白く飛んだ。
  6. 宝箱が横を向いていた。
  7. 開けた宝箱の中が、真っ白な板に写った。

どれも終了コードは 0 のままで、試験も合格のままでした。見つけたのは、ゲームの時刻を指定して撮った静止画です。Claude Code が撮った画像を見て、おかしい所を言葉にし、直し、同じ時刻を撮り直して確かめています。

2 件目の松明では、エンジンのログ(動作の記録)に、光の輪を描く板(粒の絵を貼る四角い面)が 72 枚出ていました。板は出ていたのに、小さく薄すぎて見えなかった例です。輪の幅を 240 cm に広げ、細長い炎と大きい火の粉を足しました。3 件目の焦げ跡は、床に寝かせた煙の粒に替えました。残りの 5 件は、次の節から順に書きます。

半透明の粒が黒い四角に写った。部品をつなぐ関数は失敗を返したのに、スクリプトは止まらなかった

煙と、命中の暗い縁の粒が、ぼかしのない黒い四角に写りました(図3)。重なるほど明るくなる足し算の粒は丸く写っていたので、粒の絵は正しく、半透明の粒の材質に原因があると切り分けられました。

図3:半透明の粒が、ぼかしのない黒い四角に写った

煙と命中の暗い縁の粒を撮った比較。直す前は黒い四角に見え、直した後は縁のぼけた丸い煙になっている
左が直す前、右が直した後。同じゲームの時刻を撮り直して比べた。

原因は、材質を組む Python のスクリプトにありました。半透明の粒の材質には、DepthFade という部品を使っています。粒が床や壁と交わる所を薄くして、境目を目立たなくする部品です。粒の丸い形(中心が濃く、外ほど薄い模様)は、この部品の不透明度の入力につなぐはずでした。スクリプトはその入力を “InOpacity” という名前で指定していましたが、この名前ではつながりません。不透明度は既定の 1 のまま残り、四角い板の全体が濃く写りました。

部品どうしをつなぐ関数は、このとき False(失敗)を返しています。ところがスクリプトは戻り値を見ておらず、つながっていない材質をそのまま保存しました。Claude Code は、粒の形を不透明度に掛け算で入れる形に直し、あわせて、つなぐ関数が False を返したらスクリプトを止めるようにしました。失敗が関数の戻り値にだけ出ていた点で、前回の記事の節「終了コード 0 でも、中身は失敗していることがある」と同じ型です。

白く飛んだ光る物は 3 つ。原因はそれぞれ違った

出口の円盤・焚き火・開けた宝箱の中が、白く写りました(図4は宝箱の中)。

図4:開けた宝箱の中が真っ白な板に写った

開けた宝箱の中を撮った比較。直す前は中が真っ白な板に写り、直した後は暗い金の面に明るい金貨が散っている
左が直す前、右が直した後。直す前は、画素の値が上限の 255 に張り付いていた。

3 つの原因と直し方は次のとおりです。

  • 出口の円盤:光る強さの倍率が 3 で、強すぎた。0.8 に下げ、色も濃い青にした。
  • 焚き火:重なるほど明るくなる炎を 10 枚重ねていた。炎の色を橙にして強さを半分にし、周りの石と薪を暗くし、焚き火の明かりを高い位置から弱く当てる形にした。
  • 宝箱の中:光る面は、入れた色の 6 倍で光る作りだった。明るい金色をそのまま入れたので、画素の値が上限に張り付き、白い板になった。暗い金の面にして、明るい金貨を 9 枚散らした。

画面の画素の値は 0 から 255 で表し、255 より明るくはできません。見た目が白いだけでは、色の値が悪いのか倍率が悪いのかが分からないので、宝箱では画素の値を読み、上限への張り付きだと確かめました。

宝箱は横を向いていた。撮影には一度も写っていなかった

宝箱のモデルは、-Y の向きを正面として組んでありました。一方、ゲームのカメラは +X の向きを見ています。そのため宝箱は、錠の付いた正面をカメラに向けず、横を向いて写りました。-90° 回して直しています。

この欠陥が見つかるまでには、撮影の穴がありました。自動で遊ぶボットは宝箱の部屋に寄らないので、宝箱は撮影に一度も写っていませんでした。焚き火のある休憩の部屋を宝箱の部屋に替える起動オプション(ゲームを起動する時に付ける指定)を足して、初めて宝箱を撮りました。横向きも、中が白く写ることも、このとき分かっています。写っていない物は、試験でも撮影でも確かめられません。

見本に寄せる光の値は、決め打ちせずに撮り比べて選んだ

光の値は、松明・月・空の明るさを変えた 4 通りを撮り比べ、見本に一番近かった組(図5の C)を既定にしました。見本は、編集部が以前に作ったゲームの画面です。暗闇の中で部屋だけが青く照らされ、松明は小さなオレンジの点になっています。段 4 までの今回の版は、松明のオレンジが部屋全体に広がっていました。

光の値は、起動オプションで変えられる形にしてあります。ビルドし直さずに撮れるので、4 通りを撮り比べました(図5)。光の強さは、松明を cd(カンデラ。光源そのものの明るさ)、月を lux(ルクス。照らされた面の明るさ)で指定し、数字が大きいほど明るくなります。

図5:光の 4 通りを撮り比べ、C を既定にした

光の設定 A から D の 4 通りで撮って並べた画像。A は暖色が部屋全体に広がり、C は部屋が青く、松明が小さな点になっている
同じ乱数の種で、ゲームの 16 秒の時点を撮った。自動で遊ぶボットの動きは毎回少しずれる。A は松明 30 cd・月 0.8 lux(それまでの既定)、B は松明 12 cd・月 2.0 lux、C は松明 8 cd・月 3.0 lux・空の明るさ 0.2、D は松明 10 cd・月 1.6 lux・空の明るさ 0.5・露出(画面全体の明るさの補正)0.6。

焚き火(48 cd)と出口(88 cd)は松明の何倍かで明るさを決める作りなので、明るさが変わらないように倍率を直しています。

それでも、青が灰色に寄っていました。床の画素の平均で赤に対する青の比を測ると、見本は 1.64、C は 1.02 です。月の色を 3 通り撮り、赤・緑・青の割合を (0.3, 0.45, 1.0)、明るさを 3.6 lux にすると、比は 1.29 まで上がりました。石の模様の下地が暖色なので、光だけでは見本ほど青くなりません。見本では部屋の外が真っ黒な点も違い、差はまだ残っています。

階ごとの月の色は、5 色(青・青緑・紫・緑・薄い灰)にしました(図6)。色の明るさ(輝度。白を 1 とした明るさ)は約 0.45 にそろえ、赤は外しています。敵と攻撃範囲が赤いので、床まで赤いと見分けにくくなるためです。自動で遊ぶボットは 2 階まで進まないので、色を選ぶ起動オプションを足して 5 色を撮りました。

図6:階ごとの月の色は、輝度をそろえた 5 色にした

月の色を 5 通りにして撮った画像。青、青緑、紫、緑、薄い灰の月明かりで、明るさはほぼそろっている
起動オプションで月の色を選んで撮った。上の段の左から 1〜3 階、下の段が 4・5 階。2〜5 階は同じ場面で、1 階だけ敵と戦っている別の場面が写った。

画面の文字は、撮った静止画を測って小ささに気づきました。1080p の画面で、階の表示が約 14 画素、体力の数字が約 10 画素です。文字の位置と大きさを、画面の大きさに関係なく固定の画素で決めていたためです。720 画素の高さの画面として並べ、実際の画面の高さに合わせて広げる形にしたので、1080p では 1.5 倍になります。

任せる前に用意したのは、撮り直しを安くする 4 つの仕組みだった

撮って・見て・直すを回せたのは、撮り直しが安かったからです。編集部は次の 4 つを先に作っておきました。

  • ゲームの時間を 1/30 秒刻みに固定する(-benchmark -fps=30)。描画の速さに左右されず、ゲームの時刻で撮る瞬間を指定できる。
  • ゲームの時刻を指定して静止画を撮る。確かめたい瞬間だけを撮れる。
  • 効果音は鳴らした時刻をログに出し、後から組み直して動画に重ねる。音の付いた動画を、画面を出さずに作れる。
  • 光の値を起動オプションで変える。ビルドし直さずに撮り比べられる。図5と図6は、この仕組みで撮った。

撮影は社内の GPU サーバー(H200)で、画面を出さずに行いました。動画は 30 秒・1920×1080・900 コマです。

宝箱の件からは、撮る場所を先に決めておく必要も分かりました。自動で遊ぶボットが寄らない場所は、起動オプションでその場所を作り出して撮っています。見た目の仕事を AI エージェントに任せるなら、この 4 つの仕組みと撮る場所の一覧を、コードを書かせる前に用意することを勧めます。

この記録の限界

  • キャラクターと敵は、エンジンのテンプレートに入っている人形の色違いです。見た目で一番テンプレートらしさが残る所です。
  • 人が遊んで確かめてはいません。すべて、自動で遊ぶボットを撮った画像と動画です。
  • 良し悪しの判断は、Claude Code が撮った画像を見て行いました。人が全部の画像を見直してはいません。
  • 見本は静止画 2 枚だけで、こちらと同じ場面ではありません。赤に対する青の比は床の画素の平均で、見た目の近さそのものではありません。
  • 1 本のゲームの 2 日間の記録です。他のゲームや、もっと長い期間に当てはまるかは、確かめていません。

よくある質問

AI エージェントに、ゲームの見た目も作らせることはできますか。

今回は、外部の素材を使わずに、箱と球だけの画面から、石の部屋・光・粒子・部屋の飾りのある画面まで作り直せました。良し悪しの判断は、Claude Code が自分で撮った画像を見て行いました。人が遊んで確かめてはいません。キャラクターと敵はエンジンのテンプレートに入っている人形の色違いで、見た目で一番テンプレートらしさが残っています。

自動の試験があれば、見た目の欠陥は防げますか。

今回は防げませんでした。試験は 18 本から 22 本に増え、どのビルドでも失敗は 0 でしたが、画面を撮って見つけた欠陥は 7 件ありました。半透明の粒が黒い四角に写った時も、スクリプトの終了コードと試験は合格のままでした。試験はゲームの規則や計算を確かめる物で、画面に何が写るかは見ていません。

画面の撮影は、どんなサーバーで回しましたか。

社内の GPU サーバー(H200)で、画面を出さずに撮りました。ゲームの時間を 1/30 秒刻みに固定し、ゲームの時刻を指定して静止画を撮ります。動画は 30 秒・1920×1080・900 コマです。効果音は鳴らした時刻をログに出し、後から組み直して動画に重ねました。

撮影で一番見落としやすい点は何ですか。

どこを撮るかです。自動で遊ぶボットは宝箱の部屋に寄らないため、宝箱は撮影に一度も写っていませんでした。休憩の部屋を宝箱の部屋に替える起動オプションを足して初めて、宝箱が横を向いていることと、開けた中が真っ白に写ることが分かりました。

この記録は、他のゲームにも当てはまりますか。

分かりません。1 本のゲームの 2 日間の記録で、見本も静止画 2 枚だけです。数字は傾向として読んでください。ゲームエンジンでの失敗全般の記録は、前回の記事「Claude Code でゲームエンジン開発を回す環境」にまとめています。

関連する取り組み

このテーマのガイド 2件