잠자기 및 전원

Mac의 caffeinate: 터미널에서 잠자기 방지하기

터미널에서 caffeinate -i을 실행하여 Mac의 유휴 잠자기를 방지하세요. 중단하려면 Control-C를 누르세요. 작업 하나에는 caffeinate -i make을 실행하고 2시간 동안은 caffeinate -i -t 7200을 사용하세요.

적용 대상: 현재 모든 macOS 버전. 시스템 설정 경로는 macOS 13 Ventura 이상을 기준으로 합니다.확인: 2026년 11월 1일

명령 한눈에 보기

명령기능
caffeinate -iControl-C를 누를 때까지 유휴 시스템 잠자기를 막습니다.
caffeinate -i -t 72002시간 동안 시스템이 유휴 상태에서 잠자기로 전환되지 않도록 합니다.
caffeinate -i makemake 명령이 끝날 때까지 잠자기를 방지합니다.
caffeinate -di -t 3600화면과 시스템이 한 시간 동안 잠자기 상태로 전환되지 않도록 합니다.
caffeinate -i -w 12345프로세스 12345가 종료될 때까지 잠자지 않도록 유지합니다. 실제 프로세스 ID로 바꾸세요.

증상

  • Mac이 잠자기 상태가 되면 다운로드, 빌드 또는 스크립트가 중단됩니다.
  • 입력 없이 몇 분이 지나면 원격 세션 또는 SSH 연결이 끊깁니다.
  • 한 작업을 위해 Mac의 잠자기를 방지하고 싶지만 잠자기 설정은 변경하고 싶지 않습니다.

가능한 원인

  • 유휴 상태에서 잠자기. macOS는 일정 시간 키보드나 마우스 입력이 없으면 Mac을 잠자기 상태로 전환합니다. 네트워크 활동만으로는 항상 이를 막을 수 없습니다.
  • 디스플레이 잠자기. 디스플레이는 자체 타이머에 따라 꺼집니다. 일부 Mac에서는 시스템도 잠자기 상태가 됩니다.
  • 덮개. Mac 노트북의 덮개를 닫으면 잠자기 상태가 됩니다. caffeinate은 이를 변경하지 않습니다. 덮개를 닫은 상태에서 MacBook 잠자기 방지하기를 참조하세요.

확인 방법

  1. 터미널을 여세요. 현재 잠자기를 방지하는 프로세스를 확인하세요.

    pmset -g assertions

    출력 PreventUserIdleSystemSleep 같은 assertion 목록과 각각을 유지하는 프로세스.

  2. 현재 사용 중인 잠자기 설정을 확인합니다.

    pmset -g

해결 방법

  1. 명령 하나가 실행되는 동안 Mac을 깨워 두려면 명령 앞에 caffeinate -i을 넣으세요. 명령이 중단되면 어설션도 중단됩니다.

    caffeinate -i make
  2. Mac을 정해진 시간 동안 깨워 두려면 -t으로 시간을 초 단위로 지정하세요. 이 예제는 2시간입니다.

    caffeinate -i -t 7200
  3. 프로세스가 중단될 때까지 Mac이 잠들지 않게 유지하려면 -w으로 프로세스 ID를 지정하세요.

    caffeinate -i -w 12345
  4. 디스플레이도 켜 두려면 -d를 추가합니다.

    caffeinate -d -i
  5. 명령 없이 시작한 caffeinate을 중지하려면 Control-C를 누르세요.

  6. 해당 터미널 세션을 실행 상태로 둡니다. 타이머가 전원 유지 요청을 자동으로 종료하며 저장된 잠자기 설정은 변경하지 않습니다.

  7. 디스플레이가 꺼져 있을 때 자동 잠자기를 중단하려면 설정을 변경하세요. Mac 노트북에서 Apple 메뉴 > 시스템 설정 > 배터리 > 옵션을 선택하세요. “디스플레이가 꺼져 있을 때 전원 어댑터 사용 시 자동으로 잠자지 않게 하기”를 켜세요.

  8. Mac 데스크탑에서 Apple 메뉴 > 시스템 설정 > 에너지를 선택하세요. “디스플레이가 꺼져 있을 때 자동으로 잠자지 않게 하기”를 켭니다.

Kilobat 사용

  1. Kilobat은 다운로드가 조용해질 때까지 Mac의 잠자기를 방지한 다음 다시 잠자기 상태가 되도록 허용합니다. 메뉴 막대에서 Kilobat을 여세요. 찻잔을 클릭하고 다운로드가 끝날 때까지를 선택하세요.

  2. CLI도 같은 작업을 합니다. 3분간 16 KB/s 미만이면 중지합니다.

    kilobat awake --until-quiet
  3. 명령 하나가 실행되는 동안 Mac의 잠자기를 방지하고 전송한 데이터를 보려면 awake --을 사용합니다.

    kilobat awake -- make release
  4. 이 기능은 무료입니다. 앱, CLI 및 MCP 단계는 활용법을 참조하세요.

  5. 덮개를 닫고 디스플레이 없이 작업하려면 Kilobat의 선택적 전원 도우미를 사용하세요.

질문

caffeinate를 사용하면 덮개를 닫아도 Mac의 잠자기가 방지되나요?

아니요. 덮개를 닫았을 때의 잠자기를 해제하지 않습니다. 외장 디스플레이 모드 또는 Kilobat의 선택적 전원 도우미를 사용하세요. 덮개를 닫은 상태에서 MacBook 잠자기 방지를 참조하세요.

caffeinate를 중단하려면 어떻게 하나요?

실행 중인 터미널 윈도우에서 Control-C를 누르세요. 타이머나 감싼 명령이 끝나도 어설션이 자동으로 종료됩니다.

caffeinate를 사용하면서 화면이 꺼지게 할 수 있나요?

예. -i는 디스플레이를 켜 두지 않고 시스템의 유휴 잠자기를 방지합니다. 화면을 켜 두어야 할 때만 -d를 추가하세요.

-s 옵션은 무슨 역할을 하나요?

-s은(는) 시스템 잠자기를 방지합니다. man 페이지에 따르면 Mac이 전원 어댑터에 연결되어 있을 때만 작동합니다.

caffeinate가 설정을 변경하나요?

아니요. 전원 유지를 요청하며, caffeinate이 중지되면 요청도 끝납니다.

출처

2026년 11월 1일에 확인했습니다.