Claude Code Routines로 일회성 클라우드 작업 예약하기

자동화 도구 중에는 두 종류가 있습니다. 매일 같은 시간에 울리는 자명종(cron)이 있고, 한 번만 발송되는 택배 예약이 있습니다. 두 가지 모두 필요하지만, 둘 다 잘 다뤄야 진짜 자동화가 됩니다.

Anthropic이 2026년 4월 14일 공개한 Claude Code의 Routines 기능 중 "Schedule a One-Off Run"은 후자에 해당합니다. 미래의 특정 시점에 딱 한 번만 실행되고, 자동으로 비활성화되는 클라우드 작업입니다.

이 글에서는 One-Off Run의 동작 원리, CLI 사용법, 사용량 정책, 그리고 실전 시나리오 4가지를 정리합니다.

Routines가 무엇이고, One-Off Run은 그중 어디인가

Claude Code Routines는 Anthropic 클라우드에서 실행되는 자동화 단위입니다. 비유하자면 사무실에 24시간 근무하는 비서를 한 명 둔 것과 같습니다. 노트북을 닫고 잠들어도 정해진 시간에 알아서 일을 처리합니다.

하나의 routine은 다음 5가지 요소를 패키징합니다.

• Prompt: 매 실행마다 Claude가 받는 자기충족적 지시문
• Repositories: 시작 시점에 default branch에서 clone되는 저장소들
• Environment: 네트워크 접근 수준, 환경변수, 셋업 스크립트
• Connectors: Slack, Linear, Google Drive 같은 MCP 커넥터
• Triggers: Schedule, API, GitHub events의 조합

이 중 Trigger 종류는 세 가지입니다. Schedule(cron), API(/fire endpoint), GitHub events. Schedule은 다시 두 종류로 나뉘는데, 하나가 정기 실행(recurring)이고 다른 하나가 오늘 다룰 One-Off Run입니다.

One-off schedule fires the routine a single time at a specific timestamp.

— Anthropic 공식 문서

동작 방식: 발사 후 자동 폐기

One-Off Run은 한 번 발화한 뒤 자동으로 비활성화됩니다. 웹 UI에서는 해당 routine에 "Ran" 마킹이 붙고, 다시 실행하려면 routine을 편집해 새로운 one-off timestamp를 설정해야 합니다.

타임존은 알아서 처리됩니다. 사용자가 입력한 로컬 시간이 자동으로 UTC로 변환되며, Anthropic 클라우드 인프라가 어느 리전에 위치하든 wall-clock 기준으로 정확히 그 시간에 실행됩니다. 한국에서 "다음 월요일 오후 3시 KST"라고 입력해도 헷갈릴 일이 없습니다.

CLI 사용법: /schedule 한 줄이면 끝

세션 안에서 자연어로 시점을 입력하면 Claude가 절대 timestamp로 변환한 뒤 사용자 확인을 거쳐 클라우드에 routine을 생성합니다.

/schedule in 2 weeks, open a cleanup PR that removes the feature flag

/schedule tomorrow at 9am, summarize yesterday's merged PRs

/schedule next Monday at 3pm KST, run smoke tests on production

GitHub 연결이 안 되어 있으면 /web-setup 명령으로 웹 셋업을 안내받습니다. API trigger나 GitHub trigger 같은 추가 트리거를 붙이려면 CLI가 아닌 웹 UI에서 편집해야 합니다.

웹 UI(claude.ai/code/routines)에서는 New routine → Schedule 선택 → preset 또는 one-off timestamp 지정 흐름으로 만듭니다. 데스크톱 앱에서는 Schedule 페이지 → New task → New remote task를 선택해야 합니다. New local task는 사용자 머신에서 실행되는 로컬 작업이라 routine이 아니니 헷갈리지 마세요.

사용량 정책: 일일 한도에서 제외된다

이 부분이 실무자 입장에서 가장 반가운 포인트입니다. One-off run은 일일 routine 한도에 카운트되지 않습니다. 정기 routine을 가득 등록해 daily cap을 다 써도, 일회성 예약은 별도로 자유롭게 사용할 수 있습니다.

대신 일반 세션처럼 plan(Pro / Max / Team / Enterprise) 사용량은 정상적으로 차감됩니다. 즉 "한도 초과로 cleanup PR이 못 돌아가는 사고"는 발생하지 않지만, 무제한 공짜 자동화는 아닙니다.

Recurring과 One-Off의 차이

핵심 차이는 "반복할지 여부"와 "daily cap에 영향을 주는지"입니다. 일주일에 한 번 도는 정기 routine이라면 recurring이 적합하고, 2주 뒤 단 한 번만 필요한 cleanup 작업이라면 one-off가 정답입니다.

다른 자동화 도구와의 비교

기존 자동화 수단과 비교하면 One-Off Run의 장점이 더 분명해집니다.

