プロンプトからテストを作成する
ワークフローを Claude、ChatGPT、または提供するローカル AI モデルか独自のモデルに説明すると、画面上でテストを記録、検証、実行し、既存のテストをその場で編集し、Figma のデザインからテストを作ります。
プロンプトから作るテスト
AI アシスタント、つまり Claude、ChatGPT、または当社が提供するか自分で持ち込むローカル AI モデルにワークフローを説明すると、代わりにテストを記録してくれます: コンピューター上でアプリや Web ページを開き、本物のクリックとキー操作としてステップを実行し、進めながら検証し、通常の GUI Test Studio のテストとして保存します。GUI Test Studio で開き、GUI Test Runner-Recorder で実行し、gtr-cli でパイプラインに加えてください: モデルが作ったことを示すものは、テストのどこにもありません。
これは、自分で記録するのと並ぶ、テストを作る 2 番目の方法です: どちらでも、できあがるテストは同じです。アシスタントは、既存のテストをその場で編集し、Figma デザインからテストを作り、テストを実行して信頼度レポートを見せることもできます。
Claude Desktop、Claude Code (ターミナル、および VS Code と JetBrains の拡張機能)、Codex 付きの ChatGPT (ChatGPT デスクトップアプリ、Codex コマンドライン、Codex の VS Code 拡張機能)、そして VS Code の Copilot Chat で動作します。アシスタントがまったくなくても、ローカル AI モデルがこのコンピューター上で動き、GUI Test Studio の内蔵エンジンで当社が提供するモデルか自分で持ち込むモデルが、まったく同じツールでテストを作ります。コネクターは GUI Test Studio と一緒にインストールされ、必要なのは、このコンピューターで無料トライアルまたは有料プランのアカウントにサインインしていることだけです: キーも設定も要りません。このページでは Claude と書きますが、ChatGPT とローカルモデルも同じように動きます。
「プロンプトからテストを作成」ウィンドウ
GUI Test Runner-Recorder でプロンプトからテストを作成をクリックしてください: ホーム画面の新しいテストを作成カードで記録の横に、そしてツールバーにあります。どちらのアプリでも、ヘルプの Claude または ChatGPT で使う...からも開けます。ウィンドウは上から下へ 4 個の部分でできています。
1. テストは何をしますか?
テスターに説明するつもりで、テストが何をして何を検証すべきかを書いてください。アシスタントが受け取るのはこの欄だけなので、アプリまたはアドレス、ステップ、結果を名指ししてください。
2. または例から始める
破線の 6 個のタイルが、できあいの依頼文を欄に入れます: アプリ全体、1 つのワークフロー、ブラウザーとデバイス、テストを実行、テストを変更、Figma のデザインからです。最初の 2 個では、対象の行でテストするものを指定します: デスクトップアプリ、Web アプリ、またはスマートフォン上のアプリです。どの例も「GUI Test Studio で、...」で始まり、置き換える部分を « » で示し、最初の部分は選択済みなので、その上から入力するだけです。
3. このプロンプトを AI アシスタントで実行する
アシスタントごとに 1 枚のカードがあります: Claude Desktop、Claude Code、ChatGPT と Codex、VS Code で、それぞれに状態と、次に行うことをするボタンが 1 個あります。
| カードの表示 | ボタン |
|---|---|
| 未インストール | 入手: アシスタントのダウンロードページを開きます。 |
| 未接続 | 接続: GUI Test Studio のコネクターがアシスタントの設定に自動で追加され、入力するものも、編集するファイルもありません。開いていた Claude Desktop や ChatGPT アプリでは「再起動して開く」と表示され、その両方を行います。 |
| 接続済み | 開く: プロンプトがアシスタントに渡ります。Claude Desktop は入力済みの新しいチャットを開き (読んで Enter を押します)、Claude Code と Codex はそれを最初のメッセージとしてコンソールで開き、ChatGPT アプリはそれをクリップボードに入れて開き (Codex のスレッドを始めて貼り付けます)、VS Code はそれを使って Copilot Chat をエージェントモードで開きます。 |
Claude Code は、ターミナルと、VS Code および JetBrains の拡張機能をまとめた 1 枚のカードです: 同じプログラムを実行し、接続を共有します。ChatGPT と Codex も 1 枚のカードです: ChatGPT デスクトップアプリ、Codex コマンドライン、Codex の VS Code 拡張機能は同じ設定を読むので 1 回の接続で 3 個すべてに使えますが、Web 版とスマートフォン版の ChatGPT はコンピューター上のプログラムに届きません。VS Code のカードは Copilot Chat のエージェントモードです。
コネクターを受け付けるほかのアシスタントでも使えます: カードの下のコネクターの場所をコピーが、アシスタントに必要なただ 1 個のコマンドをコピーするので、コネクターを求められた場所に貼り付けてください。別のコンピューターや自分のターミナルでは、このコマンド 1 行で Claude Code のセットアップができます (ウィンドウの「?」にも表示されます):
claude mcp add --transport stdio --scope user gui-test-studio -- "C:\Program Files\GUI Test Studio\Runner\gts-mcp.exe"そしてこちらが ChatGPT と Codex のセットアップです (ChatGPT アプリは起動時にこれを読みます):
codex mcp add gui-test-studio -- "C:\Program Files\GUI Test Studio\Runner\gts-mcp.exe"1 個のプロジェクトだけで使うなら、プロジェクトのルートに置いた .mcp.json ファイルが Claude Code で同じ役目を果たし、.vscode/mcp.json ファイルが VS Code で同じ役目を果たします。
4. またはこのコンピューターで作る
アシスタントの下のこのコンピューターカードは、当社が提供するか自分で持ち込むローカル AI モデルでテストを作ります: 設定...で一度だけセットアップし、ここで作成で始めます。次のセクションをご覧ください。
このコンピューターで、ローカル AI モデルを使って
AI アシスタントは不要です: 「このコンピューター」カードは、GUI Test Studio の内蔵エンジンで当社が提供するか、LM Studio や OpenAI 互換のローカルサーバーを通じて自分で持ち込むローカル AI モデルでテストを作ります。依頼も画面もコンピューターから出ることはなく、AI 企業のアカウントも、テストごとのコストもありません。モデルは Claude や ChatGPT とまったく同じツールを受け取るので、できあがるテストも同じ種類のテストです。
一度だけセットアップする
このコンピューターカードの設定...をクリックしてください。ウィンドウには、何を期待できるか、このコンピューターのグラフィックスカードとメモリ、そしてその上で最もよく動くモデルの推奨が表示されます。おまかせで設定をクリックするか、別のモデルを選んでダウンロードをクリックします: モデルは発行元から一度だけダウンロードされ、すべてのテストのために保持されます。
| 設定 | 内容 |
|---|---|
| プロバイダー | 推奨の「GUI Test Studio に内蔵」か、ローカルサーバー: LM Studio や Ollama など、既に動かしている OpenAI 互換サーバーを、そのアドレスとそのモデルのどれかで使います。 |
| モデルと精度 | どのモデルが、どの形でテストを作るか: 高い精度は画面を少しよく読み取り、より多くのメモリを必要とします。 |
| 詳細設定: コンテキストウィンドウ | モデルが一度に保持する会話の量で、既定は 32,768 です。ローカルサーバーは同じ数でモデルを読み込む必要があります。 |
| 詳細設定: ステップ 1 回あたりの時間制限 | 実行をあきらめるまでに、モデルの 1 ステップにかけてよい時間です。 |
これらの選択は AI スマート分析のものとは別です: ここであるモデルがテストを作り、別のモデルやクラウドプロバイダーが不合格アサーションを説明する、ということもできます。
テストを作る
プロンプトを書き、ここで作成をクリックしてください。画面の隅のカードに、モデルが進める各ステップの名前が表示されます。その間はマウスとキーボードに触れないでください: モデルがクリックや入力をする間、カードは脇に退き、テストの画像に写ることはありません。最後に、テストの保存先と合格したかどうかが、GUI Test Studio で開くとフォルダーで表示とともに表示されます。
何を頼むか
テスターに説明するつもりで、テストが何をして何を検証すべきかを伝えてください:
Open the calculator, compute 5 + 5 and verify the result shows 10.Create a test for my app C:\Apps\Shop.exe: add a client named Atlas Textiles and verify it is listed.Test the sign-up form at https://shop.example/signup in Chrome, Edge and Firefox and on an iPhone 15.Run the Checkout test and tell me what failed.With GUI Test Studio, test the whole of C:\Apps\Shop.exe: list its main workflows and create one test per workflow, each verifying its outcome.Show me the report of the Checkout test.In the Checkout test, rename the check "Visual Assert #3" to "Pay button" and let it wait 10 s.Create a test from my Figma design C:\Designs\Login.gtsdesign.頼む先のアプリがほかの方法でもできてしまう場合は、「GUI Test Studio で、...」で始めてください: ウィンドウの一般的なタスクは、どの依頼もそう書き出します。USB で接続した Android スマートフォン上のアプリ (USB デバッグをオン) には、「スマートフォンで」と伝えてください: テストはこの画面上のウィンドウにスマートフォンを表示し、Claude はそのウィンドウを通じて作業します。
どのタスクも同じように終わります: Claude はテストの保存先と実行の判定を伝え、次に何をするか、つまりもう一度実行するか、GUI Test Studio で編集するか、GUI Test Runner-Recorder で開いて信頼度レポートを読むかを尋ねます。不合格だった実行はレポートから説明され、求めない限り、テストをもう一度記録することで答えることはありません。
「GUI Test Studio でテストを編集して」と言えば Claude はそこで開き、「GUI Test Runner-Recorder で開いて」と言えば自分で実行するウィンドウが開き、「レポートを見せて」と言えば最新の信頼度レポートを表示した状態でテストが開きます。Claude アプリのプロンプトメニュー (Claude Desktop の「+」) には、テストを作る、Web ページを複数のブラウザーでテストする、アプリを全体的にテストする、実行する、編集する、GTR で開く、といった一般的な依頼が並び、それぞれ短い 1 行を受け取り、詳細はチャットに書きます。
Claude は、頼まれたワークフローをそのとおりに行います。アプリを自分で探索するのは頼まれたときだけで (「このアプリの基本機能をすべてテストして」)、その場合、見つけたワークフローごとに、それぞれのシナリオとアサーションを備えたテストを 1 件ずつ作ります。
アシスタントが画面上で行うこと
Claude が作業している間は、マウスとキーボードに触れないでください: 本物の画面を使っています。アプリを起動するかページを開き、画面を見て、クリックや入力をし、各ステップの後に、レコーダーがするのと同じように結果を検証します。2 個のステップの間に Claude が考える時間はテストから除かれ、Claude が意図的に求めた待ち時間は待機ステップになります。
| Claude にできること | テストでの形 |
|---|---|
| クリック、入力、キー操作、スクロール、ドラッグ、マウスの移動 | マウスとキーボードのイベントで、それぞれにレコーダーが自動で付けるビジュアルアサーションが付きます。 |
| テキスト、値の形式、個数、画像、不在、配置、ダイアログ全体の検証 | テキスト、動的テキスト、カウント、ビジュアル、ビジュアル不在、レイアウト、グループの各アサーション: どのアサーションもその場で試され、合格できなければ拒否されます。 |
| ステップのグループ化とメモ | タイムライン上のシナリオ (必要ならネスト) とマーカー。 |
| 操作ではないステップの追加 | アプリを実行、アプリを終了、JavaScript を実行、Python スクリプトを実行、ファイルをアップロード、オフラインにする / オンラインにする。 |
| 誤った操作の取り消し、アプリの状態を戻すための一時停止 | テストには何も残りません。 |
| 保存したテストの実行、内容の確認、GUI Test Studio で開く | GUI Test Runner-Recorder が行うのと同じ実行で、信頼度レポートがテストの横に置かれます。 |
| レポートの表示 | 最新の信頼度レポートを表示した状態で、テストが GUI Test Runner-Recorder で開きます。 |
| 既存のテストの編集 | 確認のうえ、頼んだ変更がその場で加えられます: 何も記録し直しません。 |
| 保存したテストへのアサーションの追加 | 新しいアサーションで、まずテスト自身の記録のその瞬間で試され、そこで合格できなければ拒否されます。 |
| 実行が不合格になった理由と、いつからかの確認 | 各不合格が期待したものと見つけたもの、画像、AI スマート分析の見解、過去のすべての実行、テストが不安定かどうか。 |
| 同意のうえでの、実行結果の採用 | 信頼度レポートの「採用」と同じく、以後テストが期待するもの。 |
| バグレポートの作成 | エビデンス付きの PDF または Excel のレポート、または確認のうえで Jira の課題。 |
| パイプライン向けのテストの準備 | 実行専用テスト (.GTR) と、CI ツール向けのコマンドおよびパイプラインの記述。 |
| Figma デザインからのテストの作成 | GUI Test Studio がデザインパッケージから行うインポート: 要素ごとに 1 個のアサーションと、プロトタイプフローのクリック経路。 |
別のフォルダーを指定しない限り、テストは Documents\GUI Test Studioの中の専用フォルダーに置かれ、結果もその横に置かれます。
既存のテストをプロンプトで編集する
Claude は、既存のテストを記録し直さずに変更できます: ステップの名前の変更、アサーションが期待するテキストの変更、アサーションのタイムアウトの延長、失敗時の動作の決定、ステップの削除や無視、待機の追加、テストの名前や説明の変更です。テストを名指しし、何を変えるか伝えてください:
In the Checkout test, let the "Order confirmed" check wait 10 s and continue the test if it fails.In the Sign in test, ignore the step that clicks "Remember me", and add a 2 s wait before the Sign in click.Rename the Checkout test to "Checkout with a coupon" and describe it as the coupon scenario.アサーションが見る場所、画像比較の厳密さ、アサーションについて AI に伝える内容の変更、ステップの移動、ステップのシナリオへのグループ化、テストフローステップやマーカーの追加もできます。新しいアサーションは、まずテスト自身の記録のその瞬間で試され、そこで合格できなければ拒否されます。
In the Checkout test, also verify that the total is shown after step 12.In the Checkout test, group steps 3 to 9 as a Scenario called Payment.何かを書き込む前に、Claude は変更しようとしている内容を毎回示し、確認を求めます: 編集はテストファイルを上書きするためです。テスト全体の記録し直しは、求めたときにだけ行われます。その後、GUI Test Studio でテストを開くと、タイムライン上で変更を確認できます: プロンプトによる編集はテストの通常の編集であり、次回の実行で使われます。
実行の後: 不合格の理由と、その対処
何が不合格だったか尋ねると、Claude は何も実行せずに、その実行の結果を読みます: 各アサーションが期待したものと実行が見つけたもの、すべての差異を枠で示した画像、そして AI スマート分析の見解です。テストの履歴も読みます: いつから不合格か、合否が行ったり来たりしているかです。
Why did the Checkout test fail? Show me the difference.When did the Checkout test start failing? Is it flaky?The new button is correct: accept what the last run found.File this failure as a Jira bug in project SHOP.Run the Checkout test from step 12 on, and retry it once if it fails.Put the Checkout test in TeamCity.Claude が代わりに決めることはありません。結果を採用すると、以後は実行が見つけたものが正しいものになり、Jira の課題はほかの人が読みます: どちらも、Claude が示す内容を確認してからでなければ行われません。PDF または Excel のレポートはすぐに書き出されます。
Figma デザインからのテスト
デザイナーがスイートの Figma プラグインでエクスポートしたデザインパッケージ、つまり .gtsdesign ファイルを Claude に渡すと、GUI Test Studio が提供するのと同じインポートを通じてテストを作ります: 各画面はリファレンス画像に、各要素はアサーションになり、プロトタイプフローはクリック経路になります。ログインページのデザインからは、機能が作られる前に、ログインシナリオのテストができあがります。
Create a test from C:\Designs\Login.gtsdesign, following its prototype flow.デザインは、Figma からデザインをインポートするの説明どおりに Figma からエクスポートし、機能ができる前にテストで何ができるかは、実装前の機能をテストするにあります。
Web アプリ: ブラウザー、デバイス、条件
Web ページでは、ほかのブラウザー、デバイス、条件を同じ文で頼んでください (「Edge と iPhone 15 で、フランス語、150% ズームで」): Claude はページを一度だけ記録し、保存された時点ですべての組み合わせ向けにテストを生成し、それぞれを実行できます。記録はブラウザーウィンドウ付きで記録されたとおりに実行され、生成されたブラウザーとデバイスはウィンドウなしで実行されます。
保存した Web テストには、後からブラウザーとデバイスを追加でき、ページが変わった後に生成し直すこともできます。生成し直すと中身が置き換わるので、Claude は先に確認します。
アシスタントにできること、できないこと
| ルール | 理由 |
|---|---|
| 無料トライアルまたは有料プランで、サインイン済みのコンピューターのみ | コネクターは依頼のたびにアカウントを確認し、トライアルの終了やサインアウトで、すぐに止まります。 |
| Claude が見るのはツールだけで、エンジンは見えない | 与えられるのはテスターが行うこと (クリック、検証、実行) で、アサーションがどう評価されるかは GUI Test Studio の内部にとどまります。 |
| 頼まない限り何も探索しない | テストは説明したとおりのもので、それ以上ではありません。 |
| 今は不合格になるアサーションは拒否される | そのため、できあがったテストは、それが作られた画面で合格します。 |
うまくいかないとき
| 表示される内容 | 対処 |
|---|---|
| Claude が、誰もサインインしていないので GUI Test Studio が拒否した、と言う | GUI Test Studio または GUI Test Runner-Recorder からサインインし、もう一度頼んでください。 |
| Claude が、GUI Test Studio の更新が必要だと言う | どちらかのアプリを起動してください: 更新がダウンロードされてインストールされ、Claude がまた動くようになります。 |
| Claude Desktop に GUI Test Studio が表示されない | 「プロンプトからテストを作成」(または「ヘルプ」>「Claude で使用...」) を開き、Claude Desktop のカードで「接続」をクリックし、次に「再起動して開く」をクリックしてください。接続されると、「設定」>「コネクタ」に GUI Test Studio として表示されます。 |
| VS Code で GUI Test Studio が表示される場所 | Copilot Chat のツール一覧 (チャットのツールボタン) と、コマンド「MCP: List Servers」で、Claude Code では /mcp と入力してください。 |
| ChatGPT アプリに GUI Test Studio が表示されない | ChatGPT と Codex のカードで「接続」をクリックし、次に「再起動して開く」をクリックしてください: アプリは起動時に設定を読みます。接続されると、「設定」>「MCP サーバー」に表示され、ターミナルでは codex mcp list に表示されます。 |
| Claude Desktop が依頼の横に注意書きを表示する | リンク経由で届いたあらゆる依頼に対する Claude Desktop 自身の注意書きで、GUI Test Studio のものではありません: 依頼を読んで送信してください。 |
| Claude が GUI Test Studio を使わずに答えた | 依頼を「GUI Test Studio で、...」で始めるか (ウィンドウの一般的なタスクはそうしています)、「テスト」と言ってください: 「X を開いて Y を検証して」という単純な依頼もテストであり、コネクターはそう Claude に伝えます。 |
| 「このコンピューター」カードに、モデルがダウンロードされていないと表示される | 「設定...」をクリックし、次に「おまかせで設定」をクリックしてください: 推奨モデルが一度だけダウンロードされ、「ここで作成」が使えるようになります。 |
| ローカルモデルが遅い、または終わらない | より短いワークフローを頼むか、「設定...」で当社が提供するか自分で持ち込む、より小さなモデルを選ぶか、カードの「代わりに Claude または ChatGPT を使用...」をクリックしてください: クラウドのアシスタントは、長いテストをはるかに速く作ります。 |
| 次の実行でテストが不合格になる | GUI Test Studio で開いてください: Claude が追加したすべてのアサーションは「検証」トラックにあり、信頼度レポートがどれがなぜ不合格かを示します。 |
コネクター自身のログは %LOCALAPPDATA%\GUI Test Studio\logs\claude-connector.logにあります。
まだ解決しませんか?何をしようとしていたかをお知らせください。1 営業日以内に回答します。Ask our team