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. 회사 내부 서버처럼 외부 IP가 못 닿는 리소스에 접근해야 할 때입니다. 보안 솔루션을 거쳐야만 DB 에 붙는 회사 환경이 대표적입니다.
3. 민감 데이터 외부 유출 회피. 코드/데이터를 Anthropic 인프라에 올리지 않고 끝내고 싶을 때입니다.

로컬 루틴 트리거

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

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

스케줄은 Manual / Hourly / Daily / Weekdays / Weekly 프리셋을 고르거나 cron 표현식을 씁니다. 시간은 로컬 존으로 입력합니다. 최소 간격은 1분이라 프리셋에 없는 주기(예: 15분마다)도 가능하고, stagger 때문에 정확한 시각보다 몇 분 늦게(루틴마다 고정 오프셋) 시작될 수 있습니다.

실행 조건

로컬 루틴은 Desktop 앱이 켜져 있고 사용자가 로그인되어 있어야 동작합니다. 절전 중이면 그 시각의 실행은 건너뜁니다. 다만 앱을 다시 켜거나 절전이 풀리면 최근 7일 내 놓친 실행 중 가장 최근 것 1회가 catch-up 으로 돌고, Settings → Desktop app → General 의 Keep computer awake 로 유휴 절전 자체를 막을 수도 있습니다(노트북 덮개를 닫으면 그래도 절전됩니다). 그래서 노트북이 불리한 건 정시성이 중요한 작업에 한합니다.

/loop, /schedule, 루틴, GitHub Actions

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

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

CLI에서 만들 때

CLI의 /schedule 은 기본적으로 scheduled 루틴을 만듭니다. GitHub 트리거는 Claude Code v2.1.225 이상이면 CLI 에서도 자연어로 붙일 수 있고, 웹 전용으로 남은 건 API 트리거(엔드포인트 URL·토큰 발급/폐기)뿐입니다.

사용량 제한

Pro 5개/일, Max 15개/일, Team·Enterprise 25개/일까지 실행 가능합니다. 특정 시각에 1회만 예약해 발사되는 one-off 실행은 이 일일 캡에서 빠집니다(구독 사용량은 일반 세션처럼 그대로 소모합니다). 너무 짜네요 진짜..

정리

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