이럴 때는? — 자주 막히는 5가지

막힘은 잘못이 아니라 통과 의례입니다. 우리도 전부 겪었습니다. 아래 다섯 가지가 처음 몇 주에 가장 자주 만나는 증상들입니다 — 증상을 고르면 해결 순서가 나옵니다.

1"설치·실행이 안 돼요"

1. 방금 설치했다면 — 터미널 창을 닫았다가 새로 여십시오. 새 명령은 새 창에서 인식되는 경우가 많습니다.
2. 자동 점검 — 터미널에 아래를 쳐서 설치 상태를 검진합니다.

# 터미널에 붙여넣기
claude doctor

• "command not found(명령어를 찾을 수 없다)" — 설치된 위치를 터미널이 못 찾는 상태입니다. 새 창에서도 그러면, 그 오류 문구를 통째로 복사해 클로드 앱에 붙여넣고 물어보십시오. 컴퓨터 환경에 맞는 처방을 받는 가장 빠른 길입니다.
• 로그인이 꼬였다면 — 클로드 코드 안에서 /logout 하고 다시 /login. 이것이 가장 잘 듣습니다.
• "Unable to connect(연결할 수 없다)" — 인터넷 연결·회사 방화벽·프록시 문제가 대부분입니다. 회사 컴퓨터라면 IT 담당자에게 프록시 주소를 문의하십시오.
• 5xx·529 같은 숫자 오류 — 서버가 잠시 붐비는 것입니다. 몇 분 뒤 다시 시도하면 됩니다.

2"어제 한 일을 기억 못 해요"

고장이 아니라 원래 그렇습니다. 세션(대화 한 판)이 끝나면 기록은 남지만, 새 세션이 그것을 자동으로 이어 읽지는 않습니다 — 책 5장이 말한 약점 ㉠(기억 상실)의 실물입니다. 길은 둘입니다.

• 바로 잇기 — 터미널에서 claude --continue(가장 최근 대화를 즉시 이어감) 또는 claude --resume(목록에서 골라 이어감). 이미 켜져 있다면 /resume.
• 근본 해법 — 인수인계 — 책 8장 뼈대 셋(기억) 그대로, 끝낼 때 오늘 한 일을 문서로 남기게 하고 시작할 때 읽게 만드는 것입니다. 따라 하기 2편의 CLAUDE.md와 훅이 그 장치입니다.

3"갑자기 대답이 둔해졌어요"

대화가 길어지면 그릇(맥락 창)이 가득 찹니다. 그릇이 차면 앞의 내용을 흘리기 시작합니다 — 게으름이 아니라 물리적 한계입니다.

1. 계기판 확인 — /context로 그릇이 얼마나 찼는지 봅니다.
2. 같은 일을 이어 갈 거라면 — /compact. 지금까지를 요약해 그릇을 비우고 일은 이어 갑니다.
3. 새 일을 시작할 거라면 — /clear. 싹 비우고 새로 시작합니다.

자세한 원리는 기능 사전 — 맥락 관리에 있습니다.

4"파일을 잘못 고쳤어요, 되돌리고 싶어요"

클로드 코드는 파일을 고치기 직전마다 그 순간의 상태를 사진처럼 자동 저장해 둡니다(체크포인트). 게임의 세이브 지점과 같습니다.

# 클로드 코드 입력창에
/rewind

저장 지점 목록이 나오면 마음에 들었던 시점을 골라 되돌립니다. 코드와 대화를 함께 되돌릴 수 있습니다.

5"권한을 자꾸 물어봐요 / 위험한 일은 아예 막고 싶어요"

매번 묻는 것은 결함이 아니라 브레이크입니다(책 13장). 다만 브레이크의 세기는 조절할 수 있습니다.

• 덜 묻게 하기 — 믿는 일은 허용 목록에 올립니다. 말로 하면 됩니다 — "파일 읽기는 항상 허용해 줘. 반영 전에 바뀌는 내용을 먼저 보여 줘." 또는 Shift+Tab으로 편집 자동 승인 모드로 바꿉니다(화면 아래 상태 표시줄에서 현재 모드 확인).
• 아예 막기 — 되돌릴 수 없는 일(삭제·발송·결제 등) 3가지를 골라 "이건 어떤 경우에도 막아 줘(deny)"로 정합니다. 책 13장 실행 상자의 그 매트릭스입니다. 막기(deny) 규칙은 모드와 무관하게 지켜집니다 — 마지노선입니다.

깊은 내용은 기능 사전 — settings.json과 권한·대화 모드 전환에 있습니다.