Claude Code 멈춤·프리즈 대처 완전 정복

"Compacting conversation…"(대화 압축 중)에서 멈춤

컨텍스트 창이 차오르면 자동 압축이 발동합니다: Claude Code는 지금까지의 대화를 요약해 갈아끼웁니다. 정말 거대한 세션이면 이 요약 단계가 몇 분 걸리는 게 정상——게다가 v2.1.282와 v2.1.284에서는 요약 요청이 거절되어 압축이 실패하거나, 압축 뒤에 "Prompt is too long"이 남는 실제 결함이 수정되었습니다. 평범한 크기의 세션이 2~3분 넘게 버벅거린다면, 일하는 게 아니라 멈춘 겁니다.

1. 1세션이 정말 거대하다면 먼저 몇 분은 기다리세요——v2.1.283에서 압축 스피너가 다시 만들어져 타이머가 압축이 실제로 시작될 때부터 돕니다.
2. 2그 이상이면 Esc, 이어서 Ctrl+C로 압축을 취소하세요. 공식 문서는 Ctrl+C가 현재 작업만 취소할 뿐 세션을 버리지 않는다고 명시합니다.
3. 3다음은 초점을 주고 수동 압축해서 요약에서 부피 큰 도구 출력을 뺍니다. 예: /compact keep only the plan and the diff.
4. 4오래된 기록을 버려도 된다면 /clear로 새로 시작——그리고 v2.1.284 이상으로 업데이트해 수정된 압축 재시도를 장착하세요.

/compact keep only the plan and the diff/clear

"Almost done thinking…"에서 멈춤

직관에 어긋나지만, 이 스피너 문구는 진행 상황이 아닙니다: 멤버가 issue #63387에서 돌아가는 문구들이 모델의 실제 추론 상태와 대응하지 않는다고 확인했습니다. 그래서 "almost done"은 몇 분이나 떠 있을 수 있고, issue #55328에는 확장 사고가 길어지는 동안 Esc도 Ctrl+C도 듣지 않던 턴이 기록되어 있습니다.

1. 1먼저 Esc을 한 번 누르고 몇 초 기다리고, 스피너가 계속 돌면 Ctrl+C.
2. 2입력이 죽은 채라면 터미널 탭을 닫고 새로 열어, 같은 디렉터리에서 claude --resume으로 세션을 되살립니다.
3. 3긴 턴마다 똑같이 멈춘다면 Claude Code를 업데이트한 뒤 멈춘 MCP 서버나 훅을 의심하세요——생각이 멈춘 것과 구분이 안 되거든요. /mcp를 보면 어느 서버가 문제인지 나옵니다.

claude --resume

"Not responding — try stopping"

이 주황색 배너는 Claude Code의 와치독입니다: 도구 호출——보통 긴 bash 명령——이 일정 시간 조용하면 UI가 정지 버튼을 내밉니다. 이건 조언이지 판정이 아닙니다: Anthropic 자신의 데모에서 배너 아래에서 프로세스가 정상적으로 일하고 있었고, Claude Code 리드 Boris Cherny는 이 상태의 녹화를 공개적으로 요청했습니다——팀이 인지하고 조사 중이라는 뜻입니다.

1. 1먼저 기반 명령이 아직 출력을 내는지 확인——조용히 컴파일 중인 빌드는 중단할 필요가 없습니다.
2. 2정말 낌어있는 게 확인되면 Esc이나 주황색 정지 버튼으로 그 턴을 중단합니다.
3. 3그다음 내가 수동으로 멈췄다고 Claude에게 알려주세요——수동 정지 뒤 모델은 도구가 거절됐다고 오해해, 계속하는 대신 사과부터 할 수 있습니다.
4. 4긴 작업은 백그라운드로 또는 잘게 나눠 다시 실행해, 포그라운드 와치독이 다시 울지 않게 하세요.

claude --resume

