앤트로픽(Anthropic)이 Claude Code에 혁신적인 루틴(Routines) 기능을 새롭게 도입했습니다. 이 기능은 개발자들이 반복적인 작업을 자동화하고, AI 에이전트가 정해진 스케줄에 따라 백그라운드에서 작업을 수행할 수 있게 해줍니다. 이번 글에서 루틴 기능의 핵심을 정리해 드리겠습니다.
Claude Code 루틴이란?
루틴(Routines)은 Claude Code 에이전트가 정해진 트리거에 따라 자동으로 실행되는 자동화 작업입니다. 기존에는 개발자가 직접 명령을 내려야 했지만, 이제는 시간 기반, 이벤트 기반, 또는 조건 기반으로 에이전트가 스스로 작업을 시작합니다.
- 시간 기반 트리거 — 매일 오전 9시, 매주 월요일 등 크론 스케줄로 실행
- 이벤트 기반 트리거 — git push, PR 생성, 파일 변경 등 특정 이벤트 발생 시 실행
- 조건 기반 트리거 — 특정 조건 충족 시 자동 실행
루틴의 핵심 기능
1. 스케줄 기반 자동화
개발자가 자주 수행하는 반복 작업을 자동화할 수 있습니다. 예를 들어:
- 매일 아침 코드 리뷰 자동 실행
- 주간 보안 감사 자동 수행
- 매일 테스트 스위트 실행 및 리포트 생성
- 정기적인 의존성 업데이트 체크
2. 백그라운드 에이전트 실행
루틴은 백그라운드에서 독립적으로 실행됩니다. 개발자가 다른 작업을 하는 동안 에이전트가 자동으로 코드 분석, 문서 업데이트, 성능 모니터링 등을 수행합니다.
3. 멀티 에이전트 협업
루틴과 에이전트 팀(Agent Teams) 기능을 결합하면 더욱 강력해집니다. 예를 들어:
- 탐색 에이전트가 코드 변경 감지 → 개발 에이전트가 자동 수정 → QA 에이전트가 검증
- 매일 자동으로 팀 단위 작업 파이프라인 실행
루틴 설정 방법
Claude Code에서 루틴을 설정하는 방법은 간단합니다.
CLI 명령어
# 루틴 생성
claude routine create --name "daily-review" --schedule "0 9 * * *" --prompt "코드 리뷰 실행"
# 루틴 목록 확인
claude routine list
# 루틴 실행 (수동)
claude routine run daily-review
# 루틴 삭제
claude routine delete daily-review설정 파일 방식
# .claude/routines.json
{
"routines": [
{
"name": "daily-review",
"schedule": "0 9 * * *",
"prompt": "src/ 디렉토리의 최근 변경사항을 리뷰하고 개선점을 제안해줘",
"model": "sonnet",
"timeout": 300
}
]
}실전 활용 사례
1. 매일 아침 코드 품질 체크
매일 오전 9시에 자동으로 코드 품질을 점검하고, 문제가 발견되면 Slack이나 텔레그램으로 알림을 보냅니다.
2. PR 자동 리뷰
새로운 PR이 생성되면 자동으로 코드 리뷰를 수행하고, 보안 취약점이나 성능 이슈를 감지합니다.
3. 문서 자동 동기화
코드가 변경되면 자동으로 관련 문서(README, API 문서 등)를 업데이트합니다.
4. 의존성 모니터링
매주 자동으로 패키지 업데이트를 체크하고, 보안 패치가 필요한 의존성을 리포트합니다.
기존 자동화 도구와 비교
| 구분 | Claude Code 루틴 | GitHub Actions | Cron + 스크립트 |
|---|---|---|---|
| 자연어 명령 | 지원 | YAML 문법 | Bash 스크립트 |
| AI 추론 | Claude 모델 내장 | 별도 API 호출 필요 | 없음 |
| 컨텍스트 이해 | 코드베이스 전체 이해 | 제한적 | 없음 |
| 유연성 | 자연어로 조건 설정 | 정형화된 워크플로우 | 하드코딩 |
| 설정 난이도 | 쉬움 (자연어) | 보통 (YAML) | 어려움 (코딩) |
주의할 점
- 비용 관리 — 루틴은 모델 API를 호출하므로 실행 빈도와 토큰 사용량 모니터링이 필요합니다
- 권한 설정 — 루틴이 파일을 수정하거나 외부 API를 호출하는 경우 적절한 권한 설정이 중요합니다
- 타임아웃 — 장시간 실행되는 루틴은 타임아웃을 적절히 설정하세요
- 에러 핸들링 — 루틴 실패 시 알림을 받을 수 있도록 설정하는 것을 권장합니다
자주 묻는 질문 (FAQ)
루틴은 무료인가요?
루틴 기능 자체는 Claude Code에 포함되어 있지만, 실행 시 사용하는 모델 API 비용은 별도로 발생합니다. 가벼운 작업에는 haiku 모델을, 복잡한 분석에는 opus 모델을 사용하는 것이 비용 최적화에 도움됩니다.
루틴은 로컬에서만 실행되나요?
현재는 로컬 머신에서 실행됩니다. Claude Code가 실행 중인 터미널 세션이 활성화되어 있어야 합니다. 향후 클라우드 기반 실행도 지원될 예정입니다.
여러 루틴을 동시에 실행할 수 있나요?
네, 여러 루틴을 동시에 등록하고 병렬로 실행할 수 있습니다. 각 루틴은 독립적인 에이전트 세션에서 실행됩니다.
마무리
Claude Code의 루틴 기능은 AI 에이전트 자동화의 새로운 패러다임을 제시합니다. 반복적인 코드 리뷰, 보안 점검, 문서 업데이트를 자동화함으로써 개발자는 창의적인 문제 해결에 더 집중할 수 있게 됩니다. 아직 초기 단계이지만, 하네스 엔지니어링과 결합하면 강력한 개발 워크플로우를 구축할 수 있습니다.
