Claude Code 상세 사용법 63: 데스크톱 예약 작업 운영하기 | DAKER 커뮤니티

Claude Code 상세 사용법 63: 데스크톱 예약 작업 운영하기

Claude Code Desktop 예약 작업은 정해진 시간에 새 로컬 세션을 시작해 반복 작업을 실행하는 기능입니다. 공식 문서 기준 로컬 예약 작업은 내 컴퓨터에서 돌아가므로 파일, 도구, 미커밋 변경에 접근할 수 있지만, 앱이 열려 있고 컴퓨터가 깨어 있어야 실행됩니다. 꺼진 시간에도 돌아야 하면 원격 루틴을 봐야 합니다.

Mermaid 흐름으로 보는 운영 루프

아래 Mermaid source처럼 예약은 “시간 설정”보다 “검증 가능한 반복 작업”으로 설계합니다.

Mermaid source:
flowchart TD
  A[반복 작업 후보] --> B{로컬 파일이 필요한가}
  B -->|예| C[데스크톱 예약 작업]
  B -->|아니오| D[원격 루틴 검토]
  C --> E[프롬프트와 완료 조건 작성]
  E --> F[권한과 실행 시간 설정]
  F --> G[결과와 실패 메모 확인]

좋은 후보를 고른다

로컬 예약 작업은 “내 repo 상태”가 중요한 일에 맞습니다. 매일 아침 미커밋 변경을 포함한 코드 리뷰, dependency audit, 전날 실패한 테스트 재확인, 로컬 스크립트 결과 요약이 좋은 예입니다.

반대로 외부 API만 읽는 브리핑, GitHub 이벤트 기반 작업, 컴퓨터가 꺼져도 돌아야 하는 자동화는 원격 루틴이 더 맞습니다. 두 기능을 같은 것으로 보면 실패 원인을 놓칩니다.

프롬프트는 완료 조건까지 쓴다

예약 작업 프롬프트에는 주기보다 산출물이 중요합니다.

매주 월요일 09:00에 이 저장소의 의존성 변경 위험을 점검한다.
읽을 것: package manager lockfile, 최근 7일 dependency PR, 테스트 설정.
할 것: 위험 패키지, 필요한 테스트, 자동 수정 가능 여부를 표로 요약한다.
하지 말 것: 승인 없이 dependency를 업그레이드하지 않는다.
완료 조건: 실행한 명령과 실패한 명령을 모두 남긴다.

개발 생산성을 올리는 CLI 자동화는 “성공했을 때만 보고”가 아니라 실패도 재사용 가능한 증거로 남겨야 합니다.

권한을 보수적으로 둔다

예약 작업은 사람이 보고 있지 않은 시간에 시작될 수 있습니다. 처음에는 읽기 중심으로 두고, 수정이 필요하면 PR 작성이나 draft 생성까지만 허용합니다.

오늘은 수정하지 말고, 필요한 변경을 파일 경로와 명령으로 제안해줘.
테스트를 실행하되, 실패하면 로그 마지막 80줄만 요약해줘.

작업이 안정화된 뒤에만 formatter, test, draft 생성 같은 낮은 위험 쓰기를 허용하세요. 배포, 결제, 고객 데이터 쓰기는 별도 approval 경계가 필요합니다.

놓친 실행과 실패 모드

앱이 닫혔거나 컴퓨터가 잠자기 상태면 로컬 예약 작업이 실행되지 않을 수 있습니다. 노트북 사용자는 전원, 절전, 네트워크 상태를 운영 조건으로 적어야 합니다. 로컬 파일 권한이 막히면 Desktop 설정과 macOS 권한도 확인합니다.

두 번째 실패는 결과를 사람이 안 보는 것입니다. 예약 작업은 마지막에 “다음 사람이 할 일”을 남기게 하세요. 자동 수정보다 더 중요한 것은 실패가 조용히 묻히지 않는 구조입니다.

선임 엔지니어 takeaways

클로드 코드 예약 작업은 AI 코딩을 반복 가능한 LLM 개발 워크플로우로 만드는 장치입니다. 하지만 자동화의 핵심은 시간표가 아니라 입력, 권한, 완료 조건, 실패 보고입니다. 로컬 상태가 필요하면 Desktop 예약 작업, 항상 켜진 실행이 필요하면 remote routine으로 나누세요. 그러면 바이브코딩, 코드 리뷰, 테스트 자동화가 “가끔 돌던 프롬프트”에서 팀이 믿을 수 있는 운영 루프로 바뀝니다.

참고: Anthropic Claude Code Desktop scheduled tasks, routines, desktop, llms.txt 문서를 2026-06-15 Asia/Seoul 기준으로 확인했습니다.