Claude Code Game Studios でクロスワードパズルを作ってみた — /prototype の質問から完成・修正まで

目次
広告
注意事項
- 本記事の内容は試験的な実装であり、アイデアベースの検証です
- 実務での利用を保証するものではありません
- 実装についての責任は負いかねます。自己責任でご利用ください
- AIの出力結果は常に検証が必要です
- 雛形にはフック(自動で動くスクリプト)が含まれます。複製したら、使う前に
.claude/の中身を読んでください
はじめに
ゲーム開発に効く Claude の Skills まとめ で紹介した Claude-Code-Game-Studios を、実際に使ってみました。
作ったのは、IT用語をひらがなで解く日本語のクロスワードパズルです。

結果を先にまとめます。
| 項目 | 結果 |
|---|---|
| 人がしたこと | ゲームのアイデアを1文で伝え、7つの質問に答え、企画書に「このまま作る」と返した |
| ビルドにかかった時間 | 約14分(企画書の承認から完成の報告まで) |
| できたもの | 9×9 の盤、15語、ローマ字・IME・50音キーの3通りの入力、答え合わせ、ヒント、評価 |
| 自分で遊んで見つけた不具合 | 1件(説明ポップアップの文字の重なり)。頼んで約1分で直った |
| 費用 | Claude Code が表示した API 換算の費用で約4.7ドル(契約しているプランによって違います) |
記事中の出力は、すべて2026年11月21日に実際に動かしたときのものです。Claude-Code-Game-Studios は v1.3.0、Claude Code は 2.1.330 を使いました。
1. 準備する
Claude-Code-Game-Studios は、インストールするものではなく、プロジェクトの雛形です。リポジトリを複製して、その中で Claude Code を起動します。
git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git crossword
cd crossword
# 自動で動く設定とフックを先に読んでおく
cat .claude/settings.json
ls .claude/hooks/
claude
必要なものは Git、Python 3、Bash、Chrome(または Edge・Chromium)です。Chrome は、作ったゲームを自動で遊んでスクリーンショットを撮るのに使われます。
ポイント: Claude Code は、必ず
CLAUDE.mdとproject.yamlがあるフォルダで起動してください。src/などの下のフォルダで起動すると、フックや「書き込む前に確認する」の設定が読み込まれません。
2. /prototype でアイデアを伝える
起動したら、/prototype に続けて作りたいゲームを1文で書きます。
/prototype ひらがなで解く日本語のクロスワードパズル。テーマはプログラミング・IT用語。マスをクリックして文字を入力し、縦と横のカギを見ながら解く
すると、リポジトリに入っているジャンルの資料(.claude/genres/)から「word-game(言葉のゲーム)」が選ばれ、7つの質問が返ってきました。それぞれに「(標準)」の案が付いていて、「おまかせ」と答えれば標準の案で進みます。
| # | 質問 | 標準の案 | ほかの案 |
|---|---|---|---|
| 1 | 盤の大きさと問題の数 | 9×9 を1問、12〜16語 | 7×7 を3問、だんだん難しく |
| 2 | 遊んだ感触 | 解けた言葉の説明が出る「学びのある解き心地」 | 説明なしで解くことに集中 |
| 3 | 見た目 | 新聞のような紙と墨の盤 | エディタ風のダークテーマ |
| 4 | 難しさと手助け | 答え合わせと1文字ヒント。ヒントを使うと評価が下がる | 手助けなし |
| 5 | ゴール | 全部正解でクリア。時間とヒントの数を表示 | — |
| 6 | 入力のしかた | IME でひらがなを打つ | 画面に50音ボタン(スマホ向け)、両方 |
| 7 | 遊べる版か、仕組みの試しか | 最初から最後まで遊べる版 | 入力の仕組みだけ試す版 |
日本語の IME をどう扱うか(質問6)まで聞かれたのが印象的でした。技術ブログなので、見た目は「エディタ風」、入力は「両方」を選び、残りは標準にしました。
1は標準、2は標準、3は(b)エディタ風のダークテーマ、4は標準、5は標準、6は両方付けてください、7は標準で。
3. 企画書(ブリーフ)を確認する
答えると、1ページの企画書が返ってきます。この時点では、まだファイルは1つも書かれていません。「このまま作る」と答えることが、作り始めてよいという許可になる仕組みです。
企画書の主な中身はこうでした(抜粋)。
# Game Brief: こーどくろす(Code Cross)
**Pitch:** コードエディタの画面で、「へんすう」「こんぱいら」などの IT 用語を
ひらがなで埋めていく、学びのあるクロスワード。
## First minute
エディタ画面が開き、カーソルは「よこ 1」の先頭のマスで点滅している。
(中略)最後の文字を入れると単語の色が変わり、
「へんすう(変数):値を保存して名前で呼び出すもの」というポップアップが出る。
## Out of scope
- もっと多くの問題とテーマ別の単語リスト → grow it
- 盤を自動で作る仕組み → add it as a feature
- 毎日の問題とスコアの共有 → needs a server: not built yet
いいと思った点は3つです。
- 最初に入力した1文が「In your words」としてそのまま残り、書き換えられない
- 「最初の1分で何が起きるか」が具体的に書かれていて、完成のイメージを合わせやすい
- 推測で決めた項目に (guessed) と付いていて、どこを確認すればよいかがわかる
内容に問題がなかったので、「1. このまま作る」と答えました。
4. ビルド(約14分、人は待つだけ)
ここからは、Claude Code が1人で作業します。ログから、実際にしていたことを拾ってみます。
- 盤を作る小さなツールを書いた: 12語以上が交差する盤を手で並べるのは大変なので、
tools/grid-gen.jsを書き、乱数の種を3つ試して、いちばん良い盤(15語、交差16か所)を選んだ - ゲーム本体を書いた:
index.html(約880行)、問題データのpuzzle.js、調整できる数値をまとめたconfig.js - 読み直して自分で直した: ローマ字の変換、カギの当たり判定、画面の重なりなど
- ヘッドレスの Chrome で動かして確かめた: 起動してエラーが出ないか、キー操作に反応するか、文字がはみ出していないかを確認し、スクリーンショットを撮った
- 見た目を1回直した: 空きマスと黒マスの色の差が小さかったので、明るさの差を広げた
- 企画書の項目と照らし合わせた: 15項目すべてを「できた」と判定した
最後に、次のような「引き渡しカード」が出ました(抜粋)。
Open: prototypes/code-cross/index.html
Small check: passed boots, shot, brief words, outlines
Brief checklist: 15 of 15 pass
Fixed: 空きマスと黒マスの色の差が小さかったので、明暗をはっきりさせた
Guessed: 盤の言葉は全部で 15 語(りふぁくたりんぐ・あるごりずむ・いんすとーる など)で、
ブリーフの例に挙げた ばぐ・ふぁいる・こんぱいら は盤に入っていない / …
Built in 13 minutes
Not yet played by a person.
「Not yet played by a person.(まだ人が遊んでいません)」 で終わるのが、このツールらしいところです。自動の確認は通っていても、「遊んで楽しいか」「本当に解けるか」は人が確かめる、という考え方です。
企画書で例に挙げた「ばぐ」「こんぱいら」が盤に入らなかったことも、隠さずに「Guessed(推測で決めたこと)」に書かれていました。
そのあと「コミットしてタグを付けますか?」と聞かれたので、お願いしました。one-shot/code-cross というタグが付き、あとで変更しても、いつでもこの状態に戻せます。
5. 自分で遊んで確かめる
カードに従って、実際に遊びました。
盤のデータを確かめる
まず、問題が正しく作られているかを Node.js で確かめました。交差するマスの文字が食い違っていないか、言葉として登録されていない文字の並びがないかを調べます。
// puzzle.js の盤を 9×9 に並べて、食い違いがないか調べる
global.window = {};
require("./puzzle.js");
const P = window.PUZZLE;
const g = [...Array(9)].map(() => Array(9).fill(null));
let bad = 0;
for (const w of P.words) {
[...w.answer].forEach((ch, i) => {
const r = w.r + (w.d ? i : 0), c = w.c + (w.d ? 0 : i);
if (g[r][c] && g[r][c] !== ch) bad++; // 交差するマスで文字が違う
g[r][c] = ch;
});
}
console.log(g.map(row => row.map(x => x || "■").join("")).join("\n"));
console.log("problems:", bad);
へんすう■■■■い
ん■■■■あいこん
かーそる■■■■す
ん■ー■■ぱけっと
■しすてむ■■■ー
■ぇ■■■■もでる
あるごりずむ■ば■
ぷ■■ん■■■っ■
りふぁくたりんぐ■
problems: 0
15語すべてが正しく交差していました(答えが見えてしまうので、自分で解きたい人は読み飛ばしてください)。
解いてみる
index.html をブラウザで開き、カギをクリックして答えを入力していきます。言葉が埋まると色が変わり、ドキュメントのポップアップ風に用語の説明が出ます。

