승인하기 전에 보는 세 가지

y는 저장 버튼이 아니라 문 여는 버튼입니다

Claude Code를 쓰다 보면 가장 많이 만나게 되는 순간이 있습니다.

Do you want to make this change?
> y / n

여기서 y를 누르면 Claude가 실제로 파일을 만들거나, 고치거나, 지울 수 있습니다.

무서워할 필요는 없습니다. 대신 습관 하나만 만들면 됩니다.

y를 누르기 전 10초만 보기.

오늘 볼 것은 딱 세 가지입니다.

1. 무엇을 하려는가: 생성, 수정, 삭제 중 무엇인가?

2. 어디를 건드리는가: 예상한 파일만 바뀌는가?

3. 명령을 실행하는가: 안전한 명령인가, 멈춰야 할 명령인가?

이 세 가지만 보면 초보자도 Claude에게 휘둘리지 않습니다. Claude는 운전대를 잡고 있지만, 브레이크는 여전히 내 손에 있습니다.

오늘의 프로젝트 상태 확인하기

이전 장까지 우리는 작은 자기소개 페이지를 만들었습니다.

폴더 안에는 보통 이런 파일이 있습니다.

my-first-page/
├─ index.html
├─ style.css
└─ script.js

각 파일의 역할은 간단합니다.

이제 Claude에게 작은 수정을 부탁해 보겠습니다.

다크모드 버튼의 문구를 조금 더 자연스럽게 바꿔줘.
버튼을 누르기 전에는 "밤 모드 켜기", 누른 뒤에는 "낮 모드로 돌아가기"라고 보이게 해줘.
가능하면 script.js만 수정해줘.

여기서 마지막 문장이 중요합니다.

가능하면 script.js만 수정해줘.

이렇게 말하면 Claude가 수정 범위를 좁혀서 생각합니다. 초보자에게는 이 한 문장이 안전벨트입니다.

첫 번째 체크: 생성, 수정, 삭제 중 무엇인가

Claude Code의 제안 화면에는 보통 어떤 파일을 어떻게 바꿀지 표시됩니다.

초보자는 코드를 전부 읽으려고 하면 금방 지칩니다. 처음에는 코드보다 작업 종류부터 보세요.

예를 들어 이런 제안은 괜찮습니다.

Modify script.js

우리가 버튼 문구를 바꿔 달라고 했으니 script.js 수정은 자연스럽습니다.

이런 제안도 상황에 따라 괜찮습니다.

Modify index.html
Modify script.js

버튼 문구가 HTML에 직접 들어 있다면 index.html도 바뀔 수 있습니다.

하지만 이런 제안이 보이면 잠깐 멈춥니다.

Delete style.css
Create app.js
Modify index.html
Modify package.json

버튼 문구 하나 바꾸는데 CSS를 지우고, 새 파일을 만들고, 설정 파일까지 바꾸는 건 너무 큽니다.

이때는 y를 누르지 말고 이렇게 말하세요.

수정 범위가 너무 커 보여.
삭제하지 말고, 버튼 문구 변경에 꼭 필요한 파일만 수정해줘.
가능하면 script.js 한 파일만 바꿔줘.

Claude에게 다시 좁혀 달라고 하면 됩니다. 처음 제안이 마음에 들지 않으면 거절해도 됩니다.

두 번째 체크: 예상보다 많은 파일을 건드리면 줄여 달라고 하기

초보자가 가장 자주 하는 실수는 이것입니다.

"Claude가 알아서 하겠지."

Claude는 정말 알아서 하려고 합니다. 문제는 가끔 너무 열심히 한다는 점입니다.

우리는 작은 수정만 원했는데 Claude가 구조를 바꾸고, 파일을 나누고, 새 라이브러리를 설치하려 할 수 있습니다.

그럴 때는 이 문장을 그대로 복사해서 쓰세요.

지금은 큰 구조 변경을 원하지 않아.
수정 범위를 한 파일로 줄여줘.
어떤 파일 하나를 바꾸는지 먼저 말해주고, 그 다음에 수정안을 제안해줘.

조금 더 단호하게 말해도 됩니다.

새 파일을 만들지 말고 기존 파일 안에서만 해결해줘.

index.html은 건드리지 말고 style.css만 수정해줘.

script.js만 수정해서 해결할 수 있는 방법으로 다시 제안해줘.

좋은 프롬프트는 멋진 문장이 아닙니다. 범위를 좁히는 문장입니다.

Claude에게 일을 맡길 때는 이렇게 생각하면 쉽습니다.

