---
title: "Claude Code 루틴 (Routines)"
description: "정의 루틴은 저장된 Claude Code 설정이다. 프롬프트, 저장소, 커넥터를 한 번 묶어두면 트리거에 따라 자동 실행된다. 2026년 4월 14일 research preview로 출시됐고, /loop과는 다른 실행 모델. /loop은 세션 내,…"
date: 2026-05-03
updated: 2026-05-03T12:51:18.414Z
tags: [클로드, claude, claude code, 루틴, routine]
canonical: https://blog.wooncloud.com/posts/4
---

## 정의

루틴은 저장된 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가 답이다.