3부 세상에 공개한다

13장 · 오류가 나도 멈추지 않기

빨간 글씨는 협박문이 아니라 '여기가 문제'라는 안내문입니다. 읽는 건 Claude가 하고, 우리는 통째로 전달하고 결과를 확인합니다.

마음가짐

온라인 강의로 배우다 포기하는 지점은 대부분 첫 번째 에러입니다. 영어로 된 빨간 글씨가 뜨면 "나는 안 되나 보다" 하고 닫습니다. 그런데 에러 메시지는 협박문이 아니라 '여기가 문제'라는 안내문입니다. 영어라서 못 읽어도 됩니다. 읽는 건 Claude가 하고, 우리는 통째로 전달하고 결과를 확인합니다.

오류 메시지 읽는 법 — 세 군데만 봅니다

• ① Error·failed·not found 같은 단어가 있는 줄 — 무슨 문제인지
• ② 파일 이름과 줄 번호 (예: index.html:42) — 어디서 났는지
• ③ 방금 내가 한 행동 — 무엇을 눌렀더니·무엇을 시켰더니

나머지 긴 글은 몰라도 됩니다. 요약하지 말고 통째로 복사. 내가 요약하면 중요한 단서가 빠집니다. 전부 복사가 가장 빠른 길입니다.

오류가 보이는 곳 네 군데

브라우저 F12 → Console 탭의 빨간 줄도 통째로 가져가면 좋습니다.

오류 설명 공식 — 어디서 · 무엇을 · 무슨 일 · 기대

[어디서] Vercel 배포에서
[무엇을 했더니] GitHub에 올리고 나서
[무슨 일이] 배포가 실패로 떴어.
[기대한 것] 새 버전이 공개돼야 해.
아래가 오류 메시지 전체야:
(여기에 통째로 붙여넣기)
원인을 쉬운 말로 먼저 설명하고,
네가 찾아서 고친 다음, 되는지 확인까지 해줘.

네 칸만 채우면 Claude가 헤매지 않습니다. 수업이 끝난 뒤에도 똑같이 씁니다.

찾아 고치게 하는 3단계

1. 붙여넣기: 오류 전체 + 상황 한 줄 → "원인 설명하고 고쳐줘"
2. 확인까지 시키기: "고친 뒤 네가 직접 확인하고 결과를 보고해줘"
3. 세 번 고쳐도 같으면: "이 방법은 막혔어. 다른 방법으로. 요구사항은 그대로"

고친 뒤엔 반드시 내 눈으로 확인합니다. 최종 판단은 나. 같은 자리를 네 번째 파는 것보다 '다른 방법으로'가 보통 더 빠릅니다. Claude가 "고쳤다"고 말하는 것과 실제로 되는 것은 다릅니다. 열어 보기 전에는 믿지 않습니다.

일부러 망가뜨리고 고치게 하기

진짜 오류가 오기 전에 한 번 겪어 두면 손이 먼저 움직입니다.

1. "연습용으로 상담 신청 버튼 연결을 일부러 망가뜨려줘 (어떻게 했는지는 말하지 말고)"
2. 브라우저에서 버튼이 안 되는 것 확인 — 메시지 없는 '화면 문제'
3. 오류 설명 공식대로 상황을 적고: "찾아서 고치고 확인까지 해줘"
4. 고쳐지면 F5 확인 → GitHub에 올리기 → 폰에서 확인

대화가 꼬였을 때 — 되감기와 새 대화

같은 문제를 두 번 넘게 고쳤는데 계속 이상하면, 대화에 실패한 시도가 쌓여 Claude가 헤맵니다. 이때는 두 가지 방법이 있습니다.

• 되감기 — Claude Code는 요청마다 파일 상태를 기록해 둡니다. "마지막으로 잘 되던 상태로 되돌려줘"라고 하면 됩니다. 터미널에서는 Esc를 두 번 누르거나 /rewind로 시점을 고릅니다. 무엇이 사라지는지 먼저 설명받고 진행하세요
• 새 대화 — 배운 것을 넣어 더 나은 첫 요청으로 다시 시작합니다. 폴더의 파일과 CLAUDE.md는 그대로니 새 대화가 두렵지 않습니다. 관계없는 작업 사이에는 /clear로 대화를 비웁니다

공식 가이드도 같은 말을 합니다. 같은 문제로 두 번 넘게 고쳤으면, 새 대화에서 더 구체적인 요청으로 다시 시작하는 편이 거의 항상 빠릅니다.

막힐 때 순서 — 수업 뒤에도 똑같습니다

좋은 질문이 빠른 답을 만듭니다. 화면 없이 말로만 물으면 답도 추측이 됩니다. 5분 넘게 혼자 씨름하지 않습니다.

3부를 마치며

비밀번호·키는 파일·GitHub·단톡방에 두지 않습니다. 3부의 보안 한 줄입니다.

이 장의 결과물

• ☐ 오류 설명 공식(어디서·무엇을·무슨 일·기대)을 써 봤다
• ☐ Claude에게 '고친 뒤 확인까지' 시켜 봤다
• ☐ 일부러 망가뜨린 버튼을 고쳐 다시 올렸다
• ☐ 가족·동료 1명에게 주소를 보내 의견 1개를 받았다