Claude Code Routines 살펴보기: 로컬 CLI를 떠나 클라우드에서 반복 작업을 자동화하는 방식

Claude Code를 오래 쓰다 보면, 매번 같은 흐름으로 손이 가는 작업들이 눈에 들어옵니다. 아침마다 이슈 큐를 훑고, PR이 열리면 체크리스트를 돌리고, 배포 후 스모크 테스트를 확인하는 일들입니다.

이런 반복은 사람이 직접 하기엔 피곤하고, GitHub Actions로 짜기엔 판단이 필요한 부분이 너무 많습니다. 스크립트가 딱 떨어지게 처리하기 어려운 영역, 즉 “그때그때 상황을 보고 결정해야 하는” 일들이 주로 남습니다.

2026년 4월 14일 Anthropic이 공개한 Claude Code Routines는 바로 이 틈을 겨냥합니다. 로컬 CLI에 앉아서 직접 프롬프트를 입력하는 방식에서 벗어나, 스케줄·API·GitHub 이벤트를 트리거로 삼아 클라우드에서 Claude가 반복 작업을 스스로 돌리게 하는 기능입니다.

이 글에서는 Routines가 어떤 구조로 되어 있는지, 세 가지 트리거가 각각 무엇을 겨냥하는지, 그리고 같은 제품군 내의 Ultra Plan이나 Channels와는 어떻게 다른지 정리해보겠습니다.

Claude Code Routines는 무엇인가요?

Routines는 Claude Code 내부의 자동화 단위입니다. 매 실행마다 새로운 세션이 만들어지고, 사용자의 노트북이 꺼져 있어도 Anthropic 관리 클라우드에서 작업이 계속됩니다.

하나의 루틴은 네 가지 요소로 구성됩니다.

• Prompts: 루틴이 실행할 작업을 자연어로 기술한 명령. 내용이 스스로 완결되어야 하고, 성공 기준을 명확히 적어야 합니다
• Repositories: 작업할 GitHub 저장소. 매 실행마다 기본 브랜치에서 새로 클론되고, claude/ 접두사 브랜치로 변경사항을 푸시합니다
• Connectors: MCP 기반 외부 서비스 연결. 현재 Slack, Linear, Google Drive를 지원합니다
• Triggers: 루틴이 언제 실행될지 결정하는 조건

즉, Routines는 “프롬프트 + 저장소 + 커넥터”를 하나의 패키지로 묶고 거기에 실행 조건을 붙여둔 자동화 단위라고 볼 수 있습니다.

인터페이스는 세 가지입니다. 웹은 claude.ai/code/routines에서 생성·관리하고, 데스크톱 앱은 Schedule 탭의 “New remote task”로 생성하며, CLI에서는 스케줄 기반 루틴에 한해 /schedule 명령어를 지원합니다.

동작 흐름

전체 그림은 의외로 단순합니다. 트리거가 루틴을 깨우고, Claude가 저장소와 커넥터에 접근해 작업을 수행하고, 결과를 PR 혹은 외부 채널로 내보내는 구조입니다.

flowchart LR
    S[Schedule] --> R[Routine]
    A[API Endpoint] --> R
    G[GitHub Event] --> R
    R --> E{실행 환경<br/>Anthropic Cloud}
    E --> Repo[Repository<br/>claude/ branch]
    E --> MCP[Connectors<br/>Slack · Linear · Drive]
    Repo --> PR[Draft PR / 커밋]
    MCP --> Notify[메시지 / 이슈 업데이트]

여기서 핵심은 실행이 로컬이 아니라 Anthropic이 관리하는 클라우드에서 일어난다는 점입니다. 사용자는 세션을 열어둘 필요가 없고, 승인 프롬프트도 뜨지 않습니다. 권한은 루틴에 연결한 저장소·커넥터·환경 변수의 조합으로 결정됩니다.

세 가지 Trigger

Routines를 Routines답게 만드는 건 결국 트리거입니다. 세 가지가 각기 다른 상황을 겨냥합니다.

Schedule

시간 기반 실행입니다. 사전 설정으로 Hourly, Daily, Weekdays, Weekly가 제공되고, /schedule update로 크론 표현식을 직접 지정할 수도 있습니다. 최소 주기는 1시간입니다.

# CLI에서 스케줄 루틴 업데이트
/schedule update