무엇을 바꿀지 + 어디만 바꿀지 + 무엇은 하지 말지

예를 들어 스타일만 고치고 싶다면 이렇게 말합니다.

카드의 배경색과 그림자만 더 세련되게 바꿔줘.
style.css만 수정해줘.
HTML 구조와 JavaScript 기능은 건드리지 마.

이 문장은 초보자에게 아주 좋습니다. Claude가 건드려도 되는 곳과 안 되는 곳을 동시에 알 수 있기 때문입니다.

세 번째 체크: 삭제와 대규모 변경이 보이면 계획부터 다시 받기

삭제는 늘 조심해야 합니다.

특히 아래 단어가 보이면 바로 승인하지 마세요.

Delete
Remove
rm
reset
clean
overwrite

이 단어들이 항상 나쁜 것은 아닙니다. 하지만 초보자라면 일단 멈추는 편이 안전합니다.

이럴 때 쓰는 문장은 하나입니다.

아직 변경하지 마.
먼저 어떤 파일을 왜 바꾸려는지 계획만 다시 요약해줘.
삭제가 필요한 이유도 설명해줘.

더 안전하게 묻고 싶다면 이렇게 말하세요.

삭제 없이 같은 목표를 달성할 수 있는 방법으로 다시 제안해줘.

Claude가 대규모 변경을 제안할 때도 마찬가지입니다.

예를 들어 이런 상황입니다.

Modify index.html
Modify style.css
Modify script.js
Create utils.js
Create theme.js

우리는 버튼 하나를 고치고 싶었을 뿐입니다. 이 정도면 너무 큽니다.

이때는 이렇게 되돌립니다.

지금 단계에서는 파일 구조를 늘리고 싶지 않아.
새 파일을 만들지 말고, 현재 세 파일 안에서만 최소 수정으로 해결해줘.
변경 계획을 먼저 3줄로 요약해줘.

핵심은 이것입니다.

불안하면 승인하지 말고, 설명을 요구한다.

Claude는 질문을 싫어하지 않습니다. 오히려 질문을 받으면 더 정확히 움직입니다.

승인 전 10초 체크리스트

y를 누르기 전, 이 표만 눈으로 훑으세요.

초보자 기준으로 가장 좋은 변경은 이렇습니다.

Modify script.js

또는 이 정도입니다.

Modify index.html
Modify style.css

반대로 이런 제안은 바로 승인하지 마세요.

Delete index.html
Modify package.json
Run rm -rf dist
Install new dependencies

모르면 멈추면 됩니다. 멈추는 것도 실력입니다.

권한 요청이 나왔을 때: 허용해도 되는 명령, 멈춰야 하는 명령

Claude Code는 가끔 파일 수정뿐 아니라 터미널 명령 실행도 요청합니다.

예를 들면 이런 식입니다.

Run command?
npm run dev
> y / n

명령어가 나오면 코드를 볼 때보다 더 천천히 봐야 합니다.

대체로 허용해도 되는 명령

아래 명령들은 보통 확인용이거나 개발 서버 실행용입니다.

물론 npm run dev나 npm test도 프로젝트 설정에 따라 내부에서 다른 일을 할 수 있습니다. 하지만 우리가 만든 작은 웹페이지에서는 대부분 개발 서버를 켜거나 확인하는 용도입니다.

일단 멈춰야 하는 명령

아래 명령이 보이면 초보자는 바로 승인하지 않는 편이 좋습니다.

이런 명령이 보이면 이렇게 물어보세요.

이 명령을 실행하지 말고 설명만 해줘.
무엇을 바꾸는 명령인지, 어떤 위험이 있는지, 대체 방법이 있는지 알려줘.

또는 이렇게 말해도 좋습니다.

삭제나 관리자 권한 없이 해결하는 방법으로 다시 제안해줘.

Claude가 명령을 제안했다고 해서 꼭 실행해야 하는 것은 아닙니다. 명령 실행은 항상 내가 선택합니다.

실습: 일부러 범위를 좁혀 보기

이제 실제로 Claude에게 작은 요청을 해봅시다.

Claude Code에 아래 문장을 입력하세요.

현재 페이지의 버튼 문구를 더 친절하게 바꿔줘.
단, script.js만 수정해줘.
수정하기 전에 어떤 파일을 바꿀지 먼저 알려줘.

Claude가 제안을 보여주면 바로 y를 누르지 말고 확인합니다.

좋은 흐름은 이런 모습입니다.

