Desktop 예약 작업 (Scheduled tasks)
기준일: 2026-07-26
공식 기준: Schedule recurring tasks in Claude Code Desktop
개요
예약 작업은 지정한 시각·주기로 새 세션을 자동 시작합니다. 매일 코드 리뷰, 의존성 점검, 캘린더·메일 기반 모닝 브리핑 같은 반복 작업에 씁니다.
Desktop Routines 페이지에서 로컬 예약 작업과 원격 routines를 모두 만들 수 있습니다.
- 로컬 작업: 머신에서 파일·도구에 직접 접근. 앱이 열려 있고 컴퓨터가 깨어 있을 때만 실행
- 원격 routine: Anthropic 관리 클라우드에서 컴퓨터가 꺼져 있어도 실행. API 호출·GitHub 이벤트 트리거 가능
이 페이지는 로컬 예약 작업만 다룹니다. 원격은 Routines.
핵심 개념
| Cloud (routines) | Desktop scheduled | /loop |
|
|---|---|---|---|
| 실행 위치 | Anthropic cloud | 내 머신 | 내 머신 |
| 머신 전원 | 불필요 | 필요 | 필요 |
| 열린 세션 | 불필요 | 불필요 | 필요 |
| 재시작 후 유지 | 예 | 예 | 미만료 시 --resume으로 복원 |
| 로컬 파일 | 아니오 (fresh clone) | 예 | 예 |
| MCP | 작업별 connectors | config·connectors | 세션 상속 |
| 권한 프롬프트 | 없음 (자율) | 작업별 설정 | 세션 상속 |
| 최소 간격 | 1시간 | 1분 | 1분 |
클라우드: 머신 없이도 안정 실행. Desktop: 로컬 파일·도구 필요 시. /loop: 세션 중 빠른 폴링.
기본 동작은 워킹 디렉터리 현재 상태(미커밋 포함)를 대상으로 합니다. 생성 시 worktree 토글을 켜면 병렬 세션처럼 실행마다 격리 Git worktree를 씁니다.
상세
예약 작업 만들기
사이드바 Routines → New routine → Local.
| 필드 | 설명 |
|---|---|
| Name | 식별자. lowercase kebab-case로 디스크 폴더명. 작업 간 유일 |
| Description | 목록용 짧은 요약 |
| Instructions | 실행 시 Claude가 할 일 (프롬프트와 동일 형식). permission mode·model 피커, working folder·isolated worktree 선택 |
| Schedule | 주기. 아래 옵션 |
저장 전 폴더 필수. 미신뢰 폴더는 저장 전 trust 프롬프트.
세션에서 자연어로도 생성 가능. 예: “매일 아침 9시 코드 리뷰 예약”, “내일 3시에 배포 확인 리마인더”(1회 후 비활성).
스케줄 옵션
- Manual — 스케줄 없음. Run now만. 온디맨드 프롬프트 저장용
- Hourly — 매시
- Daily — 시간 피커, 기본 로컬 9:00 AM
- Weekdays — Daily + 토·일 스킵
- Weekly — 시간·요일 피커
15분마다, 매월 1일, 특정 미래 1회 등은 세션에서 Claude에게 자연어로 요청. 예: “모든 테스트를 6시간마다 돌리도록 스케줄”.
실행 방식
앱이 열려 있는 동안 Desktop이 1분마다 스케줄을 확인하고, 수동 세션과 독립적으로 새 세션을 띄웁니다. 각 작업은 예정 시각 후 수 분 지연으로 API 트래픽을 분산합니다. 지연은 결정적이라 같은 작업은 항상 같은 오프셋입니다.
실행 시 데스크톱 알림과 사이드바 Scheduled 섹션에 세션이 생깁니다. 열어 결과·권한 프롬프트를 처리합니다. 일반 세션과 같이 파일 편집·명령·커밋·PR이 가능합니다.
앱 실행 중 + 컴퓨터 깨어 있을 때만 동작. 잠들면 해당 시각 실행은 스킵. 유휴 잠 방지: Settings → Desktop app → General → Keep computer awake. 노트북 덮개 닫으면 여전히 sleep. 전원 off 시에도 필요하면 원격 routine.
놓친 실행
앱 시작·깨우기 시 최근 7일 내 놓친 실행을 확인합니다. 있으면 가장 최근 1회만 catch-up하고 더 오래된 것은 버립니다. 6일 놓친 daily도 1회만. catch-up 시 알림.
프롬프트에 타이밍 가드레일을 넣으세요. 예: “오늘 커밋만 리뷰. 5시 이후면 리뷰 스킵하고 놓친 요약만.”
권한
작업별 permission mode. ~/.claude/settings.json allow 규칙도 적용. Manual mode에서 미허용 도구면 승인까지 stall. 사이드바 세션은 나중에 응답 가능.
stall 방지: 생성 후 Run now로 권한 프롬프트를 보고 “always allow” 선택. 이후 같은 도구는 자동 승인. 작업 상세에서 승인 검토·철회.
조직이 connector를 ask로 둔 도구, MCP requiresUserInteraction 도구는 매번 프롬프트하며 always-allow 없음.
관리
Routines 목록에서 작업 상세:
- Run now
- Status Active/Paused
- Edit
- Review history (스킵 사유: sleep, 이전 실행 진행 중, 다른 예약 작업 실행 중 등)
- Always allowed 승인 목록
- Delete — 생성 세션 아카이브. Also delete files on disk 체크 시
~/.claude/scheduled-tasks/데이터·SKILL.md삭제
세션 자연어로 list/create/edit/pause 가능. 삭제는 상세 Delete 버튼.
실행 중 세션이 update_scheduled_task MCP 도구로 자체 스케줄·프롬프트를 바꿀 수 있습니다. 예: 릴리스 브랜치 감지 시 리뷰 일정을 앞당김.
디스크 편집: ~/.claude/scheduled-tasks/<task-name>/SKILL.md (CLAUDE_CONFIG_DIR 설정 시 그 아래). YAML frontmatter name/description, body가 프롬프트. 다음 실행부터 반영. Schedule·folder·model·enabled는 파일에 없음 → Edit 폼 또는 Claude에게 요청.
체크리스트
- 로컬 vs cloud routine vs
/loop중 맞는 옵션을 골랐다 - 폴더 trust와 Instructions·permission mode를 설정했다
- 앱 실행·깨우기 조건과 놓친 실행 catch-up 규칙을 이해했다
- Manual mode면 Run now로 always-allow를 확보했다
- 타이밍 민감 작업에 프롬프트 가드레일을 넣었다
다음 단계
기준일
- 문서 작성·동기화 기준일: 2026-07-26
- 원문: https://code.claude.com/docs/en/desktop-scheduled-tasks