Claude Code·Codex 사용할 때 Mac 안 잠들게 하는 법

Claude Code를 실행한 채로 화면을 잠그고 점심을 먹으러 갑니다. 나중에 휴대폰으로 확인해 보니 세션이 응답하지 않습니다. Mac이 잠자기 상태로 들어간 것입니다. 잠금이 문제였던 것은 아닙니다. 잠겨 있어도 Mac은 계속 모든 작업을 실행합니다. 에이전트를 멈추게 하는 것은 유휴 절전입니다.

각 에이전트는 한 턴 동안 작업 중일 때만 Mac을 깨어 있게 유지합니다.

• Claude Code: 턴이 실행되는 동안 caffeinate -i를 실행합니다. 사용자의 승인을 기다리는 동안과 턴이 끝난 뒤에는 이를 해제합니다.

• Codex: 기본적으로 꺼져 있습니다. /experimental에서 Prevent sleep while running을 켭니다. 이 역시 실행 중인 턴에만 적용됩니다.

• Grok Build: 턴 동안 화면을 깨어 있게 유지하며(sleep_prevention, 기본값 켜짐), 턴이 끝나면 해제합니다.

• 턴 사이: caffeinate -i를 사용하거나 System Settings의 전원 설정으로 Mac을 직접 깨어 있게 유지합니다.

• 주의할 점: 외부 디스플레이에 연결한 상태로 덮개를 닫고 사용하는 경우를 제외하면, 덮개를 닫거나 Sleep을 선택해도 이 동작은 유지되지 않습니다.

Mac을 잠그면 Claude Code나 Codex가 멈추나요?

아니요. 화면을 잠그거나 디스플레이가 꺼지도록 두어도 모든 프로세스는 계속 실행됩니다. 작업을 하던 중인 에이전트는 계속 진행합니다.

절전은 다릅니다. Mac이 잠자기 상태가 되면 프로세스가 일시 정지되고 네트워크가 끊깁니다. 모델로 전송 중이던 요청은 실패할 수 있고, 외부에서 Mac에 연결하는 것은 무엇이든 접근할 수 없게 됩니다. 예를 들어 휴대폰 앱에서 Claude Code를 원격 제어하는 것, SSH 세션, 터널 등이 그렇습니다. Mac이 깨어나면 에이전트는 멈춘 지점부터 다시 이어가며, 요청이 실패했다면 계속 진행하라고 다시 알려줘야 할 수도 있습니다.

그러므로 중요한 질문은 화면이 잠겼는가가 아닙니다. 자리를 비운 동안 Mac이 잠자기 상태로 들어갈 수 있느냐입니다.

Claude Code, Codex, Grok는 언제 스스로 Mac을 깨어 있게 하나요?

턴이 실행되는 동안에만 그렇습니다.

Claude Code는 작업을 시작할 때 caffeinate -i를 실행하고, 턴이 끝나거나 사용자의 승인을 요청하기 위해 멈출 때 이를 중지합니다. 따라서 권한 확인 창에서 기다리는 중이라면 Mac이 잠들 수 있습니다.

Codex도 실험 기능으로 같은 개념을 제공합니다. 기본값은 꺼져 있습니다. /experimental을 입력해 Prevent sleep while running을 켜거나, ~/.codex/config.toml에 다음과 같이 설정합니다:

[features]
prevent_idle_sleep = true

Grok Build는 에이전트가 작업하는 동안 화면을 깨어 있게 유지하고, 턴이 끝나면 해제합니다. 기본적으로 켜져 있으며, 끄려면 ~/.grok/config.toml에 다음을 설정합니다:

[ui.notifications]
sleep_prevention = false

이들 중 어느 것도 턴 사이에 Mac을 깨어 있게 유지하지는 않습니다. 바로 그때가 키보드로나 휴대폰으로 다음 메시지를 보낼 때를 기다리는 순간입니다.

턴 사이에 Mac을 깨어 있게 유지하려면 어떻게 하나요?

macOS에 기본 포함된 caffeinate를 사용합니다. -i는 유휴 절전을 막고, 디스플레이가 꺼지고 잠기는 것은 평소처럼 허용합니다:

12345# For as long as this agent runs
caffeinate -i claude

# For two hours, in the background
caffeinate -i -t 7200 &

첫 번째 형식은 에이전트가 실행되는 동안만 유지됩니다. Claude Code를 종료하면 일반적인 절전 동작이 다시 돌아옵니다. codex나 grok에서도 동일하게 사용할 수 있습니다.

MacBook이 전원에 연결되어 있을 때 항상 깨어 있게 하려면 System Settings → Battery → Options를 열고 Prevent automatic sleeping on power adapter when the display is off를 켭니다. 이 설정은 지속적으로 적용되므로, 하루 저녁만 필요했다면 나중에 다시 꺼두는 것을 잊지 마세요.

Mac이 깨어 있는 이유를 어떻게 확인하나요?

다음을 실행합니다:

pmset -g

sleep 항목에는 현재 Mac을 깨어 있게 붙잡고 있는 앱이 표시됩니다. 예를 들어 sleep prevented by caffeinate와 같이 나옵니다. 각 항목이 무엇을 막고 있는지까지 포함한 전체 목록을 보려면 pmset -g assertions를 실행합니다.

떠나기 전에 빠르게 확인할 수 있는 방법입니다. 항목에 아무것도 표시되지 않고 에이전트가 턴 사이 상태라면, Mac은 평소 스케줄에 따라 잠자기 상태로 들어갑니다.

덮개를 닫으면 어떻게 되나요?

caffeinate, 에이전트, 전원 설정이 무엇이라고 하든, MacBook은 덮개를 닫으면 잠자기 상태가 됩니다. Apple 메뉴에서 Sleep을 선택해도 마찬가지입니다.

예외는 의도적으로 덮개를 닫은 채로 사용하는 경우입니다. Mac이 전원에 연결되어 있고 외부 디스플레이, 키보드, 마우스가 연결되어 있으면 덮개를 닫아도 깨어 있는 상태가 유지됩니다. 이런 구성이 아니라면 에이전트에 계속 접근할 필요가 있는 동안에는 덮개를 열어 두세요.

한 번의 클릭으로 Mac을 깨어 있게 할 수 있나요?

네. PonyMux에서 사이드바 하단의 커피잔을 클릭합니다. 그러면 강조색으로 바뀌고, 툴팁에는 Keep Awake (On)이라고 표시됩니다.

Keep Awake가 켜진 PonyMux 사이드바 하단: 커피잔이 강조 표시되어 있습니다.

켜져 있는 동안 PonyMux는 턴과 턴 사이, 그리고 에이전트가 사용자를 기다리는 동안에도 Mac이 유휴 절전 상태로 들어가지 않도록 막습니다. 디스플레이는 여전히 꺼지고 잠길 수 있습니다. 덮개를 닫거나 Sleep을 선택하는 것은 막지 않으며, 타이머도 없습니다. 다시 컵을 클릭할 때까지 계속 켜져 있습니다. 작업이 끝나면 꺼서 Mac이 다시 에너지를 절약할 수 있게 하세요.

PonyMux의 다른 전원 설정은 Settings and Accessibility에서 확인하세요.

이 글은 원래 ponymux.com 에 게시되었으며, 데모는 인터랙티브합니다.

출처

• 원문: https://dev.to/heylittlepan/how-to-keep-your-mac-awake-for-claude-code-and-codex-n2n (2026-10-07 · Little Pan)