Claude Codeで単体テストを自動生成！カバレッジ向上の実践テクニック

「テストを書く時間がない」「カバレッジを上げろと言われても何から手をつければ良いかわからない」——SES現場でこういった悩みを抱えるエンジニアは少なくありません。特に既存のコードベースに後からテストを追加する作業は、コードの意図を読み解く必要があり、思った以上に時間がかかります。

Claude Codeを使えば、こうした課題を大幅に軽減できます。自然言語で指示するだけで、対象コードを解析して適切なテストケースを自動生成してくれるのです。本記事では、Claude Codeを活用した単体テスト自動生成の実践的な使い方を、コマンド例を交えながら詳しく解説します。

Claude Codeのテスト生成機能とは

Claude Codeは、Anthropicが開発したCLI型AIコーディングツールです。ターミナルから直接コードの生成・編集・レビューができますが、特にテスト生成において高い実用性を発揮します。

テスト生成の仕組みはシンプルです。Claude Codeは対象ファイルを読み込み、関数やメソッドの入出力パターンを解析して、網羅的なテストケースを生成します。単純なハッピーパスだけでなく、エラーケースや境界値のテストも自動で考慮してくれます。

対応しているテストフレームワーク

Claude Codeは主要なテストフレームワークに対応しています。プロジェクト内の設定ファイル（package.json、pyproject.toml、go.modなど）を自動検出して、適切なフレームワークのテストを生成します。

基本的なテスト生成コマンド

JavaScript/TypeScriptのテスト生成

最もシンプルな使い方は、ファイルを指定して「テストを生成して」と指示するだけです。

# 特定ファイルのユニットテストを生成
claude "src/utils/date.ts のユニットテストを生成して"

# テストファイルの出力先も指定する場合
claude "src/utils/date.ts のJestテストを src/utils/date.test.ts に生成して"

# 特定の関数だけテストを追加したい場合
claude "src/utils/date.ts の formatDate 関数のテストを追加して。境界値も含めて"

たとえば、以下のような日付ユーティリティ関数があった場合：

// src/utils/date.ts
export function formatDate(date: Date, format: string): string {
  const year = date.getFullYear();
  const month = String(date.getMonth() + 1).padStart(2, '0');
  const day = String(date.getDate()).padStart(2, '0');

  return format
    .replace('YYYY', String(year))
    .replace('MM', month)
    .replace('DD', day);
}

export function isWeekend(date: Date): boolean {
  const day = date.getDay();
  return day === 0 || day === 6;
}

Claude Codeは以下のようなテストを生成します：

// src/utils/date.test.ts（Claude Codeが生成したテスト例）
import { formatDate, isWeekend } from './date';

describe('formatDate', () => {
  it('YYYY-MM-DD フォーマットで日付をフォーマットする', () => {
    const date = new Date(2026, 1, 26); // 2026-02-26
    expect(formatDate(date, 'YYYY-MM-DD')).toBe('2026-02-26');
  });

  it('MM/DD/YYYY フォーマットで日付をフォーマットする', () => {
    const date = new Date(2026, 0, 1); // 2026-01-01
    expect(formatDate(date, 'MM/DD/YYYY')).toBe('01/01/2026');
  });

  it('1桁の月・日をゼロパディングする', () => {
    const date = new Date(2026, 2, 5); // 2026-03-05
    expect(formatDate(date, 'YYYY/MM/DD')).toBe('2026/03/05');
  });

  it('月の最終日を正しくフォーマットする', () => {
    const date = new Date(2026, 11, 31); // 2026-12-31
    expect(formatDate(date, 'YYYY-MM-DD')).toBe('2026-12-31');
  });
});

describe('isWeekend', () => {
  it('土曜日はtrueを返す', () => {
    const saturday = new Date(2026, 1, 28); // 2026-02-28（土）
    expect(isWeekend(saturday)).toBe(true);
  });

  it('日曜日はtrueを返す', () => {
    const sunday = new Date(2026, 2, 1); // 2026-03-01（日）
    expect(isWeekend(sunday)).toBe(true);
  });

  it('平日はfalseを返す', () => {
    const monday = new Date(2026, 1, 23); // 2026-02-23（月）
    expect(isWeekend(monday)).toBe(false);
  });

  it('金曜日はfalseを返す', () => {
    const friday = new Date(2026, 1, 27); // 2026-02-27（金）
    expect(isWeekend(friday)).toBe(false);
  });
});

