こんにちは、hakairyuousinn です(Xアカウント)。
Claude Codeでゲームを作るとき、自分はこの順で進めています。
- 何を作るかを文書にする(ルール、操作、画面の流れ)
- 実装の指示書を書く(ファイルの役割と、終わりの条件)
- 実装する(自分はCodexに渡しています)
- 最後まで自動で遊ばせて、画面を撮って見る
- おかしな所を直しの指示書にして、もう一度確かめる
- 自分のサイトに出して、出てから見つかった不具合を直す
コードを書かせる前に、何を作るかと、どうなったら終わりかを文章にしておく。だいたいこれだけです。
狐とうそをつき合うサイコロのゲーム「Kitsune Den」は、10月27日の指示書から10月31日の公開まで、この順で作りました。
実装の指示書に書いたこと
指示書はClaudeが書きました。最初に、もう用意してあるものを並べています。背景、狐3人の立ち絵、声のファイル。それと、前に作った穴掘りゲーム「Dig It!」から写してきた、文字の切り替えと効果音の仕組み。
そのあとに、作るファイルの表と、1回の勝負の流れ。初めて遊ぶ人への案内の文も、指示書の時点で決めてあります。下の画面の「これがあなたの目。狐には見えません。」は、指示書の一文がほぼそのまま入ったものです。

指示書の最後には「終わりの条件」を置きます。Kitsune Den のときはこうでした。
- ビルドが型エラーなしで通る
- パソコンの横画面でもスマホの縦画面でも、タイトルから結果の画面、Xへの共有ボタンまで通して遊べる
- 狐の癖を見ないで遊ぶ人が、4人の中で勝つ率が20〜40%
- このゲームの説明書き(AGENTS.md)に、動かし方を書き足す
- 「変えたファイルと要点」を短く報告する
勝つ率は、画面を出さずに対局だけ回して測る仕組みを、同じ指示書で作らせました。あとで1,000回やらせたら36.2%で、1回の勝負は平均9.3回戦。癖を読めば、もっと上がるように作ってあります。
エラーが出なくても画面は見る
10月28日にCodexの実装が上がってきました。終わり際に「モデルが混雑中」で止まっていたんですが、コードもビルドも、Codexが自分で書いたテストも終わっていました。
次はClaudeの番です。タイトルから結果の画面まで自動で遊ばせて、場面ごとに撮らせました。横画面の日本語と、縦画面の英語の2通り。エラーは1つも出ません。でも撮った画面には、狐の尻尾の印が顔に重なっている所などがありました。直す所は6つ。直しの指示書にしてCodexに戻したら、同じ日のうちに直りました。直す前と後の画面は「Claude CodeとCodexの違い」の記事に載せています。
地味に困ったのは、アプリの中のブラウザを裏に回すと、ゲームが1秒に1コマまで落ちること。画面は別のブラウザ(Playwright)で撮るようにしました。仕様を知らないAIに初見で遊ばせる話は「AIに自作ゲームを初見プレイさせたら、1回目は飢え死にでした」にあります。
公開した日と、そのあとの直し
10月31日に、このサイトのゲーム置き場に出しました。出すのと同じ日に直したのが、スマホだと最初に画面をタップするまで起動が止まる不具合です。狐の声を起動のときに全部読み込んでいたのをやめて、タイトルや対局の画面の裏で読むように変えました。
そのあと、11月4日に英語、11月5日に韓国語でも遊べるようにしています。言語の切り替えは、ほかのゲームと同じ仕組みにそろえました。
▶ Kitsune Den を遊ぶ(ルールとコツはこちら)