cron을 직접 운영해본 사람이라면 알겠지만, "노트북을 닫지 못하는" 자동화는 자동화가 아닙니다. One-Off Run은 클라우드에서 돌기 때문에 사용자 디바이스 상태와 완전히 분리됩니다.

실전 시나리오 4가지

문서에 등장하는 6가지 사용 사례 중 One-Off Run에 자연스럽게 어울리는 케이스를 추려보면 다음과 같습니다.

1. 롤아웃 후 정리 (Cleanup after rollout)

가장 대표적인 시나리오입니다. 새 기능을 feature flag로 런칭한 뒤 "2주 뒤 안정화되면 flag 제거 PR을 만들고 싶다"는 요구는 매우 흔합니다.

/schedule in 2 weeks, open a cleanup PR that removes the SIGNUP_V2_ENABLED feature flag from frontend and backend repos

월요일 출근하면 PR이 이미 와 있고, 코드 리뷰만 진행하면 됩니다.

2. 배포 후 follow-up

배포 후 한두 시간 뒤에 production 헬스체크와 핵심 메트릭을 자동으로 확인하는 시나리오입니다.

/schedule in 1 hour, run smoke tests on production and post the result to #deploy-alerts

3. 미래 리마인더

회의에서 "이거 다음 주에 검토하자"라고 결정한 항목이 흔히 잊히는데, 이걸 routine으로 박아두면 사람이 기억할 필요가 없습니다.

/schedule next Friday at 4pm KST, summarize this week's merged PRs and draft a release note

4. Forget-me-not 추적

긴 호흡의 추적 작업에 좋습니다. 외부 라이브러리 마이그레이션 후 N일 뒤 결과를 모니터링한다든가, 새로 도입한 도구의 실효성을 한 달 뒤 점검하는 식입니다.

Research Preview 한계와 주의사항

이 기능은 아직 Research Preview 단계입니다. 실무 도입 전에 다음 사항을 확인하세요.

• 베타 헤더: experimental-cc-routine-2026-04-01. API 형태와 토큰 의미가 변경될 수 있고, 직전 2개 버전만 유지됩니다.
• API trigger 토큰 노출: 생성 시 단 한 번만 표시됩니다. 즉시 비밀번호 관리자나 시크릿 매니저에 저장하세요.
• Daily cap: routine 발화 횟수에 일일 한도가 있습니다. 초과 시 metered overage 또는 거부 처리됩니다 (One-Off Run은 이 한도에 포함되지 않습니다).
• GitHub webhook 한도: per-routine + per-account hourly cap이 있으며, 초과분은 drop됩니다.
• Branch 보호: 기본 설정에서는 claude/ prefix 브랜치에만 push 가능합니다. main이나 develop에 직접 push하지 않게 막아두는 안전장치이며, 필요하면 "Allow unrestricted branch pushes" 옵션으로 해제할 수 있지만 신중히 결정해야 합니다.

또 하나 중요한 점은 GitHub 커밋, PR, Slack 메시지가 모두 사용자 본인 명의로 기록된다는 사실입니다. routine 실행 ID는 사용자 계정 단위이고 팀과 공유되지 않습니다. "내가 했다"고 표시되는 작업이 실제로는 자동 스케줄링된 routine이라는 점을 팀원들과 미리 합의해두는 것이 좋습니다.

도입 체크리스트

실제로 사용해보기 전에 다음을 점검하세요.

1. 사용 가능 플랜 확인: Pro / Max / Team / Enterprise이며, Claude Code on the web을 활성화해야 합니다.
2. GitHub 앱 연결: routine이 PR을 만들려면 GitHub 앱이 워크스페이스에 설치되어 있어야 합니다.
3. 타임존 명시 습관: "tomorrow 9am"보다 "tomorrow 9am KST"가 안전합니다.
4. secret 관리: API trigger 토큰은 1회 노출이라 즉시 안전한 곳에 저장.
5. Branch 보호 정책 확인: 팀의 git workflow에 claude/ prefix가 충돌하지 않는지 확인.

마무리

One-Off Run은 화려한 신기능은 아닙니다. cron이 풀지 못한 "이번에만 한 번 돌리고 싶은 작업"이라는 작은 빈틈을 메우는 기능입니다.

하지만 그 빈틈이 실무에서는 의외로 자주 나타납니다. feature flag 정리, 배포 후 follow-up, 회의 결과 N일 뒤 리뷰 같은 일들은 사람이 기억하고 처리하기에는 너무 잡다하고, 정기 cron으로 박아두기에는 너무 일회성입니다.

이런 작업들을 자연어 한 줄로 클라우드에 던져두면 끝나는 시대가 왔습니다. 지금 당장 필요하지 않은 작업이라면, 미래의 자신에게 routine 하나를 보내두는 것부터 시작해보세요.

출처

• Claude Code Routines — Schedule a One-Off Run (Anthropic 공식 문서)
• Introducing Routines in Claude Code (Anthropic 블로그)