Claude Code 데스크톱 예약 작업 — 9시 작업이 밤 11시에 돌 수 있습니다

AI에게 매일 아침 9시에 코드 리뷰를 시켜두고 싶다면 방법이 세 가지 있습니다. 클라우드에서 돌리거나, 내 컴퓨터에서 돌리거나, 열린 세션 안에서 돌리거나. 어제 클라우드 쪽을 정리했으니 오늘은 내 컴퓨터에서 도는 쪽입니다. 공식 문서를 열어보니 9시로 걸어둔 작업이 밤 11시에 돌 수 있다고 적혀 있더군요. 그럴 만한 이유가 있었습니다.

📌 30초 요약

• 컴퓨터가 자면 그 실행은 건너뜁니다. 앱이 열려 있고 컴퓨터가 깨어 있을 때만 돕니다.
• 놓친 실행은 딱 한 번만 따라잡습니다. 엿새를 놓쳐도 깨어날 때 한 번 돌고 나머지는 버려집니다.
• 그 한 번이 엉뚱한 시각에 옵니다. 문서가 직접 "9시 작업이 밤 11시에 돌 수 있다"고 예를 듭니다.
• 최소 간격이 1분입니다. 클라우드 쪽은 1시간이니 60배 차이입니다.
• 권한 모드를 작업마다 고를 수 있습니다. 클라우드 루틴에는 없는 선택지입니다.
• 기본은 작업 폴더의 현재 상태 그대로입니다. 커밋 안 한 변경까지 포함해서 돕니다.

세 갈래를 한 표로

문서가 친절하게도 세 방식을 나란히 놓은 표를 실어놨습니다. 고르는 기준이 여기 다 들어 있어서 그대로 옮깁니다.

항목	클라우드 루틴	데스크톱 예약	세션 안 반복
도는 곳	클라우드	내 컴퓨터	내 컴퓨터
컴퓨터 켜져 있어야	아니오	예	예
세션 열려 있어야	아니오	아니오	예
로컬 파일 접근	불가 — 새로 클론	가능	가능
권한 확인 창	없음 — 자율 실행	작업마다 설정	세션 설정 상속
최소 간격	1시간	1분	1분

문서가 붙여둔 요령도 간단합니다 — 컴퓨터 없이도 확실히 돌아야 하면 클라우드, 로컬 파일과 도구가 필요하면 데스크톱, 세션 중 잠깐 상태를 확인할 거면 반복 명령입니다. 로컬 파일 접근 여부가 가장 큰 갈림길입니다. 클라우드 쪽은 매번 저장소를 새로 클론하니 내 디스크에만 있는 파일은 못 봅니다.

자면 건너뜁니다, 그리고 한 번만 따라잡습니다

이 방식의 가장 큰 약점입니다. 앱이 열려 있고 컴퓨터가 깨어 있을 때만 돌고, 예약 시각에 컴퓨터가 자고 있었으면 그 실행은 그냥 건너뜁니다. 유휴 절전을 막는 설정이 앱에 따로 있긴 한데, 문서가 한 줄 덧붙입니다 — 노트북 덮개를 닫으면 그래도 잡니다.

그럼 놓친 건 어떻게 되느냐. 여기가 재미있습니다. 앱이 시작되거나 컴퓨터가 깨어나면 지난 7일 안에 놓친 실행이 있는지 확인하고, 가장 최근에 놓친 시각 하나만 따라잡고 나머지는 버립니다. 문서의 예를 그대로 옮기면 엿새를 놓친 일간 작업은 깨어날 때 한 번 돕니다.

"A task scheduled for 9am might run at 11pm if your computer was asleep all day. If timing matters, add guardrails to the prompt itself, for example: 'Only review today's commits. If it's after 5pm, skip the review and just post a summary of what was missed.'"

— Claude Code 공식 문서, 놓친 실행

"9시 작업이 밤 11시에 돌 수 있다"는 걸 문서가 먼저 인정하고, 해결책으로 프롬프트에 조건을 넣으라고 안내합니다. 시각을 지키는 건 시스템이 보장 못 하니 프롬프트가 스스로 시간을 확인하게 만들라는 겁니다. 예로 든 문장도 실용적입니다 — "오늘 커밋만 리뷰해라. 오후 5시가 지났으면 리뷰는 건너뛰고 놓친 것만 요약해라."

정시에 뜨지 않는 이유가 하나 더 있습니다. API 트래픽을 분산하려고 예약 시각 뒤에 몇 분 지연을 둡니다. 같은 작업은 항상 같은 만큼 늦게 시작하니 편차가 일정하다는 점은 그나마 다행입니다. 클라우드 루틴에도 같은 장치가 있었습니다.

권한은 고를 수 있지만, 멈춥니다