Modify script.js

이 경우에는 우리가 요청한 범위와 맞습니다. 내용을 보고 괜찮으면 승인해도 됩니다.

만약 이런 식으로 나온다면 멈춥니다.

Modify index.html
Modify style.css
Modify script.js

그때는 이렇게 입력합니다.

이번에는 script.js만 수정하고 싶어.
index.html과 style.css는 그대로 두고 다시 제안해줘.

Claude가 다시 제안하면 또 확인합니다.

이 과정이 귀찮아 보일 수 있습니다. 하지만 실제 작업에서는 이 10초가 훨씬 큰 시간을 아껴 줍니다.

잘못 바뀐 코드를 되돌리는 것보다, 바뀌기 전에 막는 편이 쉽습니다.

작업 전 백업: 가장 쉬운 되돌리기 버튼 만들기

안전하게 쓰는 사람들은 공통점이 있습니다.

큰 변경 전에 되돌릴 지점을 만들어 둡니다.

거창할 필요 없습니다. 초보자는 폴더 복사만 해도 충분합니다.

방법 1: 폴더를 통째로 복사하기

가장 쉽습니다.

1. 프로젝트 폴더를 찾습니다.

2. 폴더를 복사합니다.

3. 이름을 이렇게 바꿉니다.

my-first-page-backup

또는 날짜를 붙여도 좋습니다.

my-first-page-backup-2026-05-18

이제 Claude가 뭔가 이상하게 바꿔도 원본을 다시 가져올 수 있습니다.

방법 2: 터미널에서 폴더 복사하기

macOS나 Ubuntu 터미널이라면 프로젝트 폴더의 한 단계 위에서 이렇게 입력합니다.

cp -R my-first-page my-first-page-backup-2026-05-18

Windows 파일 탐색기를 쓰고 있다면 마우스로 폴더를 복사해도 됩니다. 명령어가 낯설다면 굳이 터미널 복사를 쓰지 않아도 됩니다. 마우스로 복사해도 완벽한 백업입니다.

방법 3: Git으로 저장하기

Git을 이미 쓰고 있다면 변경 전마다 저장 지점을 만들 수 있습니다.

git status
git add .
git commit -m "before claude change"

아직 Git이 낯설다면 지금은 폴더 복사로 충분합니다. 중요한 것은 도구가 아니라 습관입니다.

작업 전 복사. 승인 전 확인. 이상하면 질문.

이 세 가지면 초보자도 꽤 안전해집니다.

승인하지 않는 연습도 필요합니다

Claude Code를 잘 쓰는 사람은 y를 빨리 누르는 사람이 아닙니다.

필요할 때 n을 누를 줄 아는 사람입니다.

다음 상황에서는 승인하지 마세요.

• 내가 요청하지 않은 파일을 바꾸려 할 때

• 삭제가 포함되어 있을 때

• 새 패키지를 설치하려 할 때

• 관리자 권한을 요구할 때

• 명령어 뜻을 모르겠을 때

• 변경 파일이 갑자기 많아졌을 때

이때 쓸 수 있는 문장을 모아 두겠습니다.

아직 승인하지 않을게.
변경 계획만 다시 요약해줘.

수정 범위를 너무 넓게 잡은 것 같아.
한 파일만 수정하는 방식으로 다시 제안해줘.

삭제는 하지 마.
삭제 없이 해결하는 방법을 알려줘.

이 명령어가 무슨 일을 하는지 초보자도 이해할 수 있게 설명해줘.
실행은 아직 하지 마.

내가 직접 확인한 뒤 실행할게.
지금은 명령어만 보여줘.

이 문장들은 초보자의 방패입니다. 외워도 좋고, 메모장에 붙여 두어도 좋습니다.

오늘의 한 줄 습관

Claude Code는 빠릅니다. 그래서 우리는 조금 천천히 봐야 합니다.

y를 누르기 전에는 딱 세 가지만 확인하세요.

1. 생성, 수정, 삭제 중 무엇인가?
2. 예상한 파일만 바뀌는가?
3. 위험한 명령은 없는가?

이 체크가 끝났다면 승인해도 됩니다.

반대로 하나라도 찜찜하면 멈추세요.

먼저 변경 계획만 다시 요약해줘.

이 한 문장이 내 코드를 지켜 줍니다.

다음 장에서는 더 현실적인 상황을 다룹니다. Claude가 이상한 코드를 줬을 때, 당황하지 않고 에러 메시지를 그대로 건네 해결하는 법을 배워보겠습니다.