막혔을 때

24.1 이 장은 나중에 다시 펼 장입니다

지금 쭉 읽으셔도 되지만, 진짜 쓸모는 나중에 생깁니다. 뭔가 안 될 때 이 장으로 돌아오세요.

찾기 쉽게 증상으로 정리했습니다.

---

24.2 증상으로 찾기

24.3 대화가 무거워졌을 때

증상

• 아까 말한 걸 잊었다고 한다
• 답이 점점 엉뚱해진다
• 같은 걸 계속 다시 설명하게 된다
• 응답이 느려졌다

원인

3.4절입니다. 공책이 찼습니다.

파일을 여러 개 읽히고, 대화를 스무 번쯤 주고받으면 컨텍스트가 찹니다. 그러면 앞장부터 찢겨 나갑니다.

해결 — /clear

입력창에 이렇게 칩니다.

/clear

대화가 초기화됩니다. 공책을 새로 꺼내는 것입니다.

⚠️ /clear 는 대화만 지웁니다. 파일은 안 지웁니다

무서워하지 않으셔도 됩니다. 만들어진 파일은 그대로 있습니다. 지금까지 나눈 말만 사라집니다.

그리고 CLAUDE.md 는 새 대화에서 다시 읽힙니다(7장). 규칙은 안 사라집니다.

지우기 전에 할 일

지우면 정말 사라지니까, 필요한 건 파일로 남기고 지우세요.

지금까지 한 작업과 결정한 것들을 정리해서
작업노트.md 파일로 저장해줘.

그다음 /clear 하고, 새 대화에서는 이렇게 시작합니다.

작업노트.md 를 읽고, 이어서 작업할 거야.

💡 긴 대화보다 짧은 대화 여러 개가 낫습니다

3.4절에서 말씀드린 그 이야기입니다.

사람은 오래 같이 일한 사람이 일을 잘 압니다. AI는 반대입니다. 공책이 비어 있을수록 정확합니다.

일 하나 끝나면 /clear. 이게 습관이 되면 체감이 확 달라집니다.

---

24.4 결과가 매번 달라질 때

원인

12.6절입니다. “알아서” 를 시키고 있습니다.

확인할 곳

고치는 법

구체적인 숫자와 형식으로 바꿉니다.

마지막 줄이 핵심입니다. “알아서” 대신 “물어봐” 를 쓰세요.

---

24.5 파일이 어디 갔는지 모를 때

가장 빠른 해결

그냥 물어보세요.

방금 만든 파일이 어디 있어? 전체 경로로 알려줘

이 폴더에서 최근에 만들어지거나 수정된 파일 다섯 개를 알려줘

재발 방지

15.5절입니다. 저장 위치를 안 정해줘서 생기는 일입니다.

CLAUDE.md 에 표를 하나 만들어 두세요.

## 파일 저장 위치
| 종류 | 위치 |
|---|---|
| 원본 자료 | `10_input/` |
| 중간 결과 | `20_working/` |
| 최종 결과물 | `30_output/` |

표에 없는 곳, 특히 작업 폴더 최상단에 파일을 만들지 않는다.

마지막 줄이 있어야 합니다. 안 적으면 최상단에 쌓입니다.

---

24.6 되돌리고 싶을 때

6.5절을 다시 정리합니다. 위에서부터 시도하세요.

①이 안 되는 경우

스무 번쯤 주고받은 뒤라면 공책 앞장이 찢겼습니다(24.3절). 그때는 ②③④로 가세요.

미리 해둘 것

💡 마음에 드는 상태가 나오면 그때 백업하세요

지금 상태를 backup/ 폴더에 날짜 붙여서 복사해줘

한 줄이면 됩니다. 그리고 이게 Git이 자동으로 해주는 일입니다. 나중에 Git을 배우시면 이 과정이 사라집니다.

---

24.7 권한 창이 너무 자주 뜰 때

먼저 — 정말 줄여야 하나

2.3절에서 말씀드린 대로, 권한 창은 안전장치입니다. 귀찮다고 다 끄면, 10장에서 걱정한 사고가 그대로 일어납니다.

줄이는 기준

읽기만 자동으로 넘기는 것이 가장 균형 잡힌 설정입니다.

설정을 바꾸려면 Claude에게 물어보시는 게 빠릅니다.

권한 설정을 어떻게 바꾸는지 알려줘.
읽기는 자동으로 허용하고, 쓰기와 실행은 계속 물어보게 하고 싶어.

⚠️ Agent에게는 특히 신중하게

18.6절입니다. Agent는 여러 동작을 연달아 합니다. 자동 허용을 켜두면 그 전부가 확인 없이 지나갑니다.

---

24.8 만든 Skill이 안 불릴 때

16.3절의 그 표를 다시 꺼냅니다.

① 위치와 이름 확인

.claude/skills/{이름}/SKILL.md

• 폴더를 한 겹 만들었나요? (.claude/skills/SKILL.md 는 안 됩니다)
• 프론트매터의 name 이 폴더 이름과 같나요?
• 이름에 한글이나 공백이 있지 않나요?

② / 를 쳐서 목록에 뜨는지 보기

목록에 없으면 Claude가 그 Skill의 존재를 모르는 것입니다. ①로 가세요. 목록에 있는데 안 불리면 ③입니다.

③ description 고치기

15.6절입니다. 언제 부르는지가 안 적혀 있어서입니다.

description: 주간 메모를 받아 보고서를 작성한다.
  '/weekly-report', '주간보고', '이번 주 보고서' 요청 시 사용.

뒷부분을 추가하면 자연스러운 말로도 불립니다.

④ 직접 지목하기

급하면 그냥 이렇게 말하세요.

.claude/skills/weekly-report/SKILL.md 를 읽고 그대로 실행해줘

---

24.9 답이 없거나 오류가 날 때

순서대로 확인

오류 메시지가 나왔다면

그대로 복사해서 물어보세요. 이게 가장 빠릅니다.

이런 오류가 났어. 무슨 뜻이고 어떻게 고치면 돼?

(오류 메시지 붙여넣기)

💡 오류 메시지를 무서워하지 마세요

오류는 “뭐가 잘못됐는지 알려주는 친절한 메시지” 입니다. 영어라서 무서워 보일 뿐입니다.

통째로 복사해서 던지면 대개 해결됩니다. 그리고 “이게 무슨 뜻이야?” 를 같이 물으면 다음에 같은 오류를 만났을 때 혼자 풉니다.

0.3절에서 약속한 “막혔을 때 혼자 빠져나오는 법” 이 이겁니다.

---

24.10 안 되는 걸 붙잡고 있지 않기

마지막으로, 10.4절의 이야기를 다시 합니다.

포기가 답인 경우가 있습니다.

💡 자동화의 실력은 “어디까지 안 할지” 를 아는 것입니다

전부 자동화하려는 사람은 결국 아무것도 자동화하지 못합니다. 시간의 80%가 마지막 20%에 들어가기 때문입니다.

되는 것만 자동화하고, 안 되는 건 손으로 하세요. 그게 빠릅니다.

---

24.11 자주 나는 오류 열 가지 — 빠른 표

10번은 오류가 아니라 성질입니다. 고칠 수 없습니다. 검수로 막습니다.

---

24.12 정리

마지막 장에서는 앞으로 뭘 어디서 할지를 정리합니다.