Routines 클라우드 자동화
기준일: 2026-07-26
난이도: 중급
공식 기준: Automate work with routines
Routine은 프롬프트·저장소·connectors를 묶어 Anthropic 관리 클라우드에서 자동 실행하는 설정입니다. 노트북이 꺼져 있어도 동작합니다. research preview이며 Pro / Max / Team / Enterprise와 Claude Code on the web가 필요합니다.
관리 UI: claude.ai/code/routines. CLI: /schedule (별칭 /routines).
핵심 개념
| 트리거 | 용도 |
|---|---|
| Schedule | 매시간/매일/평일/매주, 또는 일회성 시각 |
| API | HTTP POST + bearer token으로 외부 시스템에서 fire |
| GitHub | pull_request / release 등 이벤트 |
한 routine에 여러 트리거를 붙일 수 있습니다.
세션 내 반복(/loop)·Desktop 로컬 스케줄과 비교:
| Routines | /loop |
Desktop scheduled tasks | |
|---|---|---|---|
| 실행 위치 | 클라우드 | 열린 CLI 세션 | 로컬 머신 |
| 노트북 off | 동작 | 세션 종료 시 중단 | 머신 켜짐 필요 |
| 권한 프롬프트 | 무인 full session | 세션 권한 정책 | 로컬 정책 |
선택 기준
적합한 예: 야간 이슈 라벨링, 알림 기반 초안 PR, PR 오픈 시 팀 체크리스트 리뷰, 배포 후 smoke, 문서 drift 주간 점검.
Routine은 개인 계정에 속하며 팀 공유가 아닙니다. 커밋/PR/Slack 등은 연결된 본인 신원으로 나타납니다. 일일 run 상한과 구독 사용량이 함께 적용됩니다(일회성 스케줄은 daily cap 예외 — 공식 문서 확인).
실습
웹에서 생성
- routines → New routine
- 이름·자기 완결형 프롬프트·모델
- GitHub 저장소, cloud environment(네트워크·env·setup script)
- 트리거(Schedule / GitHub / API)
- Connectors 최소화, branch push 권한 검토
- Create → 필요 시 Run now
기본 push는 claude/ 접두 브랜치. 기존 브랜치 푸시가 필요하면 Allow unrestricted branch pushes를 저장소별로 켭니다.
CLI
/schedule daily PR review at 9am
/schedule list
/schedule update
/schedule run
/schedule은 스케줄 트리거 생성에 초점을 둡니다. API·GitHub 트리거는 웹에서 추가하는 것이 일반적입니다.
API fire (연구 프리뷰)
curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_.../fire \
-H "Authorization: Bearer sk-ant-oat01-xxxxx" \
-H "anthropic-beta: experimental-cc-routine-2026-04-01" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"text": "Sentry alert SEN-4521 fired in prod."}'
text는 <routine-fire-payload>로 감싸져 신뢰할 수 없는 데이터로 전달됩니다. 루틴 프롬프트가 페이로드를 명시적으로 사용하도록 작성해야 합니다. 베타 헤더·스키마는 변경될 수 있습니다.
트러블슈팅 요약
| 증상 | 점검 |
|---|---|
/schedule Unknown command |
claude.ai 구독 로그인 필요. API key/Bedrock 등 우선 시 실패. DISABLE_TELEMETRY 등 플래그 비활성 |
| 조직 policy disabled | Owner가 admin Claude Code → Routines 토글 |
| 네트워크 403 | environment Trusted allowlist에 호스트 추가 또는 Custom/Full |
도구에 입력할 프롬프트
우리 팀의 반복 작업 중 cloud routine으로 옮길 후보 3개를 골라줘.
각각 트리거 유형, 프롬프트 초안, 필요한 connectors, 위험(쓰기 권한·시크릿)을 표로 정리해.
로컬 /loop로 충분한 것은 구분해줘.
체크리스트
- claude.ai 로그인과 web 환경이 준비됐다.
- 프롬프트가 무인 실행에 충분한 성공 조건을 포함한다.
- connectors·네트워크·branch push를 최소 권한으로 제한했다.
- 일일 run 한도와 usage credits 정책을 확인했다.
- 실패 시 세션 transcript를 열어 작업 성공 여부를 검증한다(초록 상태 ≠ 업무 성공).
다음 단계
- 스케줄 작업에서 세션 범위 자동화와 비교합니다.
- 웹에서 Claude Code 환경을 다듬습니다.
- Goal으로 열린 세션 안 완료 조건을 다룹니다.