Claude CodeでE2Eテストを作る|単体テストを通った画面の不具合を見つける

公開 更新 11 分で読了
Claude CodeでE2Eテストを作る|単体テストを通った画面の不具合を見つける

Claude CodeとPlaywrightで、単体テストを通っても残る画面の不具合を見つけます。表示名フォームを題材に、コピーして使える依頼文とテスト例、修正前の失敗と修正後の合格をトレースで確かめる手順、証拠を残す照合表を紹介します。

Claude CodeでE2Eテストを書くときは、利用者がブラウザで操作したあと、画面に何が出れば合格かを最初に決めます。 Claude Codeは手元のターミナルで使え、個人向けProの月払いは20米ドルです。ブラウザを操作するPlaywrightは無料で使え、この記事では「保存した表示名が一覧に出ない」不具合を、修正前後で同じテストを実行して確かめます。[1][2][3]

Claude CodeのE2Eテストで何を確認するか

単体テストでは入力値の処理を、E2Eテストでは入力から保存後の表示までを確認します。 E2Eは「最初から最後まで」を意味し、この例の最後は、入力した表示名が一覧に現れた時点です。

入力値の確認とフォーム全体の操作を見比べるイラスト

自社アプリのローカル開発環境にある「表示名の登録」フォームを想定します。空白を取り除く関数の単体テストが通っても、保存処理が結果を一覧へ渡し忘れれば、画面には名前が出ません。ブラウザで入力して保存し、一覧の行まで調べる理由はそこにあります。

確認の範囲 入力と操作 合格条件
単体テスト 名前の前後に空白を付けて整形関数に渡す 前後の空白を除いた名前が返る
E2Eテスト 表示名を入力して保存する 「保存済みの表示名」の一覧に入力した名前が表示される

保存後に入力欄が空になるだけでは、一覧への追加を確かめられません。この例では一覧への表示が要件です。ページを再読み込みしても名前が残ることが製品の要件なら、永続化を確かめるケースとして追加します。

AIが行った作業を証拠付きで検証するという考え方は、今回の題材になったXの投稿でも紹介されています。この記事では、ブラウザで観察できる結果を合格条件にして、その証拠を修正担当とレビュー担当が同じように読める形にします。修正前に作業範囲を相談する段取りは、Claude CodeのPlan Modeで計画を詰める手順で確認できます。

Playwrightで再現する画面操作を決める

テストを書く前に、開くページ、入力する値、最後に確認する表示を固定します。 Playwrightの公式ガイドでは、内部の実装に依存する指定より、利用者に見えるラベルや役割を使って要素を探すことを勧めています。[4]

入力、保存、一覧への表示を順に確かめる図

  1. ローカルの対象ページを開きます。 作例のURLは http://127.0.0.1:8765/form.html です。「表示名」欄、「保存」ボタン、「保存済みの表示名」一覧があるフォームを使います。
  2. 一覧に「テスト利用者A」がない状態を用意します。 実際の氏名に依存しないダミーデータです。保存前から同じ名前が一覧にあれば、その名前を探すだけのテストが誤って合格するため、開始時に該当する行が0件であることも確認します。
  3. 「表示名」へ「テスト利用者A」を入力し、「保存」を実行します。 作例のテストはキーボードのEnterで送信します。保存後は、入力欄や通知ではなく「保存済みの表示名」一覧の中だけを見て、名前が見えることを確かめます。

既存データを使うアプリでは、ブラウザの状態を切り離しても、サーバー側に保存した行は残ることがあります。テスト専用のデータを使い、初期化や後片付けは既存のテストで採用されている方法にそろえます。失敗直後の再実行でも同じ初期状態から始められることが、修正前後の比較に必要です。[4]

Claude CodeにE2Eテストを書かせて失敗を確かめる

先にテストだけを追加し、保存後の一覧を確認する行で失敗するところまで確かめます。 アプリを先に修正すると、そのテストが元の不具合を検出できたか判断できません。

保存操作後に一覧から欠けた項目を調べるイラスト

1. 既存の起動方法とテスト設定を調べる

プロジェクトのルートで、既存の playwright.config.ts などの設定ファイル、package.json の実行スクリプト、近い画面のテストを確認します。設定にローカルサーバーの起動方法や複数のブラウザが指定されている場合は、対象のプロジェクト名も控えます。[5]

