Claude Code 루틴 (Routines)

정의

루틴은 저장된 Claude Code 설정이다. 프롬프트, 저장소, 커넥터를 한 번 묶어두면 트리거에 따라 자동 실행된다. 2026년 4월 14일 research preview로 출시됐고, /loop과는 다른 실행 모델. /loop은 세션 내, 루틴은 세션 밖이다.

두 종류: Remote vs Local

만들 때 두 가지 중 고른다.

Remote 루틴. Anthropic 클라우드에서 돈다. 노트북 꺼도 실행된다.

Local 루틴. 본인 머신에서 돈다. Desktop 앱에서 Routines → New routine → Local을 고르면 Desktop scheduled task가 만들어지고, 클라우드가 아니라 사용자 머신에서 실행됨.

로컬 루틴이 필요한 경우

세 가지다.

1. 로컬 파일/도구 접근. 클라우드는 본인 디스크를 못 본다. 홈서버 파일, 로컬 DB, 로컬 CLI 도구를 써야 하면 로컬이다.
2. 사내망/VPN. Flow 사내 서버처럼 외부 IP가 못 닿는 리소스에 접근해야 할 때. 운구름님 경우 DBSAFER 환경이 여기 해당.
3. 민감 데이터 외부 유출 회피. 코드/데이터를 Anthropic 인프라에 올리지 않고 끝내고 싶을 때.

로컬 루틴 트리거

로컬은 schedule 트리거만 지원한다. API 트리거와 GitHub 트리거는 클라우드 전용이다.

이유는 단순하다. API 트리거는 공개 HTTP 엔드포인트가 필요한데, 사용자 노트북에 그걸 띄울 수 없다. GitHub 웹훅도 마찬가지다. 그래서 로컬은 시간 기반만 남는다.

스케줄은 hourly / daily / weekdays / weekly 프리셋을 고르거나 cron 표현식을 쓴다. 시간은 로컬 존으로 입력하고, 최소 간격은 1시간이며, stagger 때문에 정확한 시각보다 몇 분 늦게 시작될 수 있음.

실행 조건

로컬 루틴은 Desktop 앱이 켜져 있고 사용자가 로그인되어 있어야 동작한다. 절전모드여도 안 된다. 즉 데스크탑 PC처럼 24시간 켜두는 머신에서나 의미가 있다. 노트북에서 굳이 로컬을 고르는 건 거의 안 맞다.

/loop, /schedule, 루틴, GitHub Actions

같은 이름의 자동화지만 실행 모델이 전부 다르다.

방식	실행 위치	노트북 꺼도?	트리거
/loop	현재 세션	❌	시간
Local 루틴	본인 머신	❌ (앱 켜져 있어야)	시간만
Remote 루틴	Anthropic 클라우드	✅	시간/API/GitHub
GitHub Actions	GitHub runner	✅	다양

CLI에서 만들 때

CLI의 /schedule은 scheduled 루틴만 만든다. API나 GitHub 트리거를 추가하려면 claude.ai/code/routines에서 편집해야 함. 즉 터미널에서는 schedule만, 웹에서는 전부 가능.

사용량 제한

Pro 5개/일, Max 15개/일, Team·Enterprise 25개/일까지 실행 가능. 일회성 수동 실행은 카운트에서 빠진다. 너무 짜다 진짜..

정리

루틴은 "저장된 자동화 단위"다. /loop이 임시 알람이라면 루틴은 등록된 백그라운드 잡이다. 로컬은 머신에 묶이는 시간 트리거 전용이고, Remote는 트리거 자유도가 훨씬 높다. 사내망 안에서 도는 작업이 아니면 거의 항상 Remote가 답이다.