Claude Code를 실행해 두고 자리 비우기: 워크플로

01긴 작업이 멈추는 이유

Claude Code는 세 가지 지점에서 사용자를 기다려요.

1. 권한 prompt. 기본 모드에서는 대부분의 셸 명령과 파일 수정 전에 물어봐요.
2. 질문. 선택이 필요하면 AskUserQuestion으로 묻고 기다려요.
3. 턴 종료. 작업을 마치면 다음 메시지를 기다려요.

이 중 어느 것이든 자리를 비운 사이 긴 작업을 한 시간씩 멈춰 있게 만들 수 있어요. 아래 루틴은 불필요한 대기는 없애고, 남은 대기는 나에게 전달되도록 해 줘요.

021단계: 혼자서도 끝낼 수 있는 작업 작성하기

질문을 피하는 가장 좋은 방법은 미리 답해 두는 거예요. 떠나기 전에 Claude에게 알려 주세요.

• "완료"의 의미. "API 고쳐 줘"보다 "tests/api의 모든 테스트 통과"가 더 좋아요.
• 결과를 확인하는 방법. 테스트나 빌드 명령을 명시하세요.
• 하면 안 되는 일. "데이터베이스 스키마는 바꾸지 마"나 "push하지 마" 같은 것이요.
• 막혔을 때 할 일. "적당한 횟수 안에 못 고치면 멈추고 시도한 내용을 정리해 줘."

큰 변경이라면 plan mode로 시작해 계획을 합의한 뒤 실행하게 하세요.

claude --permission-mode plan

032단계: 일상적인 건 허용하고, 위험한 건 남겨 두기

권한 prompt 하나하나가 멈춤이에요. Claude가 자유롭게 실행할 수 있는 명령을 미리 정해 두세요. 안전하고 반복적인 명령은 .claude/settings.json이나 /permissions로 allow 규칙을 추가하세요.

{
  "permissions": {
    "allow": [
      "Bash(npm test *)",
      "Bash(npm run lint)",
      "Bash(git diff *)"
    ],
    "deny": [
      "Bash(git push *)"
    ]
  }
}

deny 규칙은 allow 규칙보다 우선하므로, git push에 deny를 걸어 두면 더 넓은 범위가 허용돼 있어도 유지돼요. 모드를 바꿀 수도 있어요. acceptEdits는 작업 디렉터리 안의 파일 수정과 일반적인 파일 시스템 명령을 묻지 않고 수락해요. 각 모드의 장단점과 bypassPermissions를 컨테이너나 VM에서만 써야 하는 이유는 Claude Code 권한 모드 설명에서 확인하세요.

먼저 확인하고 싶은 작업에는 prompt를 남겨 두세요. 파일 삭제, 예상치 못한 네트워크 호출, 프로덕션에 영향을 주는 모든 작업이요.

043단계: 세션 유지하기

컴퓨터가 잠들면 Claude Code도 함께 멈춰요. 운영체제마다 깨어 있게 하는 방법이 있어요.

Mac. Claude Code를 caffeinate로 실행하세요. 명령이 실행되는 동안 Mac이 잠들지 않아요.

caffeinate -i claude

Linux. systemd 배포판에서는 systemd-inhibit가 명령이 실행되는 동안 절전을 막아 줘요.

systemd-inhibit claude

Windows. 설정에서 시스템, 전원 설정으로 들어가 전원이 연결된 동안 절전 모드로 전환되지 않게 설정하세요.

원격 서버이거나 terminal을 닫을 수도 있다면, 연결이 끊겨도 계속 실행되도록 tmux나 screen 안에서 Claude Code를 실행하세요.

tmux new -s work
claude
# detach with Ctrl+B then D; reattach later with: tmux attach -t work

detach된 세션의 알림은 tmux나 screen에서 Claude Code 사용하기에서, 원격 서버는 SSH로 알림 받기에서 다뤄요.

054단계: 대기 상태가 나에게 전달되게 하기

대부분의 설정이 여기서 부족해요. Claude가 작업을 마쳤거나 나를 필요로 할 때 알 수 있어야 하고, 가능하면 자리로 돌아가지 않고 답할 수 있어야 해요.

몇 가지 방법이 있어요:

