대화로 코드 다루기

Claude Code의 핵심 사용법은 단순합니다. 하고 싶은 일을 자연어로 말하는 것입니다. 다만 요청을 어떻게 쓰느냐에 따라 결과의 품질이 크게 달라집니다.

학습 목표

• 코드를 읽게 하고 수정하게 하는 기본 흐름을 익힌다.
• 좋은 요청과 모호한 요청의 차이를 이해한다.
• 변경 사항을 확인하는 방법을 안다.

코드 이해부터 시작하기

낯선 프로젝트라면 먼저 파악을 요청하는 것이 좋습니다.

> src/lib/auth 폴더가 인증을 어떻게 처리하는지 설명해줘

Claude Code가 관련 파일을 읽고 흐름을 요약해 줍니다.

수정 요청하기

수정은 구체적으로 요청할수록 좋습니다.

> 로그인 함수에서 비밀번호가 8자 미만이면 에러를 던지도록 검증을 추가해줘

Claude Code는 해당 함수를 찾아 편집한 뒤, 무엇을 바꿨는지 보여 줍니다.

좋은 요청 vs 모호한 요청

모호한 요청	더 나은 요청
코드 개선해줘	이 컴포넌트의 중복된 상태 관리를 useReducer로 합쳐줘
버그 고쳐줘	장바구니 합계가 할인 적용 후 음수가 되는 버그를 고쳐줘
테스트 추가해줘	formatPrice 함수에 0원·음수·소수 케이스 단위 테스트를 추가해줘

목표와 제약을 함께 알려 주면 의도에 맞는 결과를 얻을 가능성이 높아집니다.

변경 사항 확인하기

Claude Code는 파일을 수정할 때 어떤 부분을 바꿨는지 보여 줍니다. 작업 후에는 직접 확인하는 습관을 들이세요.

git diff

마음에 들지 않으면 그대로 되돌리거나, 후속 요청으로 수정 방향을 잡아 주면 됩니다.

> 방금 변경에서 에러 메시지를 한국어로 바꿔줘

요약

Claude Code는 자연어 요청으로 코드를 읽고 수정합니다. 목표와 제약을 구체적으로 적을수록 결과가 좋아지고, git diff로 변경을 확인하며 후속 요청으로 다듬어 가는 것이 기본 흐름입니다.