Claude Code 상세 사용법 25: Desktop Scheduled Tasks로 로컬 반복 작업 만들기 | DAKER 커뮤니티

Claude Code 상세 사용법 25: Desktop Scheduled Tasks로 로컬 반복 작업 만들기

Claude Code 공식 Desktop scheduled tasks 문서는 로컬 데스크톱 앱에서 새 세션을 정해진 시간에 자동 시작하는 기능을 설명한다. 이전 글의 cloud routines가 Anthropic 관리 환경에서 도는 자동화라면, Desktop scheduled task는 내 컴퓨터의 파일, 로컬 MCP, 터미널 도구가 필요한 반복 작업에 맞다.

1. 언제 Desktop task를 고를까

공식 문서 기준 로컬 task는 앱이 열려 있고 컴퓨터가 깨어 있을 때만 실행된다. 대신 현재 로컬 저장소, 미커밋 변경, 로컬 MCP 서버, 개인 개발 도구에 접근할 수 있다. 매일 아침 코드 리뷰, 로컬 의존성 점검, 사내 VPN이 필요한 테스트처럼 “내 장비에서만 의미 있는 일”에 적합하다.

반대로 노트북이 꺼져도 돌아야 하거나 GitHub 이벤트/API 호출로 시작해야 하면 cloud routine이 낫다. 현재 Claude Code 세션 안에서 배포 완료를 10분마다 확인하는 정도라면 /loop가 더 가볍다.

2. 만들기 전 작업 문장을 먼저 쓴다

~/.claude/settings.json의 allow rule도 적용된다. 하지만 무조건 넓게 풀기보다 task detail의 allowed permissions에서 해당 routine만 필요한 승인으로 좁힌다. 코드 수정 자동화는 isolated worktree를 켜면 병렬 세션 충돌을 줄일 수 있다.

4. 실패 모드까지 프롬프트에 넣는다

Desktop은 매분 스케줄을 확인하고, 작업마다 몇 분의 deterministic delay를 둔다. 컴퓨터가 잠들어 실행을 놓치면 최근 missed run 하나만 catch-up으로 실행할 수 있다. 따라서 시간 민감 작업은 프롬프트에 조건을 둔다.

오후 5시 이후에 catch-up으로 실행됐다면 코드를 수정하지 말고
오늘 놓친 항목만 요약해줘.
이전 실행이 아직 진행 중이면 새 수정 작업을 시작하지 마.

기록은 task detail의 history에서 본다. skipped 항목은 sleep, 이전 실행 진행 중, 다른 예약 작업 대기 같은 이유를 확인한다.

Senior takeaway: 클로드 코드 예약 작업은 “AI 코딩을 매일 돌린다”가 아니라 반복 가능한 운영 루틴을 세션으로 만든다는 뜻이다. 바이브코딩 팀에서는 local task, cloud routine, /loop를 구분하고, permission과 worktree를 task 단위로 설계해야 개발 생산성이 안정적으로 오른다.

Desktop 앱에서 Routines를 열고 New routine, Local을 고른다. Name, Description, Instructions, Schedule, Working folder를 채우고 필요하면 isolated worktree를 켠다. 프롬프트는 일반 채팅보다 더 좁게 쓴다.

매주 월요일 오전 9시에 이 저장소의 최근 7일 변경을 읽고,
테스트 실패 가능성이 높은 파일 5개와 확인 명령을 요약해줘.
파일 수정은 하지 말고, 필요한 경우에만 PR 후보를 제안해줘.

코드를 고치는 작업이면 검증 명령까지 넣는다.

매일 오전 9시에 main과 현재 브랜치 차이를 보고
작은 리팩터링 후보 하나만 수정해줘.
npm test -- --runInBand를 실행하고 실패하면 변경을 멈춘 뒤 원인만 보고해줘.

3. 첫 실행은 반드시 Run now로 본다

예약 작업은 task별 permission mode를 가진다. Ask mode에서 필요한 승인 없이 실행되면 세션은 사이드바에서 멈춰 기다린다. 그래서 저장 직후 Run now로 한 번 돌리고, 실제로 필요한 도구에만 “always allow”를 준다.