Claude Code 상세 사용법 42: Routines로 클라우드 자동화 만들기 | DAKER 커뮤니티

Claude Code 상세 사용법 42: Routines로 클라우드 자동화 만들기

지난 두 편에서 /loop는 열린 세션의 반복 점검, Channels는 외부 이벤트를 세션에 밀어 넣는 방식이라고 봤습니다. Routines는 한 단계 더 멀리 갑니다. 공식 문서 기준으로 Routines는 프롬프트, 저장소, 환경, 커넥터, 트리거를 저장해 Anthropic 관리 클라우드에서 Claude Code 세션을 자동 실행하는 research preview 기능입니다.

언제 Routines를 쓰나

노트북이 닫혀도 돌아야 하고, 매번 같은 결과물을 만들어야 하는 작업이 후보입니다. 예를 들면 야간 PR 리뷰, 배포 후 스모크 체크, 문서 드리프트 점검, 알림 기반 초안 PR 생성입니다.

Create a daily routine at 9am KST.
Review yesterday's merged PRs, find docs that mention changed APIs,
open a claude/docs-drift-* branch only when a doc update is needed,
and summarize evidence plus skipped items.

공식 문서에 따르면 Routines는 schedule, API, GitHub 트리거를 붙일 수 있습니다. CLI에서는 /schedule로 예약 루틴을 만들고, API나 GitHub 트리거는 웹 UI에서 설정합니다.

/schedule weekdays at 9am, review open PRs and leave only high-confidence comments
/schedule in 2 weeks, remove the feature flag after checking rollout metrics

트리거 설계

API 트리거는 bearer token으로 /fire 엔드포인트를 호출합니다. 요청 본문의 text는 실행 때 추가 컨텍스트로 들어갑니다. 토큰은 한 번만 보이므로 비밀 저장소에 넣고, 로그에는 남기지 마세요.

안전 설정이 먼저다

Routines는 실행 중 승인 프롬프트를 기다리지 않습니다. 그래서 바이브코딩 자동화일수록 권한을 좁혀야 합니다.

프롬프트에 성공 조건과 중단 조건을 씁니다.
필요한 저장소만 연결합니다.
기본 claude/ 브랜치 제한을 유지합니다.
환경 변수와 네트워크 접근을 최소화합니다.
커넥터는 필요한 것만 남깁니다.

녹색 실행 상태는 인프라가 시작되고 끝났다는 뜻이지, 작업이 성공했다는 증거가 아닙니다. 실행 transcript, 변경 diff, 테스트 로그, PR 링크를 확인해야 합니다.

실패 모드

가장 흔한 문제는 /schedule이 보이지 않는 경우입니다. 공식 troubleshooting은 오래된 CLI, claude.ai 구독 로그인이 아닌 API 키 우선 설정, feature flag fetch를 막는 환경 변수, 조직 정책 비활성화를 원인으로 듭니다. 먼저 claude --version, 로그인 방식, 조직 설정을 확인하세요.

두 번째는 네트워크 403입니다. 기본 클라우드 환경은 신뢰된 도메인만 허용할 수 있으므로 내부 API나 자체 배포 URL을 호출해야 한다면 환경의 Allowed domains를 조정해야 합니다.

선임 엔지니어 관점

Routines는 “자동으로 코딩해줘”가 아니라 “반복 가능한 운영 절차를 Claude Code 세션으로 포장”하는 기능입니다. 좋은 루틴은 트리거보다 종료 조건이 선명합니다. 실행 후에는 초록 배지만 보지 말고 증거, diff, 테스트, 남은 리스크를 읽으세요. 이것이 LLM 개발 워크플로우를 장난감 자동화에서 팀 생산성 도구로 바꾸는 경계입니다.

참고: Claude Code 공식 문서의 Routines, Scheduled tasks, Claude Code on the web 문서를 기준으로 작성했습니다.