Pythonのテスト生成

# pytestテストを全メソッドに生成
claude "payment_service.py のpytestテストを全メソッドに生成して"

# 特定クラスのテストを生成
claude "models/user.py の UserModel クラスのテストを tests/test_user.py に生成して"

# フィクスチャを使ったテストを生成
claude "payment_service.py のテストをpytestフィクスチャを活用して生成して"

# payment_service.py のテスト生成例
# claude "payment_service.py のpytestテストを生成して" 実行後

import pytest
from unittest.mock import Mock, patch
from decimal import Decimal
from payment_service import PaymentService, PaymentError

class TestPaymentService:
    @pytest.fixture
    def payment_service(self):
        return PaymentService(api_key="test_key")

    @pytest.fixture
    def mock_gateway(self):
        return Mock()

    def test_process_payment_success(self, payment_service, mock_gateway):
        """正常な支払い処理が成功することを確認"""
        mock_gateway.charge.return_value = {"status": "success", "id": "ch_123"}
        payment_service.gateway = mock_gateway

        result = payment_service.process_payment(
            amount=Decimal("1000.00"),
            currency="JPY",
            card_token="tok_test"
        )

        assert result["status"] == "success"
        mock_gateway.charge.assert_called_once()

    def test_process_payment_insufficient_funds(self, payment_service, mock_gateway):
        """残高不足の場合にPaymentErrorが発生することを確認"""
        mock_gateway.charge.side_effect = Exception("insufficient_funds")
        payment_service.gateway = mock_gateway

        with pytest.raises(PaymentError, match="insufficient_funds"):
            payment_service.process_payment(
                amount=Decimal("999999.00"),
                currency="JPY",
                card_token="tok_test"
            )

    def test_process_payment_invalid_amount(self, payment_service):
        """無効な金額でValueErrorが発生することを確認"""
        with pytest.raises(ValueError):
            payment_service.process_payment(
                amount=Decimal("-100.00"),
                currency="JPY",
                card_token="tok_test"
            )

Goのテスト生成

# Go標準testingパッケージのテストを生成
claude "pkg/calculator/calculator.go のテストを生成して"

# テーブル駆動テストで生成
claude "pkg/validator/validator.go のテストをテーブル駆動テストスタイルで生成して"

// Claude Codeが生成するGoテストの例（テーブル駆動テスト）
func TestCalculate(t *testing.T) {
    tests := []struct {
        name     string
        a, b     float64
        op       string
        want     float64
        wantErr  bool
    }{
        {"加算：正常ケース", 10, 5, "+", 15, false},
        {"減算：正常ケース", 10, 5, "-", 5, false},
        {"乗算：正常ケース", 10, 5, "*", 50, false},
        {"除算：正常ケース", 10, 5, "/", 2, false},
        {"除算：ゼロ除算エラー", 10, 0, "/", 0, true},
        {"不明な演算子エラー", 10, 5, "%", 0, true},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            got, err := Calculate(tt.a, tt.b, tt.op)
            if (err != nil) != tt.wantErr {
                t.Errorf("Calculate() error = %v, wantErr %v", err, tt.wantErr)
                return
            }
            if got != tt.want {
                t.Errorf("Calculate() = %v, want %v", got, tt.want)
            }
        })
    }
}

カバレッジを確認して不足テストを追加するプロセス

最も効率的なテスト改善方法は、カバレッジレポートをClaude Codeに読ませて指示するパターンです。

Step 1: カバレッジレポートを生成する

# JavaScript/TypeScript（Jest）
npx jest --coverage --coverageReporters=text

# JavaScript/TypeScript（Vitest）
npx vitest run --coverage

# Python（pytest-cov）
pytest --cov=src --cov-report=term-missing

# Go
go test ./... -coverprofile=coverage.out && go tool cover -func=coverage.out

Step 2: カバレッジレポートをClaude Codeに渡す

