Claude Code로 API 테스트 자동화: QA 실전 가이드

Claude Code로 API 테스트 자동화 실천하기

API 품질을 보증하기 위해서는 포괄적인 테스트가 필수적입니다. Claude Code를 활용하면 테스트 케이스 설계부터 모크 생성, CI 통합까지 한 번에 자동화할 수 있습니다.

테스트 케이스 설계

REST API의 CRUD 테스트

> Vitest + supertest로 사용자 API의 CRUD 테스트를 만들어줘.
> 정상, 비정상, 경계값 테스트를 모두 커버해줘.

// tests/api/users.test.ts
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
import request from 'supertest';
import { app } from '../../src/app';
import { resetDatabase, seedUsers } from '../helpers/db';

describe('Users API', () => {
  beforeEach(async () => {
    await resetDatabase();
    await seedUsers();
  });

  describe('GET /api/users', () => {
    it('사용자 목록을 가져올 수 있다', async () => {
      const res = await request(app)
        .get('/api/users')
        .expect(200);

      expect(res.body.data).toBeInstanceOf(Array);
      expect(res.body.data.length).toBeGreaterThan(0);
      expect(res.body.data[0]).toHaveProperty('id');
      expect(res.body.data[0]).toHaveProperty('name');
      expect(res.body.data[0]).not.toHaveProperty('password');
    });

    it('페이지네이션이 올바르게 동작한다', async () => {
      const res = await request(app)
        .get('/api/users?page=1&limit=5')
        .expect(200);

      expect(res.body.data.length).toBeLessThanOrEqual(5);
      expect(res.body.meta).toHaveProperty('totalPages');
      expect(res.body.meta).toHaveProperty('currentPage', 1);
    });
  });

  describe('POST /api/users', () => {
    it('새 사용자를 생성할 수 있다', async () => {
      const newUser = {
        name: '테스트 사용자',
        email: '[email protected]',
        password: 'SecurePass123!',
      };

      const res = await request(app)
        .post('/api/users')
        .send(newUser)
        .expect(201);

      expect(res.body.data.name).toBe(newUser.name);
      expect(res.body.data.email).toBe(newUser.email);
    });

    it('잘못된 이메일 주소로는 400을 반환한다', async () => {
      const res = await request(app)
        .post('/api/users')
        .send({ name: 'Test', email: 'invalid', password: 'Pass123!' })
        .expect(400);

      expect(res.body.errors).toBeDefined();
    });

    it('중복 이메일 주소로는 409를 반환한다', async () => {
      await request(app)
        .post('/api/users')
        .send({ name: 'User1', email: '[email protected]', password: 'Pass123!' });

      await request(app)
        .post('/api/users')
        .send({ name: 'User2', email: '[email protected]', password: 'Pass456!' })
        .expect(409);
    });
  });
});

모크와 스텁 생성

외부 API 의존성 테스트

> MSW를 사용해서 Stripe 결제 API의 모크를 만들어줘.

// tests/mocks/handlers.ts
import { http, HttpResponse } from 'msw';

export const handlers = [
  http.post('https://api.stripe.com/v1/charges', () => {
    return HttpResponse.json({
      id: 'ch_test_123',
      amount: 1000,
      currency: 'jpy',
      status: 'succeeded',
    });
  }),

  http.post('https://api.stripe.com/v1/refunds', () => {
    return HttpResponse.json({
      id: 're_test_456',
      amount: 1000,
      status: 'succeeded',
    });
  }),
];

컨트랙트 테스트

API 사양과 구현의 정합성을 검증하는 컨트랙트 테스트도 Claude Code로 생성할 수 있습니다. OpenAPI 스키마와 응답을 자동 비교하는 테스트를 구축할 수 있습니다.

성능 테스트

> k6를 사용한 API 부하 테스트 스크립트를 만들어줘.
> 단계적 부하 증가 시나리오로 해줘.

import http from 'k6/http';
import { check, sleep } from 'k6';

export const options = {
  stages: [
    { duration: '1m', target: 50 },
    { duration: '3m', target: 50 },
    { duration: '1m', target: 100 },
    { duration: '3m', target: 100 },
    { duration: '1m', target: 0 },
  ],
  thresholds: {
    http_req_duration: ['p(95)<500'],
    http_req_failed: ['rate<0.01'],
  },
};

정리

Claude Code를 활용하면 API 테스트 설계부터 구현, CI 통합까지 한 번에 자동화할 수 있습니다. 테스트 전략 가이드와 CI/CD 파이프라인 구축도 함께 참고하세요.

API 테스트에 대한 자세한 내용은 Vitest 공식 문서를 참고하세요.