클로드 코드 루틴(Routines) 출시
앤스로픽(Anthropic)이 클로드 코드(Claude Code)에 작업을 자동화하는 '루틴(Routines)' 기능을 추가했습니다. 루틴은 프롬프트, 리포지토리, 커넥터를 하나로 묶어 클라우드 환경에서 주기적 또는 이벤트 발생 시 자동으로 실행되도록 구성할 수 있습니다. 이를 통해 개발자는 노트북을 닫아도 백로그 관리, 경고 분류, 코드 리뷰, 배포 검증 등 반복적이고 무인으로 처리 가능한 업무를 손쉽게 자동화할 수 있습니다.
메인 콘텐츠로 건너뛰기 클로드 코드(Claude Code) 문서 홈페이지 영어 검색... ⌘ K AI 검색... 탐색 클로드 코드 웹 버전 루틴(Routines)으로 작업 자동화하기
시작하기, Claude Code로 빌드, 배포, 관리, 설정, 참고 문서, Agent SDK, 새로운 소식, 리소스
시작하기 개요, 빠른 시작, 변경 로그 핵심 개념 Claude Code 작동 방식, Claude Code 확장, .claude 디렉터리 탐색, 컨텍스트 윈도우 탐색, Claude Code 사용법, 지침 및 메모리 저장, 권한 모드 일반적인 워크플로우 모범 사례
플랫폼 및 통합 개요, 원격 제어, 웹 버전 Claude Code, 시작하기, 참고 문서, 클라우드에서 계획하기 데스크톱 앱, Chrome 확장 프로그램(베타), 컴퓨터 사용(프리뷰), Visual Studio Code, JetBrains IDEs 코드 리뷰 및 CI/CD, Slack에서 Claude Code 사용
현재 페이지 예제 사용 사례 루틴 만들기 웹에서 만들기, CLI에서 만들기, 데스크톱 앱에서 만들기 트리거 구성하기 예약 트리거 추가, API 트리거 추가, 루틴 API 참고 문서 GitHub 트리거 추가 (지원 이벤트, 풀 리퀘스트 필터링, 세션이 이벤트에 매핑되는 방식) 루틴 관리 (실행 확인 및 상호작용, 루틴 편집 및 제어, 리포지토리 및 브랜치 권한) 커넥터, 환경, 사용량 및 한도 관련 리소스
루틴(Routines)은 현재 연구 프리뷰(Research Preview) 단계입니다. 동작 방식, 한도 및 API 구성이 변경될 수 있습니다.
루틴은 저장된 Claude Code 구성을 의미합니다. 즉, 하나의 프롬프트, 하나 이상의 리포지토리, 그리고 일련의 커넥터(Connectors)를 하나로 묶어 패키지화한 뒤 자동으로 실행하는 것을 말합니다. 루틴은 Anthropic이 관리하는 클라우드 인프라에서 실행되므로, 노트북을 닫아도 작업이 계속해서 진행됩니다.
각 루틴에는 하나 이상의 트리거를 연결할 수 있습니다.
- 예약(Scheduled): 매시간, 매일 밤, 또는 매주와 같이 정기적인 주기로 실행됩니다.
- API: Bearer 토큰과 함께 개별 루틴 전용 엔드포인트로 HTTP POST 요청을 보내 필요할 때마다 실행(On-demand)할 수 있습니다.
- GitHub: 풀 리퀘스트(Pull Request), 푸시(Push), 이슈(Issue) 또는 워크플로우 실행과 같은 리포지토리 이벤트에 응답하여 자동으로 실행됩니다.
단일 루틴에 여러 트리거를 조합할 수 있습니다. 예를 들어, PR 리뷰 루틴은 매일 밤 실행되도록 예약할 수도 있고, 배포 스크립트에서 트리거할 수도 있으며, 새로운 PR이 생성될 때마다 반응하도록 설정할 수도 있습니다.
루틴은 웹 버전의 Claude Code가 활성화된 Pro, Max, Team, Enterprise 요금제에서 사용할 수 있습니다. claude.ai/code/routines에서 루틴을 생성하고 관리하거나, CLI에서 /schedule 명령어를 통해 관리할 수 있습니다. 이 문서에서는 루틴 생성 방법, 각 트리거 유형 구성, 실행 관리 방법 및 사용량 한도가 적용되는 방식을 다룹니다.
예제 사용 사례 (Example use cases)
각 예제는 트리거 유형과 루틴에 적합한 작업(무인 작동, 반복 가능, 명확한 결과물 수반)을 짝지어 보여줍니다.
- 백로그 유지보수 (Backlog maintenance): 예약 트리거가 커넥터를 통해 이슈 트래커에 매주 평일 밤 실행됩니다. 루틴은 마지막 실행 이후 등록된 이슈를 읽고 라벨을 적용하며, 참조된 코드 영역을 기반으로 담당자를 할당하고, 팀이 하루를 시작할 때 정리된 대기열을 확인할 수 있도록 Slack에 요약을 게시합니다.
- 알림 분류 (Alert triage): 모니터링 도구가 오류 임계값을 초과할 때 루틴의 API 엔드포인트를 호출하고, 알림 본문을 텍스트로 전달합니다. 루틴은 스택 트레이스를 추출해 리포지토리의 최근 커밋과 상관관계를 분석한 뒤, 수정 제안이 포함된 초안 풀 리퀘스트(PR)를 열고 알림에 대한 링크를 남깁니다. 당직(On-call) 엔지니어는 빈 터미널에서부터 시작할 필요 없이 해당 PR을 검토하면 됩니다.
- 맞춤형 코드 리뷰 (Bespoke code review): GitHub 트리거가
pull_request.opened이벤트에서 실행됩니다. 루틴은 팀만의 리뷰 체크리스트를 적용하고, 보안, 성능 및 스타일 문제에 대한 인라인 코멘트를 남기며 요약 코멘트를 추가하여, 사람 리뷰어가 기계적인 확인 작업 대신 설계 자체에 집중할 수 있도록 돕습니다. - 배포 검증 (Deploy verification): CD 파이프라인이 프로덕션 배포 후 루틴의 API 엔드포인트를 호출합니다. 루틴은 새 빌드에 대해 스모크 테스트(Smoke check)를 실행하고 오류 로그를 스캔해 회귀(Regression) 여부를 확인한 뒤, 배포 기간이 끝나기 전에 릴리즈 채널에 Go 또는 No-Go 여부를 게시합니다.
- 문서 드리프트 (Docs drift): 예약 트리거가 매주 실행됩니다. 루틴은 마지막 실행 이후 병합된 PR을 스캔하고, 변경된 API를 참조하는 문서를 표시한 다음, 에디터가 검토할 수 있도록 문서 리포지토리에 업데이트 PR을 엽니다.
- 라이브러리 포팅 (Library port):