# カバレッジレポートを確認して不足テストを追加
claude "テストカバレッジレポートを確認して、カバレッジが低い箇所のテストを追加して"

# 特定のカバレッジ目標を指定する場合
claude "src/services/ 配下のカバレッジが80%未満のファイルを探して、不足しているテストを追加して"

# レポートを直接貼り付けて指示する場合
claude "以下のカバレッジレポートを見て、カバレッジが低い src/utils/validation.ts の未カバー行にテストを追加して：
[レポートの内容をペースト]"

Step 3: 段階的にカバレッジを向上させる

一度にすべてのテストを生成しようとすると品質が落ちることがあります。以下のように段階的に進めるのがコツです：

# まずハッピーパスのテストを生成
claude "src/services/order.ts の正常系テストをすべて生成して"

# 次にエラーケースを追加
claude "src/services/order.ts のエラーケース・例外処理のテストを追加して"

# 最後に境界値テストを追加
claude "src/services/order.ts の境界値テスト（空文字列、null、undefined、最大値・最小値）を追加して"

エッジケース・境界値テストの生成

通常、開発者がテストを書くと正常系に偏りがちです。Claude Codeはコードを静的解析して、見落としがちなエッジケースを自動的に考慮してくれます。

# エッジケースに特化したテストを生成
claude "src/utils/validation.ts の validateEmail 関数のエッジケーステストを生成して。
国際化ドメイン、特殊文字、極端に長いアドレス、Unicode文字を含む"

# 境界値テストを明示的に指定
claude "src/models/product.ts の price フィールドの境界値テストを生成して。
0円、負の値、最大整数値、小数点以下の扱い、null/undefinedを含む"

Claude Codeが生成するエッジケーステストの例：

describe('validateEmail - エッジケース', () => {
  // 有効なケース
  it('標準的なメールアドレスは有効', () => {
    expect(validateEmail('[email protected]')).toBe(true);
  });

  it('サブドメインを含むアドレスは有効', () => {
    expect(validateEmail('[email protected]')).toBe(true);
  });

  it('プラス記号を含むアドレスは有効', () => {
    expect(validateEmail('[email protected]')).toBe(true);
  });

  // 無効なケース
  it('@がないアドレスは無効', () => {
    expect(validateEmail('userexample.com')).toBe(false);
  });

  it('ドメインがないアドレスは無効', () => {
    expect(validateEmail('user@')).toBe(false);
  });

  it('空文字列は無効', () => {
    expect(validateEmail('')).toBe(false);
  });

  it('nullはfalseを返す', () => {
    expect(validateEmail(null as any)).toBe(false);
  });

  it('undefinedはfalseを返す', () => {
    expect(validateEmail(undefined as any)).toBe(false);
  });

  it('255文字を超えるアドレスは無効', () => {
    const longEmail = 'a'.repeat(250) + '@e.com';
    expect(validateEmail(longEmail)).toBe(false);
  });

  it('スペースを含むアドレスは無効', () => {
    expect(validateEmail('user @example.com')).toBe(false);
  });
});

モック・スタブの自動生成

外部サービスやデータベースに依存する処理をテストする際、モック・スタブの作成が必要です。Claude Codeはコードを解析して適切なモックを生成してくれます。

# 外部APIへの依存をモック化したテストを生成
claude "src/services/notification.ts のテストを生成して。
SendGridへのAPI呼び出しはモック化して"

# データベース依存のモックを生成
claude "src/repositories/user.repository.ts のテストを生成して。
Prismaのクエリはすべてモック化して。jest.mock()を使って"

// Claude Codeが生成するモックテストの例
import { jest } from '@jest/globals';
import { NotificationService } from './notification';

// SendGridモジュールをモック化
jest.mock('@sendgrid/mail', () => ({
  setApiKey: jest.fn(),
  send: jest.fn(),
}));

import sgMail from '@sendgrid/mail';

