エージェントとモデル

AI Game Dev アプリでは、どの AI モデルが回答するか、どれだけ深く考えるか、どのエージェントのペルソナがタスクに取り組むか、どのツールを使ってよいかを選べます。このページでは、モデルピッカー、プロバイダーと利用可否、エージェントとスキル、承認、プランモード、音声入力、そして自分のコンピューター上で動くローカルモデルについて説明します。

モデルとプロバイダー#

アプリでは、複数のプロバイダーが提供するホスト型チャットモデルを利用できます。Anthropic の Claude ファミリー、OpenAI の GPT ファミリー、DeepSeek、Google の Gemini です。正確な一覧はアプリに組み込まれているわけではなく、お使いのアカウント向けに ai-game.dev から取得されるため、常にプランと地域に合致します。新しいアカウントは、サーバーが割り当てたデフォルトモデルで開始します。

モデルを使えるかどうかを決める要素:

• プラン。 一部のモデルには特定のプラン（たとえば Studio 以上）が必要です。料金ページを参照してください。
• 地域。 利用可否は請求先住所の国によって決まります。モデルの利用可否ページを参照してください。
• 年齢。 一部のモデルでは、アカウントで 18 歳以上であることを確認済みである必要があります。

利用できないモデルも一覧に表示され、その名前の下に理由が表示されます。

デスクトップアプリでモデルを選ぶ#

1. チャットを開きます。コンポーザーの操作ボタンの行にあるモデルバッジに、現在のモデルが表示されています。
2. バッジをクリックするとモデル一覧が開きます。
3. モデルを選択します。利用できないモデルには、アップグレードのヒントや「お住まいの地域では利用できません」など、その理由が表示されます。一覧の下部には、利用可否の判定に使われている地域が表示されます。

対応しているモデルには 推論の強度 設定もあります。強度を上げると難しい設計やデバッグ作業に適し、下げると定型的な編集を素早く行えます。

各ペインはそれぞれのモデル、推論の強度、エージェントを保持します。実用的な構成は、1 つのペインに大きなモデルを置いて機能の計画と実装を任せ、2 つ目のペインには素早い質問用の高速なモデルを置くことです。Workspaceを参照してください。

CLI でモデルを選ぶ#

/model と入力するとモデルピッカーが開きます。矢印キーと Enter で選択し、Tab で推論の強度を切り替えます。起動時にモデルを指定することもできます:

gamedev --model <model-id>

指定したモデルがアカウントで利用できない場合、CLI はその旨を伝え、--model または /model で別のモデルを選ぶよう求めます。

エージェントとスキル#

モデルに加えて、セッションには エージェント があります。これは独自の指示を持つ役割で、たとえば特定の種類の作業の専門家などです。一覧には Claude agent SDK の組み込みエージェントに加え、プロジェクトの Claude 設定で定義されたエージェントや、Claude プラグインで追加されたエージェントが含まれます。

CLI では:

/agent                    list the agents and show the active one
/agent use <agent-id>     switch this session to an agent
/agent refresh            ask for the agent list again
/skills                   list the skills available in this project

デスクトップアプリでは、各ペインが独自のモデルと同様に独自のエージェントを保持します。

スキル、コマンド、エージェントは、Claude プラグイン（Settings、Claude Plugins、または CLI の /plugin）やパッケージで追加できます。Packagesを参照してください。

セッションのツール#

各セッションは、どのツールを携えるかを選べます。コンポーザーの上にある Tools row には、インストール済みパッケージ（Blender、Music、Knowledge Base、Image Gen、Video、Tripo、Cloud generation）のツールが並び、それぞれをこのセッションに限ってオン/オフできます。CLI では /config を開き、Tools セクションを使います。

どのツールもエージェントのコンテキストの一部を占めるため、そのタスクに必要なツールだけを持つセッションのほうが高速で、誤ったツールを選ぶ可能性も低くなります。変更はチャットを再起動せずに次のメッセージから適用されます。

承認と権限#

承認ポリシーに応じて、エージェントはツールを実行する前に確認を求めます。モードは 3 つあります:

プロジェクト外の追加フォルダーを信頼することもできます。そのようなパスに対する承認プロンプトでは、そのフォルダーを常に許可するよう選択できます。モードは Settings、Permissions、または CLI で変更します:

/permissions                     show the mode and trusted folders
/permissions always              ask every time
/permissions outside-project     ask only outside the project
/permissions never               never ask
/permissions trust <folder>      trust a folder and everything in it
/permissions untrust <folder>    stop trusting a folder
/permissions timeout on          auto-deny a request left unanswered for 5 minutes

変更は次のターンから適用されます。

プランモードと質問#

プランモードはコンポーザーにあるセッション単位のスイッチです。オンにすると、エージェントはファイルを読み、プロジェクト内を検索できますが、計画を提示してあなたが承認するまで、すべての変更は拒否されます。エージェントは確認のための質問もでき、作業中にフォローアップのメッセージをキューに入れることもできます。プランモードの記事では、機能を 1 つ作り上げる流れを順を追って説明しています。

音声入力#

プッシュトゥトークは両方のフロントエンドで使えます。チャット入力欄で Space キーを押したまま（デスクトップアプリではマイクボタンを使います）話し、離します。音声はローカルの Whisper モデルによってお使いのコンピューター上で文字起こしされ、何かをインストールする必要はありません。言語は Settings、Voice、または CLI の /voice-language で設定します。

自分の GPU で動かすローカルモデル#

チャットモデルはホスト型ですが、メディアモデルはお使いのコンピューター上で、無料かつ利用枠を消費せずに実行できます:

• ローカル画像生成: FLUX、SDXL ベースのモデル、Qwen-Image、Qwen-Image-Edit、Z-Image Turbo など。stable-diffusion.cpp で実行します。セッションの Tools row で Image Gen をオンにしてください。
• ローカル動画生成: LTX-2.5 と Wan 2.2 TI2V 5B。Video をオンにしてください。

モデルはパッケージとして提供され、承認した後にのみダウンロードされます。アプリは GPU、ビデオメモリ、ドライバーを確認し、お使いのコンピューターで実行できるモデルを提案します。管理は Packages ウィンドウの Models タブ、または CLI の /images と /models で行います。ハードウェア要件を含む完全な一覧はパッケージカタログにあります。

クラウドのメディアモデル（動画、音声、効果音、音楽）は AI Game Dev のサーバー上で実行され、利用枠を消費します。Cloud generationを参照してください。

さらに詳しく#

• エンジン別のリクエストの書き方についてはベストプラクティスを参照してください。
• ゲーム向けのローカル AI 画像生成とローカル AI 動画生成。
• エージェントにツールを追加するにはパッケージを参照してください。