클라우드 루틴과 가장 크게 갈리는 지점입니다. 데스크톱 예약 작업은 작업마다 권한 모드를 따로 정합니다. 개인 설정 파일의 허용 규칙도 그대로 적용되고요. 사람이 통제할 여지가 있다는 뜻인데, 대가가 있습니다.

수동 모드로 둔 작업이 권한 없는 도구를 쓰려 하면 그 실행은 승인해줄 때까지 멈춰 있습니다. 세션은 사이드바에 열린 채로 남아 나중에 답할 수 있게 해두지만, 자동화를 걸어둔 의미는 사라집니다. 새벽에 멈춰 서서 아침까지 기다리는 셈이니까요.

✋ 문서가 권하는 우회법

작업을 만든 직후 지금 실행을 눌러 뜨는 권한 창마다 "항상 허용"을 골라두라고 합니다. 그러면 다음 실행부터 같은 도구는 묻지 않습니다. 저장된 승인은 작업 상세 화면에서 확인하고 철회할 수도 있고요. 다만 조직이 매번 묻도록 설정한 커넥터 도구와, 사용자 확인이 필수인 도구는 "항상 허용"이 아예 없습니다. 그런 도구를 부르는 작업은 매번 멈춥니다.

커밋 안 한 변경 위에서 돕니다

놓치기 쉬운 기본값입니다. 예약 작업은 작업 폴더가 지금 어떤 상태든 그 위에서 돕니다 — 커밋하지 않은 변경까지 포함해서요. 어젯밤 작업하다 만 코드가 널린 채로 아침 리뷰 작업이 돌면, 그 미완성 코드를 대상으로 리뷰합니다.

막는 방법은 작업을 만들 때 별도 작업공간 토글을 켜는 것입니다. 그러면 매 실행이 각자 격리된 깃 작업공간을 갖습니다. AI 도구들이 전부 git worktree를 쓰는 이유를 정리한 적이 있는데, 거기서 확인한 "격리하려고 쓰는 것"이라는 결론이 여기서도 그대로 적용됩니다. 예약 작업이야말로 사람이 안 보는 사이에 도니 격리가 더 필요한 자리입니다.

🛠️ 잘 만들어둔 부분

운영 편의는 촘촘합니다. 건너뛴 실행도 기록에 남고, 왜 건너뛰었는지 이유까지 보입니다 — 컴퓨터가 자고 있었는지, 이전 실행이 아직 돌고 있었는지, 다른 예약 작업이 이미 돌고 있었는지. 프롬프트는 디스크에 파일로 저장돼 직접 열어 고칠 수 있고, 다음 실행부터 반영됩니다. 세션에서 말로 시켜도 됩니다 — "매일 아침 9시에 코드 리뷰 걸어줘" 같은 문장으로 만들어지고, "그 작업 잠깐 멈춰줘"로 일시정지됩니다. 심지어 작업이 실행 중에 자기 스케줄을 바꿀 수도 있습니다.

그래서 뭘 골라야 하나

문서의 기준에 오늘 확인한 것들을 얹으면 이렇게 정리됩니다.

• 시각을 지켜야 하는 일 — 클라우드입니다. 데스크톱은 컴퓨터 상태에 매여 있어 정시를 보장하지 못합니다.
• 로컬 파일·사내 도구를 만져야 하는 일 — 데스크톱뿐입니다. 클라우드는 매번 새로 클론하니 내 디스크의 파일을 못 봅니다.
• 사람 확인을 남기고 싶은 일 — 데스크톱입니다. 클라우드 루틴에는 권한 모드 자체가 없습니다.
• 1시간보다 자주 돌려야 하는 일 — 데스크톱이나 세션 안 반복입니다. 클라우드는 최소 1시간이 하한입니다.

비용 관점도 빼놓을 수 없습니다. 어느 쪽이든 실행될 때마다 토큰을 씁니다. 하루 얼마쯤 든다는 계산은 사람이 앉아 있는 시간을 전제로 하는데, 예약 작업은 그 전제 밖에서 돕니다. 특히 데스크톱 쪽은 최소 간격이 1분이라, 15분마다 도는 작업을 무심코 걸어두면 하루 96번입니다.

🧾 정직하게 — 제가 확인하지 못한 것

• 예약 작업을 만들어 돌려보지 않았습니다. 데스크톱 앱 화면을 캡처해 확인한 것도 아니고, 문서를 읽고 정리한 글입니다.
• 데스크톱 예약 작업의 사용량이 어떻게 집계되는지는 이 문서에 없었습니다. 클라우드 루틴처럼 별도 일일 상한이 있는지 이 경로에서는 못 찾았습니다.
• "하루 96번" 같은 계산은 산술일 뿐입니다. 실제로 그렇게 걸어두는 사람이 있는지, 그때 무슨 일이 생기는지는 모릅니다.
• 요금제·운영체제별 차이도 이 문서에 명시가 없어 다루지 않았습니다. 데스크톱 앱이 필요하다는 것만 확실합니다.

