コーディングエージェントでゲームをプレイテスト
エディタで開いているゲームに対して、挙動の検証や目標達成、バグの探索をClaude CodeやCodexに依頼できます。エージェントがC#ハーネスを記述し、Jevがゲームをプレイして、エージェントが測定された証拠とともに判定を報告します。
Windows 11、.NET 10 SDK、TypeSafeのAPIキー、およびソースコードからのビルドが必要です。
Verify that the player can fly with the jetpack from the start of the level, without picking anything up.
DENIED 110.8 秒、1 エピソード
From the start of MainScene with nothing picked up, the agent cannot fly with the jetpack: it is locked.
- t=0.2-6.2 s: 5 completed attempts … Best rise 206.2 cm against 203 cm computed for a plain jump (JumpForce 9, GravityDownForce 20).
- Control probe after a level restart, same input sequence: locked, rise 204.9 cm, fuel 1; after calling Jetpack.TryUnlock directly (research change, probe only), rise 1472 cm, fuel down to 0.
- Code: Jetpack.cs:84 requires IsJetpackUnlocked to fire; TryUnlock's only caller is JetpackPickup.cs:11.
動作の流れ
-
エディタでゲームを開く
Cluewrenプラグインを導入したUnity、Godot、またはUnreal Engineでプロジェクトを開きます。
-
エージェントに指示する
Claude CodeやCodexに対して、挙動の検証、目標の達成、またはゲームの探索を指示します。
-
プレイと報告
エージェントがコードを調査してC#ハーネスを作成します。Jevがゲームをプレイし、判定に必要な場合はエージェントが画面フレームを確認したうえで、測定された証拠とともに判定を報告します。
検証済みエンジン
| エンジン | 検証済みバージョン | 導入方法 |
|---|---|---|
| Unity | 6000.6.7f1（パッケージ定義は6000.0以降） | Git URLまたはディスクからUPMパッケージとして導入 |
| Godot | 4.7.2 | addons/にアドオンをコピーして有効化 |
| Unreal Engine | 5.8（Win64のみ） | C++プロジェクトではプラグインをビルド、BlueprintのみのプロジェクトではBuildPluginによるビルド済みパッケージを使用 |
データとプライバシー
ローカルマシンに残るデータ
- アカウントやテレメトリはなく、Cluewrenへのデータ送信はありません。
- 実行データはプロジェクト内に保存されます（harness.cs、トレースログ、report.json、notes.md）。
- ゲームプレイのフレーム画像はbrainプロセスのメモリ（最新160 MiB分）にのみ保持され、ディスクには書き出されず、終了時に破棄されます。
外部に送信されるデータ
- Jevへの意思決定リクエスト（ハーネスが算出したゲーム状態のテキストと選択肢）はapi.typesafe.aiに送信されます。
- コーディングエージェントが読み取った内容（ソースコードやframesツール経由のフレーム画像）は、エージェントのプロバイダに送信されます。Cluewrenはその送信内容を制御できません。
ハーネスのサンドボックス
Windows 11では、ハーネスはAppContainer内で実行されます。コンテナはネットワークアクセスを持たず、書き込みは実行フォルダのみに限定され、APIキーを保持しません。コンテナを作成できない場合、Cluewrenは環境変数にキーを持たない通常の子プロセスにフォールバックします。そのフォールバックプロセスはユーザーのファイルを読み取り、ネットワークにアクセスできる状態となり、実行ログにもその旨が記録されます。
クイックスタート
以下のコマンドでCluewrenをビルドし、お使いのエージェントに登録します。
git clone https://github.com/crane-valley/cluewren.git
cd cluewren
dotnet build -c Release利用するエージェントに合わせてconnect claudeまたはconnect codexを実行してください。
./src/Cluewren/bin/Release/net10.0/cluewren connect claude
./src/Cluewren/bin/Release/net10.0/cluewren connect codex