공식 문서 · 04

자주 쓰는 워크플로

코드 이해·버그 수정·테스트·리팩터링·git까지. 복사해서 바로 쓰는 지시 모음.

성격 실전 패턴형식 복사용 지시소요 약 12분
패턴같은 리듬, 다른 일

대부분의 작업은 이 4박자로 흐른다

버그 수정이든 리팩터링이든, 실전 작업은 대개 계획 → 실행 → 검증 → 커밋의 흐름을 탄다. 큰 작업일수록 먼저 계획을 받아 확인하고 시작하는 게 안전하다.

계획 모드 (Plan)큰 작업 전에 Shift+Tab을 눌러 계획 모드로 바꾸면, Claude가 파일을 고치지 않고 계획만 제안한다. 계획을 확인·수정한 뒤 승인하면 그때부터 실행한다. (자세한 모드 전환은 05 참고)
모음자주 쓰는 작업

상황별 그대로 쓰는 지시

아래 지시문은 복사해서 바로 쓸 수 있다. 핵심은 "무엇을, 어떻게, 어디까지"를 한국어로 분명히 말하는 것.

① 코드베이스 이해

이 코드베이스 전체 구조를 개요로 설명해줘
로그인 과정을 화면부터 DB까지 순서대로 따라가줘

② 버그 수정

이런 에러가 나: [에러 메시지 붙여넣기]
원인을 찾아서 고쳐줘. 고친 뒤 관련 테스트도 돌려줘

③ 테스트 작성·수정

calculator.js의 함수들에 대한 단위 테스트를 작성해줘
테스트를 실행하고, 실패하는 것들을 고쳐줘

④ 리팩터링

utils.js를 최신 문법으로 리팩터링해줘. 단, 동작은 그대로 유지하고 리팩터 후 테스트로 확인해줘

⑤ git · PR

변경사항을 의미가 드러나는 메시지로 커밋해줘
feature/new-auth 브랜치를 만들고 지금 변경을 올려 PR을 만들어줘

⑥ 이미지로 질문

에러 화면·디자인 시안 이미지를 대화창에 끌어다 놓고 물어볼 수 있다.

이 에러 스크린샷의 원인이 뭐야? (이미지 첨부)

⑦ 깊이 생각하게 하기

어려운 문제는 "먼저 계획을 세워줘"라고 하면 Claude가 더 신중히 접근한다.

OAuth 로그인을 붙이는 가장 좋은 방법을 먼저 깊이 검토해서 계획부터 세워줘. 코드는 그 다음에
예시버그 수정이 도는 모습

한 마디가 루프를 만든다

claude — 대화
테스트가 3개 깨졌어. 원인 찾아서 고치고 다시 돌려줘
CLAUDE

테스트를 실행해 원인을 확인하겠습니다.

npm test 실행
✗ 3 failing — TypeError: total is not a function
cart.js 확인 → total 오타(toal) 발견
cart.js 수정
npm test 재실행
All 27 tests passing

오타 하나 때문이었습니다. 수정 후 전체 테스트 통과. 커밋할까요?

내가 한 건 한 문장이다. 실행→에러 확인→원인 파악→수정→재실행은 Claude가 루프로 알아서 돌았다.

실습따라하기

버그 하나 잡아보기

실습 3

일부러 낸 버그를 Claude에게 맡기기

약 10분
  1. 연습 폴더에서 claude 실행.
  2. 재료 만들기: 두 수를 더하는 함수와 그 테스트를 각각 add.py, test_add.py로 만들어줘
  3. 버그 심기: add.py의 더하기를 일부러 빼기로 바꿔줘 (버그 재현용) → 승인.
  4. 맡기기: 테스트를 돌려서 실패하면 원인을 찾아 고치고, 다시 통과시켜줘
  5. 지켜보기: Claude가 실행→실패 확인→수정→재실행하는 루프를 관찰.
예상 결과

Claude가 테스트 실패를 확인하고, add.py의 빼기를 다시 더하기로 되돌린 뒤 테스트를 재실행해 통과시킨다.
"무엇을 왜 고쳤는지"를 마지막에 요약해준다.
포인트: 나는 검증 기준(=테스트 통과)만 줬고, 반복은 Claude가 했다. 좋은 지시는 끝 상태를 분명히 말한다.

다음공식 문서 → 05 명령어·단축키·모드에서 세션을 자유자재로 다루는 슬래시 명령과 키를 정리한다. ▸ 명령어 보기
클로드코드 시작하기공식 문서 · 04 자주 쓰는 워크플로