목차

워크플로우 & 코딩 철학

Claude Code를 단순한 코드 생성기가 아닌 협업 파트너로 활용하기 위한 실전 워크플로우를 정리합니다.

1. Plan Mode 먼저

큰 변경은 반드시 Plan Mode(Shift+Tab)로 시작하세요.

절차:

  1. Plan Mode 진입 (Shift+Tab)
  2. Claude가 계획을 제시
  3. 계획을 리뷰하고 피드백
  4. Accept Mode로 전환하여 실행

Plan 없이 바로 실행하면 엉뚱한 방향으로 대량 수정이 발생할 위험이 있습니다. 특히 아키텍처 변경이나 다중 파일 수정 시 반드시 Plan Mode를 거치세요.

2. TDD 기반 스마트 코딩

핵심은 작은 루프를 빠르게 반복하는 것입니다.

작은 변경 → 테스트 → 린트 → 커밋 → 반복

이 루프를 지키면 문제가 생겨도 마지막 커밋으로 즉시 롤백할 수 있습니다. 한 번에 큰 변경을 시도하지 마세요.

3. Thinking 로그 읽기

Claude의 thinking 로그를 무시하지 마세요.

  • Claude가 어떤 가정을 세우고 있는지 thinking 로그에서 확인할 수 있습니다
  • 잘못된 가정을 발견하면 즉시 Escape로 중단하세요
  • 잘못된 가정 위에 쌓인 코드는 전부 쓸모없습니다

코드가 생성되는 속도에 감탄하기보다, thinking 로그에서 방향이 맞는지 먼저 확인하는 습관을 들이세요.

4. 다른 AI에게 비평 받기

Claude의 작업 결과를 다른 AI에게 검증받는 전략입니다.

  1. /export로 현재 대화를 내보내기
  2. ChatGPT 또는 Gemini에게 전달
  3. 다음과 같이 요청:
이 대화를 분석해서, Claude가 놓치고 있는 것이나
잘못된 접근이 있으면 지적해줘
Custom Skill로 자동화하기

/review-with-gpt 같은 Custom Skill을 만들면 원커맨드로 자동화할 수 있습니다. 대화 내보내기부터 다른 AI에게 분석 요청까지 하나의 명령으로 처리됩니다.

5. 에러 로그 그대로 붙여넣기

에러가 발생하면 해석하지 말고 로그를 통째로 전달하세요.

  • 여러분이 해석하면 오히려 중요한 정보가 빠질 수 있습니다
  • Claude는 스택 트레이스 분석에 능합니다
  • 로그 전체를 붙여넣는 것이 가장 정확한 디버깅으로 이어집니다

“이런 에러가 나요”보다 에러 로그 전체를 붙여넣는 것이 훨씬 효과적입니다.

6. 로컬 TODO.md 활용

프로젝트 루트에 TODO.md를 만들어 태스크를 추적하세요.

실전 흐름:

  1. TODO.md에 할 일 목록 작성
  2. Claude에게 “TODO.md 읽고 첫 번째부터 시작해”라고 지시
  3. Agent Teams로 병렬 처리 가능
  4. 완료 후 “TODO.md 업데이트해줘”로 진행 상황 반영

여러 세션에 걸쳐 작업 연속성을 유지할 수 있는 가장 간단한 방법입니다.

7. WAT 프레임워크

Claude Code 활용의 핵심 프레임워크입니다.

요소 설명 핵심 포인트
Workflows plain English로 작업 흐름 정의 10분 투자로 수시간의 삽질을 줄임
Agents Self-healing + Sub-agent 활용 병렬 처리로 속도 향상
Tools 작고 원자적인 도구들 조합 큰 스크립트보다 작은 스크립트 여러 개
종합 예시: "블로그에 댓글 기능 추가하기"를 WAT로 풀기

Workflows - 작업 흐름을 plain English로 정의:

1. 댓글 데이터 모델 설계
2. API 엔드포인트 구현
3. 프론트엔드 컴포넌트 개발
4. 통합 테스트 작성

Agents - 병렬 처리 설계:

  • Agent 1: 백엔드 API + 데이터 모델
  • Agent 2: 프론트엔드 댓글 컴포넌트
  • Agent 3: 테스트 코드 작성

Tools - 작은 단위로 분리:

  • DB 마이그레이션 스크립트
  • API 라우트 핸들러
  • 컴포넌트 단위 테스트
  • E2E 테스트 스크립트