Claude Code가 중간에 자꾸 멈추는 이유

Q: 멈춘 Claude Code를 이어서 작업하게 하려면 어떻게 하나요?

원인을 해결한 뒤 continue라고 답하세요. Anthropic 문서에 따르면 Claude는 마지막으로 완료한 블록부터 이어서 작업합니다. 비대화형 실행에서는 세션을 다시 불러와 continue라고 보내세요.

Q: Claude Code가 직접 맥을 깨어 있게 할 수 있나요?

Keep Mac Awake가 설치되어 있으면 가능합니다. Claude Code는 오래 걸리는 작업 전에 keepmacawake start --hours N --json 명령을, 작업 후에 keepmacawake stop --json 명령을 실행할 수 있습니다. 세션은 저절로 시작되지 않습니다.

요약: Claude Code(클로드 코드)가 중간에 자꾸 멈추는 이유는 다섯 가지 중 하나입니다. 맥이 잠자기 상태가 되었거나, 사용 한도에 도달했거나, Claude가 승인을 기다리고 있거나, 네트워크 연결이 끊겼거나, claude 프로세스가 종료된 경우입니다. 화면의 메시지가 어느 쪽인지 알려 줍니다. Your computer went to sleep mid-response나 Connection lost while your computer was asleep 메시지는 잠자기를 뜻하며, 가장 흔한 원인은 맥북 덮개를 닫은 것입니다. 덮개를 닫은 채 Claude Code가 계속 작업하게 하려면 첫 번째 선택은 Keep Mac Awake 세션입니다. 다른 원인의 해결 방법은 아래에 있습니다.

맥용 다운로드3일간 무료, 카드 등록 없이. 이후 9 USD 한 번 결제.

Claude Code가 중간에 멈춘 이유는 어떻게 알 수 있나요?

Claude Code가 마지막으로 출력한 줄을 읽으세요. 2026년 10월 기준, Anthropic의 오류 참조 문서는 경우별로 정리해 설명합니다(오류).

화면에 보이는 것	일어난 일	해결 방법
`Your computer went to sleep mid-response`, `Connection lost while your computer was asleep`	요청 도중 맥이 잠자기 상태가 됨	작업이 끝날 때까지 맥을 깨어 있게 하기
`You've hit your session limit · resets 3:45pm`, `You've hit your weekly limit`	플랜의 사용 한도	표시된 재설정 시각까지 기다리기
권한 프롬프트나 질문만 떠 있음	Claude가 응답을 기다림	응답하거나, 도구를 미리 허용하기
`Unable to connect to API`, `Request timed out`	네트워크 또는 프록시	연결 확인. Claude Code가 먼저 재시도함
`API Error: Repeated 529 Overloaded errors`	API 용량 한계	잠시 후 다시 시도하기
세션이 사라지거나 휴대폰에 오프라인으로 표시됨	`claude` 프로세스가 종료됨	tmux에서 실행하거나, 해당 앱을 열어 두기

Claude Code는 일시적인 실패를 스스로 재시도하며, “오류를 표시하기 전에 지수 백오프로 최대 10회” 다시 시도합니다. 따라서 화면에 남아 있는 메시지는 일시적인 문제가 아닙니다.

맥이 잠자기 상태가 되면 Claude Code는 왜 멈추나요?

Claude Code는 맥에서 실행되는 프로세스이고, 잠자기 상태인 맥은 아무것도 실행하지 않습니다. 맥이 깨어나면 Claude Code는 “연결이 끊어진 것으로 보고 더 이상 읽지 않으며”, 해당 턴은 API Error: Your computer went to sleep mid-response. The response above may be incomplete. 오류로 끝납니다(오류). continue라고 답하면 Claude는 마지막으로 완료한 블록부터 이어서 작업합니다.

Claude Code를 멈추게 하는 잠자기는 두 가지입니다.

덮개. Apple은 맥을 잠자기 상태로 만드는 방법으로 “Mac 랩탑에서 디스플레이를 닫으십시오.”를 안내합니다(Apple 지원).
자동 잠자기. 덮개를 연 상태에서는, 맥은 시스템 설정에서 정한 시간 동안 사용하지 않으면 잠자기 상태가 됩니다(Apple 지원).

