Claude Code と Playwright で QA テスト

QA テストで Claude Code ができること

• 大事なフローのエンドツーエンドテストを書きます：登録、購入、主要な画面。
• テストスイートを実行して失敗を読み、テストとコードのどちらを直したかを明示して修正します。
• 実際のブラウザを操作して変更を人と同じように確認し、手順とスクリーンショット付きでバグを起票します。
• 不安定なテストを見つけ、通るまでリトライするのではなく、issue を作って隔離します。

QA テストに使える Claude Code の機能

QA テスト向けに Claude Code を設定する方法

1. ツールをつなぐ

   Playwright MCP サーバーを追加すると、Claude Code がブラウザでアプリを開けるようになります。リポジトリのテストスイートには、いつもどおり Playwright をインストールします。Claude はほかのコマンドと同じように実行します。

   # 探索的な確認のための実際のブラウザ
   claude mcp add playwright npx @playwright/mcp@latest
   
   # テストスイートがまだなければ
   npm init playwright@latest

2. CLAUDE.md にルールを書く

   Claude Code は、claude -p での実行も含め、すべてのセッションの開始時に CLAUDE.md を読みます。仕事のルールはそこに書くか、長くなるなら .claude/skills/ 以下のスキルにします。CLAUDE.md ガイドをご覧ください。

   ## QA のルール
   - テストはローカルかステージングのアプリで行う。本番環境では決して
     行わない。
   - .env.example のテストアカウントを使う。実際のアカウントは決して
     使わない。
   - 失敗したテストは発見の 1 つ。どちらかを変える前に、テストと
     コードのどちらが間違っているかを書く。
   - バグ報告にはすべて、手順、期待される結果、実際の結果、
     スクリーンショット、テストしたコミットを書く。
   - スイートを通すためにテストを削除したりスキップしたりしない。

3. 対話型の画面なしで実行する

   claude -p は 1 つのタスクを実行して終了するので、cron や CI、ほかのツールから起動できます。確認なしで何をしてよいかは --allowedTools か --permission-mode で決めます。--output-format json を付けると、結果がコストと一緒に返ります。

   # CI や cron から、スイートを実行して失敗を直す
   claude -p "npx playwright test を実行し、CLAUDE.md に従って失敗を直して" \
     --allowedTools "Bash,Read,Edit"

4. スケジュールに載せる

   /schedule でクラウドのスケジュールタスクにするか（Pro、Max、Ultra、Team、Enterprise）、デスクトップのスケジュールタスクを使うか、セッションを開いている間は /loop を使います。Claude Code を自律的に動かす方法をご覧ください。

出典：Claude Code のドキュメント

限界と安全性

• テストできるのは届く範囲だけです：テストデータの入ったローカルかステージングのアプリで、本番環境ではありません。
• スイートが通っても、カバーされているのは誰かがテストを書いたフローだけです。カバーされていないものを一覧にするよう頼みましょう。
• ブラウザでの実行は遅く、プランの利用量も多く使います。フルスイートはスケジュールで、スモークテストは変更ごとに実行しましょう。
• Claude Code v2.1.302 以降、claude -p は Manual モードで始まります。承認が必要な操作は、ルールで許可されていない限り拒否されます。許可するツールは、その仕事に必要なものだけにしましょう。

QA テストに使うなら Claude Code と Codex のどちら？

ルールはそのまま使い回せます。AGENTS.md に一度書き、CLAUDE.md に @AGENTS.md と書いておけば、両方のエージェントが同じファイルを読みます。

もう一方のエージェントでの手順：QA テストを Codex で行う方法。

QA テストを誰かの仕事にする

コマンドは、誰かが実行を思い出したときにしか動きません。Crewmark は、あなたの Claude Code を、職種、数字の目標、勤務時間、ハートビートを持つ AI 社員に変えます。仕事はスケジュールどおりに進み、ボードに表示されます。

1. 職種から始める

   AI ソフトウェアエンジニアを選び、ブリーフにこのページのルールを加えます。

2. 仕事をボードに載せる

   この仕事を定期 issue として追加します。社員はハートビートで起きて仕事をこなし、結果をコメントで報告します。

3. 関連ページ

   起票したバグのその後は GitHub の issue 対応で扱っています。

よくある質問