파일 조작 배우기

앞 글에서 @로 파일을 지목하는 법을 배웠습니다. 이 글은 파일을 읽고, 만들고, 고치고, 여러 개를 한꺼번에 다루는 지시 방법과, 그 과정에서 원치 않는 변경을 막는 습관을 다룹니다. 읽고 나면 내 업무 폴더를 Claude Code에게 맡기되 되돌릴 수 없는 사고는 피할 수 있습니다. 다음 글은 「AI를 활용한 코드 생성」입니다.

핵심 요약

• 읽기는 묻지 않고 실행되고, 만들기와 고치기는 승인을 거칩니다.
• 큰 정리 작업은 "계획을 먼저 보여 주고 승인하면 실행"으로 시킵니다.
• 고칠 때는 "파일 전체를 다시 쓰지 말고 필요한 부분만" 수정하게 합니다.
• Bash 명령으로 옮기거나 지운 파일은 되돌리기가 안 되므로 커밋을 기준점으로 둡니다.

읽기

읽기는 가장 안전한 작업입니다. 작업 폴더 안의 파일은 승인 없이 읽습니다. 경로를 정확히 알면 @로 지목하고, 모르면 찾게 합니다.

@notes/2026-08-상담.md 를 읽고 결정 사항만 뽑아 줘
이 폴더에서 고객 연락처가 들어 있는 파일을 찾아 목록으로 보여 줘

교재 1주차의 첫 실습이 바로 읽기입니다. 공고문을 폴더에 넣고 지원 대상, 금액, 기간, 제출 서류, 제외 조건을 표로 뽑게 합니다. 파일을 고치지 않으니 부담 없이 반복해도 됩니다.

새로 만들기

새 파일은 파일명, 위치, 형식을 함께 말합니다. 형식을 정하지 않으면 Claude Code가 임의로 고릅니다.

docs/고객DB-표준.md 파일을 만들어 줘.
교재 4주차의 고객 DB 표준 10항목을 표로 정리하고, 각 항목에 예시 값을 하나씩 넣어 줘.

만들기 전에 "docs/고객DB-표준.md를 생성할까요?" 같은 승인 요청이 옵니다. 승인하면 파일이 생기고 내용이 화면에 표시됩니다.

고치기

고치기는 지시 방식이 결과를 좌우합니다. 교재 5주차의 원칙을 파일 수정에 맞게 옮기면 이렇습니다.

@src/report.py 에서 날짜 형식을 YYYY-MM-DD로 바꿔 줘.
파일 전체를 다시 쓰지 말고 필요한 부분만 수정하고,
바꾼 줄과 이유를 정리해 줘.

Claude Code는 바꿀 부분을 diff로 보여 주고 승인을 기다립니다. diff에서 시키지 않은 줄이 바뀌어 있으면 승인하지 말고 "그 부분은 원래대로 두고 날짜 형식만"이라고 다시 지시합니다.

여러 파일을 한꺼번에

여러 파일에 같은 변경을 넣을 때는 대상 범위와 예외를 분명히 적습니다.

notes/ 폴더의 모든 md 파일에서 고객 실명을 "고객A" 형식으로 가리고,
어떤 파일의 어느 줄을 바꿨는지 표로 정리해 줘. 템플릿.md는 제외.

파일을 옮기거나 폴더 구조를 바꾸는 작업은 반드시 계획을 먼저 받습니다. 교재 1주차 실습 2의 문장 그대로입니다. "옮기기 전에 어떻게 정리할지 계획을 먼저 보여 주고, 내가 승인하면 실행해." Shift+Tab으로 plan 모드에 들어가 두면 파일을 읽고 계획만 세우고 편집하지 않으므로 이 습관을 도구가 강제해 줍니다.

안전 습관 세 가지

1. 계획 먼저, 실행은 승인 후. 특히 이동·삭제·이름 변경은 되돌리기 대상이 아닙니다. 체크포인트는 Claude의 편집 도구로 바꾼 파일만 추적하고, rm이나 mv 같은 Bash 명령으로 바뀐 파일은 추적하지 않습니다.
2. 작업 전 커밋. 교재 5주차의 말대로 "AI가 잘못 수정한 게 문제가 아니라, 되돌릴 기준점을 안 만든 게 문제입니다." 큰 수정 전에는 "지금까지 커밋해 줘" 한마디로 기준점을 만듭니다.
3. 최소 수정 지시. "기존 기능은 유지하고, 필요한 부분만 고치고, 변경 파일 목록을 정리해 줘"를 붙입니다. diff를 읽고 승인하는 것은 사람 몫입니다.

흔한 실수

• 다운로드 폴더나 바탕화면 전체에서 claude를 켜는 것. 교재 3주차에서 실제로 폴더를 대부분 날린 사례가 나옵니다. 프로젝트 하나에 폴더 하나, 경로는 짧게, 한글과 공백 없이 만듭니다.
• "깔끔하게 정리해 줘" 같은 범위 없는 지시. 시키지 않은 파일까지 바뀝니다.
• diff를 읽지 않고 승인하는 것. 열 번째 승인부터는 눈이 멈춥니다. 그때가 plan 모드로 바꿔 계획을 한 번에 검토할 시점입니다.

연습 문제

1. 업무 폴더의 파일 하나를 @로 지목해 요약시키고, 파일이 바뀌지 않았는지 확인하세요.
2. 새 md 파일을 만들게 하되 파일명과 형식을 지시문에 넣어 보세요.
3. 파일 하나를 최소 수정으로 고치게 한 뒤 diff에서 바뀐 줄 수를 세어 보세요.
4. plan 모드에서 폴더 정리 계획만 받아 보고 실행은 하지 마세요.

다음 레슨

파일을 다루는 감각이 생겼으면 이제 코드를 만들게 할 차례입니다. 다음 글 「AI를 활용한 코드 생성」에서는 좋은 지시의 네 요소와 황금 문장을 배웁니다.

정리

• 읽기는 자유롭게, 만들기와 고치기는 diff를 읽고 승인합니다.
• 이동·삭제는 계획을 먼저 받고, 작업 전 커밋으로 기준점을 만듭니다.
• 최소 수정과 변경 목록 정리를 지시문에 항상 넣습니다.

자주 묻는 질문