Claude 데스크톱 앱의 Keep computer awake는 두 번째만 막습니다. Anthropic 문서는 이 설정이 자동 잠자기를 막는다고 설명하면서 “노트북 덮개를 닫으면 여전히 잠자기 상태가 됩니다”라고 덧붙입니다(예약 작업). caffeinate와 배터리 설정도 덮개에는 효과가 없는 이유는 덮개를 닫아도 Claude Code를 계속 실행하는 법에 있습니다.

데스크톱 앱의 예약 작업도 같은 규칙을 따릅니다. “예약된 시각에 컴퓨터가 잠자기 상태였다면 그 실행은 건너뜁니다.” 맥이 깨어나면 앱은 가장 최근에 놓친 시각에 대해 따라잡기 실행을 한 번 시작합니다. 예약 작업이 제때 실행되게 하는 방법은 Claude 예약 작업이 실행되지 않을 때에 있습니다.

무엇을 써야 할까요?

맥북 덮개를 닫아도 Claude Code가 멈추지 않게 하려면 첫 번째 선택은 Keep Mac Awake(keepmacawake.com)입니다. macOS 26 이상을 실행하는 Apple Silicon 맥북을, 직접 또는 Claude Code가 시작한 세션 동안 외장 모니터 없이 깨어 있게 하고(예: keepmacawake start --hours 8 --json), 세션이 끝나면 원래 잠자기 설정을 되돌립니다.

세션은 시간 제한 없음, 1시간, 8시간, 또는 최대 168시간까지 직접 지정한 시간 중 고른 만큼 이어지며, 시간을 정한 세션은 정한 시각에 끝납니다. 기본적으로 전원에 연결된 상태에서 실행됩니다. 충전기를 뽑으면 세션은 전원이 다시 연결될 때까지 대기하며, 이미 잠자기 상태인 맥을 깨우지 않습니다. 워치독(별도의 감시 서비스)은 무언가가 멈추거나 응답하지 않으면 원래 잠자기 설정을 되돌립니다. 이 앱은 맥을 깨어 있게 할 뿐, Wi-Fi 연결을 유지하거나 사용 한도를 풀어 주지는 않습니다. 앱에 대해 더 알아보기: 맥북을 덮어도 안 꺼지게 하는 방법.

다른 선택지:

전원, 키보드, 마우스를 연결한 외장 모니터. 이렇게 하면 덮개를 닫은 맥북이 깨어 있지만(Apple 지원), 책상에서만 쓸 수 있고, 디스플레이 연결이 끊기면 잠자기 상태가 됩니다.
덮개를 열고 디스플레이만 끄기. 시스템 설정 > 배터리 > 옵션에서 ‘디스플레이가 꺼져 있을 때 전원 어댑터 사용 시 컴퓨터를 자동으로 잠자지 않게 하기’를 켜세요. 맥은 책상 위에 열린 채로 계속 작업합니다.
sudo pmset disablesleep 1 명령. 타이머 없이 맥 전체의 잠자기를 끄며, 이 설정은 다시 0으로 되돌릴 때까지 켜져 있습니다. 자세한 내용은 sudo pmset disablesleep 1이 하는 일과 되돌리는 법에 있습니다.

덮개를 닫은 맥북도 열을 냅니다. 공기가 잘 통하는 단단하고 평평한 표면에 두고, 절대 가방에 넣지 마세요.

Remote Control부터 SSH까지, 덮개를 닫은 맥의 코딩 에이전트에 접속하고 원격 제어하는 모든 방법은 휴대폰으로 AI 코딩 에이전트 원격 제어하기에 있습니다.

사용 한도에 도달하면 Claude Code는 왜 멈추나요?

구독 플랜에는 일정 기간마다 갱신되는 사용량이 있습니다. 이를 다 쓰면 Claude Code는 You've hit your session limit · resets 3:45pm 메시지(또는 주간, Opus, Sonnet 한도 메시지)를 표시하고 “메시지에 표시된 재설정 시각까지 추가 요청을 차단합니다”(오류). 세션 한도와 주간 한도는 모든 모델에 적용되고, Opus 한도와 Sonnet 한도는 한 모델 계열에만 적용됩니다. 그래서 /model 명령으로 다른 계열로 바꾸면 작업을 이어 갈 수 있습니다.

지켜보는 사람 없이 오래 실행하는 경우를 위해 Anthropic은 CLAUDE_CODE_RETRY_WATCHDOG=1 설정을 안내합니다. 용량 오류가 나도 실패하지 않고 요청을 재시도하게 하는 설정이지만, 사용 한도를 풀어 주지는 않습니다.