• Anthropic의 Remote Control은 claude.ai로 로그인한 지원 플랜에서 Claude 앱을 로컬 세션에 연결해 줘요. 자세한 내용과 다른 휴대폰 옵션은 휴대폰에서 Claude Code 사용하기에서 설명해요.
• 직접 만드는 hook으로 ntfy, Telegram, Slack, Discord에 push를 보내면 무슨 일이 생겼는지 알 수 있어요. 답장은 직접 처리해야 해요. Claude Code 알림을 Telegram, Slack, Discord로 보내기를 참고하세요.
• Claude Code Notifier: 이 섹션의 나머지 부분에서 설명하는 방법이에요.

Claude Code Notifier 사용하기

Claude Code Notifier는 Anthropic이 아닌 TouchTap Ltd가 만든 독립 도구예요. 무료 커맨드 라인 도구인 ccn은 Mac, Windows, Linux에서 Claude Code의 hook을 통해 동작하고, iPhone과 Android 앱으로 답장할 수 있어요. 아직 설정하지 않았다면 휴대폰을 Claude Code에 연결하기를 따라 해 보세요. 1분 정도면 끝나요.

페어링하고 나면 세 가지 대기 상황이 모두 휴대폰으로 전달돼요:

• 완료. 턴이 끝나는 즉시 push가 와요. 바로 휴대폰에서 다음 지시를 보내면 Claude가 이어서 작업해요.
• 권한. 한 번 허용, 세션 동안 허용, 거부 중에서 선택해요.
• 질문. Claude가 제시한 옵션 중 하나를 골라요.

자리를 비우기 전에 간단히 확인해 보세요:

ccn doctor   # hooks, credentials, server connection, presence detection
ccn test     # a test notification to your phone

대기 시간 조정하기

ccn은 사용자가 컴퓨터 앞에 있는지 알아요. 최근 30초 안에 입력했다면 terminal에서 평소처럼 물어봐요. 자리를 비운 상태라면 terminal은 최대 대기 시간까지 휴대폰의 응답을 기다리고, 키보드를 건드리는 순간 대기를 멈춰요. 오후 내내 자리를 비울 거라면 최대 대기 시간을 늘리세요:

ccn config set hold_ceiling_seconds 1800

30~3600초 사이로 설정할 수 있고 기본값은 600이에요. 관련 설정인 stop_hold_seconds(0~600, 기본값 120)는 턴이 끝난 뒤 휴대폰에서 후속 지시를 기다리는 시간을 정해요. ccn config show로 전체 설정을 볼 수 있고, 대부분의 설정은 앱에서 컴퓨터별로 바꿀 수도 있어요.

자다가 깨지 않게 하기

작업을 밤새 돌린다면 방해 금지 시간을 설정해서 자는 동안 휴대폰이 울리지 않게 하세요:

ccn config set quiet_hours 22:00-08:00

자세한 내용은 방해 금지 시간과 방해 금지 모드를 참고하세요.

앱은 무료로 다운로드할 수 있지만 사용하려면 구독이나 평생 이용권 구매가 필요해요. 휴대폰 없이도 ccn은 무료 데스크톱 알림을 제공해요. 다른 방에 있을 때는 유용하지만 외출 중일 때는 도움이 안 돼요. 가격을 확인하세요.

065단계: 돌아와서 검토하기

자리를 비워도 안전하려면 무슨 일이 있었는지 꼭 확인해야 해요. 돌아오면:

• 커밋하기 전에 diff를 읽어 보세요. git diff나 에디터의 리뷰 화면을 쓰면 돼요.
• 테스트를 직접 실행해 보세요.
• Claude가 실행한 명령어를 다시 훑어보세요. 특히 휴대폰에서 승인한 명령어는 꼭 확인하세요.

브랜치나 git worktree에서 작업하면 잘못된 실행 결과를 쉽게 버릴 수 있어요. 여러 세션을 동시에 돌린다면 여러 Claude Code 세션 실행하기를 보면 어느 세션이 부르는지 구분하는 데 도움이 돼요.

07복사해서 쓰는 체크리스트

1. 완료 기준과 테스트 명령어가 명확한 작업 설명을 작성했어요.
2. 일상적인 명령어는 allow 규칙, 위험한 명령어는 deny 규칙으로 설정했어요.
3. 컴퓨터가 잠들지 않게 했거나 세션을 tmux에서 실행 중이에요.
4. 휴대폰을 페어링했고 ccn doctor와 ccn test를 통과했어요.
5. 자리를 비우는 시간에 맞게 최대 대기 시간과 방해 금지 시간을 설정했어요.
6. 돌아오면 diff를 검토해요.

08FAQ