QA 자동화에 Claude Code를 사용하는 방법

QA 워크플로에서 Claude Code가 할 수 있는 일

• 프로젝트의 기존 스타일과 프레임워크에 맞춰 모듈의 단위 테스트를 생성합니다.
• 버그 보고서를 실패하는 회귀 테스트로 변환한 다음, 테스트가 통과할 때까지 코드를 수정합니다.
• 기존 테스트 모음에 누락된 경계 사례를 추가합니다(빈 입력, 유니코드, 시간 초과, 동시성).
• Playwright나 Cypress용 엔드투엔드 테스트를 작성하고, 브라우저 MCP 서버를 통해 실제 실행 중인 앱을 대상으로 테스트를 실행합니다.
• 실패한 CI 실행을 진단합니다. 로그를 읽고 원인을 찾아 수정안을 제안하거나 적용합니다.
• 풀 리퀘스트에서 테스트되지 않은 경로를 검토하고 발견한 내용을 게시합니다.

할 수 없는 일은 무엇이 중요한지 판단하는 것입니다. 유용한 검증이 전혀 없는 테스트로도 기꺼이 100%의 라인 커버리지를 달성합니다. 결과물의 품질은 지시의 품질에 달려 있습니다. 아래 설정이 프롬프트보다 메모리 파일부터 시작하는 이유입니다.

설정: 테스트 실행 방법 알려 주기

# CLAUDE.md
## Testing
- Unit tests: `npm test` (vitest). Files live next to the source as `*.test.ts`.
- E2E: `npx playwright test`, specs in `e2e/`. Needs the dev server: `npm run dev`.
- Always run the relevant test file after editing it. Do not mark a test `.skip` to make the suite pass.
- Prefer table-driven tests; one behaviour per `it()`; no snapshot tests for logic.

이 블록은 추측하는 에이전트와 기여 가이드를 읽은 동료처럼 행동하는 에이전트를 가르는 차이입니다. 원하는 검증 스타일과 절대 원하지 않는 작업도 추가하세요(데이터베이스 모킹, 테스트 건너뛰기, 잘못된 출력에 맞춰 픽스처 수정하기).

명세나 버그 보고서에서 테스트 생성하기

> Read src/billing/prorate.ts. Write vitest tests covering the documented behaviour in
  docs/billing.md, including month boundaries, leap years and a zero-day period.
  Run them; if any fail, tell me whether the code or the doc is wrong before changing code.

> Bug #412: uploading a 0-byte file returns 500 instead of 400. Write a failing test that
  reproduces it, then fix the handler so the test passes. Do not touch other tests.

각 프롬프트의 마지막 문장이 중요합니다. "코드와 문서 중 어느 쪽이 잘못됐는지 알려 줘"는 방금 만들어 낸 테스트에 맞춰 동작을 몰래 변경하지 못하게 합니다. "다른 테스트는 건드리지 마"는 테스트를 통과시키려고 관련 없는 검증문을 수정하는 전형적인 실패를 막습니다.

실행·수정 반복

테스트를 작성한 뒤 실행하도록 요청하세요. 실패 출력을 읽고 조정한 다음 다시 실행하며, 보통 두세 번 반복합니다. 권한 요청을 주의해서 보세요. 다음을 허용하세요. Bash(npm test*) 및 Bash(npx playwright test*) 다음을 사용해 한 번 허용하세요. /permissions 반복 과정이 중단되지 않도록 하고, 파괴적인 명령은 계속 승인을 요청하도록 설정하세요. 하나의 테스트에서 네다섯 번 넘게 반복하면 중단하세요. 테스트가 잘못된 내용을 검증하고 있을 가능성이 높으므로 사람이 살펴봐야 합니다.

CI에서 헤드리스로 실행하기

# generate regression tests for whatever changed, non-interactively
git diff --name-only origin/main...HEAD | grep -E 'src/.*\.ts$' > changed.txt
claude -p "For each file in changed.txt, add or extend tests for the changed behaviour. Run them." \
  --allowedTools "Read,Edit,Write,Bash(npm test*),Bash(git diff*)" \
  --max-turns 25 --output-format json > claude-qa.json

출력 모드는 질문을 전혀 하지 않으므로, 수행할 수 있는 모든 작업을 다음으로 미리 승인해야 합니다. --allowedTools및 --max-turns 반복 횟수를 제한합니다. ANTHROPIC_BASE_URL=https://aiprimetech.io과 게이트웨이 키를 CI 시크릿으로 설정하면 실행 비용이 게이트웨이 잔액이나 무제한 요금제에 반영됩니다. 결과를 브랜치에 커밋하고 사람이 검토하게 하세요. 생성된 테스트를 자동으로 병합하지 마세요.

모든 풀 리퀘스트에서 실행: GitHub Action

Claude Code GitHub Action은 누군가 댓글을 달면 같은 반복 과정을 실행합니다. @claude 풀 리퀘스트에서 실행하거나, 풀 리퀘스트가 열릴 때 자동으로 실행합니다. 워크플로에 QA 관점의 지시문인 "이 PR에서 테스트되지 않은 분기를 검토하고 해당 분기에 대한 테스트를 추가하세요"를 넣으면 검토자가 살펴보기 전에 모든 PR을 일차적으로 점검할 수 있습니다. GitHub 가이드에서는 앱 설치, 워크플로 파일, 비용을 다룹니다.

Playwright를 사용한 엔드 투 엔드 테스트

두 가지 수준으로 활용할 수 있습니다. 브라우저 없이 사용하면 페이지 구조와 사용자의 설명을 바탕으로 Playwright 테스트 명세를 작성하고, 사용자가 이를 실행합니다. Playwright MCP 서버를 연결하면(/mcp), 앱을 열고, 클릭하며 흐름을 따라가고, DOM을 읽은 뒤 관찰한 내용에 맞는 테스트를 작성할 수 있습니다. 선택자의 신뢰성은 훨씬 높아지지만 세션은 더 길어집니다. 각 브라우저 세션에서는 하나의 흐름만 다루고, 세션 사이에는 /clear 을 실행하세요. 스크린샷과 DOM 덤프는 크기가 크며 매 턴마다 다시 전송됩니다.

QA 실행 비용 절감하기

• Sonnet 등급을 사용하세요. 테스트 생성에 Opus가 필요한 경우는 드뭅니다. 로그 분류에는 Haiku 등급으로 충분합니다.
• 한 번에 하나의 모듈이나 버그만 대상으로 지정하세요. "저장소 전체에 테스트를 추가하세요"는 가장 비용이 많이 드는 프롬프트입니다.
• /compact 을 각 테스트 파일이 반영된 후에 실행하세요. 읽었던 실패 로그는 더 이상 유용하지 않습니다.
• CI에서는 다음으로 상한을 설정하세요: --max-turns 그리고 변경된 파일에 대해서만 실행하세요.
• 매일 이를 실행하는 팀이라면 정액 무제한 요금제를 통해 토큰당 비용을 따질 필요가 완전히 없어집니다.

모든 무제한 요금제 →

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

자주 묻는 질문

AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.