맥북에서 클로드 코드 사용시 화면꺼짐 방지하는 방법

맥북에서 Claude Code 작업 시 화면이 꺼지거나 잠들 때의 동작과 개발 환경 설정에 대해 자세히 알려드리겠습니다.

🔋 화면 꺼짐 vs 슬립 모드

화면만 꺼진 경우:

• ✅ Claude Code 계속 실행됨
• ✅ 네트워크 연결 유지
• ✅ 작업 진행 계속됨

맥북이 슬립 모드로 들어간 경우:

• ❌ Claude Code 일시 중단됨
• ❌ 네트워크 연결 끊김
• ❌ 작업 진행 중단

⚙️ 개발용 맥북 설정

1. 에너지 절약 설정

시스템 설정 → 배터리 → 전원 어댑터:

 

 

✅ 디스플레이 끄기: 10분 (원하는 시간)
❌ Mac 자동 잠자기 방지: 체크
✅ 전원이 연결되어 있을 때 잠자기 방지: 체크
✅ Wake for network access: 체크

터미널 명령어로 설정:

 

 

bash

# 전원 연결 시 절대 잠들지 않기
sudo pmset -c sleep 0

# 디스플레이만 10분 후 끄기
sudo pmset -c displaysleep 10

# 배터리 사용 시에도 설정 (선택사항)
sudo pmset -b sleep 30
sudo pmset -b displaysleep 5

# 현재 설정 확인
pmset -g

2. Caffeinate 명령어 사용

장시간 작업할 때:

 

 

bash

# 시스템 잠들지 않게 하기 (무제한)
caffeinate

# 특정 시간만 (3600초 = 1시간)
caffeinate -t 3600

# 디스플레이도 안 끄기
caffeinate -d

# Claude Code와 함께 실행
caffeinate claude

3. 터미널 세션 유지

tmux 사용 (권장):

 

 

bash

# tmux 설치
brew install tmux

# 새 세션 시작
tmux new-session -s claude-work

# Claude Code 실행
claude

# 세션에서 분리 (Ctrl+B, 그다음 D)
# 맥북 종료해도 세션 유지됨

# 나중에 다시 연결
tmux attach-session -t claude-work

screen 사용 (대안):

 

 

bash

# screen 세션 시작
screen -S claude-work

# Claude Code 실행
claude

# 분리: Ctrl+A, 그다음 D
# 재연결: screen -r claude-work

🛠 Claude Code 최적 설정

1. 자동 저장 설정

 

 

bash

# Claude Code에서 자동 저장 활성화
claude config set auto-save true

# 작업 상태 자동 저장 간격 설정
claude config set save-interval 60  # 60초마다

2. 알림 설정

 

 

bash

# 작업 완료 시 알림
claude config set notifications true

# 맥 알림 센터 사용
claude config set notification-type system

3. 긴 작업을 위한 설정

 

 

bash

# 타임아웃 시간 늘리기
claude config set timeout 3600  # 1시간

# 자동 재시도 설정
claude config set auto-retry true

📱 개발 환경 완전 설정

1. 기본 도구 설치

 

 

bash

# Homebrew가 없다면
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 개발 필수 도구들
brew install tmux tree htop git node

2. 터미널 환경 개선

 

 

bash

# ~/.zshrc 또는 ~/.bash_profile에 추가
echo 'alias ll="ls -la"' >> ~/.zshrc
echo 'alias claude-session="tmux new-session -s claude"' >> ~/.zshrc
echo 'alias claude-resume="tmux attach-session -t claude"' >> ~/.zshrc

# 설정 적용
source ~/.zshrc

3. 작업 공간 설정

 

 

bash

# 개발 전용 디렉토리 생성
mkdir -p ~/Development/claude-projects
cd ~/Development/claude-projects

# 각 프로젝트별 tmux 세션 관리 스크립트
cat > ~/start-claude.sh << 'EOF'
#!/bin/bash
PROJECT_NAME=${1:-default}
tmux new-session -d -s "claude-$PROJECT_NAME"
tmux send-keys -t "claude-$PROJECT_NAME" "cd ~/Development/claude-projects/$PROJECT_NAME" Enter
tmux send-keys -t "claude-$PROJECT_NAME" "claude" Enter
tmux attach-session -t "claude-$PROJECT_NAME"
EOF

chmod +x ~/start-claude.sh

🔔 작업 모니터링

1. 진행 상황 확인

 

 

bash

# 다른 터미널에서 작업 상황 모니터링
watch -n 30 'ps aux | grep claude'

# 네트워크 상태 확인
ping -c 1 api.anthropic.com

2. 로그 확인

 

 

bash

# Claude Code 로그 확인
tail -f ~/.claude/logs/claude.log

# 시스템 로그에서 네트워크 문제 확인
log stream --predicate 'subsystem contains "com.apple.network"'

🚨 비상 계획

1. 작업 복구

 

 

bash

# Claude Code 세션 복구
claude resume

# 이전 작업 상태 확인
claude status
claude history

2. 백업 및 복구

 

 

bash

# 작업 상태 정기 백업
crontab -e
# 매 시간마다 백업: 0 * * * * cp -r ~/.claude/sessions ~/Dropbox/claude-backup/

💡 추천 워크플로우

장시간 작업 시작 전:

 

 

bash

# 1. 전원 연결 확인
# 2. tmux 세션 시작
tmux new-session -s claude-work

# 3. Caffeinate 실행
caffeinate &

# 4. Claude Code 시작
claude

# 5. 작업 시작

작업 중단 시:

 

 

bash

# tmux 세션에서 분리
Ctrl+B, 그다음 D

# 나중에 재연결
tmux attach-session -t claude-work

이렇게 설정하면 맥북 화면이 꺼져도 Claude Code 작업이 안전하게 계속 진행됩니다! 특히 tmux나 screen을 사용하면 맥북을 완전히 종료해도 서버에서 작업이 계속 실행될 수 있어 매우 유용합니다.