Claude 기반 TDD로 더 깨끗한 코드 작성하기

구현하고자 하는 동작을 설명합니다: "사용자는 이메일로 비밀번호를 재설정할 수 있어야 한다. 엔드포인트는 이메일이 존재하는지 검증하고, 시간 제한이 있는 토큰을 생성하고, 재설정 링크를 보내야 한다." Claude Code는 어떤 구현도 존재하지 않는 상태에서 예상되는 HTTP 응답, 토큰 생성, 이메일 발송을 확인하는 테스트를 먼저 작성합니다. 올바른 이유(함수 없음, 구문 오류가 아님)로 테스트가 실패하는지 확인하기 위해 테스트를 실행합니다.

그다음 Claude Code는 테스트를 통과시키는 가장 단순한 구현을 작성합니다. 과도하게 설계하지 않고, 테스트 어설션을 만족시키기에 충분한 만큼만 코드를 작성합니다. 이 원칙이 TDD가 빛을 발하는 부분입니다. 테스트가 계약을 정의하고, 구현이 그것을 이행합니다. Claude Code는 구현을 작성한 후 테스트 스위트를 실행해 새 테스트가 통과하고 기존 테스트가 깨지지 않았는지 확인합니다.

통과하는 테스트가 안전망이 되어주므로, Claude Code에게 구현을 정리해달라고 요청합니다: 헬퍼 함수 추출, 변수 이름 개선, 중복 줄이기, 성능 최적화 등입니다. 각 리팩터링 단계 후 Claude Code는 테스트를 다시 실행합니다. 테스트가 실패하면 리팩터링이 동작 변화를 일으킨 것이고, Claude Code는 되돌리거나 조정합니다. 이 단계는 포괄적인 테스트로 뒷받침되는 깨끗하고 유지보수 가능한 코드를 만들어냅니다.

먼저 사용자 관점에서 기능이 무엇을 해야 하는지 Claude Code에게 알려주세요. "가격과 백분율을 받는 calculateDiscount라는 함수를 만들어라" 대신, "프리미엄 멤버십 고객은 주문 총액의 20% 할인을 받아야 하지만, 할인이 50달러를 넘지는 않아야 한다"라고 말하세요. 이 동작 기반 설명은 비즈니스 규칙을 검증하는 테스트를 만들어내기 때문에 더 나은 테스트를 생성합니다.

Claude Code는 여러 테스트 케이스가 담긴 테스트 파일을 작성합니다: 정상 경로(프리미엄 사용자, 유효한 할인), 엣지 케이스(할인이 50달러 한도를 초과, 가격이 0인 주문), 오류 케이스(비프리미엄 사용자, 음수 가격)입니다. Claude Code가 기능을 구현하게 하기 전에 이 테스트들을 검토하세요. 테스트 케이스가 당신의 명세를 정의하므로, 빠진 케이스가 있다면 지금 추가하세요. 운영 환경에서 빠진 엣지 케이스를 발견하는 것보다 테스트 케이스를 추가하는 것이 훨씬 저렴합니다.

테스트를 승인하면 Claude Code에게 기능을 구현하라고 지시하세요. 코드를 작성하고, 테스트를 실행하고, 결과를 보여줍니다. 모든 테스트가 첫 시도에 통과하면 리팩터링으로 넘어갈 수 있습니다. 일부 테스트가 실패하면 Claude Code는 실패 출력을 읽고 구현을 조정합니다. 이 사이클은 보통 한두 번의 반복으로 완료되며, 수동으로 작성-실행-디버그하는 루프보다 훨씬 빠릅니다.

개발자들이 TDD를 건너뛰는 가장 큰 이유는 테스트 작성이 느리고 지루하게 느껴지기 때문입니다. 특히 설정 코드, 모킹, 반복적인 어설션이 그렇습니다. Claude Code는 이 마찰을 완전히 제거합니다. 한 문장으로 무슨 일이 일어나야 하는지 설명하면 Claude Code가 올바른 import, fixture, mock, 엣지 케이스 커버리지를 갖춘 완전한 테스트 파일을 생성합니다. 인지 부담이 "이 의존성을 어떻게 모킹할까"에서 "어떤 동작이 중요한가"로 옮겨갑니다.

