Claude Code의 루틴 기능 소개

오늘 Claude Code에 루틴 기능을 리서치 프리뷰로 선보입니다. 루틴은 프롬프트, 리포지토리, 커넥터를 포함해 한 번만 설정하면 예약된 일정, API 호출 또는 이벤트에 따라 실행되는 Claude Code 자동화 기능입니다. 루틴은 Claude Code의 웹 인프라에서 실행되므로, 노트북을 켜 두지 않아도 됩니다.

개발자들은 이미 Claude Code를 사용해 소프트웨어 개발 주기를 자동화하고 있지만, 지금까지는 cron 작업, 인프라, 그리고 MCP 서버와 같은 추가 도구를 직접 관리해야 했습니다. 루틴은 리포지토리와 커넥터에 대한 액세스를 기본으로 제공하므로, 자동화 작업을 패키지로 묶어 예약된 일정이나 트리거에 따라 실행되도록 설정할 수 있습니다.

사용 방법

예약된 루틴

Claude Code에 프롬프트와 실행 주기(매시간, 매일 밤 또는 매주)를 지정하면 해당 일정에 따라 실행됩니다.

Every night at 2am: pull the top bug from Linear, attempt a fix, and open a draft PR.

CLI에서 /schedule 명령어를 사용하고 있다면, 해당 작업은 이제 예약된 루틴으로 전환됩니다.

API 루틴

API 호출을 통해 트리거되도록 루틴을 구성할 수도 있습니다. 모든 루틴에는 고유한 엔드포인트와 인증 토큰이 부여됩니다. POST 요청으로 메시지를 전송하면 세션 URL이 반환됩니다. HTTP 요청을 보낼 수 있는 곳이라면, Claude Code를 알림 시스템, 배포 후크, 내부 도구 등 어디든 연결하세요.

Read the alert payload, find the owning service, and post a triage summary to #oncall with a proposed first step.

Claude Code를 자동화하는 것이 아니라 Claude Platform에서 클라우드 호스팅 에이전트를 구축하고 있다면, Claude 관리형 에이전트의 예약 배포 기능을 통해 직접 만든 에이전트도 동일하게 일정에 따라 실행할 수 있습니다.

웹훅 루틴, GitHub부터 지원

GitHub 리포지토리 이벤트를 구독하면 해당 이벤트가 발생할 때 루틴이 자동으로 시작됩니다. Claude는 필터와 일치하는 모든 PR에 대해 새 세션을 생성하고 루틴을 실행합니다.

Please flag PRs that touch the /auth-provider module. Any changes to this module need to be summarized and posted to #auth-changes.

Claude는 PR마다 하나의 세션을 열고 해당 PR의 업데이트를 세션에 계속 전달하므로, 댓글이나 CI 실패와 같은 후속 상황에도 대응할 수 있습니다.

향후 웹훅 기반 루틴을 더 많은 이벤트 소스에서 트리거할 수 있도록 확장할 계획입니다.

팀이 개발하는 대상

루틴을 도입한 초기 사용자들 사이에서 몇 가지 공통적인 패턴이 나타났습니다.

예약된 루틴

• 백로그 관리: 매일 밤 새로운 이슈를 분류하고, 레이블을 지정하고 할당한 다음, Slack에 요약 내용을 게시합니다.
• 문서 불일치: 매주 병합된 PR을 스캔하고, 변경된 API를 참조하는 문서를 표시한 후, 업데이트 PR을 생성합니다.

API 루틴

• 배포 검증: 배포가 완료될 때마다 CD 파이프라인이 메시지를 게시하면, Claude가 새 빌드의 스모크 테스트를 실행하고 오류 로그에서 회귀 문제를 검사한 다음 릴리스 채널에 진행/중단 여부를 공유합니다.
• 알림 분류: Datadog을 루틴의 엔드포인트로 연결하면, Claude가 트레이스를 가져와 최근 배포 내역과의 연관성을 분석하고, 온콜 담당자가 호출 알림을 확인하기도 전에 수정안 초안을 준비해 둡니다.
• 피드백 해결: 문서 피드백 위젯이나 내부 대시보드가 보고서를 게시하면, Claude가 해당 이슈를 컨텍스트로 삼아 리포지토리에서 세션을 열고 변경 사항의 초안을 작성합니다.

GitHub 루틴

• 라이브러리 포팅: Python SDK에 병합된 모든 PR은 해당 변경 사항을 대응하는 Go SDK로 포팅하고 이에 상응하는 PR을 여는 루틴을 실행합니다.
• 맞춤형 코드 리뷰: PR이 열리면 보안 및 성능 전반에서 팀 고유의 체크리스트를 실행하고, 사람 리뷰어가 검토하기 전에 인라인 댓글을 남깁니다.

시작하기

루틴은 오늘부터 웹용 Claude Code가 활성화된 Pro, Max, Ultra, Team, Enterprise 플랜의 Claude Code 사용자에게 제공됩니다. claude.ai/code에서 첫 번째 루틴을 만들거나, CLI에서 /schedule 명령어를 입력하세요.

루틴은 대화형 세션과 동일한 방식으로 구독 사용량 한도에서 차감됩니다. 또한 루틴에는 일일 한도가 적용됩니다. Pro 사용자는 하루 최대 5개, Max 사용자는 하루 최대 15개, Team 및 Enterprise 사용자는 하루 최대 25개의 루틴을 실행할 수 있습니다. 추가 사용량으로 이러한 한도를 초과하여 루틴을 실행할 수 있습니다. 자세한 내용은 문서를 참조하세요.