알려진 거친 면: Anthropic 자신의 이 배너 데모에서도 정지 버튼이 뜬 순간 명령은 여전히 건강했습니다——멈추기 전에 확인하세요.

"Resuming container…"에서 멈춤 (클라우드 세션)

Claude Code의 웹·모바일 세션은 클라우드 컨테이너에서 돕니다. 오래된 세션을 다시 연다는 건 그 컨테이너를 다시 띄우고 대화 기록을 스트리밍한다는 뜻이라, 기록이 클수록 실제로 오래 걸립니다. v2.1.286은 아주 큰 기록의 세션이, 트랜스크립트 로딩 중 컨테이너가 멈춘 탓에 다시는 깨어나지 못하던 버그를 수정했습니다.

1. 1먼저 몇 분 기다리세요——콜드 컨테이너 재개는 새 세션보다 느리고, 움직이고 있다고 알려주는 진행 바도 없습니다.
2. 2CLI를 v2.1.286 이상으로——claude update, 또는 npm install -g @anthropic-ai/claude-code——그 릴리스가 아주 큰 클라우드 기록이 깨어나지 못하는 버그를 수정했습니다.
3. 3업데이트 후에도 얼어 있다면? 웹 세션을 새로 고치고, 그래도 안 되면 새 세션을 열어 작업을 이어가세요.

claude updatenpm install -g @anthropic-ai/claude-code

커뮤니티 우회법, 공식 답변 대기 중: 여러 사용자가 컨테이너가 5분 안쪽으로 깨어났다고 보고했습니다——그 시점을 넘긴 뒤에 사망 판정을 하세요.

시작할 때 프리즈

프롬프트가 뜨기 전에 얼어붙는 건 거의 항상 로컬 문제입니다: 크래시하는 MCP 서버, 플러그인, 훅, 깨진 상태, 또는 확장 자체. v2.1.284는 Restart Extensions 뒤 탭이 응답하지 않는 문제를, v2.1.286은 확장이 응답을 멈췄을 때 끝없이 도는 "Teleporting session…" 스피너를 수정했습니다. 앱 안의 /doctor는 세션이 살아 있어야 돌아가므로, 셸부터 시작합니다.

1. 1터미널에서 claude doctor를 실행——시작조차 안 되는 경우에 공식 문서가 권하는 바로 그 방법입니다. 설치를 검사하고 수정안을 제안합니다.
2. 2claude --safe-mode로 실행하세요. 그 세션 한정으로 모든 플러그인·MCP 서버·훅을 끕니다——시작에 성공하면 범인은 그 커스터마이즈 중에 있습니다.
3. 3커스터마이즈를 하나씩 다시 켜거나——들어갈 수 있으면 /mcp를 돌려——범인을 찾아 업데이트하거나 제거하세요.
4. 4VS Code라면 확장도 업데이트——위의 두 2.1.28x 수정은 현재 버전에만 존재합니다.

claude doctorclaude --safe-mode

터미널에서 프리즈

정석적인 전 창 프리즈——입력 죽음, 스피너 정지, Ctrl+C 무시——에는 공식 매뉴얼이 있습니다: 취소를 시도하고, 필요하면 터미널을 재시작하고, 세션을 재개하는 것. 어느 쪽이든 잃는 건 없습니다. 에디터 통합 터미널에서 출력이 갈라지거나 반쯤 그려지는 건 별개의, GPU 가속 문제이며 명령 한 줄로 고칩니다.

1. 1Ctrl+C로 현재 작업 취소를 시도합니다.
2. 2창이 여전히 무반응이면 터미널을 완전히 닫고 새로 엽니다.
3. 3새 터미널에서 같은 프로젝트 디렉터리에 claude --resume——공식 문서는 대화가 사라지지 않는다고 약속합니다.
4. 4VS Code 통합 터미널에서 출력이 갈라진다면 /terminal-setup——터미널의 GPU 가속을 꺼서 깨짐을 해결합니다.

claude --resume/terminal-setup