起動方法が曖昧なら、Claude Codeにまず調査結果だけを返すよう頼みます。開発用データの初期化やログインが必要な場合は、その条件を確認してから今回のテストを追加します。

2. 操作と失敗条件を伝えて、テストを1本追加する

次の依頼文では、アプリの修正を次の工程に残し、今回の終了条件を「狙った検証行で失敗した記録がある」にしています。URLと名前は、対象フォームに合わせて置き換えます。

既存のPlaywright設定、テストフォルダ、ローカル起動コマンドを確認してください。
既存方式に合わせて、表示名フォームのE2Eテストを1本だけ追加してください。

対象はローカル開発環境です。
「保存済みの表示名」一覧が見え、「テスト利用者A」が0件であることを確かめます。
「表示名」に「テスト利用者A」を入力し、「保存」を実行します。
同じ一覧の中に、入力した表示名が見えれば合格です。

この段階ではアプリを修正せず、追加したテストだけをトレース付きで実行してください。
実行コマンド、失敗した行、画面で確認できた結果、トレースの保存先を報告してください。
ブラウザやサーバーが起動しないときは、起動失敗として報告してください。

練習用フォームを用意する

手元に対象のフォームがなければ、次のHTMLを練習用フォルダの form.html として保存します。一覧には別のダミー名を1件置き、保存前にも一覧が見える状態にしています。

<!doctype html>
<html lang="ja">
<meta charset="utf-8">
<title>表示名の登録</title>
<form>
  <label for="name">表示名</label>
  <input id="name" required>
  <button type="submit">保存</button>
</form>
<ul aria-label="保存済みの表示名"><li>既存のテスト利用者</li></ul>
<script>
  const form = document.querySelector('form')
  const field = document.querySelector('#name')
  form.addEventListener('submit', (event) => {
    event.preventDefault()
    const name = field.value.trim()
    if (name.length === 0) return
    const item = document.createElement('li')
    item.textContent = name
    field.value = ''
  })
</script>
</html>

Node.jsとPython 3を使える環境で、練習用フォルダにPlaywright Testを用意します。既存プロジェクトに導入済みなら、その環境とブラウザを使えます。[8]

npm init -y
npm install -D @playwright/test
npx playwright install firefox
python3 -m http.server 8765 --bind 127.0.0.1

最後のコマンドは実行した端末で起動したままにします。別の端末で同じフォルダへ移動し、次のテストを保存して実行します。

以下は、認証のない練習用フォーム向けの profile.spec.ts です。ラベルの検索と最後の検証を分け、保存前の0件確認と保存後の表示確認で同じ一覧を使います。[4]

import { expect, test } from '@playwright/test'

test('保存した表示名が一覧に出る', async ({ page }) => {
  await page.goto('http://127.0.0.1:8765/form.html')

  const name = 'テスト利用者A'
  const list = page.getByRole('list', { name: '保存済みの表示名' })
  const savedName = list.getByText(name, { exact: true })
  await expect(list).toBeVisible()
  await expect(savedName).toHaveCount(0)

  await page.getByLabel('表示名', { exact: true }).fill(name)
  await page.getByRole('button', { name: '保存', exact: true }).press('Enter')

  await expect(savedName).toBeVisible()
})

3. 修正前のテストを実行し、失敗した行を読む

テスト対象のサーバーを起動した状態で、プロジェクトのテスト実行場所から次を実行します。Firefoxを使えるPlaywright環境での例です。既存設定で名前付きプロジェクトを使う場合は、ブラウザ指定を --project=プロジェクト名 に置き換え、前後で指定をそろえます。[5][6]

npx playwright test profile.spec.ts --browser=firefox --trace=on --output=artifacts-before

作例で確認したい失敗箇所は、最後の expect(savedName).toBeVisible() です。サーバーに接続できない場合や、保存ボタンを見つけられない場合は、エラーが前の行で起きます。その段階では一覧への表示をまだ検証できていないため、接続や画面上の名前を先に確認します。

テストを追加したあと、編集直後にも決まった検査を呼び出したい場合は、Claude CodeのHooksで編集後にチェックする方法を参照できます。最初の1本は手元で失敗の理由を確認してから、繰り返し実行する仕組みへ組み込みます。

修正後の合格をPlaywrightのトレースで確かめる

