Anthropic이 출시한 기능 중 하나인데, 거의 아무도 이야기하지 않고 있습니다.
북마크하고 저장하세요 :)
바로 Claude Code Routines입니다.
그리고 이 기능은 Anthropic이 올해 출시한 기능 중 가장 중요할 수도 있습니다.
이유는 이렇습니다.
지금까지 모든 Claude Code 자동화는 노트북이 켜져 있어야 작동했습니다. /loop으로 변경 사항을 폴링하거나 /schedule로 반복 작업을 설정할 수 있었습니다. 하지만 터미널을 닫거나 노트북을 덮는 순간 모든 것이 멈췄습니다.
Routines이 이 문제를 완전히 해결합니다.
Routine은 한 번만 설정하면 되는 Claude Code 자동화입니다. 프롬프트, 레포지토리, 커넥터 세트를 구성하면 Anthropic의 클라우드 인프라에서 실행됩니다. 예약된 시간에, API 호출로, 또는 GitHub 이벤트에 의해 트리거됩니다.
노트북이 꺼져 있어도 됩니다. 터미널이 닫혀 있어도 됩니다. Routine은 어쨌든 실행됩니다.
이것이 바로 "사용하는 AI 도구"에서 "당신을 위해 일하는 AI 시스템"으로의 전환입니다.
Claude Code를 한 번도 사용해본 적이 없어도 정확히 설정하는 방법을 알려드립니다.
Routines이 다른 모든 것과 다른 이유
Claude Code에는 이미 스케줄링 기능이 있었습니다. 그렇다면 무엇이 바뀌었을까요?
차이는 인프라입니다.
기존의 /schedule 및 /loop 명령은 로컬 Claude Code 세션 내에서 실행되었습니다. 이는 기기가 켜져 있고, 터미널이 열려 있으며, 인터넷 연결이 안정적이어야 했습니다. 이 중 하나라도 실패하면 자동화가 중단되었습니다.
Routines은 Anthropic의 클라우드에서 실행됩니다. 재시작, 터미널 종료, 야간 실행에도 살아남는 지속적인 자율 에이전트입니다. Slack, Linear, Google Drive, GitHub 등 커넥터에 직접 액세스할 수 있으며, 이를 관리할 필요가 없습니다.
기존 시스템을 휴대폰의 알림이라고 생각해보세요. 알림이 오지만, 여전히 직접 작업을 해야 합니다.
Routines은 당신이 자는 동안 작업을 수행하고, 일어났을 때 요약을 보내주는 직원과 같습니다.
1단계: 무엇을 자동화할지 결정하기
가장 좋은 Routines은 다음과 같은 작업을 자동화합니다:
- 반복적 — 예측 가능한 일정(매일, 매주 또는 이벤트 트리거)으로 발생합니다.
- 명확히 정의됨 — "완료" 상태가 무엇인지 모호함 없이 정확히 설명할 수 있습니다.
- 판단력이 적게 필요함 — 작업에 독창적인 사고나 의사 결정이 필요하지 않습니다. 실행만 필요합니다.
초기 사용자들이 지금 실행하고 있는 패턴은 다음과 같습니다:
- 백로그 관리 — 매일 자정에 Routine이 Linear에서 새 이슈를 가져와 유형과 심각도별로 분류하고, 레이블을 할당한 후 Slack 채널에 요약을 게시합니다. 엔지니어링 리드는 깔끔하게 정리된 보드를 보고 아침을 시작합니다.
- 문서 드리프트 감지 — 매주 금요일마다 Routine이 지난주에 병합된 PR을 스캔하여 API나 인터페이스를 변경한 PR을 식별하고, 문서와 교차 참조한 후 업데이트가 필요한 문서에 대한 PR을 엽니다.
- 배포 검증 — 배포 후 웹훅으로 트리거되어 Routine이 새 빌드에 대해 스모크 테스트를 실행하고, 오류 로그에서 회귀를 스캔하며, 문제를 최근 코드 변경과 연관시킨 후 릴리스 채널에 Go/No-Go 판정을 게시합니다.
- 일일 코드 리뷰 — 매일 오전 9시에 Routine이 가장 오래된 열린 PR을 선택하여 보안 문제, 논리 오류, 스타일 위반을 검토하고 인라인 댓글을 게시합니다.
이러한 Routine을 3~4개 설정한 사람들은 Claude를 채팅 도구로만 사용하는 사람들과는 완전히 다른 수준으로 작업하고 있습니다.
2단계: 첫 번째 Routine 만들기
Routine을 만드는 방법은 두 가지입니다.
웹 인터페이스에서: claude.ai/code/routines로 이동하여 "New routine"을 클릭하세요. 전체 구성 옵션(일정 트리거, API 트리거, GitHub 이벤트 트리거)을 제공합니다.
CLI에서: 이미 터미널에서 Claude Code를 사용 중이라면 /schedule 다음에 설명을 입력하세요. 예:
1/schedule daily PR review at 9am
CLI는 일정 기반 트리거만 생성합니다. API 및 GitHub 트리거는 웹 인터페이스가 필요합니다.
Routine을 만들 때 다음 네 가지를 구성합니다:
- 프롬프트 — 이것이 가장 중요한 부분입니다. Routine이 자율적으로 실행되므로 프롬프트는 완전히 자체 포함되어야 합니다. 에이전트가 알아야 할 모든 것이 프롬프트에 포함되어야 합니다. "이전 대화의 맥락"은 없습니다. 매 실행은 깨끗한 상태로 시작됩니다.
- 레포지토리 — Routine이 작업할 코드베이스입니다. 기본적으로 전체 읽기 액세스 권한이 있으며
claude/접두사가 붙은 브랜치에 푸시할 수 있습니다. - 커넥터 — Routine이 액세스할 수 있는 외부 서비스입니다. 업데이트 게시용 Slack, 이슈 읽기 및 관리용 Linear, 문서 읽기 및 쓰기용 Google Drive, 이벤트 모니터링 및 PR 열기용 GitHub.
- 트리거 — Routine이 실행되는 시기와 방법입니다. 예약(매시간, 매일 밤, 매주), API 트리거(프로그래밍 방식으로 호출), 또는 GitHub 트리거(레포지토리에서 특정 이벤트가 발생할 때 실행).
3단계: 완벽한 프롬프트 작성하기
이것이 대부분의 사람들이 실패하는 지점입니다.
Routine은 당신이 지켜보지 않아도 실행됩니다. 프롬프트가 모호하면 에이전트가 매번 다르게 해석하여 일관성 없는 결과를 얻을 수 있습니다.
가장 좋은 Routine 프롬프트는 다음 구조를 따릅니다:
- 역할 정의: "당신은 보안과 성능을 전문으로 하는 시니어 코드 리뷰어입니다."
- 작업 정의: "이 레포지토리에서 가장 오래된 열린 풀 리퀘스트를 검토하세요."
- 단계별 프로세스: "먼저 PR 설명을 읽으세요. 그런 다음 브랜치를 체크아웃하세요. 변경된 파일을 읽으세요. 보안 취약점, 논리 오류, 성능 문제를 분석하세요. 발견된 각 문제에 대해 인라인 댓글을 작성하세요."
- 출력 사양: "PR에 요약 댓글을 게시하세요: 발견된 총 문제 수(심각도별), 한 문단의 전체 평가, 명확한 승인/변경 요청 판정."
- 오류 처리: "열린 PR이 없으면 Slack의 #engineering에 '오늘 검토할 열린 PR이 없습니다.'라고 게시하세요. PR에 변경된 파일이 50개를 초과하면 건너뛰고 수동 검토가 필요하다고 게시하세요."
- 제약 조건: "Critical 심각도 문제가 있는 PR은 절대 승인하지 마세요. 코드를 직접 수정하지 말고 댓글만 작성하세요. 파일당 최대 3개의 인라인 댓글로 노이즈를 줄이세요."
프롬프트가 정확할수록 Routine이 더 신뢰할 수 있게 됩니다.
4단계: 한계 이해하기
Routines은 강력하지만 알아야 할 제약 사항이 있습니다.
- 일일 실행 한도: 연구 프리뷰 기간 동안 각 계정은 하루에 15회의 Routine 실행이 가능합니다. 더 필요하면 조직 설정에서 추가 사용량을 활성화하세요. 추가 실행은 측정 기준으로 요금이 부과됩니다.
- 토큰 소비: Routines은 대화형 Claude Code 세션과 동일한 구독 한도에서 토큰을 사용합니다. 많은 파일을 읽고 여러 API 호출을 하는 복잡한 Routine은 단순한 Routine보다 훨씬 더 많은 토큰을 사용합니다.
- 브랜치 보안: 기본적으로 Claude는
claude/접두사가 붙은 브랜치에만 푸시할 수 있습니다. 이는 안전 조치입니다. 잘못 작성된 Routine이 실수로 main에 푸시하는 것을 방지합니다. 하위에 강력한 리뷰 프로세스가 없는 한 이 기능을 비활성화하지 마세요. - GitHub 이벤트 한도: GitHub 트리거 Routine은 프리뷰 기간 동안 Routine당 및 계정당 시간당 한도가 있습니다. 레포지토리가 매우 활발하다면 어떤 이벤트가 Routine을 트리거할지 필터링하여 노이즈에 실행을 낭비하지 마세요.
- 일정 의존성: 예약된 Routine은 지정된 시간에 실행되지만, 수요가 많은 시간에는 변동이 있을 수 있습니다. 정확한 초 단위 타이밍에 의존하는 워크플로를 구축하지 마세요.
5단계: Routine 스택 구축하기
하나의 Routine은 유용합니다. Routine 스택은 시스템입니다.
소규모 엔지니어링 팀을 위한 완전한 Routine 스택의 예는 다음과 같습니다:
- 아침 (9시) — 일일 PR 리뷰: Claude가 모든 열린 PR을 검토하고, 인라인 댓글을 게시하며, 오늘 주의가 필요한 항목의 우선순위 목록과 함께 Slack에 요약을 보냅니다.
- 배포 후 (웹훅) — 배포 검증: 스테이징에 배포가 있을 때마다 Claude가 테스트 스위트를 실행하고, 로그에서 오류를 스캔하며, 몇 분 내에 릴리스 채널에 Go/No-Go를 게시합니다.
- 야간 (오전 2시) — 백로그 트리아지: Claude가 그날 제출된 모든 새 이슈를 처리하고, 레이블을 추가하며, 우선순위 점수를 할당하고, 아침 브리핑 문서를 만듭니다.
- 주간 (금요일 오후 5시) — 문서 점검: Claude가 그 주에 병합된 PR을 스캔하고, 업데이트가 필요한 문서를 식별하며, 각각에 대한 초안 PR을 엽니다.
- 주간 (월요일 오전 8시) — 기술 부채 보고서: Claude가 코드베이스에서 TODO 주석, 더 이상 사용되지 않는 종속성, 테스트 커버리지 격차를 스캔합니다. 예상 노력과 함께 기술 부채 항목의 순위 목록을 생성합니다.
각 Routine을 설정하는 데 10~15분이 걸립니다. 스택을 구성하는 데는 오후 정도가 소요됩니다. 시간 절약은 매주 누적됩니다.
6단계: 모니터링 및 개선
모든 Routine 실행은 로그를 생성합니다. 이를 검토하세요.
다음 패턴을 찾아보세요:
- Routine이 일관되게 좋은 결과를 생성하고 있나요? 그렇지 않다면 프롬프트의 어떤 부분이 모호한가요?
- 특정 실행에 너무 오래 걸리나요? 범위를 좁혀야 할 수도 있습니다.
- 오류가 발생하나요? 프롬프트에 명시적인 오류 처리를 추가하세요.
- 너무 많은 노이즈를 생성하나요? 제약 조건을 강화하세요.
5월 6일 Code with Claude에서 발표된 새로운 "Dreaming" 기능은 이를 더욱 발전시킵니다. Dreaming이 활성화되면 Claude가 실행 사이에 자신의 과거 Routine 세션을 검토하고, 무엇이 잘 작동했고 무엇이 그렇지 않았는지 패턴을 식별하며, 다음 번을 위해 접근 방식을 스스로 개선합니다.
Routine이 실행될수록 문자 그대로 더 똑똑해집니다.
이 기능이 적합한 사람 (그리고 적합하지 않은 사람)
Routines은 다음과 같은 개발자 및 기술에 능숙한 운영자를 위해 만들어졌습니다:
- 이미 Claude Code를 사용 중이거나 배우려는 의지가 있는 사람
- 워크플로에 명확한 패턴을 따르는 반복 가능한 작업이 있는 사람
- 매주 많은 시간을 소모하는 운영 오버헤드를 자동화하려는 사람
- GitHub에 호스팅된 코드베이스로 작업하는 사람
AI 자동화를 찾는 비기술 사용자라면 예약된 작업이 있는 Claude Cowork가 더 나은 시작점입니다. Routines은 파워 유저 도구입니다.
하지만 개발자, 엔지니어링 매니저, DevOps 엔지니어, 기술 창업자라면 — Routines은 Anthropic이 출시한 어떤 기능보다 더 많은 시간을 절약해줄 것입니다.
Routines vs. GitHub Actions: 차이점은 무엇인가
많은 개발자가 묻습니다: GitHub Actions이 무료인데 왜 Claude Routines에 비용을 지불해야 하나요?
답은 GitHub Action은 스크립트라는 것입니다. 모든 단계를 직접 작성합니다. 모든 조건을 직접 정의합니다. 모든 엣지 케이스를 직접 처리합니다. 코딩한 대로만 정확히 수행하고 그 이상은 하지 않습니다.
Claude Routine은 에이전트입니다. 목표를 제시하면 스스로 도달 방법을 결정합니다. 예상치 못한 상황에 적응합니다. 문제에 대해 추론합니다. 자신의 작업을 검증합니다.
GitHub Action은 린터를 실행하고 무엇이 실패했는지 알려줍니다. Claude Routine은 오류를 읽고, 왜 실패했는지 이해하며, 수정 사항을 제안하고, 수정 사항이 포함된 풀 리퀘스트를 엽니다.
이는 근본적으로 다른 범주입니다. 스크립트는 규칙을 따릅니다. 에이전트는 문제를 해결합니다.
단순한 자동화(테스트 실행, 포맷팅 확인, 알림 게시)에는 GitHub Actions으로 충분합니다. 판단, 분석 또는 적응이 필요한 모든 것에는 Routines이 다른 차원에 있습니다.
지금 바로 복사할 수 있는 일반적인 Routine 레시피
다음은 한 시간 안에 설정할 수 있는 5가지 Routine 구성입니다:
레시피 1: 아침 스탠드업 봇
- 일정: 매일 오전 8시 30분
- 프롬프트: "GitHub 레포지토리에서 어제 푸시된 모든 커밋을 확인하세요. Linear에서 새롭고 업데이트된 이슈를 확인하세요. Slack #engineering에서 블로커를 언급하는 메시지를 확인하세요. 세 가지 섹션(완료된 작업, 진행 중인 작업, 차단된 작업)으로 스탠드업 브리핑을 작성하세요. 브리핑을 Slack의 #daily-standup에 게시하세요."
레시피 2: 종속성 감사자
- 일정: 매주 월요일 오전 6시
- 프롬프트: "package.json과 requirements.txt에서 모든 종속성을 스캔하세요. 웹을 사용하여 각 종속성에 알려진 취약점이 있는지 확인하세요. 현재 버전보다 두 개 이상의 메이저 버전 뒤처진 종속성을 식별하세요. 심각도 등급이 포함된 우선순위 보고서를 만들고 Critical 취약점이 발견되면 GitHub 이슈를 여세요."
레시피 3: 체인지로그 생성기
- 트리거: GitHub 이벤트 — 새 릴리스 태그 푸시
- 프롬프트: "새 릴리스 태그가 푸시되면 이전 태그 이후의 모든 커밋을 읽으세요. 각 커밋을 기능, 수정, 개선, 또는 잡일로 분류하세요. CHANGELOG.md에 형식화된 체인지로그를 생성하고 PR을 여세요."
레시피 4: 테스트 커버리지 모니터
- 일정: 매일 오전 1시
- 프롬프트: "테스트 스위트를 실행하세요. 모듈별 커버리지 백분율을 계산하세요. coverage-config.json의 커버리지 기준선과 비교하세요. 모듈이 기준선보다 2% 이상 떨어지면 특정 모듈, 이전 커버리지, 새 커버리지, 하락을 초래한 커밋과 함께 GitHub 이슈를 여세요."
레시피 5: PR 설명 강제자
- 트리거: GitHub 이벤트 — 새 PR 열림
- 프롬프트: "새 PR이 열리면 설명이 템플릿 요구 사항을 충족하는지 확인하세요: 요약 섹션, 테스팅 섹션, UI 변경이 포함된 경우 스크린샷 섹션이 포함되어야 합니다. 누락된 섹션이 있으면 작성자에게 리뷰 전에 설명을 업데이트해 달라고 정중한 댓글을 게시하세요."
각 레시피는 구성하는 데 10분 미만이 소요됩니다. 함께 사용하면 팀이 매월 수십 시간을 절약할 수 있습니다.
결론
기존 방식: 일어나서, 터미널을 열고, Claude Code 세션을 시작하고, 명령을 입력하고, 결과를 기다리고, 다음 작업으로 넘어갑니다. 내일도 반복합니다.
새로운 방식: Routines을 한 번 구성하고, Anthropic의 클라우드에서 실행되도록 두고, 결과와 함께 일어납니다.
이는 이론적인 개선이 아닙니다. 사람들은 이미 전체 운영 워크플로를 야간에 처리하는 Routine 스택을 실행하고 있습니다.
"Claude를 챗봇으로 사용하는 사람"과 "Claude가 24시간 자율적으로 작업하게 하는 사람" 사이의 격차는 매주 커지고 있습니다.
Routines이 그 반대편으로 넘어가는 방법입니다.
대부분의 사람들은 이 글을 읽고 "언젠가 설정해야지"라고 생각할 것입니다. 오늘 실제로 첫 번째 Routine을 만드는 사람들은 다음 주까지 매월 몇 시간을 절약해주는 시스템을 가동하게 될 것입니다.
더 많은 AI 분석과 워크플로를 보려면 @eng_khairallah1을 팔로우하세요. 저는 실제로 작동하는 도구, 설정, 전략에 대한 콘텐츠를 정기적으로 게시합니다.
도움이 되었길 바랍니다, Khairallah ❤️
