💻 Claude Code入門 📖 約22分で読めます

Claude Codeでテストコードを書かせるテクニック

単体テストからE2Eテストまで、AIによるテスト自動生成

クロガイド｜Claude＆Claude Codeを無料で学ぼう

AI基礎からプロンプト術、Claude Codeの使い方まで。知識レッスンとクイズ式トレーニングで、AIスキルを段階的にアップ。ユーザー登録不要、すべて無料で今すぐ始められます。

無料で学習を始めるクロガイドとは？

はじめに ― なぜClaude Codeでテストを書くのか

テストコードは品質保証の要ですが、手動で書くのは時間がかかり、単調な作業になりがちです。Claude Codeを活用すれば、既存コードを読み取ってテストケースを自動生成し、エッジケースの見落としも減らせます。

Claude Codeによるテスト生成のメリット

時間短縮: テストコードを書く時間を最大80%削減
網羅性: 人間が見落としがちなエッジケースを自動提案
一貫性: プロジェクト内で統一されたテストスタイルを維持
学習効果: テストの書き方を実例から学べる

単体テスト（Unit Test）の生成

まず最も基本的な単体テストの生成方法を見ていきましょう。言語・フレームワーク別に効果的なプロンプトを紹介します。

JavaScript / TypeScript（Jest）

テスト対象のコード

// utils/calculator.ts
export function calculateTax(price: number, taxRate: number): number {
  if (price < 0) throw new Error('Price must be non-negative');
  if (taxRate < 0 || taxRate > 1) throw new Error('Tax rate must be between 0 and 1');
  return Math.round(price * (1 + taxRate));
}

export function formatCurrency(amount: number, locale = 'ja-JP'): string {
  return new Intl.NumberFormat(locale, {
    style: 'currency',
    currency: 'JPY'
  }).format(amount);
}

Claude Codeへの指示

> utils/calculator.ts の単体テストをJestで書いて。
> 以下を含めて：
> - 正常系テスト（代表的な入力値）
> - 境界値テスト（0、最大値付近）
> - 異常系テスト（不正な入力でエラーが出ること）
> - テストはdescribe/itで構造化して日本語で記述

Claude Codeが生成するテストコード

// utils/__tests__/calculator.test.ts
import { calculateTax, formatCurrency } from '../calculator';

describe('calculateTax', () => {
  describe('正常系', () => {
    it('税率10%で正しく計算される', () => {
      expect(calculateTax(1000, 0.1)).toBe(1100);
    });

    it('税率0%の場合は元の価格が返る', () => {
      expect(calculateTax(1000, 0)).toBe(1000);
    });

    it('小数点以下は四捨五入される', () => {
      expect(calculateTax(999, 0.08)).toBe(1079);
    });
  });

  describe('境界値', () => {
    it('価格0円の場合は0が返る', () => {
      expect(calculateTax(0, 0.1)).toBe(0);
    });

    it('税率100%の場合は価格の2倍が返る', () => {
      expect(calculateTax(500, 1)).toBe(1000);
    });
  });

  describe('異常系', () => {
    it('負の価格でエラーがスローされる', () => {
      expect(() => calculateTax(-100, 0.1)).toThrow('Price must be non-negative');
    });

    it('税率が1を超えるとエラーがスローされる', () => {
      expect(() => calculateTax(100, 1.5)).toThrow('Tax rate must be between 0 and 1');
    });

    it('負の税率でエラーがスローされる', () => {
      expect(() => calculateTax(100, -0.1)).toThrow('Tax rate must be between 0 and 1');
    });
  });
});

Python（Pytest）

Pytestでのテスト生成指示

> services/user_service.py のテストをpytestで書いて。
> - fixtureを使ってテストデータを準備
> - parametrizeで複数パターンをテスト
> - モックはunittest.mockを使用
> - 非同期関数はpytest-asyncioを使用

PHP（PHPUnit）

PHPUnitでのテスト生成指示

> app/Services/OrderService.php のテストをPHPUnitで書いて。
> - @dataProvider でテストデータを分離
> - モックオブジェクトはcreateMockを使用
> - setUp/tearDownで初期化と後処理
> - @covers アノテーションでカバレッジ明示

TDD（テスト駆動開発）ワークフロー

Claude CodeはTDDワークフローにも活用できます。先にテストを書き、そのテストを通る実装コードを生成する流れです。

Claude CodeでのTDD手順

Red（失敗するテストを書く）: 「この仕様のテストを先に書いて。実装はまだしないで」
Green（テストを通す実装）: 「このテストが通る最小限の実装を書いて」
Refactor（リファクタリング）: 「テストが通る状態を維持しつつ、コードをきれいにリファクタリングして」

TDDの会話例

> ショッピングカート機能をTDDで作りたい。
> まずテストを書いて。仕様：
> - 商品を追加できる
> - 同じ商品を追加すると数量が増える
> - 商品を削除できる
> - 合計金額を計算できる（税込み）
> - カートを空にできる
> 実装はまだ書かないで、テストだけ。

Claude Code:
テストを先に作成します。実装は空のクラスのみ用意します。

[cart.test.ts を作成]
[Cart クラスのスタブを作成]

現在すべてのテストは失敗します（Red状態）。
次に「テストを通す実装を書いて」と指示してください。

結合テスト・E2Eテストの生成

単体テストだけでなく、複数のコンポーネントが連携する結合テストや、ブラウザ操作を模倣するE2Eテストもclaude Codeで生成できます。

APIの結合テスト

API結合テストの指示例

> api/routes/users.ts のAPIエンドポイントの結合テストを書いて。
> - supertestを使用
> - テスト用DBはインメモリSQLiteを使用
> - 各テスト前にDBをリセット
> - CRUD全操作のテスト
> - 認証が必要なエンドポイントは認証トークン付きで
> - ステータスコードとレスポンスボディの両方を検証

E2Eテスト（Playwright / Cypress）

E2Eテストの指示例

> ログイン→商品検索→カート追加→購入完了のE2Eテストを
> Playwrightで書いて。
> - Page Object Modelパターンを使用
> - スクリーンショットを各ステップで撮影
> - タイムアウトは30秒に設定
> - CI環境でのヘッドレス実行に対応

テストカバレッジの改善

既存のテストのカバレッジを向上させたい場合、Claude Codeに現状を分析させて不足分を補うことができます。

カバレッジ改善の会話例

> npm test -- --coverage の結果、
> src/services/payment.ts のカバレッジが45%しかない。
> カバーされていない行・分岐を特定して、
> 追加テストを書いて。カバレッジ80%以上を目標にして。

Claude Code:
payment.ts を分析します...

カバーされていない箇所:
1. L23-30: タイムアウト時のリトライ処理
2. L45-52: 部分返金の計算ロジック
3. L67-75: 通貨変換のエッジケース

これらをカバーするテストを追加します...
[テスト追加完了]

追加後の推定カバレッジ: 87%

モック・スタブの効果的な生成

外部APIやデータベースに依存するコードをテストする場合、モックやスタブが必要です。Claude Codeに適切なモックを生成させるコツを紹介します。

依存対象	モック手法	指示のコツ
外部API	HTTPリクエストのモック	「nockでAPIレスポンスをモックして」
データベース	インメモリDB / リポジトリモック	「テスト用のインメモリDBで置き換えて」
ファイルシステム	仮想FS / tmpdir	「memfsを使ってファイル操作をモックして」
日時	Date / timerのモック	「jest.useFakeTimersで時刻を固定して」
環境変数	process.envのモック	「テスト前後でenv変数を復元して」