アプリの原因箇所を直し、同じ操作・入力・合格条件で再実行します。 トレースはPlaywrightが行った操作と実行時の画面をたどるための記録です。修正前と修正後を別の出力先に置くと、同じ操作を見比べられます。[7]

同じ操作の流れを修正前と修正後で並べる図

1. アプリを修正し、出力先だけ変えて再実行する

練習用フォームでは、送信処理で作った一覧項目を、表示先のリストへ追加する処理が抜けています。練習用のHTMLでは、item.textContent = name の直後に document.querySelector('ul').append(item) を1行追加します。テストの検証行と入力値を保ったまま実行します。

npx playwright test profile.spec.ts --browser=firefox --trace=on --output=artifacts-after

結果の集計で対象テストが 1 passed になったことを確認します。実行対象が0件だったり、違うテストだけが合格していたりすると比較できないため、集計と併せて実行されたテスト名も残します。

2. Trace Viewerで保存操作と一覧の変化を照合する

  1. 端末の出力に表示された修正前の trace.zip を探し、npx playwright show-trace "実際のtrace.zipのパス" で開きます。修正後の結果は artifacts-after 配下の trace.zip を使います。[7]
  2. Actions で保存に対応する操作を選び、Before と After を見比べます。保存直後の表示が非同期で更新される画面では、続く検証の時点まで進み、結果が現れたかを見ます。[7]
  3. 修正前は Errors で最後の表示確認が失敗した理由を読みます。修正後は同じ検証まで進み、一覧に「テスト利用者A」が見えることと、テストの合格を突き合わせます。[7]

3. 修正前後の証拠を表に残す

ローカルのFirefoxでは、修正前に一覧表示の検証行で1件失敗し、一覧への追加を直した後に同じテストが1件合格しました。次の表のように、操作と結果を揃えて記録すると、レビュー担当もどこが変わったか確認できます。

照合項目 修正前に確かめること 修正後に確かめること
開始時の一覧 一覧が見え、対象名は0件 同じ初期状態
操作 「表示名」に「テスト利用者A」を入力して保存 同じ入力値と操作
一覧表示 保存後の表示確認で失敗 同じ確認で表示を検出
実行記録 対象テスト名と失敗した検証行、修正前のトレース 同じテスト名と合格結果、修正後のトレース

トレースには画面の内容やネットワーク情報が含まれ得るため、共有用にはダミーデータを使い、相手が見る必要のある範囲で扱います。修正の担当と確認の担当を分ける場合は、Claude Codeでレビュー担当を分ける方法も参照できます。[7]

確認項目と修正前後の記録をまとめるイラスト

よくある質問

Q. Playwrightを導入済みである必要はありますか?
掲載したテストの実行にはPlaywright Testと対象ブラウザが必要です。未導入なら公式の導入手順を確認し、既存のテスト環境がある場合はその設定と起動方法に合わせます。
Q. 単体テストとE2Eテストはどう分担しますか?
単体テストでは文字列の整形など、個別の処理を確かめます。E2Eテストではブラウザで入力して保存し、処理結果が一覧に表示されるところまで確かめます。
Q. 同じテストが通ったり落ちたりするときはどうしますか?
失敗時のトレースで、対象の要素、保存前のデータ、保存後に表示を調べた時点を確認します。固定時間の待機に頼る前に、画面表示を待つPlaywrightのアサーションと、毎回同じ初期状態を作る準備を見直します。
Q. 完了報告に何を添えればよいですか?
対象テスト名、実行コマンド、修正前に失敗した検証行、修正後の合格結果を添えます。修正前後のトレースを区別し、期待した表示と実際の表示も照合表に残します。

出典・参考データ

  1. [1] Claude Code公式概要 — 取得 2026-11-20
  2. [2] Anthropic公式料金表 — 取得 2026-11-20
  3. [3] Playwright ライセンス — 取得 2026-11-20
  4. [4] Playwright Best Practices — 取得 2026-11-20
  5. [5] Playwright Test Configuration — 取得 2026-11-20
  6. [6] Playwright Command Line — 取得 2026-11-20
  7. [7] Playwright Trace Viewer — 取得 2026-11-20
  8. [8] Playwright Installation — 取得 2026-11-20

この記事を書いた人

水島 翔吾

株式会社kairos 代表取締役 / AgentSignal 開発者

AI クローラー・AI 流入計測と AIO 診断ツール AgentSignal を開発。実測データを元に AI 検索時代の計測と対策を書いています。

関連記事