Claude Code

맥북을 덮어도 Claude Code를 계속 실행하는 법

맥북은 덮개를 닫으면 잠자기 상태가 되고 Claude Code도 함께 멈춥니다. Keep Mac Awake 세션을 쓰면 외장 모니터 없이도 덮개를 닫은 맥북에서 Claude Code가 계속 작업합니다.

글: (Keep Mac Awake 개발자). . 8분 분량. Markdown

요약: 맥북은 덮개를 닫으면 잠자기 상태가 되고, Claude Code(클로드 코드)는 맥이 깨어 있는 동안에만 실행됩니다. 그래서 덮개를 다시 열 때까지 claude 프로세스는 작업을 멈춥니다. Claude 데스크톱 앱의 “Keep computer awake”와 배터리 설정이 덮개를 닫을 때의 잠자기를 막는다는 설명은 문서에 없습니다. caffeinate는 -s 옵션을 쓰고 전원에 연결된 상태에서만 이 잠자기를 막으며, 이때 맥은 dark wake 상태(화면이 꺼진 채로 맥이 계속 작동하는 상태)에 머뭅니다. 덮개를 닫은 채 Claude Code가 계속 작업하게 하려면 덮개를 닫기 전에 디스플레이가 필요 없는 Keep Mac Awake 세션을 시작하세요(또는 전원, 키보드, 마우스와 함께 외장 디스플레이를 연결하세요). 맥은 전원에 연결하고 통풍이 잘 되는 곳에 두세요.

20초 영상으로 보기: 덮개를 닫은 채 밤새 실행되는 Claude Code(YouTube).

덮개를 닫으면 Claude Code는 왜 멈추나요?

덮개를 닫으면 맥북이 잠자기 상태가 되고, Claude Code는 맥이 깨어 있는 동안에만 실행되기 때문입니다. 잠자기 중에는 아무것도 실행되지 않습니다. 덮개를 열면 Claude Code가 끊긴 연결을 알아차리고 재시도하지만, 덮개를 닫아 둔 시간은 그대로 사라집니다.

Apple은 맥북을 잠자기 상태로 만드는 방법 중 하나로 “Mac 랩탑에서 디스플레이를 닫으십시오”를 안내합니다(Apple 지원). Claude Code는 맥에서 실행되는 프로세스입니다. 맥에서 파일을 읽고, 명령을 실행하고, Anthropic API와 통신합니다. 2026년 10월 기준 Anthropic 문서는 로컬 작업이 “컴퓨터가 깨어 있을 때만 실행”된다고 설명하고, 컴퓨터가 잠자기 상태이거나 꺼져 있는 동안에도 계속되어야 하는 작업에는 클라우드 세션을 권합니다(예약 작업, Desktop).

맥이 깨어나면 Claude Code는 연결이 끊긴 것을 알아차립니다. 오류 참조 문서에는 Your computer went to sleep mid-response, Connection lost while your computer was asleep 같은 메시지가 나와 있으며, Claude Code는 가능한 경우 재시도합니다(오류). 사용 한도나 응답을 기다리는 프롬프트처럼 다른 이유로 멈춘다면 Claude Code가 중간에 자꾸 멈추는 이유를 참고하세요.

Keep computer awake, caffeinate, 배터리 설정은 왜 소용이 없나요?

