Claude가 막혔을 때
신호를 알아채고 정상으로 돌아오기
⏱ 예상 ~7분
01 · 읽기
가끔 Claude Code가 예상대로 안 할 때가 있어요. 같은 파일을 진전 없이 세 번 수정할 수도 있고, 요청하지 않은 코드를 추가하거나, 앞서 한 말을 잊은 것처럼 보일 수도 있어요.
정상이에요. Claude가 망가졌거나 여러분이 뭘 잘못한 게 아니에요. 문제를 알아채고 복구해야 한다는 뜻이에요.
같은 잘못된 길을 계속 다시 계산하는 GPS 처럼 생각해 봐요. '다시 시도' 라고 해도 소용없어요 — 길가에 멈춰서 목적지를 지우고 다시 입력해야 해요. Claude Code 도 마찬가지예요.
아래는 Claude가 막혔을 때 가장 흔한 신호예요: - 빙빙 돌기 — 같은 방법을 계속 시도하면서 비슷한 편집을 해요 - 범위 확장 — 요청하지 않은 파일을 수정하거나 기능을 추가하기 시작해요 - 컨텍스트 잊기 — 앞서 한 말과 반대로 하거나 이미 끝난 일을 다시 해요 - 잘못된 타겟 — 잘못된 파일을 수정하거나 존재하지 않는 문제를 고쳐요
02 · 퀴즈
Claude가 같은 함수를 연달아 세 번 편집하면서 매번 살짝 다른 버전을 만들어요. 가장 가능성 높은 상황은?
- Claude가 신중하게 완벽한 코드로 다듬는 중이에요
- 컴퓨터가 너무 느려서 Claude가 잘 못해요
- 함수가 너무 복잡해서 Claude가 처리 못 해요
- Claude가 루프에 갇혀 있어요 — 리셋이나 더 명확한 방향이 필요해요
03 · 읽기
Claude Code 에는 상황이 안 좋을 때 쓸 두 가지 내장 명령어가 있어요: /clear — 전체 대화를 지우고 새로 시작해요. 대화가 너무 멀리 벗어나서 컨텍스트를 더 추가해도 살릴 수 없을 때 써요. 모든 브라우저 탭을 닫고 새로 시작하는 것과 같아요.
/compact — 중요한 컨텍스트를 유지하면서 대화 기록을 압축해서 공간을 비워요. Claude 컨텍스트를 거의 다 썼지만 (오래 작업했어요) 전체 방향은 아직 맞을 때 써요.
핵심 차이: /clear 는 완전 리셋이에요. /compact 는 다듬기예요. Claude가 뭘 해야 할지 헷갈리면 /clear, Claude가 생각할 공간이 없으면 /compact.
04 · 빈칸 채우기
벗어난 Claude Code 대화를 완전히 리셋하려면 /___ 를 입력해요.
05 · 짝짓기
각 문제를 가장 좋은 복구 동작과 짝지어요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
06 · 체크리스트
Claude가 잘못된 걸 만들면, 다시 시도하기 전에 '멈추고, 되돌리고, 다시 표현하기' 흐름을 따라요.
- 멈추기 — Claude가 잘못된 방향으로 계속 가게 두지 말기
- 되돌리기 — git diff 로 뭐가 바뀌었는지 보고, 필요하면 되돌리기
- 다시 표현하기 — 더 명확하고 구체적인 prompt 쓰기
- 대화가 너무 멀리 벗어나면 /clear 를 고려해요
07 · 읽기
Claude가 막히는 걸 가장 잘 다루는 방법은 애초에 예방하는 것 이에요. 아래가 효과적이에요: - 작은 prompt — 한 번에 한 가지 변경, 한 메시지에 다섯 개 넣지 말기 - 구체적이기 — '검증 추가' 보다 'ContactForm.tsx 의 email 필드에 검증 추가' 가 좋아요 - 하지 말아야 할 것 말하기 — '기존 테스트 바꾸지 말기' 또는 '데이터베이스 schema 건드리지 말기' - 일찍 검토하기 — 변경할 때마다 git diff 를 보세요, 10 번 수정 후가 아니라요
막히는 건 실패가 아니에요. AI 도구를 쓸 때의 일반적인 상황이에요. Claude Code 에서 가장 많이 뽑아내는 엔지니어는 절대 안 막히는 사람이 아니라 — 가장 빨리 복구하는 사람이에요.
08 · 퀴즈
Claude Code가 오래 작업하다가 대화 앞쪽에서 준 지시를 잊기 시작해요. 전체 방향은 맞지만 생각할 공간이 거의 없어졌어요. 어떻게 해야 해요?
- /compact 입력해서 대화 기록을 압축하고 컨텍스트를 유지해요
- /clear 입력해서 전부 지우고 다시 시작해요
- 터미널을 닫았다가 다시 열어요
- Claude가 기억할 때까지 지시를 계속 반복해요
09 · 빈칸 채우기
Claude가 실수했을 때 세 단계 복구를 따라요: 멈추기, _____, 다시 표현하기.
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.