클로드 코드의 큰 강점은 처음 보는 프로젝트도 스스로 탐색해서 이해한다는 점입니다. 파일을 하나하나 복사해서 보여줄 필요 없이, "어디에 있는지 찾아봐"라고 시키면 됩니다. 새 팀에 합류했을 때 코드를 파악하는 용도로도 훌륭합니다.
탐색시키기 좋은 질문들
- "이 프로젝트의 전체 구조를 폴더별로 설명해 줘"
- "로그인 처리는 어느 파일에서 하고 있어? 흐름을 순서대로 설명해 줘"
- "이 함수를 사용하는 곳을 전부 찾아 줘"
- "결제 관련 코드에서 에러 처리가 빠진 곳이 있는지 점검해 줘"
파일을 직접 지정하는 법: @
어느 파일인지 이미 알고 있다면, 클로드가 찾아 헤매게 두지 말고 직접 알려주는 것이 빠르고 정확합니다. 입력창에서 @를 입력하면 파일을 검색해서 붙일 수 있습니다.
@로 파일을 지정한 지시 예시
@src/components/LoginForm.tsx 이 컴포넌트에서 비밀번호 유효성 검사 부분만 수정해 줘. 최소 8자, 영문+숫자 조합을 요구하도록. 다른 부분은 건드리지 마.좋은 지시 vs 나쁜 지시
클로드 코드의 결과 품질은 대부분 지시의 품질에서 결정됩니다. 같은 작업도 어떻게 말하느냐에 따라 결과가 하늘과 땅 차이입니다.
| 나쁜 지시 | 좋은 지시 | 차이점 |
|---|---|---|
| "버그 고쳐 줘" | "로그인 후 마이페이지로 이동하면 흰 화면이 뜨는 버그를 고쳐 줘. 콘솔 에러는 이거야: (에러 붙여넣기)" | 증상, 재현 경로, 에러 정보 제공 |
| "디자인 예쁘게 해 줘" | "@src/pages/Home.tsx 히어로 섹션의 버튼을 브랜드 컬러 #FF5C34로 바꾸고, 모바일에서 세로로 쌓이게 해 줘" | 대상 파일, 구체적 값, 조건 명시 |
| "코드 정리해 줘" | "utils.ts에서 안 쓰는 함수를 찾아서 목록을 먼저 보여줘. 내가 확인한 뒤에 삭제하자" | 범위 한정 + 확인 절차 포함 |
요약하면 좋은 지시는 (1) 대상이 어디인지, (2) 원하는 결과가 무엇인지, (3) 하지 말아야 할 것이 무엇인지를 담습니다. 클로드를 '눈치 빠른 신입'이라고 생각하고, 신입에게 업무를 넘기듯 구체적으로 말해 주세요.
큰 작업일수록 "바로 고치지 말고, 먼저 관련 코드를 읽고 이해한 내용을 요약해 줘"라고 한 단계를 추가하세요. 클로드가 잘못 이해했다면 코드를 고치기 전에 바로잡을 수 있어 시행착오가 크게 줄어듭니다.
"전체 코드를 다 리팩토링해 줘" 같은 범위 없는 지시는 피하세요. 한 번에 수십 개 파일이 바뀌면 검토가 불가능해집니다. 작업은 항상 '검토할 수 있는 크기'로 쪼개서 시키는 것이 원칙입니다.