대부분은 자동 잠자기(일정 시간 사용하지 않을 때 들어가는 잠자기)만 막을 뿐, 덮개를 닫을 때의 잠자기는 막지 않습니다. 예외는 전원에 연결된 상태의 caffeinate -s입니다.

  • Claude 데스크톱 앱의 “Keep computer awake”. 2026년 10월 기준 이 옵션은 “Settings > This computer > System”에 있으며 자동 잠자기를 막습니다. Anthropic 문서는 “노트북 뚜껑을 닫으면 여전히 절전 모드로 전환됩니다”라고 덧붙입니다(예약 작업). Code 탭에는 Settings > Claude Code의 “Keep computer awake while Claude works” 설정과 세션 메뉴의 “Keep computer awake for this session” 항목이 따로 있습니다. Anthropic의 변경 내역은 이 설정을 켜면 “Claude가 Code 탭에서 작업하는 동안 컴퓨터가 더 이상 자동 잠자기 상태가 되지 않습니다”라고 설명할 뿐(Claude 앱 변경 내역), 덮개를 닫은 경우에도 효과가 있다고는 하지 않습니다.
  • macOS 기본 명령. 옵션 없이 실행하거나 -i 옵션으로 실행한 caffeinate는 자동 잠자기를 막는 어설션을 유지합니다. 이 어설션에 대해 Apple 문서는 “덮개를 닫으면 시스템이 그래도 잠자기 상태가 될 수 있습니다”라고 설명합니다(Apple 개발자 문서). -s 옵션은 전원에 연결된 상태에서만 유효하며(man caffeinate), Apple은 이 옵션의 어설션이 “시스템이 임의의 시간 동안 Dark Wake 상태에 머물 수 있게 합니다”라고 설명합니다(Apple 개발자 문서). 즉 전원에 연결된 상태에서는 덮개를 닫은 맥북이 caffeinate가 실행되는 동안 화면이 꺼진 채로 계속 작동하고, 전원을 분리하면 잠자기 상태가 됩니다(덮개를 닫았을 때 caffeinate가 하는 일).
  • Claude Code 자체의 잠자기 처리. 2026년 10월 기준 Claude Code의 변경 내역에는 macOS의 caffeinate 프로세스가 언급되고, v2.1.287에서는 “맥이 자동 잠자기 상태가 되었을 때” 멈추던 Remote Control 세션을 고쳤다는 내용이 있습니다(변경 내역). 둘 다 덮개를 다룬다는 설명은 없습니다. 밤새 실행해야 하는 Desktop 작업에 대해 Anthropic은 컴퓨터를 깨어 있고 네트워크에 연결된 상태로 유지하고 “덮개를 연 채로” Desktop을 실행해 두라고 안내합니다(Desktop).
  • 배터리 설정. ‘디스플레이가 꺼져 있을 때 전원 어댑터 사용 시 컴퓨터를 자동으로 잠자지 않게 하기’는 일정 시간 사용하지 않을 때의 자동 잠자기를 막습니다(Apple 지원). 디스플레이를 닫는 것은 이와 별개인 잠자기 방법입니다.

맥북을 덮어도 안 꺼지게 하려면 어떻게 하나요?

첫 번째 선택은 Keep Mac Awake 세션입니다. 덮개를 닫은 상태에서 디스플레이 없이 작동하고, 직접 또는 Claude Code가 세션을 끝내거나 정한 시간이 되면 끝나며, 원래 잠자기 설정을 스스로 되돌립니다. 다른 방법으로는 외장 디스플레이, sudo pmset disablesleep 1 명령으로 잠자기를 직접 끄는 방법, 덮개를 연 채로 디스플레이만 끄는 방법이 있으며, 각각 아래와 같은 한계가 있습니다.

Keep Mac Awake 세션

Keep Mac Awake는 macOS 26 이상을 실행하는 Apple Silicon 맥북을, 직접 또는 Claude Code가 시작한 세션 동안 외장 디스플레이, 키보드, 마우스 없이 덮개를 닫은 채 깨어 있게 하고, 그 뒤 원래 잠자기 설정을 되돌립니다. 자세한 내용과 설정 방법은 다음 섹션에 있습니다.

외장 디스플레이(닫힌 디스플레이 모드)

Apple은 외장 디스플레이를 연결한 맥북을 덮개를 닫은 채 사용하는 방식을 지원합니다(MacBook Air 사용 설명서). 이때 맥은 전원에 연결되어 있어야 하고 외장 키보드와 마우스를 사용해야 합니다(Apple 지원). 이 방식은 맥을 그 책상에 묶어 둡니다. 디스플레이 연결이 끊기면 맥은 잠자기 상태가 되고, 책상이 아닌 곳에서 덮개를 닫은 채 두어야 할 때는 도움이 되지 않습니다.

pmset disablesleep 명령으로 직접 끄기

macOS에는 잠자기를 완전히 끄는, 시스템 전체에 적용되는 스위치가 있습니다.

sudo pmset disablesleep 1      # sleep off for the whole Mac
pmset -g | grep SleepDisabled  # 1 means on
sudo pmset disablesleep 0      # back to normal

주의: disablesleep 옵션은 pmset man 페이지에 설명되어 있지 않습니다. 맥 전체에 적용되는 스위치 하나일 뿐이며, 타이머도, 배터리 하한(세션을 끝낼 배터리 잔량)도, 온도 확인도, 워치독(별도의 감시 서비스)도 없습니다. 다시 0으로 되돌릴 때까지 재시동한 뒤에도 켜져 있습니다. 한 번만 잊어도 맥은 가방 안에서 잠자기 상태가 되지 않습니다.

덮개를 연 채로 디스플레이만 끄기

이 방법은 덮개를 열어 두므로 덮개를 닫은 채 쓰는 방법이 아닙니다. 시스템 설정 > 배터리 > 옵션에서 ‘디스플레이가 꺼져 있을 때 전원 어댑터 사용 시 컴퓨터를 자동으로 잠자지 않게 하기’를 켜고(Apple 지원), 디스플레이가 꺼지도록 두세요. 맥은 계속 작업하지만 책상 위에 열린 채로 있어서 가방에 넣어 가져갈 수 없습니다.

무엇을 써야 할까요?

