파일 조작 배우기

Claude Code의 핵심 능력은 파일을 직접 다루는 것입니다. 이 레슨에서는 그 조작을 안전하게 지시하는 법을 배웁니다.

읽기

@README.md 이 문서에서 설치 방법 부분만 요약해줘.

파일 전체를 읽되 필요한 부분만 요약하게 하면 대화가 깔끔해집니다.

이미지나 PDF도 읽을 수 있습니다. 디자인 시안을 주고 "이대로 구현해줘"라고 할 수도 있습니다.

새로 만들기

docs/api-guide.md 파일을 만들어줘. 
현재 app/api 폴더의 라우트를 전부 훑어서 
엔드포인트별 메서드·파라미터·응답 형식을 표로 정리해줘.

어디에, 무엇을 근거로, 어떤 형식으로를 명시하는 것이 핵심입니다.

고치기

수정 지시는 구체적일수록 정확합니다.

여러 파일을 한꺼번에

프로젝트 전체에서 `getUserData`를 `fetchUserProfile`로 바꿔줘.
호출부, 타입 정의, 테스트, 문서까지 전부.

이런 작업은 사람이 하면 빠뜨리기 쉽지만 Claude는 검색으로 전부 찾아냅니다.

안전 습관 세 가지

1. 작업 전 커밋

git add -A && git commit -m "작업 전 상태"

되돌릴 지점이 있으면 훨씬 과감하게 시킬 수 있습니다.

2. 변경 내용 확인

git diff

승인 창에서 대충 넘기지 말고, 작업이 끝난 뒤 한 번은 전체 diff를 보세요.

3. 건드리면 안 되는 곳 명시

`.env`와 `migrations/` 폴더는 절대 수정하지 마.

CLAUDE.md에 적어 두면 매번 말할 필요가 없습니다.

흔한 실수

• 범위를 안 정하고 "전부 정리해줘" → 의도치 않은 대량 변경
• 테스트 없이 대규모 리팩터링 → 뭐가 깨졌는지 알 수 없음
• 커밋 없이 여러 작업 연속 진행 → 되돌릴 지점이 없음

연습 문제

1. 아무 프로젝트에서 docs/ 폴더에 요약 문서를 만들게 해 보세요.
2. git diff로 실제 변경을 확인하세요.
3. 마음에 안 들면 git checkout .으로 되돌리고 다시 지시해 보세요.

다음 레슨

AI를 활용한 코드 생성