패턴같은 리듬, 다른 일
대부분의 작업은 이 4박자로 흐른다
버그 수정이든 리팩터링이든, 실전 작업은 대개 계획 → 실행 → 검증 → 커밋의 흐름을 탄다. 큰 작업일수록 먼저 계획을 받아 확인하고 시작하는 게 안전하다.
Plan
계획
뭘 어떻게 바꿀지 먼저 제안받기
→
Act
실행
파일 수정·명령 실행
→
Verify
검증
테스트·결과 확인
→
Commit
커밋
변경 기록 남기기
계획 모드 (Plan)큰 작업 전에 Shift+Tab을 눌러 계획 모드로 바꾸면, Claude가 파일을 고치지 않고 계획만 제안한다. 계획을 확인·수정한 뒤 승인하면 그때부터 실행한다. (자세한 모드 전환은 05 참고)
모음자주 쓰는 작업
상황별 그대로 쓰는 지시
아래 지시문은 복사해서 바로 쓸 수 있다. 핵심은 "무엇을, 어떻게, 어디까지"를 한국어로 분명히 말하는 것.
① 코드베이스 이해
이 코드베이스 전체 구조를 개요로 설명해줘
로그인 과정을 화면부터 DB까지 순서대로 따라가줘
② 버그 수정
이런 에러가 나: [에러 메시지 붙여넣기] 원인을 찾아서 고쳐줘. 고친 뒤 관련 테스트도 돌려줘
③ 테스트 작성·수정
calculator.js의 함수들에 대한 단위 테스트를 작성해줘
테스트를 실행하고, 실패하는 것들을 고쳐줘
④ 리팩터링
utils.js를 최신 문법으로 리팩터링해줘. 단, 동작은 그대로 유지하고 리팩터 후 테스트로 확인해줘
⑤ git · PR
변경사항을 의미가 드러나는 메시지로 커밋해줘
feature/new-auth 브랜치를 만들고 지금 변경을 올려 PR을 만들어줘
⑥ 이미지로 질문
에러 화면·디자인 시안 이미지를 대화창에 끌어다 놓고 물어볼 수 있다.
이 에러 스크린샷의 원인이 뭐야? (이미지 첨부)
⑦ 깊이 생각하게 하기
어려운 문제는 "먼저 계획을 세워줘"라고 하면 Claude가 더 신중히 접근한다.
OAuth 로그인을 붙이는 가장 좋은 방법을 먼저 깊이 검토해서 계획부터 세워줘. 코드는 그 다음에
예시버그 수정이 도는 모습
한 마디가 루프를 만든다
나
테스트가 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가 루프로 알아서 돌았다.
실습따라하기
버그 하나 잡아보기
일부러 낸 버그를 Claude에게 맡기기
약 10분- 연습 폴더에서 claude 실행.
- 재료 만들기: 두 수를 더하는 함수와 그 테스트를 각각 add.py, test_add.py로 만들어줘
- 버그 심기: add.py의 더하기를 일부러 빼기로 바꿔줘 (버그 재현용) → 승인.
- 맡기기: 테스트를 돌려서 실패하면 원인을 찾아 고치고, 다시 통과시켜줘
- 지켜보기: Claude가 실행→실패 확인→수정→재실행하는 루프를 관찰.
예상 결과
✓ Claude가 테스트 실패를 확인하고, add.py의 빼기를 다시 더하기로 되돌린 뒤 테스트를 재실행해 통과시킨다.
✓ "무엇을 왜 고쳤는지"를 마지막에 요약해준다.
포인트: 나는 검증 기준(=테스트 통과)만 줬고, 반복은 Claude가 했다. 좋은 지시는 끝 상태를 분명히 말한다.
다음공식 문서 → 05 명령어·단축키·모드에서 세션을 자유자재로 다루는 슬래시 명령과 키를 정리한다. ▸ 명령어 보기
클로드코드 시작하기공식 문서 · 04 자주 쓰는 워크플로