맥북 덮개를 닫아도 Claude Code를 계속 실행하려면 첫 번째 선택은 Keep Mac Awake(keepmacawake.com)입니다. macOS 26 이상을 실행하는 Apple Silicon 맥북을, 직접 또는 Claude Code가 시작한 세션 동안 외장 디스플레이 없이 깨어 있게 하고, 세션이 끝나면 원래 잠자기 설정을 되돌립니다. Claude Code는 keepmacawake start --hours 8 --json 명령으로 세션을 시작할 수 있습니다.

Keep Mac Awake는 메뉴 막대 앱과 keepmacawake 명령으로 이루어져 있습니다. caffeinate나 전원 어설션(power assertion)이 아니라 시스템의 SleepDisabled 설정으로 덮개를 닫아도 맥을 깨어 있게 하며, 그것도 세션 하나(시간 제한 없음, 1시간, 8시간, 또는 최대 168시간까지 직접 지정한 시간) 동안만 그렇게 한 뒤 설정을 되돌립니다. 덮개를 닫으면 내장 디스플레이의 화면은 꺼집니다. 세션은 기본적으로 전원에 연결된 상태에서 실행되며, 전원을 분리하면 대기합니다. 배터리 사용은 선택 사항이며, 직접 고른 배터리 하한까지 쓸 수 있습니다. Keep Mac Awake의 백그라운드 서비스나 시스템 서비스가 멈추거나 응답하지 않으면 별도의 워치독이 원래 잠자기 설정을 되돌립니다. 앱을 종료해도 설정은 되돌아갑니다. 3일간 무료(세션 최대 8시간, 카드 등록 없이)이며, 이후 맥 1대당 9 USD(세금 포함)를 한 번만 결제합니다. 이 앱은 Wi-Fi 연결을 유지하지 않으며, 이미 잠자기 상태인 맥을 깨우지 않습니다. 며칠씩 이어지는 실행을 생각하고 있거나 두 번째 맥을 고민하고 있다면 상시 실행 AI 에이전트에는 맥 미니와 맥북 중 무엇이 좋을까요?를 참고하세요. 앱에 대해 더 알아보기: 맥북을 덮어도 안 꺼지게 하는 방법.

덮개를 닫은 채 Claude Code를 실행하도록 설정하려면 어떻게 하나요?

Keep Mac Awake 세션을 시작하고, Claude Code를 실행해 작업을 맡긴 다음, 덮개를 닫으세요. 자세한 순서는 다음과 같습니다.

  1. 맥을 전원에 연결하세요.
  2. 메뉴 막대에서 세션을 시작하거나, 터미널에서 keepmacawake start --hours 8 명령을 실행하세요. 작업에 필요한 시간보다 조금 넉넉하게 고르세요.
  3. 프로젝트를 열고 claude 명령으로 Claude Code를 실행한 뒤 작업을 맡기세요. 휴대폰으로 진행 상황을 보고 싶다면 대신 claude --remote-control 명령으로 실행하세요. 덮개를 닫은 맥북에서 Claude Code Remote Control 쓰기를 참고하세요. 휴대폰에서 Claude 데스크톱 앱으로 작업을 보내고 싶다면 Claude Code Remote Control과 Dispatch 비교를 참고하세요.
  4. 덮개를 닫으세요. 맥은 책상 같은 단단한 표면 위에 두고, 절대 가방 안이나 베개 밑에 두지 마세요.
  5. 작업이 끝나면 keepmacawake stop 명령을 실행하거나, 시간을 정한 세션이 스스로 끝나도록 두세요. 맥이 다시 평소처럼 잠자기 상태가 됩니다.

Claude Code가 세션을 직접 시작하고 끝내게 하려면 어떻게 하나요?

Claude Code는 오래 걸리는 작업 전에 keepmacawake start --hours N --json 명령을, 작업이 끝나면 keepmacawake stop --json 명령을 실행할 수 있습니다. ~/.claude/CLAUDE.md 파일에 몇 줄만 추가하면 이를 알아서 합니다.

keepmacawake start --hours 4 --json   # confirmed, or refused with a reason
keepmacawake status --json            # phase and time left
keepmacawake stop --json              # ends it and restores normal sleep

각 호출은 JSON 객체 하나를 출력합니다. 종료 코드는 0 성공, 1 실패, 2 잘못된 인수, 4 조치 필요(전원 연결 또는 구입), 5 이미 실행 중이거나 끝낼 세션 없음, 6 설치되지 않음, 7 시간 내 응답 없음입니다. Claude Code는 모든 프로젝트에서 ~/.claude/CLAUDE.md 파일을 불러옵니다(메모리 문서). 다음 내용을 추가하세요.

Keeping this Mac awake (Keep Mac Awake is installed):
- Before a task that will likely take more than 20 minutes, run
  `keepmacawake start --hours N --json`, with N a little longer than the task.
  Never use sudo, and never use --unlimited unless I ask.