入力は3通り試しました。
- IME オフのローマ字:
hennsuuと打つと「へんすう」になる。企画書になかった機能ですが、「IME オフでも入るようにした」とカードの Guessed に書かれていました - 画面の50音キー: 「つ」→「小」で「っ」、「く」→「゛」で「ぐ」のように、直前の文字を変えるボタンが付いている
- IME(日本語入力): 確定した文字が1マスずつ入る
全部埋めると、ターミナル風の結果画面が出ます。ヒントなしで評価 S でした。

遊んでわかった注意点
最初、たての言葉を頭から全部入力したら、盤が1マスずれてしまいました。
原因は不具合ではなく仕様でした。カギを選ぶと、カーソルは最初の空きマスに移動します。よこの言葉で埋まっているマスは飛ばされるので、たての言葉は「残りのマスの分だけ」打てば正しく入ります。新聞のクロスワードアプリと同じ動きですが、操作説明には書かれていないので、遊ぶ人によっては戸惑うかもしれません。
6. 見つけた不具合を、頼んで直す
遊んでいて、1つ見た目の不具合を見つけました。いちばん長い言葉「りふぁくたりんぐ」の説明ポップアップで、カタカナの「リファクタリング」と「(refactoring)」が重なっていました。

そこで、遊んだ感想といっしょに、直してほしいところを伝えました。
遊びました。全部解けて、ヒントなしで評価Sでした。IME オフのローマ字入力も、
50音キーの濁点・小文字ボタンも問題なく使えました。1つだけ直してほしいです:
「りふぁくたりんぐ」を解いたときの説明ポップアップで、「リファクタリング」と
「(refactoring)」の文字が重なって読めません。長い言葉でも重ならないようにしてください。
約1分で、次の返事が来ました(要約)。
- 原因: 太字の言葉の幅を、太字ではない文字の幅で測っていた
- 直し方: 幅を正しく測り、1行に収まらないときだけ英語名を2行目に回す
- 確認の範囲: 確認用の画面で撮ったが、「実際に解いて出したポップアップは撮れていないので、次に遊ぶときに見てください」
ここでも、確かめていないことを正直に書いてくれます。実際に解いて確かめると、重なりは直っていました。

