Claude Code가 멈추거나 진행되지 않거나 응답하지 않는 경우: 멈춘 지점을 파악하고 벗어나는 방법

어디서 멈췄나요? 화면을 확인한 다음 프로세스를 살펴보세요

# in the session
Esc            # cancel the current tool or turn
Ctrl+C (twice) # abort the turn / exit
# from another terminal
ps aux | grep -E "claude|node" | grep -v grep     # child processes still running?
top -o cpu       # is claude spinning or idle?
claude --debug   # next time: timestamps for every request and tool call
claude -c        # resume the last session after a kill

프롬프트가 멈춘 상태에서 CPU가 유휴 상태라면 외부의 무언가를 기다리고 있다는 뜻입니다. 네트워크 스트림, MCP 서버, 자식 프로세스 또는 보이지 않는 프롬프트일 수 있습니다. CPU 사용률이 최대치에 고정되어 있다면 내부 작업을 처리하고 있다는 뜻입니다. 방대한 도구 결과 파싱, 정규식 역추적, 큰 세션 로딩 등이 해당합니다. 메모리 사용량이 계속 증가한다면 도구 결과나 세션 파일을 통째로 읽어 들이고 있다는 뜻입니다.

이슈 트래커에 보고된 원인

• `/rewind` 멈춤, `Ctrl+C` 무시됨, `kill -9` 필요 (#53011, 반응 21개, 2.1.1xx 빌드에서 세션 크기와 관계없이 발생). Anthropic 엔지니어는 2.1.233에서 재현하지 못했으므로 먼저 업데이트하세요. 이전 빌드에서는 프로세스를 종료하고 다음 명령으로 재개하세요: claude -c 되감기 대신 사용하세요.
• Remote Control 세션이 실행 도중 멈추며 로컬 `Esc`로만 다시 작동합니다 (#51267, 미해결). 도구나 하위 프로세스가 차단되면 원격 취소 기능 없이 원격 세션 전체가 멈춥니다. 이런 세션은 짧게 유지하고 입력을 요청할 수 있는 도구는 피하세요.
• `Enter`에서 MCP 인증 프롬프트가 멈춤 (#42707, 미해결). 별도의 claude mcp 명령이나 브라우저에서 서버를 인증한 다음 세션을 다시 시작하세요.
• 내장 매처를 통한 `grep` 실행이 메모리를 모두 소모함 (#54394): 네이티브 빌드에서는 모든 셸 grep 실행이 다음 프로세스 안에서 이루어집니다: claude 이 프로세스는 자체 V8 힙을 갖습니다. 긴 압축 코드 줄에 백트래킹 정규식을 적용하면 메모리 사용량이 기가바이트 단위로 급증하고, OOM 킬러가 세션까지 함께 종료합니다. WSL2와 Linux 모두에서 발생합니다. 압축된 파일에 제한 없는 정규식을 사용하지 말고, 빌드 출력과 다음 항목을 제외하세요: node_modules. 또는 시스템에 다음 도구를 설치하세요: ripgrep 그리고 명시적으로 호출하세요.
• `400 thinking blocks cannot be modified`에서 재시도 루프에 갇힘 (#63231) — 대화 기록이 유효하지 않아 재시도할 때마다 같은 방식으로 실패합니다. /rewind 해당 턴 이전으로 되돌리거나 /clear; 다음 문서를 참조하세요: 400 가이드.
• **클라우드 / 예약 실행이 *클라우드 컨테이너 설정 중*에서 멈춤** (#53691, #54528) — 서비스 측 문제입니다. 로컬에서 조치할 사항은 없으므로 취소하고 status.claude.com.를 확인하세요.
• 대규모 세션 재개에 수 분이 걸림 — 시작 시 대화 기록을 다시 처리합니다. 가장 큰 세션 대신 필요한 특정 세션을 재개하고(claude -r), 지나치게 커진 세션은 압축 기능으로 줄이세요.

시작 시 멈춤

다음 명령 직후 빈 화면이 나타나고 claude 프롬프트가 표시되지 않는다면 대개 첫 API 호출이 응답하지 않는 것입니다. 작동하지 않는 프록시를 가리키는 프록시 변수, VPN, DNS 또는 접근할 수 없는 다음 대상이 원인일 수 있습니다: ANTHROPIC_BASE_URL. 다음 문서의 curl 점검을 실행하세요: 연결 오류 가이드, 그다음 claude doctor. 시작이 느리지만 결국 프롬프트가 나타난다면 MCP 서버가 실행되는 중입니다; claude mcp list 그리고 시간 초과가 발생하는 서버를 제거하세요.

종료되지 않는 자식 프로세스

편집기를 열거나, 비밀번호를 기다리거나, 로그를 계속 추적하거나, 개발 서버를 시작하는 셸 도구는 반환되지 않으며 해당 턴은 도구가 끝나기를 기다립니다. 에이전트에게 서버를 백그라운드에서 실행하도록 지시하고, 명령이 입력을 요청할 수 있는 경우 다음을 추가하도록 하세요: --no-pager, -y 또는 < /dev/null 입력을 요청할 수 있는 명령에 사용하세요. 이미 발생했다면, Esc 도구를 취소합니다. 자식 프로세스가 이를 무시하면 다른 터미널에서 PID로 종료하세요. 그러면 오류와 함께 턴이 계속 진행됩니다.

높은 메모리 및 CPU 사용량

• 도구 결과는 세션 동안 메모리와 디스크에 보관됩니다. 200 MB 파일을 읽으면 세션 크기도 200 MB가 됩니다. 필요한 부분만 읽으세요.
• 여러 하위 에이전트를 병렬로 실행하면 모든 사용량이 배가됩니다; CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2 사양이 낮은 컴퓨터에서 사용하세요.
• 렌더링이 느린 터미널 에뮬레이터(일부 Windows 콘솔, 대역폭이 낮은 연결을 통한 원격 tmux)는 스트리밍 출력이 멈춘 것처럼 보이게 합니다; claude --debug 토큰이 계속 도착하는지 보여줍니다.
• 유휴 상태에서 메모리 사용량이 증가하면 남아 있는 다음 항목을 찾아보세요: claude 비정상 종료된 IDE 세션에서 남은 프로세스를 찾아 종료하세요(프로세스가 코드 1로 종료됨 문서에서 Windows의 고아 프로세스 사례를 다룹니다).

클라이언트가 아닌 API 문제인 경우

작은 로딩 표시가 나타나고 결국 재시도 문구가 표시되면서 매 턴 같은 지점에서 멈추는 세션은 클라이언트 버그보다 API 경로의 지연이나 연결 끊김 문제입니다: 529 과부하, 서버 측 요청 제한 또는 연결 재설정입니다. 게이트웨이를 통하면(ANTHROPIC_BASE_URL=https://aiprimetech.io) 용량이 포화된 업스트림 계정에서 다른 계정으로 장애 조치가 이루어져 바로 이런 대기 시간이 줄어듭니다.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

자주 묻는 질문

AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.