타임존은 로컬 기준으로 입력하면 자동 변환됩니다. 실제 실행은 몇 분 지연될 수 있어서, 초 단위의 정밀한 타이밍이 필요한 작업에는 적합하지 않습니다.

주로 “매일 아침 백로그 정리”, “주간 문서 동기화”처럼 주기적으로 같은 루틴을 돌리는 시나리오에 맞습니다.

API

전용 HTTP POST 엔드포인트가 루틴마다 하나씩 발급됩니다. Bearer 토큰 기반 인증이고, 요청 본문에 선택적 text 필드로 런타임 컨텍스트를 전달할 수 있습니다.

curl -X POST https://api.claude.com/routines/<routine-id>/runs \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"text": "[alert] checkout 500 error rate spike"}'

응답은 세션 ID와 URL을 담은 JSON입니다. 모니터링 도구나 배포 파이프라인처럼 외부 시스템이 직접 Claude를 깨워야 하는 상황을 겨냥합니다.

GitHub Event

Claude GitHub App을 설치한 저장소의 이벤트를 트리거로 삼습니다. 지원 이벤트는 Pull Request(opened, closed, assigned, labeled, synchronized 등)와 Release(created, published, edited, deleted)입니다.

필터링이 꽤 세밀합니다. Author, Title, Body, Base branch, Head branch, Labels, Is draft, Is merged, From fork 등을 조합해 “fork에서 온 non-draft PR만”, “특정 라벨이 붙은 머지된 PR만”처럼 조건을 좁힐 수 있습니다.

단, Research Preview 기간 동안 루틴별·계정별 시간당 한도가 있어서, 초과한 이벤트는 드롭됩니다. 트래픽이 많은 공개 저장소에 바로 붙이는 건 권장되지 않습니다.

실전 유스케이스

공식 문서와 커뮤니티 사례를 조합하면 대략 이런 형태로 쓰입니다.

Backlog Maintenance

주중 저녁에 한 번씩 도는 스케줄 루틴을 만듭니다. Linear 커넥터로 이슈 트래커를 읽고, 코드 영역에 따라 자동으로 라벨을 붙이고 담당자를 지정한 뒤, Slack에 요약을 포스팅합니다. 팀이 다음 날 아침 정리된 큐로 하루를 시작할 수 있습니다.

Alert Triage

모니터링 도구가 에러 임계값을 넘으면 API 트리거로 루틴을 깨웁니다. 스택 트레이스를 추출해 최근 커밋과 연관시키고, 제안 수정안을 담은 draft PR을 열어둡니다. 온콜 엔지니어가 빈 터미널이 아니라 검토할 수 있는 PR로 일을 시작합니다.

Custom Code Review

pull_request.opened 이벤트를 트리거로 걸고, 팀의 리뷰 체크리스트를 프롬프트에 담아둡니다. 보안·성능·스타일에 대한 인라인 코멘트를 남기고 요약 코멘트를 추가합니다. 사람 리뷰어는 기계적 검사 대신 설계 검토에 집중할 수 있습니다.

Deployment Validation

배포 파이프라인이 API로 루틴을 호출합니다. 스모크 테스트를 실행하고 에러 로그에서 회귀가 있는지 스캔한 뒤, 릴리스 채널에 go/no-go 판정을 남깁니다. 배포 윈도우 종료 전에 결정에 필요한 근거가 팀 앞에 놓입니다.

Claude Code 제품군에서의 위치

Routines만 떼어 보면 “클라우드용 크론”처럼 보일 수 있습니다. 하지만 같은 제품군의 다른 기능들과 함께 두면, 각자 다른 자리를 차지한다는 게 분명해집니다.

Channels가 “이미 열려 있는 로컬 세션에 외부 신호를 들여보내는” 구조라면, Routines는 “세션 자체를 클라우드에서 새로 만드는” 구조입니다. 사용자의 노트북이 꺼져 있어도 돌아간다는 점에서, Routines가 훨씬 에이전트 자동화 쪽으로 한 발 더 간 기능이라고 볼 수 있습니다.

Ultra Plan은 또 다른 층위입니다. Ultra Plan으로 더 나은 계획을 만들고, 그 계획을 Routines로 주기적으로 실행하는 조합도 충분히 가능합니다.

GitHub Actions와는 무엇이 다를까

“그냥 GitHub Actions로 하면 안 되나요?”라는 질문이 자연스럽게 나옵니다. 실행 방식만 보면 겹치는 부분이 많지만, 적합한 작업의 성격이 다릅니다.