Claude Code가 동작 설명으로부터 테스트를 작성할 때, 개발자들이 자주 잊어버리는 엣지 케이스를 생성합니다: 빈 입력, 경계값, 동시 접근, null 처리, 잘못된 상태 전환 등입니다. 수백만 개의 테스트 스위트를 봤기 때문에 어떤 엣지 케이스가 흔히 버그를 일으키는지 알고 있어서 이렇게 할 수 있습니다. 모든 케이스를 스스로 생각하지 않아도 더 철저한 테스트 커버리지를 얻을 수 있습니다.

TDD를 유지하기가 어려운 이유는 테스트를 건너뛰고 바로 코드를 작성하려는 유혹이 항상 있기 때문입니다. Claude Code를 사용하면 테스트를 먼저 작성하는 것이 구현을 먼저 작성하는 것보다 실제로 더 빠르기 때문에 건너뛸 이유가 없습니다. Claude Code가 각 단계를 강제하기 때문에 레드-그린-리팩터 사이클이 자연스러워집니다: 테스트를 작성하고, 실패를 확인하기 위해 실행하고, 코드를 구현하고, 성공을 확인하기 위해 테스트를 다시 실행합니다.

물론입니다. Claude Code는 기존 테스트 인프라, 테스트 프레임워크, fixture, mock, factory, 컨벤션을 읽고, 기존 스위트와 자연스럽게 어울리는 새 테스트를 작성합니다. 프로젝트가 conftest.py fixture를 사용하는 pytest를 쓴다면, Claude Code는 그 fixture를 사용하는 테스트를 생성합니다. React 프로젝트가 커스텀 render 유틸리티를 가진 Testing Library를 쓴다면, Claude Code는 그 패턴을 따릅니다. 처음부터 다시 시작할 필요가 없습니다.

커버리지 비율은 커버리지 품질보다 덜 중요합니다. Claude Code는 라인 커버리지보다 동작 커버리지에 집중하도록 도와줍니다. 기능을 (어떻게가 아니라) 무엇을 해야 하는지로 설명하면, 생성된 테스트가 자연스럽게 중요한 경로를 다룹니다. 그렇더라도 Claude Code는 기존 커버리지 보고서를 분석해 테스트되지 않은 분기를 식별하고, 간극을 메우는 타깃형 테스트를 작성할 수 있습니다. 100% 라인 커버리지가 아니라 비즈니스 로직과 오류 처리를 철저히 다루는 것을 목표로 하세요.

네. Claude Code는 여러 컴포넌트를 함께 동작시키는 통합 테스트를 작성합니다. 실제 테스트 데이터베이스에 접근하는 API 엔드포인트, 모킹된 API 응답과 상호작용하는 React 컴포넌트, 여러 의존성을 조율하는 서비스 레이어 등입니다. 테스트 데이터베이스 설정과 해제, 테스트 fixture, mock 서버 구성을 처리합니다. API 통합 테스트의 경우, 인증, 검증, 오류 응답을 포함한 전체 요청-응답 사이클을 검증하는 테스트를 생성합니다.

그린(동작하는 구현으로 테스트가 통과) 단계 후에는 리팩터 단계로 들어갑니다. Claude Code에게 구현 개선, 함수 추출, 중복 줄이기, 명명 개선, 성능 최적화를 요청하세요. Claude Code는 변경을 수행하고 각 리팩터링 단계 후 테스트 스위트를 다시 실행합니다. 테스트가 실패하면 리팩터링이 동작을 바꿨다는 뜻이며, Claude Code는 리팩터링을 수정하거나 검토를 위해 동작 변화를 표시합니다. 테스트는 이 과정 전반에서 안전망 역할을 합니다.

기능 동작을 자연어로 설명하고, Claude Code가 실패하는 테스트를 작성하게 한 다음(레드), 테스트를 통과시키는 코드를 구현해달라고 요청하고(그린), 마지막으로 리팩터링을 요청하세요(리팩터). Claude Code를 활용한 이 레드-그린-리팩터 사이클은 Claude가 테스트와 구현을 모두 작성하는 동안 당신은 요구사항을 정의하는 데 집중할 수 있어, 수동 TDD보다 더 빠릅니다.

네. Claude Code는 각 테스트를 작성한 후와 각 구현 변경 후에 테스트 스위트를 실행합니다. 테스트 출력을 읽고, 실패를 식별하고, 테스트가 통과할 때까지 반복합니다. 파일 수정마다 린터와 타입 체커를 자동으로 실행하는 훅을 설정해 완전히 자동화된 품질 게이트를 만들 수도 있습니다.