🗺️ AI 지출 전체 지도

내가 안 쳐도 도는 것들이 늘수록 청구서가 예측을 벗어납니다. 구독과 종량제 선택부터 캐시 관리, 모델 조합, 팀 단위 청구까지 지금까지 확인한 것들을 일곱 단계 지도 한 장으로 묶어뒀습니다.

자주 묻는 것

Q. 컴퓨터를 안 재우면 되지 않나요?

앱 설정에 컴퓨터를 깨어 있게 유지하는 항목이 있습니다. 다만 문서가 곧바로 단서를 답니다 — 노트북 덮개를 닫으면 그래도 잡니다. 데스크톱을 쓰거나 덮개를 열어두는 게 아니면 완전히 해결되지 않습니다. 그래서 정시성이 중요한 작업은 클라우드로 보내는 게 맞습니다.

Q. 놓친 걸 전부 따라잡게 할 수는 없나요?

문서 기준으로는 없습니다. 가장 최근 것 하나만 돌고 나머지는 버려집니다. 오히려 이게 안전장치에 가깝습니다 — 엿새치가 한꺼번에 돌면 토큰도 여섯 배고 결과물도 뒤엉킬 테니까요. 대신 프롬프트에 "놓친 기간을 확인하고 요약하라"는 식으로 적어두면 한 번의 실행으로 밀린 것을 다룰 수 있습니다.

Q. 클라우드 루틴과 같이 쓸 수 있나요?

됩니다. 데스크톱 앱의 같은 화면에서 만들면서 클라우드냐 로컬이냐만 고르는 구조입니다. 성격에 따라 나누는 게 자연스럽습니다 — 깃허브 이벤트에 반응하거나 밤새 돌아야 하는 건 클라우드, 내 디스크를 봐야 하거나 사람 확인을 남기고 싶은 건 로컬입니다. 다만 클라우드 쪽은 승인 창이 아예 없고 결과물이 내 계정 신분으로 나간다는 점은 따로 알아두셔야 합니다.

Q. 작업이 겹치면 어떻게 되나요?

건너뜁니다. 기록에서 건너뛴 이유를 볼 수 있는데 "이전 실행이 아직 진행 중"과 "다른 예약 작업이 이미 돌고 있음"이 이유 목록에 들어 있습니다. 즉 동시에 여러 개가 돌지는 않는 구조로 보입니다. 오래 걸리는 작업을 촘촘한 간격으로 걸어두면 뒤 실행들이 계속 밀려 건너뛸 수 있으니, 간격은 작업 소요 시간보다 넉넉하게 잡는 게 좋겠습니다.

🕰️ 세 방식 전부 정시성에 문제가 있었습니다 (8월 16일 추가)

이 글은 "컴퓨터가 자면 건너뛰고, 9시 작업이 밤 11시에 돌 수 있다"는 이야기였습니다. 마지막 남은 세 번째 방식까지 열어보니 어느 쪽도 적어둔 시각에 정확히 실행되지 않습니다. 세션 안 반복은 트래픽 분산용 고정 오프셋이 붙어서 매시 정각 작업이 30분에 뜰 수 있고, 클라우드 루틴에도 몇 분짜리 지연이 있습니다. 이유는 셋 다 다른데 결론은 같습니다 — "정시에 뜬다"를 전제로 프롬프트를 쓰면 안 됩니다. 이 글이 안내한 대로 프롬프트가 스스로 시간을 확인하게 만드는 게 유일한 방법입니다. 다만 세션 안 반복에는 회피법이 하나 있습니다 — 0분·30분을 피해 3분처럼 어중간하게 잡으면 원샷 오프셋은 안 붙습니다. 세 갈래 비교는 반복 실행을 뜯어본 글에 있습니다.

✨ 오늘 확인한 것 정리

데스크톱 예약 작업은 내 컴퓨터에서 도는 대신 컴퓨터 상태에 매여 있습니다. 자고 있으면 건너뛰고, 놓친 건 가장 최근 하나만 따라잡습니다 — 그래서 9시 작업이 밤 11시에 돌 수 있다고 문서가 직접 예를 듭니다. 대신 로컬 파일을 만질 수 있고, 권한 모드를 작업마다 고를 수 있으며, 최소 간격이 1분입니다. 클라우드 루틴이 정시성과 무인 실행을 주는 대신 로컬 접근과 승인 창을 포기하는 것과 정확히 반대편입니다. 기본이 커밋 안 한 변경 위에서 돈다는 것도 잊지 마세요.

※ 확인 경로(2026년 8월 16일 기준): code.claude.com/docs/en/desktop-scheduled-tasks. 비교표는 이 문서에 실린 표를 옮긴 것이며, 인용문은 원문 그대로입니다.

※ 기능과 화면 구성은 버전에 따라 달라질 수 있습니다. 이 글은 특정 시점의 문서 스냅숏입니다.