Actions는 “빌드·테스트·배포”처럼 단계가 고정된 기계적 작업에 강합니다. Routines는 “이슈 라벨링·코드 리뷰·배포 검증”처럼 매 실행마다 상황을 보고 다르게 판단해야 하는 작업에 더 잘 맞습니다.

실무에서는 둘을 대체 관계가 아니라 보완 관계로 두게 됩니다. Actions가 깃발을 올리면 Routines가 상황을 읽고 반응하는 식입니다.

플랜과 실행 한도

Routines를 쓰려면 Pro 이상 플랜과 Claude Code on the web 활성화가 필요합니다. 일일 실행 한도는 플랜마다 다릅니다.

사용량은 일반 세션과 같은 구독 사용량에서 차감됩니다. 초과 사용은 Extra usage가 활성화된 경우에만 종량제로 계산됩니다.

이 수치는 “얼마나 자주 돌릴 수 있나”를 꽤 많이 결정합니다. Pro 플랜에서 매시간 도는 스케줄 루틴을 만들면 하루 한도를 금방 소진합니다. 설계 단계에서 주기와 빈도를 현실적으로 잡는 것이 중요합니다.

주의사항

Routines는 매력적인 기능이지만, 도입 전에 짚어볼 지점이 몇 가지 있습니다.

벤더 락인 우려

Anthropic 관리 클라우드에서 실행된다는 건, 실행 환경 자체를 벤더에 맡긴다는 뜻입니다. 커뮤니티에서도 이 부분에 대한 우려가 나옵니다. Hacker News 토론에서는 “제공자가 아니라 플랫폼을 택하게 된다”는 지적이 자주 등장합니다.

대안으로는 프롬프트와 저장소 접근 로직을 MCP 커넥터·Agent SDK 쪽으로 분리해두거나, 핵심 루틴은 GitHub Actions + Claude API 조합으로 복제해두는 방식이 거론됩니다.

실행 횟수 제한

앞서 본 플랜별 일일 한도가 실제 설계에 영향을 줍니다. “이 루틴을 매시간 돌릴 것인가, 매일 한 번만 돌릴 것인가”는 기능의 가치뿐 아니라 구독 사용량 예산 관점에서도 결정해야 합니다.

Idempotency

같은 트리거가 여러 번 발생했을 때 루틴이 중복 실행되면서 일으킬 수 있는 부작용을 미리 고려해야 합니다. 예를 들어 “PR이 열릴 때마다 댓글을 남기는” 루틴은 synchronized 이벤트에서 의도치 않게 여러 번 돌 수 있습니다. 프롬프트 안에 “이미 처리했는지 확인” 단계를 명시하거나, 필터링 조건을 보수적으로 잡는 편이 안전합니다.

마무리

Claude Code Routines는 단순한 “스케줄러”가 아닙니다. 프롬프트·저장소·커넥터를 묶어 클라우드에서 Claude가 스스로 깨어나 반복 작업을 처리하게 하는 자동화 단위입니다.

• Schedule은 주기적 루틴에
• API는 외부 시스템 트리거에
• GitHub Event는 저장소 이벤트 기반 작업에

각각 자리를 갖습니다. Ultra Plan이 “큰 작업을 시작하기 전의 계획”을 겨냥한다면, Channels가 “이벤트를 현재 세션에 들여보내는” 기능이라면, Routines는 “세션 자체를 클라우드에서 반복 생성하는” 기능에 가깝습니다.

Research Preview 단계인 만큼 한도와 변동성은 감안해야 합니다. 그래도 매일 같은 루틴을 반복하고 있다면, 그중 하나를 Routines로 옮겨볼 가치는 충분합니다. “사람이 매번 같은 순서로 하고 있는 일”부터 한두 개만 빼내도, 하루의 체감은 꽤 달라집니다.

참고 자료

• Claude Code Routines 공식 문서 ↗
• Anthropic 공식 블로그: Introducing Routines in Claude Code ↗
• Claude Code 개요 ↗
• 9to5Mac: Anthropic adds routines to redesigned Claude Code ↗
• VentureBeat: We tested Anthropic’s redesigned Claude Code desktop app and ‘Routines’ ↗
• Hacker News 토론 ↗
• HowDoIUseAI: Claude Routines vs Scheduled Tasks vs /loop ↗
• Claude Code Ultra Plan 살펴보기
• Claude Code Channels 살펴보기