Claude Code “응답이 스트리밍 중간에 멈춤” 및 “완전한 데이터가 수신되기 전에 스트리밍 응답이 종료됨” — 스트림을 중단시키는 원인

먼저 continue라고 답하세요

Claude Code는 실패 전에 완료된 텍스트와 도구 호출을 유지하고 알림을 덧붙입니다. 대화형 세션에서는 도착한 내용을 읽고 continue라고 답하세요. 해당 지점부터 턴이 재개됩니다. 비대화형 실행(claude -p)에서는 Claude Code가 마지막으로 완료된 텍스트 블록 뒤에 알림을 출력합니다. 해당 세션을 재개하고 continue를 보내세요. 한 번 발생한 경우 다른 변경은 필요하지 않습니다.

메시지를 구분하세요

Claude Code의 오류 참조는 원인별로 불완전한 응답 문구를 나열합니다. 응답 중간의 서버 오류, 응답 중간의 연결 끊김, 응답 중간의 컴퓨터 절전, 응답 도착 중단(멈춤), 응답 일부 미도착 및 응답 스트림의 잘못된 형식입니다. 2026년 7월 보고서에서는 멈춤에 대해 이전 문구인 “Response stalled mid-stream”을 인용합니다. 별도의 메시지인 “Streaming response ended before any complete data was received”는 완전한 데이터가 전혀 도착하지 않은 경우이므로, Claude Code는 부분 답변을 유지하는 대신 스트리밍 없이 재시도합니다.

감시 기능을 조정하되 끄지는 마세요

Claude Code는 스트림에 데이터가 들어오지 않으면 이를 중단하는 네 가지 타이머를 실행합니다. 따라서 끊어진 연결은 무한정 멈춰 있는 대신 실패 처리되고 재시도됩니다. 이 타이머는 첫 바이트 수신 제한 시간, 이벤트 수준 감시 타이머(300초), 바이트 수준 감시 타이머(Anthropic API에 직접 연결할 때는 180초, 사용자 지정 ANTHROPIC_BASE_URL을 포함한 그 외의 경우에는 300초), 그리고 일부 제공업체에서 적용되는 5분의 본문 유휴 시간 제한입니다. CLAUDE_STREAM_IDLE_TIMEOUT_MS는 두 감시 타이머를 모두 설정합니다. 5분 미만의 값은 5분으로 상향 조정되며, 바이트 수준 감시 타이머의 상한은 30분입니다. 백그라운드 에이전트에도 적용되도록 settings.json의 env 블록에 설정하세요:

{
  "env": {
    "CLAUDE_STREAM_IDLE_TIMEOUT_MS": "600000"
  }
}

프록시 또는 게이트웨이 뒤에 있다면 해당 요소 없이 테스트하세요

스트리밍 없이 재시도한다는 메시지가 반복되면 한 번 경로를 제거하세요. 단일 세션에서 HTTPS_PROXY를 설정 해제하거나 NO_PROXY="*"로 설정한 뒤 동일한 작업을 실행합니다. 멈추면 해당 경로가 원인입니다. 일반적인 원인은 긴 세션이 초과하는 요청 본문 크기 제한, 라이브 스트림을 긴 침묵으로 바꾸는 응답 버퍼링, 모델의 사고 일시 중지보다 짧은 읽기 시간 제한입니다. ANTHROPIC_BASE_URL이 게이트웨이를 가리킬 때 첫 바이트 기한은 실행되지 않지만 바이트 수준 감시 기능은 실행된다는 점에 유의하세요.

Claude Code에서 “위 응답은 불완전할 수 있습니다”는 무슨 뜻인가요?

답변 일부가 도착한 뒤 스트리밍 답변이 멈췄습니다. 멈춤, 연결 끊김, 서버 오류 또는 컴퓨터 절전이 원인일 수 있습니다. Claude Code는 완료된 텍스트와 도구 호출을 유지하고 알림을 덧붙입니다. continue라고 답하면 도착한 내용부터 턴이 재개됩니다.

“Response stalled mid-stream”은 “The response stopped arriving”과 같은 뜻인가요?

두 문구는 같은 경우를 설명합니다. 연결은 열린 상태였지만 데이터 전송이 중단되어 스트리밍 감시 기능이 연결을 중단했습니다. Claude Code의 현재 오류 참조는 “The response stopped arriving”을 사용하며, 2026년 7월에 제출된 보고서에서는 “Response stalled mid-stream”을 인용합니다.

Claude Code가 “Retrying without streaming”이라고 표시하는 이유는 무엇인가요?

완전한 데이터가 수신되기 전에 스트림이 종료되어 유지할 내용이 없었기 때문입니다. Claude Code는 스트리밍 없이 동일한 요청을 다시 보냅니다. 메시지가 계속 나타나면 Claude Code와 프로바이더 사이의 프록시 또는 게이트웨이를 확인하세요. 일반적인 원인은 본문 크기 제한, 버퍼링 및 읽기 시간 제한입니다.

스트리밍 감시 기능을 꺼야 하나요?

아니요. 감시 기능은 연결이 끊겼을 때 세션이 무한히 멈춰 있지 않고 실패 후 재시도하도록 존재합니다. 연결이 실제로 긴 시간 동안 조용해지는 경우에는 CLAUDE_ENABLE_STREAM_WATCHDOG 또는 CLAUDE_ENABLE_BYTE_WATCHDOG를 0으로 설정하지 말고 CLAUDE_STREAM_IDLE_TIMEOUT_MS를 늘리세요(5분 미만의 값은 5분으로 상향됩니다).

ANTHROPIC_BASE_URL을 사용하는 게이트웨이가 이런 현상을 더 일으키나요?

Claude Code와 프로바이더 사이의 각 경로는 스트림이 버퍼링되거나 잘리거나 시간 초과될 수 있는 지점을 하나씩 추가하므로 메시지가 반복될 때는 해당 경로 없이 테스트하세요. 바이트 수준 감시 기능은 게이트웨이 연결에서도 실행되지만, ANTHROPIC_BASE_URL이 게이트웨이를 통해 라우팅될 때 첫 바이트 기한은 실행되지 않습니다.