밤마다 멈추던 자동 작업, 범인은 잠긴 화면 뒤의 "허용" 버튼 하나였습니다

· 약 4분

#macOS #launchd #ClaudeCode #배운것

맥에서 밤마다 도는 AI 자동 작업이 가끔 아무 말 없이 멈췄습니다. 두 달 가까이 헤맸는데, 원인은 AI가 아니라 macOS의 문서 폴더 접근 동의 창이었습니다. 그 창이 잠긴 화면 뒤에 떠서, 아무도 “허용"을 못 누르는 동안 문서 폴더를 여는 프로세스가 전부 줄줄이 멈췄습니다.

☑️ CLI가 자동 업데이트되면 macOS는 새 실행 파일을 처음 보는 프로그램으로 보고 다시 허락을 구함
☑️ 그 창이 잠긴 화면 뒤에 뜨면 에러도 로그도 없이 문서 폴더를 여는 프로세스가 전부 멈춤
☑️ 터미널에서 돌려 보는 걸로는 확인이 안 됨 — 실제 무인 조건으로 띄워 확인함

창을 띄운 건 Claude Code CLI의 새 버전이었습니다. 자동 업데이트로 밤사이 새 실행 파일이 깔리면, 맥은 그걸 처음 보는 프로그램으로 보고 다시 허락을 구합니다.

증상: 떠 있는데 일을 안 한다

제 맥에는 macOS의 예약 실행 기능(launchd)으로 도는 작업이 여럿 있습니다. 밤 10시 40분 회차는 그 안에서 claude CLI를 부릅니다. 처음 실패한 건 8월 17·18일이었습니다. 두 번 다 900초 타임아웃까지 매달리다 빈손으로 끝났습니다. 같은 호출을 낮에 돌리면 60~95초면 끝났습니다.

다루가 처음 세운 가설은 “화면이 잠기면 매달린다"였습니다. 그럴듯했습니다. 밤이니까요.

첫 가설은 틀렸다

9월 27일, 화면 잠금 기록과 실패일을 맞대 봤습니다.

9/21 풀림 → 성공
9/22 잠김 → 성공 (아침 7시부터 종일 잠긴 채)
9/23 잠김 → 실패
9/24 잠김 → 실패
9/25 풀림 → 성공

잠겨도 성공한 날이 있습니다. 잠금만으로는 설명이 안 됐습니다. 10분 간격 재현 시험을 사흘 돌렸더니 257회 중 실패 0회였습니다. 화면이 꺼진 밤까지 포함해서입니다. 재현이 안 되니 고칠 수도 없었습니다.

10월 6일 밤, 전부 멈췄다

이번엔 claude만이 아니었습니다. 같은 밤 디스코드 봇, 감시용 작업(watchdog), 새벽 5시 데일리노트 생성까지 줄줄이 멈췄습니다. 프로세스는 다 살아 있었습니다. CPU 0%로 파일 하나 여는 자리에서 서 있었을 뿐입니다.

감시자도 같이 멈췄으니 경고도 안 왔습니다. 조용했습니다.

그리고 다음 날 저녁 제가 잠금을 푼 순간, 전부 동시에 풀렸습니다. 화면에는 숫자 이름(2.1.xxx)을 단 프로그램이 문서 폴더에 접근하려 한다는 창이 떠 있었습니다. “허용"을 누르자 밀려 있던 디스코드 알림이 한꺼번에 쏟아졌습니다.

10/6 12:55  claude 2.1.291 자동 설치
10/6 21:38  화면 잠금
10/6 22:40  밤 작업 시작 → 문서 폴더 동의 창 뜸 (잠금 뒤라 아무도 못 봄)
            → 이후 문서 폴더를 여는 프로세스 전부 대기
10/7 20:23  잠금 해제, "허용" → 대기하던 요청 수십 건 동시에 풀림

잠긴 화면 뒤에서 무인 작업이 멈춘 경로. claude 새 버전 자동 설치, 화면 잠금 뒤 밤 작업이 문서 폴더에 처음 접근, 동의 창을 아무도 못 눌러 문서 폴더를 여는 프로세스가 전부 대기, 다음 날 잠금 해제와 허용으로 동시에 풀림. 옆에는 터미널 실행으로는 새 실행 파일 권한이 시험되지 않는 이유와 10월 9일에 바꾼 것, 지금의 업데이트 확인 방법

claude CLI는 버전마다 실행 파일이 따로 깔립니다. macOS 입장에선 업데이트할 때마다 처음 보는 프로그램입니다. 그래서 새 버전이 처음으로 무인 상태에서 문서 폴더를 건드릴 때 화면이 잠겨 있으면, 또 멈춥니다. 9월의 실패도 같은 패턴이었을 가능성이 있지만 그때 버전 기록이 없어 확인은 못 했습니다.

껐는데 또 올라갔다

10월 7일에 claude 자동 업데이트 설정을 껐습니다. 끝난 줄 알았습니다.

10월 9일 새벽에 또 멈췄습니다. 알고 보니 다루 봇에 CLI를 매일 새벽 4시대에 올려 주는 작업이 따로 있었습니다. 설정을 끈 뒤에도 그 작업이 10/7, 10/8, 10/9 사흘 연속 claude를 올리고 있었습니다. 버전 폴더의 수정 시각을 보고서야 알았습니다.

업데이트를 껐다는 건 설정 하나를 바꿨다는 뜻이지, 실제로 멈췄다는 뜻이 아닙니다.

그날 바로 세 가지를 바꿨습니다.

  • 봇의 업데이트 작업에서 claude를 뺐습니다
  • 감시자를 문서 폴더 밖으로 옮겼습니다. 같이 멈추면 감시자가 아니니까요
  • 감시자가 공백을 “잠자기"로 넘기지 말고 “정지"로 알리게 했습니다

10월 21일엔 아예 자동 업데이트를 전부 껐습니다. 그런데 이 과정에서 하나가 더 나왔습니다. 리서치용으로 쓰는 다른 CLI(agy)가 실행할 때마다 스스로를 업데이트하고 있었습니다. 끄는 환경변수 값으로 1을 넣었더니 무시되고 버전이 올라갔습니다. true를 넣어야 꺼졌습니다. 통로는 생각보다 많았습니다.

터미널에서 돌려 보면 되지 않나?

저도 처음엔 그렇게 생각했습니다. 업데이트하고 터미널에서 한 번 돌려 보면 확인되는 거 아닌가.

안 됩니다. 터미널에서 실행하면 macOS는 권한을 터미널 앱에 묻습니다. 새 실행 파일 자신의 문서 폴더 권한은 시험되지 않습니다. 터미널에서 잘 돌던 게 밤에 혼자 돌면 막히는 이유가 이겁니다.

그래서 지금은 업데이트를 맥 앞에 있을 때 손으로만 합니다. claude가 올라가면 임시 예약 작업을 하나 만들어 새 버전을 실제 무인 조건으로 띄우고, 권한이 창 없이 통과하는지 시스템 로그로 확인한 뒤 지웁니다. 10월 20·21일에 올린 두 버전은 이 확인을 통과했습니다.

남은 것

무인 작업은 사람이 없다는 게 전제입니다. 그런데 운영체제는 가끔 사람에게 묻습니다. 그 질문이 아무도 없는 화면 뒤에 뜨면, 에러도 로그도 없이 그냥 멈춥니다.

CLI를 업데이트했다면 터미널 말고 실제 무인 조건으로 한 번 띄워 보세요. 권한 창이 뜨는지는 거기서만 보입니다.

궁금한 점이나 틀린 내용이 있으면 pikanostudio@gmail.com으로 메일 주세요.