Claude Code 루틴 완벽 정리 — 노트북 꺼도 AI가 알아서 일하는 방법

ALT

u라는 단어가 적힌 아이콘

Claude Code 루틴(Routines)은 프롬프트·저장소·커넥터를 한 번만 설정해두면, 이후에는 사람이 개입하지 않아도 스케줄·API·GitHub 이벤트에 따라 자동 실행되는 클라우드 자동화 기능입니다.

Anthropic이 2026년 4월 14일, Claude Code의 새 기능 루틴(Routines)을 연구 미리보기(Research Preview)로 공개했습니다.

루틴은 간단히 말해 "한 번 만들어두면 알아서 돌아가는 Claude Code 자동화"입니다. 기존에는 Claude Code가 로컬 환경에서만 실행됐죠. 루틴이 생기면서 달라집니다. 웹 인프라에서 직접 실행되기 때문에 사용자가 노트북을 켜두지 않아도 됩니다.

루틴을 구성하는 요소는 네 가지입니다.

세 가지 트리거 — 언제 자동으로 실행되나?

1. 예약(Scheduled) — 정해진 시간에 반복 실행

매시간, 매일 밤, 매주처럼 원하는 주기로 자동 실행됩니다.

활용 예시:

• 밤 2시마다 Linear에서 버그 이슈를 가져와 수정 시도 후 드래프트 PR 생성

• 매일 밤 새 이슈 자동 분류, 라벨·담당자 할당, Slack 요약 발송

• 주간 병합 PR을 스캔하고 API 문서 변경 사항 감지 → 업데이트 PR 자동 생성

2. API — HTTP 요청으로 즉시 트리거

각 루틴은 고유한 엔드포인트와 인증 토큰을 갖습니다. HTTP POST 요청 하나로 언제든 실행할 수 있습니다.

활용 예시:

• 배포 후 자동 검증: 스모크 테스트 실행 → 에러 로그 스캔 → 채널에 결과 게시

• Datadog 알림이 트리거되면 트레이스 분석 후 최근 배포와 연계해 수정안 준비

3. GitHub 웹훅 — 레포지토리 이벤트에 자동 반응

PR 생성, 푸시, 이슈 등 GitHub 이벤트가 발생하면 자동으로 루틴이 실행됩니다. 향후 다른 이벤트 소스도 확대 예정이라고 합니다.

활용 예시:

• /auth-provider 모듈을 건드린 PR 자동 감지 → #auth-changes 채널에 요약 게시

• PR 오픈 시 보안·성능 체크리스트 자동 실행, 인라인 댓글 추가

• Python SDK가 병합되면 Go SDK로 자동 포팅하고 매칭 PR 생성

왜 중요한가?

루틴 이전의 Claude Code는 기본적으로 대화형 도구였습니다. 사용자가 명령을 입력해야 Claude가 움직이고, 컨텍스트 창이 닫히면 거기서 끝이었죠.

루틴은 이 패러다임을 바꿉니다. Claude가 주도적으로 작업을 시작할 수 있게 됩니다. 개발자가 자고 있는 사이, 코드베이스를 지켜보고, 이슈를 처리하고, PR을 올릴 수 있습니다.

특히 팀 단위에서 의미가 큽니다. 매일 반복되던 수작업 — 이슈 분류, 문서 업데이트, 배포 후 검증 — 을 루틴 한 번 설정으로 자동화할 수 있습니다.

실전에서 어떻게 쓸 수 있을까?

활용 1: 매일 밤 자동 버그 수정 파이프라인

스케줄 설정: 매일 새벽 2시
프롬프트: "Linear에서 우선순위 높은 버그를 가져와 수정을 시도하고, 성공하면 드래프트 PR을 올려줘"
커넥터: Linear + GitHub

출근하면 이미 드래프트 PR이 올라와 있는 상황을 만들 수 있습니다.

활용 2: PR 생성 시 자동 코드 리뷰

트리거: GitHub — PR opened
프롬프트: "이 PR의 보안 취약점, 성능 이슈, 코드 스타일을 점검하고 인라인 댓글로 피드백을 달아줘"
저장소: 팀 메인 레포