もう1つおもしろかったのは、感想の中で「問題なく使えた」と書いたローマ字入力と50音キーが、企画書の「Keep(変えずに残すもの)」に自動で追加されたことです。今後の変更でこの2つを壊さないように、という記録になります。
「受け入れる」と答えると、iteration 1 としてコミットされました。
できたファイル
最終的に、リポジトリには次のファイルができました。
design/game-brief.md # 企画書(遊んだ感想と Keep も追記される)
prototypes/code-cross/
├── index.html # ゲーム本体(ダブルクリックで開ける)
├── puzzle.js # 盤・カギ・用語の説明
├── config.js # 評価の基準や表示時間など、調整できる数値
├── brief.md # 企画書の写し
├── tools/grid-gen.js # 盤を作るためのツール(ゲームでは使わない)
├── assets/provenance.yaml # 素材の出どころの記録
└── evidence/ # 自動確認の結果とスクリーンショット
config.js には、評価の基準(ヒント何回までなら A か、など)やポップアップの表示時間が、最小値・最大値つきでまとまっています。「let me tune it(調整したい)」と頼むと、これらをスライダーで動かせる画面が付くそうです。
// config.js(抜粋)
window.CONFIG = {
hint_cost: { value: 1, min: 0, max: 3, step: 0.5 }, // ヒント1回の減点
rank_a_max: { value: 2, min: 0, max: 6, step: 0.5 }, // この点数以下なら A
popup_seconds: { value: 7, min: 2, max: 20, step: 0.5 }, // 説明ポップアップの表示秒数
};
かかった時間と費用
| 手順 | 時間 | 人がしたこと |
|---|---|---|
| アイデアを伝える → 質問が出る | 約30秒 | 1文を入力 |
| 質問に答える → 企画書が出る | 約30秒 | 7つの質問に回答 |
| 企画書を承認 → 完成 | 約14分 | 待つだけ |
| 遊んで確かめる | 数分 | 遊ぶ |
| 不具合を伝える → 修正 | 約1分 | 1件を説明 |
費用は、Claude Code が表示した API 換算の値で、全部で約4.7ドルでした。ほとんどがビルドの14分の分です。サブスクリプションのプランで使う場合は、利用量の上限に対して消費されます。
使ってみてわかったこと
よかった点
- 質問の段階で、日本語の IME をどう扱うかまで考えてくれた
- 企画書・コミット・変更のたびに確認があり、勝手に話が進まない
- 推測で決めたこと、確かめていないことを、毎回はっきり書いてくれる
- 遊んだ感想が企画書に記録され、次の変更の基準になる
気をつけたい点
- 「Brief checklist: 15 of 15 pass」でも、文字の重なりは残っていた。最後は必ず自分で遊んで確かめる必要がある
- カギを選んだときにカーソルが最初の空きマスへ移るなど、操作の細かい決まりは遊んでみないとわからない
- 雛形にはフックやスクリプトがたくさん入っているので、ほかのプロジェクトとは混ぜず、新しいフォルダで使うのがおすすめ
次の一歩
引き渡しカードには、この先の進め方も書かれていました。
- もっと多くの問題を入れる → 「grow it(育てる)」で、Vite と TypeScript のプロジェクトに作り直してから1機能ずつ足す
- 盤を自動で作る → 育てたあとの機能として追加する
- 毎日の問題とスコアの共有 → サーバーが必要なので、まだ作れない
試作で終わらせるか、育てるかを選べるので、まずは気軽に1本作ってみるのがよさそうです。
関連記事
参考リンク
広告