Claude Code, 에이전트, 긴 작업 동안 Mac을 깨어 있게 하세요.

1caffeinate: 내장 명령어

caffeinate는 모든 Mac에 기본으로 들어 있습니다. 실행되는 동안 Mac을 깨어 있게 하며, 그 외에는 아무것도 하지 않습니다.

Control-C를 누를 때까지 Mac을 깨어 있게 하기:

caffeinate -i

Claude Code(또는 다른 명령어)가 실행되는 동안만 정확히 깨어 있게 하기:

caffeinate -i claude

2시간(7,200초) 동안:

caffeinate -i -t 7200

이미 실행 중인 프로그램이 끝날 때까지(pgrep으로 그 번호를 찾은 뒤 -w 뒤에 쓰세요):

pgrep -fl claude
caffeinate -i -w 12345

각 문자의 뜻: -i는 유휴 상태에서 잠자기를 막고, -d는 디스플레이를 켜 두고, -m은 디스크를 깨어 있게 하고, -s는 전원에 연결된 동안 시스템 전체를 깨어 있게 합니다(caffeinate 매뉴얼). 에이전트와 빌드에는 -i면 충분합니다. 화면을 지켜보고 싶을 때만 -d를 추가하세요.

2터미널 없이 설정하기

MacBook에서는 시스템 설정 → 배터리 → 옵션을 열고 디스플레이가 꺼져 있을 때 전원 어댑터에서 자동으로 잠자기 방지를 켜세요. 데스크톱 Mac에서는 시스템 설정 → 에너지를 열고 디스플레이가 꺼져 있을 때 자동으로 잠자기 방지를 켜세요(Apple 지원).

이 설정은 Mac이 전원에 연결된 동안에만 작동하고 전력을 더 쓰므로, 더 이상 필요 없으면 끄세요.

3덮개 닫기

MacBook은 덮개를 닫으면 잠자기에 들어가며, caffeinate로도 바뀌지 않습니다. 덮개를 닫은 채 계속 작동하는 것은 클램셸 모드(closed-display mode)일 때뿐입니다. 전원과 외장 디스플레이에 연결되어 있고, 키보드와 마우스 또는 트랙패드가 있어야 합니다(Other World Computing).

4대신 해 주는 앱

입력보다 클릭이 편하다면, 같은 시스템 스위치를 쓰는 메뉴 막대 앱이 있습니다:

• Amphetamine(무료, Mac App Store): 타이머가 있는 세션, "앱이 실행 중인 동안" 등.
• KeepingYouAwake(무료, 오픈 소스): 메뉴 막대에서 클릭 한 번.

5자리를 비운 동안 실행되는 에이전트를 위해

• Mac을 전원에 연결해 두고, 데스크톱 Mac에서는 에너지 아래의 네트워크 접근 시 깨우기를 켜 두세요. 그래야 화면 공유와 SSH로 계속 접속할 수 있습니다.
• 에이전트를 caffeinate -i 안에서 실행하세요. 에이전트가 끝나면 Mac이 알아서 다시 잠자기에 들어갑니다.
• Mac mini는 조용하게 늘 켜 두는 AI 기기로 좋습니다. Mac mini AI 서버 가이드를 참고하세요.
• 에이전트를 켜 두고 자리를 비우기 전에, 에이전트가 무엇에 접근할 수 있는지 확인하세요. 예상하지 못한 명령어를 실행한 적이 있다면 Mac 점검을 하세요.

6자주 묻는 질문

Claude Code를 쓰는 동안 Mac이 잠자지 않게 하려면?

Claude Code를 caffeinate -i claude로 시작하세요(평소의 claude 대신). Claude Code가 실행되는 동안 Mac이 깨어 있고, 끝나면 다시 잠자기에 들어갈 수 있습니다. 긴 세션에는 Mac을 전원에 연결해 두세요.

Mac을 깨어 있게 하는 터미널 명령어는 무엇인가요?

caffeinate -i는 Control-C를 누를 때까지 깨어 있게 합니다. caffeinate -i -t 3600은 1시간 동안입니다. caffeinate -i 뒤에 명령어를 붙이면 그 명령어가 실행되는 동안 깨어 있습니다.

MacBook 덮개를 닫은 채로 깨어 있게 할 수 있나요?

클램셸 모드에서만 가능합니다. 전원, 외장 디스플레이, 키보드, 마우스가 연결되어 있어야 합니다. 그렇지 않으면 caffeinate와 상관없이 덮개를 닫으면 잠자기에 들어갑니다.

caffeinate를 쓰면 배터리가 빨리 닳나요?

잠자기를 막을 뿐이므로, Mac은 하고 있는 작업만큼 전력을 씁니다. 배터리로 쓸 때는 -t로 시간 제한을 두거나 전원을 연결하세요.

화면이 잠겨도 Mac이 계속 작업하나요?

네, Mac 자체가 잠자기 상태가 아니라면요. caffeinate나 잠자기 설정이 Mac을 계속 실행하는 동안 디스플레이는 꺼지고 화면은 잠길 수 있습니다.