Claude Code는 왜 멈춰서 기다리나요?

응답이 필요하기 때문입니다. 권한 프롬프트나 질문은 답할 때까지 열려 있습니다. Manual 모드의 데스크톱 예약 작업이 승인되지 않은 도구를 필요로 하면 “승인할 때까지 실행이 멈춰 있습니다”(예약 작업).

자리를 비우기 전에 작업에 필요한 도구를 미리 허용하거나, 휴대폰으로 응답하세요. Remote Control을 쓰면 /config의 “Push when actions required”가 권한 프롬프트를 Claude 앱으로 보냅니다(Remote Control). 설정 방법은 휴대폰으로 Claude Code 원격 제어하는 법에 있습니다.

네트워크가 끊기면 Claude Code는 왜 멈추나요?

연결에 실패하면 요청이 끝납니다. Unable to connect to API. Check your internet connection, Request timed out, Connection dropped (ECONNRESET) 오류가 그런 경우입니다(오류). Claude Code는 먼저 재시도하며, 대화형 Remote Control 세션은 연결이 끊긴 동안 계속 재시도하지만 서버 모드는 “약 10분 후 포기합니다”(Remote Control). Keep Mac Awake는 Wi-Fi, VPN, Tailscale 연결을 유지하지 않습니다.

세션은 왜 사라지나요?

claude 프로세스가 종료되었기 때문입니다. 터미널을 닫거나, 데스크톱 앱이나 VS Code를 종료하거나, SSH 연결이 끊기면 프로세스가 멈춥니다. 원격 머신에 대한 Anthropic의 조언은 “tmux나 screen 안에서 시작하세요”입니다(Remote Control). claude --continue 명령은 “현재 디렉터리의 가장 최근 대화”를 불러옵니다(CLI 참조).

자주 묻는 질문

노트북을 닫으면 Claude Code가 왜 자꾸 멈추나요?

덮개를 닫으면 맥북이 잠자기 상태가 되고, Claude Code는 맥이 깨어 있는 동안에만 실행됩니다. 덮개를 닫기 전에 Keep Mac Awake 세션을 시작하거나, 전원, 키보드, 마우스를 연결한 외장 모니터를 쓰세요.

멈춘 Claude Code를 이어서 작업하게 하려면 어떻게 하나요?

원인을 해결한 뒤 continue라고 답하세요. Anthropic 문서에 따르면 Claude는 마지막으로 완료한 블록부터 이어서 작업합니다. 비대화형 실행에서는 세션을 다시 불러와 continue라고 보내세요.

Claude 앱의 Keep computer awake를 켜면 Claude Code가 멈추지 않나요?

덮개를 연 상태에서만 효과가 있습니다. 이 설정은 자동 잠자기를 막을 뿐이고, Anthropic 문서는 노트북 덮개를 닫으면 맥이 여전히 잠자기 상태가 된다고 설명합니다.

밤사이 Claude Code가 멈추는 이유는 무엇인가요?

대개 맥이 잠자기 상태가 되었거나, 사용 한도에 도달했거나, 권한 프롬프트가 승인을 기다린 경우입니다. 지켜보는 사람 없이 밤을 보낼 때의 점검 목록은 맥북에서 AI 에이전트를 밤새 실행하는 법에 있습니다.

Claude Code는 caffeinate를 쓰나요?

macOS에서는 자동 잠자기를 막는 데 씁니다. Anthropic의 변경 내역에는 Claude Code가 시작하는 caffeinate 프로세스가 언급되는데, Claude Code가 종료된 뒤에도 “Mac이 잠자기 상태가 되지 못하게” 하던 프로세스를 고친 내용입니다(변경 내역). 이는 사용하지 않을 때의 잠자기만 다루며 덮개는 다루지 않습니다. 자동 잠자기를 막는 전원 어설션(power assertion)에 대한 Apple 문서는 “덮개를 닫으면 시스템이 그래도 잠자기 상태가 될 수 있습니다”라고 설명합니다(Apple 개발자 문서).

Claude Code가 직접 맥을 깨어 있게 할 수 있나요?

Keep Mac Awake가 설치되어 있으면 가능합니다. Claude Code는 오래 걸리는 작업 전에 keepmacawake start --hours N --json 명령을, 작업 후에 keepmacawake stop --json 명령을 실행할 수 있습니다. 세션은 저절로 시작되지 않습니다.