설치는 끝났고 커서만 깜빡이고 있다면, 다음 순서대로 30분만 써 보세요.
1단계 — 저장소를 설명하게 한다 (5분)
이 프로젝트의 구조를 설명해줘. 진입점, 주요 모듈, 데이터 흐름 순으로.여기서 나온 설명이 실제와 얼마나 맞는지 확인하면, Claude가 이 저장소를 얼마나 이해했는지 가늠할 수 있습니다.
2단계 — 되돌리기 쉬운 작업을 시킨다 (10분)
좋은 첫 과제의 조건은 세 가지입니다. 범위가 좁고, 검증 방법이 명확하고, 되돌리기 쉬울 것.
- 오타·주석 정리
- 테스트가 이미 있는 함수의 리팩터링
- 타입 오류 하나 수정
3단계 — 검증까지 맡긴다 (15분)
사용자 이메일 검증 로직에 빈 문자열 케이스가 빠져 있어.
테스트를 먼저 추가하고, 실패하는 걸 확인한 다음 구현을 고쳐줘.테스트 → 실패 확인 → 수정 → 통과 확인의 흐름을 지시에 담으면 결과 품질이 눈에 띄게 올라갑니다.
잘 먹히는 지시 vs 그렇지 않은 지시
| 잘 안 되는 지시 | 잘 되는 지시 |
|---|---|
| "코드 개선해줘" | "api/user.ts의 중복된 검증 로직을 하나로 합쳐줘" |
| "버그 고쳐줘" | "로그인 후 새로고침하면 세션이 풀려. 원인부터 찾아줘" |
| "테스트 짜줘" | "formatPrice의 경계값(0, 음수, 소수점) 테스트를 추가해줘" |
핵심은 목표가 아니라 관찰 가능한 상태를 말하는 것입니다. "무엇이 어떻게 되면 성공인지"를 알려주면 스스로 검증합니다.
세션 관리 요령
- 긴 작업은 나눠서 — 한 세션에서 너무 많은 주제를 다루면 맥락이 흐려집니다.
- 중간에 방향이 틀어지면 바로 잡기 — 잘못된 전제로 계속 가는 것보다 즉시 지적하는 게 훨씬 쌉니다.
- 커밋을 자주 — 되돌릴 지점을 만들어 두면 과감하게 시킬 수 있습니다.
처음 며칠은 "내가 직접 하면 10분인 일"을 일부러 시켜 보세요. 결과를 바로 판단할 수 있어 신뢰 구간을 빠르게 만들 수 있습니다.
입문실전프롬프트
팀에 Claude Code를 도입하려면 실제 코드베이스에 맞춘 설계가 필요합니다.
기업교육 · 도입 상담하기