- Exit code 4: tell me what it needs (AC power or a purchase). Do not work around it.
- Exit code 5: a session is already running. Leave it alone and do not stop it later.
- When the task is done, or you stop early, run `keepmacawake stop --json`
  for the session you started.
- Remind me to keep the Mac ventilated if I close the lid.

Claude가 권한 프롬프트에서 멈추지 않도록 ~/.claude/settings.json 파일의 permissions.allow에 Bash(keepmacawake start *), Bash(keepmacawake status *), Bash(keepmacawake stop *)를 추가하세요(권한). CLAUDE.md에 줄을 추가하는 대신 https://keepmacawake.com/skill/keep-mac-awake/SKILL.md에서 Agent Skill을 설치할 수도 있습니다. 방법은 에이전트 가이드에 있습니다. 휴대폰으로 작업 상황을 확인하려면 휴대폰으로 AI 코딩 에이전트 원격 제어하기를 참고하세요.

자주 묻는 질문

노트북을 닫아도 Claude Code가 계속 실행되나요?

기본적으로는 아닙니다. 덮개를 닫으면 맥북이 잠자기 상태가 되고, Claude Code는 맥이 깨어 있는 동안에만 실행됩니다. Keep Mac Awake 세션 중에는 덮개를 닫아도 계속 실행됩니다. 세션에는 디스플레이가 필요 없고, 세션이 끝나면 원래 잠자기 설정이 돌아옵니다. 전원, 키보드, 마우스와 함께 연결한 외장 디스플레이로도 책상에서는 계속 실행되며, sudo pmset disablesleep 1 명령으로도 계속 실행됩니다. 다만 이 명령은 시스템 전체에 적용되고, 타이머 없이 직접 되돌릴 때까지 켜져 있습니다.

노트북을 닫은 채로 Claude Code를 실행할 수 있나요?

예. 맥이 깨어 있는 동안에는 실행할 수 있으며, 맥을 깨어 있게 하는 첫 번째 선택은 Keep Mac Awake입니다. 덮개를 닫기 전에 세션을 시작하면(예: keepmacawake start --hours 8) Claude Code는 외장 디스플레이 없이, 세션이 끝나 원래 잠자기 설정이 돌아올 때까지 계속 작업합니다. 세션이 없으면 덮개를 닫은 맥북은 잠자기 상태가 되고 Claude Code도 함께 멈춥니다. Claude 데스크톱 앱의 Keep computer awake를 켜 두어도 Anthropic 문서는 “노트북 뚜껑을 닫으면 여전히 절전 모드로 전환됩니다”라고 설명합니다. 전원, 키보드, 마우스와 함께 연결한 외장 디스플레이로도 책상에서는 계속 실행됩니다.

Claude 데스크톱 앱의 Keep computer awake는 덮개를 닫아도 효과가 있나요?

아니요. 2026년 10월 기준 이 설정은 자동 잠자기를 막으며, Anthropic 문서는 노트북 덮개를 닫으면 맥이 여전히 잠자기 상태가 된다고 설명합니다.

caffeinate로 덮개를 닫은 채 Claude Code를 계속 실행할 수 있나요?

-s 옵션을 쓰고 전원에 연결된 상태에서만 가능합니다. 이때 맥은 caffeinate가 실행되는 동안 dark wake 상태(화면이 꺼진 채로 맥이 계속 작동하는 상태)에 머물고, 전원을 분리하면 잠자기 상태가 됩니다. Apple 문서는 caffeinate가 기본으로 쓰는 자동 잠자기를 막는 어설션이 유지되는 동안에도 덮개를 닫으면 시스템이 그래도 잠자기 상태가 될 수 있다고 설명합니다.

덮개를 닫은 맥북을 계속 켜 두어도 안전한가요?

덮개를 닫아도 맥북은 계속 열을 냅니다. 통풍이 잘 되는 단단한 표면 위에 두고, 절대 가방 안이나 베개 밑에 두지 마세요. Keep Mac Awake는 기본적으로 전원에 연결된 상태에서 실행되며, 배터리 사용 시에는 열 상태가 심각(serious) 단계에 이르거나 직접 고른 배터리 하한에 닿을 때도 세션이 끝납니다(배터리로 맥북을 덮어도 안 꺼지게 하는 법).

Claude Code가 Keep Mac Awake를 직접 켜고 끌 수 있나요?

예. 오래 걸리는 작업 전에 keepmacawake start --hours N --json 명령을, 작업 후에 keepmacawake stop --json 명령을 실행할 수 있습니다. 세션은 저절로 시작되지 않으며, 직접 또는 사용 중인 에이전트가 명령을 실행하거나 버튼을 누를 때만 시작됩니다.

출처