describe('NotificationService', () => {
  let service: NotificationService;

  beforeEach(() => {
    service = new NotificationService();
    jest.clearAllMocks();
  });

  it('メール送信が成功する', async () => {
    (sgMail.send as jest.Mock).mockResolvedValue([{ statusCode: 202 }]);

    await service.sendWelcomeEmail('[email protected]', 'テストユーザー');

    expect(sgMail.send).toHaveBeenCalledWith(
      expect.objectContaining({
        to: '[email protected]',
        subject: expect.stringContaining('ようこそ'),
      })
    );
  });

  it('API失敗時にエラーをスローする', async () => {
    (sgMail.send as jest.Mock).mockRejectedValue(
      new Error('API rate limit exceeded')
    );

    await expect(
      service.sendWelcomeEmail('[email protected]', 'テストユーザー')
    ).rejects.toThrow('API rate limit exceeded');
  });
});

CI/CDパイプラインとの連携

テストを生成したら、CI/CDパイプラインに組み込んでカバレッジを継続的に維持しましょう。

# GitHub ActionsのワークフローファイルをClaude Codeで生成
claude ".github/workflows/test.yml を作成して。
Node.js 20でJestを実行し、カバレッジが80%未満の場合はCIを失敗させる設定で"

Claude Codeが生成するGitHub Actionsの例：

# .github/workflows/test.yml
name: Test

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main, develop]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'

      - name: Install dependencies
        run: npm ci

      - name: Run tests with coverage
        run: npx jest --coverage --coverageThreshold='{"global":{"branches":80,"functions":80,"lines":80,"statements":80}}'

      - name: Upload coverage report
        uses: actions/upload-artifact@v4
        if: always()
        with:
          name: coverage-report
          path: coverage/

SES現場での活用例

ケース1: 既存コードへのテスト追加

SES案件でよくあるのが、「テストが一切ないコードベースを引き継いだ」というケースです。

# ディレクトリ全体のテスト状況を確認
claude "src/services/ ディレクトリのファイルを確認して、テストファイルがないものをリストアップして優先度順に並べて"

# 優先度の高いファイルから順番にテストを生成
claude "src/services/order.service.ts はビジネスロジックの核心なので、
まずこのファイルのテストを包括的に生成して。モックも含めて"

• 外部APIやDBに依存するサービス層から優先的にテストを追加する
• バグ修正時は必ずそのバグを再現するテストを先に書く（リグレッション防止）
• 新機能追加時にClaude Codeでテストを自動生成してからレビューに出す
• 週1回カバレッジレポートを確認して低い箇所を改善する習慣をつける

ケース2: レガシーコードのリファクタリング支援

リファクタリング前にテストを用意することで、動作保証ができます。

# リファクタリング前にテストを生成（動作保証として）
claude "legacy/payment_processor.php の現在の動作をすべてカバーするテストを生成して。
リファクタリングの安全網として使いたいので、現在の仕様を正確に反映したテストにして"

# リファクタリング後に差異がないことを確認
claude "リファクタリング後のテストを実行して、失敗したテストがあれば原因を調査して修正案を提示して"

よくある失敗パターンと対処法

失敗1: 指示が漠然としすぎている

# NG: 漠然としすぎた指示
claude "テストを書いて"

# OK: 具体的なファイルと要件を指定する
claude "src/utils/price-calculator.ts の calculateDiscountedPrice 関数のテストを生成して。
10%割引、最大割引50%の制限、割引適用前後の価格境界値を含む"

失敗2: 生成されたテストを確認せずに使う

Claude Codeが生成したテストは必ず実行して確認します。

# テスト生成後すぐに実行確認
claude "src/utils/date.ts のテストを生成して。生成後すぐに npx jest src/utils/date.test.ts を実行して結果を確認して"

失敗3: モックが実装の詳細に依存しすぎる

# モックが壊れやすい場合の修正指示
claude "生成されたテストのモックが内部実装に依存しすぎています。
外部インターフェースのみをモック化するように修正して"

FAQ

まとめ

Claude Codeによる単体テスト自動生成は、SESエンジニアの生産性を大幅に向上させます。重要なポイントをおさらいします。

テストがないコードベースを引き継いだとき、レガシーコードをリファクタリングしたいとき、新機能のカバレッジを素早く上げたいとき——Claude Codeはそのような場面で強力な武器になります。まずは小さなファイルから試してみてください。

Link1 Link2 Link3

ああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああ