MacBook 덮개를 닫았을 때 Claude Code와 Codex를 계속 실행하는 방법
요약
MacBook의 덮개를 닫아도 Claude Code나 Codex 같은 코딩 에이전트와 백그라운드 작업이 중단되지 않도록 설정하는 방법을 소개합니다. pmset과 LaunchAgent를 활용하여 디스플레이만 끄고 시스템은 계속 작동하게 만드는 셸 스크립트 기반의 튜토리얼입니다.
핵심 포인트
- pmset을 이용한 유휴 상태 절전 비활성화
- AppleClamshellState 모니터링을 통한 디스플레이 제어
- LaunchAgent를 활용한 백그라운드 프로세스 유지
- 설치 및 삭제 스크립트를 통한 간편한 설정 관리
- 장시간 작업 시 전원 연결 및 통풍 확보 권장
macOS는 유휴 상태의 절전 (idle sleep)을 피하도록 설정할 수 있지만, MacBook의 덮개를 닫으면 여전히 장시간 실행되는 코딩 에이전트 (coding agents), SSH 세션, 그리고 백그라운드 작업 (background jobs)이 중단됩니다. 저는 MacBook의 디스플레이가 닫힌 덮개 안에서 빛나게 두지 않으면서도, 에이전트 머신 (agent machine)으로서 계속 작동하기를 원했습니다.
이를 위해 작고 되돌릴 수 있는 셸 설정 (shell setup)을 구축했습니다.
변경 사항
pmset을 사용하여 유휴 상태의 절전 (idle sleep) 비활성화- 덮개를 닫을 때 시스템 절전 (system sleep) 방지
- 2초마다
AppleClamshellState를 모니터링 - 덮개를 닫을 때 디스플레이 (display)만 끄기
- macOS LaunchAgent를 통해 모니터링 도구 실행
- 정상적인 절전 동작을 복구하는 삭제 스크립트 포함
설치
git clone https://github.com/apoorvdarshan/macbook-24x7-agents.git
cd macbook-24x7-agents
./install.sh
설치 후에는 덮개를 닫아도 디스플레이는 꺼지면서 Claude Code, Codex, SSH 세션 및 기타 백그라운드 프로세스 (background processes)가 계속 실행됩니다.
모든 설정 되돌리기
./uninstall.sh
중요한 주의 사항
MacBook을 전원에 연결해 두고, 적절한 통풍을 확보하십시오. 또한 disablesleep이 활성화되어 있는 동안에는 수동 절전 (manual Sleep)이 작동하지 않는다는 점을 기억하십시오. 이 설정은 작동 중인 노트북을 가방 안에 넣고 다니기 위한 것이 아니라, 장시간 실행되는 작업 (long-lived jobs)을 수행하는 고정된 머신을 위한 것입니다.
저장소 및 전체 설명:
https://github.com/apoorvdarshan/macbook-24x7-agents
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기