리뷰어 할당 전에 Claude가 1차 리뷰를 자동으로 완료합니다.

활용 3: Datadog 알림 → 자동 트리아지

트리거: API (Datadog 웹훅 연결)
프롬프트: "알림 페이로드를 읽고 관련 서비스를 찾아 최근 배포와 연계해 트리아지 요약을 #oncall 채널에 게시해줘"
커넥터: Slack + GitHub

온콜 담당자가 알람을 받는 순간, 이미 트리아지 요약이 채널에 올라와 있습니다.

요금제별 일일 실행 한도

루틴 실행은 구독 사용량과 동일하게 차감됩니다.

한도 초과 시 추가 사용으로 계속 실행할 수 있습니다.

시작하는 방법

Claude Code on the Web이 활성화된 Pro, Max, Team, Enterprise 사용자라면 지금 바로 사용 가능합니다.

• 웹: claude.ai/code 접속 → 첫 루틴 생성

• CLI: /schedule 명령어 입력

현재 연구 미리보기 단계이며, GitHub 이외의 웹훅 소스는 추후 확대 예정입니다.

자주 묻는 질문

Claude Code 루틴은 무료인가요?

무료로 사용할 수는 없습니다. Pro, Max, Team, Enterprise 구독자에 한해 제공되며, 실행 시 구독 사용량이 차감됩니다. 한도를 초과하면 추가 비용이 발생할 수 있습니다.

Claude Code 루틴을 시작하려면 뭐가 필요한가요?

Claude Code on the Web 기능이 활성화된 계정이 필요합니다. claude.ai/code에서 루틴을 생성하거나, CLI에서 /schedule 명령어로 시작할 수 있습니다. GitHub 연동을 위해서는 레포지토리 커넥터 설정이 필요합니다.

Claude Code 루틴과 기존 CI/CD의 차이점은?

CI/CD는 코드 실행 파이프라인이고, 루틴은 Claude가 자연어 프롬프트를 바탕으로 판단해서 행동하는 AI 에이전트 파이프라인입니다. 루틴은 "버그를 찾아 고쳐줘"처럼 결과 지향적인 작업에 적합하고, 구체적인 스크립트 없이도 동작합니다.

GitHub 외 다른 이벤트 소스도 지원하나요?

현재는 GitHub 이벤트만 지원합니다. Anthropic은 향후 다른 이벤트 소스도 추가할 예정이라고 밝혔습니다.

💡 Insight

루틴 발표를 보면서 떠오른 건 "이제 Claude Code가 진짜 팀원 같아졌다"는 느낌이었습니다.

기존 AI 코딩 도구는 기본적으로 요청-응답 구조였습니다. 내가 물어봐야 답하고, 내가 시켜야 코드를 씁니다. 루틴은 이 구조를 뒤집습니다. Claude가 이벤트를 보고 스스로 판단해서 행동을 시작합니다. 사람으로 치면, 일일이 지시하지 않아도 알아서 이슈를 처리하고 보고하는 팀원입니다.

흥미로운 건 비용 구조입니다. Pro 사용자는 하루 5개 루틴만 실행할 수 있는데, 이게 처음엔 적어 보여도 실제로는 충분할 수 있습니다. 잘 설계된 루틴 5개가 수십 개의 수작업을 대체하니까요. 반대로 Team/Enterprise 플랜에서 25개 루틴을 어떻게 구성하느냐에 따라 팀의 개발 속도가 크게 달라질 수 있습니다.

한국 개발팀 입장에서 가장 바로 써먹을 수 있는 건 배포 후 자동 검증과 이슈 분류 자동화라고 봅니다. 반복적으로 사람 손이 가던 작업인데, 루틴 한 번 설정해두면 온콜 부담이 눈에 띄게 줄어들 겁니다. 특히 소규모 팀에서 하나의 루틴이 사람 0.5명치 역할을 하는 상황도 충분히 가능해 보입니다.

원문: https://claude.com/blog/introducing-routines-in-claude-code