클로드 데스크톱 앱 Routines 기능 사용법 2026 업무 자동화 완벽 가이드
2026년 4월 14일 Anthropic이 research preview로 공개한 클로드 데스크톱 앱 Routines 기능, 직접 설정해보고 공식 문서까지 꼼꼼히 확인한 핵심만 솔직하게 정리해드릴게요.
Routines는 저장된 Claude Code 설정(프롬프트·레포지토리·커넥터)을 Anthropic 클라우드 인프라에서 자동 실행하는 기능이에요. 노트북을 닫아도 새벽 2시 백로그 정리가 돌아가고, PR이 열릴 때마다 코드 리뷰가 시작되는 구조거든요. 출시 직후 개발자 커뮤니티에서 “워크플로우 도구가 아니라 AI 직원이 생긴 느낌”이라는 반응이 쏟아진 이유가 여기에 있어요.
이 글에서는 2026년 최신 기준으로 플랜별 일일 실행 한도, 데스크톱 앱에서 루틴을 만드는 5단계, Schedule·API·GitHub 3가지 트리거의 차이, 실전 업무 자동화 시나리오 6가지, 그리고 운영 중 자주 마주치는 함정까지 한 번에 풀어드릴게요.
클로드 코드 루틴이란? 2026년 업무 자동화의 새로운 축
Routines는 2026년 4월 14일 Anthropic이 Claude Code의 research preview 기능으로 공개한 클라우드 자동화 레이어예요. 핵심은 세 가지랍니다. 프롬프트 한 벌과 하나 이상의 레포지토리, 그리고 MCP 커넥터를 하나의 “저장된 세션”으로 묶어두면, Anthropic이 운영하는 클라우드 인프라에서 자동으로 실행돼요. 로컬 PC가 꺼져 있어도 작업이 계속 진행되는 구조라, 기존의 cron job이나 GitHub Actions 같은 정적 스크립트와는 결이 다른 편이에요.
쉽게 말하면 “단기 실행형 AI 에이전트”에 가깝거든요. cron이 정해진 스크립트를 돌리는 반면, 루틴은 프롬프트를 받아 LLM이 상황에 맞게 판단하고 도구를 호출해요. 그래서 오류 로그 분석, PR 리뷰, 문서 드리프트 체크처럼 “해석이 필요한 반복 업무”에 특히 유효한 편이에요.
| 항목 | 상세 |
|---|---|
| 출시일 | 2026년 4월 14일 (research preview) |
| 실행 환경 | Anthropic 관리 클라우드 인프라 |
| 생성 경로 | 웹, 데스크톱 앱, CLI (세 경로 모두 동일 계정에 연동) |
| 필수 조건 | Claude Code on the web 활성화 |
| 지원 OS | macOS, Windows |
| 성격 | 자율 실행 세션 (실행 중 승인 프롬프트 없음) |
플랜별 일일 실행 한도와 사전 준비 조건
Routines는 Free 플랜에서는 사용할 수 없고, Pro 이상 유료 플랜에서만 열려요. 그리고 플랜 티어에 따라 하루 실행 가능한 루틴 수가 명확하게 나뉜답니다. Pro는 5회, Max는 15회, Team과 Enterprise는 25회까지 실행할 수 있어요. 한도를 초과하면 추가 사용량을 구매해야 해요.
실행 한도와 별개로 반드시 확인해야 할 사전 조건이 하나 있어요. “Claude Code on the web”이 활성화되어 있어야 한답니다. 이건 클라우드 세션 기능 전반을 여는 스위치거든요. 데스크톱 앱 버전도 최소 v1.2581.0 이상이어야 해요. 그래서 오래된 버전을 쓰고 있다면 업데이트 먼저 진행해주세요.
| 플랜 | 일일 루틴 실행 한도 | 추천 대상 |
|---|---|---|
| Pro | 5회 | 개인 개발자, 사이드 프로젝트 |
| Max | 15회 | 풀타임 개인 개발자, 프리랜서 |
| Team | 25회 | 소규모 개발팀, 스타트업 |
| Enterprise | 25회 + 구매 확장 | 중대형 엔지니어링 조직 |
데스크톱 앱에서 루틴 만드는 5단계 가이드
데스크톱 앱에서 루틴을 만드는 전체 흐름은 크게 다섯 단계로 정리돼요. 순서가 꼬이면 로컬 스케줄 작업을 만들고 클라우드 루틴을 만들었다고 오해하는 경우가 많으니, 단계별로 체크하면서 진행해주세요.
가장 흔한 실수는 3단계에서 “New local task”를 선택해버리는 거예요. 로컬 작업은 로컬 PC에서 실행되는 별개 기능이라, 노트북이 꺼지면 작동하지 않아요. 그래서 반드시 “New remote task”를 선택해야 클라우드 루틴이 생성된답니다.
| 단계 | 작업 내용 | 핵심 포인트 |
|---|---|---|
| 1단계 | 데스크톱 앱 업데이트 | v1.2581.0 이상 필수 |
| 2단계 | Schedule 페이지 진입 | 사이드바 → Schedule |
| 3단계 | New task → New remote task | local task는 다른 기능 |
| 4단계 | 프롬프트·레포·환경·커넥터 설정 | 성공 기준을 프롬프트에 명시 |
| 5단계 | 트리거 선택 후 저장 | Schedule/API/GitHub 중 선택 |
3가지 트리거 유형 완벽 정리: 스케줄·API·깃허브
루틴의 핵심은 “언제 실행할지”를 정하는 트리거랍니다. Anthropic이 제공하는 트리거는 Schedule, API, GitHub 세 종류이고, 한 루틴에 여러 트리거를 조합할 수도 있어요. 예를 들어 PR 리뷰 루틴을 매일 밤 실행하면서(Schedule), 배포 스크립트에서 호출하고(API), PR이 열릴 때마다 자동 실행(GitHub)하는 3중 진입점을 동시에 걸어둘 수 있거든요.
Schedule 트리거는 hourly, daily, weekdays, weekly 네 가지 프리셋을 제공해요. “매 2시간마다”처럼 커스텀 주기가 필요하면 가장 가까운 프리셋을 고른 뒤 CLI에서 /schedule update 명령으로 cron 표현식을 직접 지정해야 해요. 시간대는 로컬 타임존으로 입력하면 자동 변환되고, 실제 실행은 stagger 때문에 몇 분 늦게 시작될 수 있는 편이에요.
| 트리거 | 실행 방식 | 대표 활용 영역 |
|---|---|---|
| Schedule | 정해진 주기(hourly/daily/weekdays/weekly)로 자동 실행 | 백로그 정리, 주간 문서 점검 |
| API | 전용 엔드포인트에 Bearer 토큰 포함 HTTP POST | CD 파이프라인, Datadog 알림 트리아지 |
| GitHub | PR opened/closed, push, review 등 저장소 이벤트 반응 | PR 자동 리뷰, 라이브러리 포팅 |
실전 업무 자동화 시나리오 6가지 패턴
Anthropic 공식 문서가 제시한 실전 활용 패턴과 커뮤니티 사례를 종합하면, 2026년 4월 기준 가장 안정적으로 작동하는 루틴 6가지는 아래와 같아요. 모두 “해석이 필요한 반복 업무”라는 공통점이 있어요.
첫 번째는 백로그 유지보수예요. 평일 매일 밤 이슈 트래커 커넥터를 통해 새 이슈를 읽어서 레이블링·담당자 배정·Slack 요약을 자동화하는 패턴이랍니다. 두 번째는 알림 트리아지로, Datadog 같은 모니터링 도구가 API 트리거로 스택트레이스를 넘기면 루틴이 최근 커밋과 상관관계를 분석해 제안 PR을 열어주는 구조예요.
| 시나리오 | 트리거 | 대표 산출물 |
|---|---|---|
| 백로그 유지보수 | Schedule (평일 야간) | 레이블·담당자 자동 배정 + Slack 요약 |
| 알림 트리아지 | API (모니터링 훅) | 원인 분석 + 초안 PR |
| PR 코드 리뷰 | GitHub (pull_request.opened) | 인라인 코멘트 + 요약 |
| 배포 검증 | API (CD 파이프라인) | 스모크 테스트 결과 + go/no-go |
| 문서 드리프트 체크 | Schedule (주간) | 문서 업데이트 PR |
| 라이브러리 포팅 | GitHub (pull_request.closed merged) | 다른 언어 SDK 매칭 PR |
CLI와 웹 콘솔에서 루틴 관리하는 방법
루틴은 웹, 데스크톱 앱, CLI 세 경로에서 모두 만들 수 있고, 어느 경로에서 만들어도 같은 계정의 claude.ai/code/routines에 즉시 나타나요. 그래서 상황에 맞게 섞어 쓰는 편이 효율적이랍니다.
CLI에서는 /schedule 명령이 중심이에요. 아무 세션에서나 /schedule을 실행하면 Claude가 대화형으로 필요한 정보를 묻고 루틴을 저장해줘요. 한 줄 설명을 붙여서 /schedule daily PR review at 9am처럼 자연어로도 생성 가능하고요. 기존 루틴은 /schedule list로 조회, /schedule update로 수정, /schedule run으로 즉시 실행할 수 있어요. 다만 CLI는 Schedule 트리거만 생성 가능한 편이라, API나 GitHub 트리거를 추가하려면 웹 UI에서 편집해야 해요.
| 경로 | 가능한 트리거 | 추천 용도 |
|---|---|---|
| 웹 (claude.ai/code/routines) | Schedule, API, GitHub 모두 | 최초 설정, API 토큰 발급, GitHub App 연결 |
| 데스크톱 앱 (Schedule 페이지) | Schedule, API, GitHub 모두 (New remote task) | 로컬·클라우드 작업을 한 화면에서 관리 |
CLI (/schedule) | Schedule만 생성, 관리는 전부 가능 | 대화형 빠른 생성, 자동화 스크립트 연동 |
운영 시 주의사항과 실전 운영 팁
루틴을 production 수준으로 굴리기 시작하면 공식 문서에 나오지 않는 함정이 몇 가지 있어요. 가장 큰 건 “자율 실행” 특성이거든요. 루틴은 실행 중에 어떤 승인 프롬프트도 띄우지 않아요. 프롬프트가 모호하거나 범위가 넓으면 Claude가 판단해서 쉘 명령을 돌리고 커밋을 만들어버릴 수 있다는 뜻이랍니다. 그래서 성공·실패 조건, 건드려도 되는 파일 범위, 실패 시 동작을 프롬프트에 미리 박아두는 편이 안전해요.
GitHub 트리거를 처음 설정할 때 자주 막히는 지점도 짚고 넘어갈게요. CLI의 /web-setup 명령은 레포지토리 클론 권한만 부여하고, GitHub App 자체는 별도로 설치해야 해요. 그래서 “트리거가 아예 안 터진다”는 증상이라면 웹 UI의 트리거 설정 단계에서 GitHub App 설치 유도 다이얼로그를 끝까지 완료했는지부터 확인하세요.
| 주의 포인트 | 체크 방법 |
|---|---|
| 자율 실행 특성 | 프롬프트에 성공 기준·파일 범위 명시 |
| GitHub 트리거 미작동 | GitHub App 설치 완료 여부 확인 |
| 일일 한도 초과 | 플랜별 5/15/25회 기준 모니터링 |
| 시간대 stagger | 예약 시각 기준 최대 수 분 지연 가능 |
| 커스텀 cron 필요 | 프리셋 지정 후 /schedule update로 교체 |
직접 주간 PR 리뷰 루틴과 야간 문서 드리프트 체크 루틴을 돌려본 경험으로는, 시간대 선택보다 “프롬프트 안에 체크리스트를 명시적으로 박아두는 것”이 결과물 일관성에 훨씬 결정적이었어요. 한 줄짜리 지시문으로 시작했더니 리뷰 톤이 매번 달라졌는데, 체크 항목 7개를 번호로 적어둔 뒤로는 거의 같은 구조의 결과물이 나와서 사람이 검수하기 훨씬 수월해진 편이랍니다.
자주 묻는 질문
Routines는 무료 플랜에서도 사용할 수 있나요?
아니요, 무료 플랜에서는 사용할 수 없어요. Pro, Max, Team, Enterprise 네 가지 유료 플랜에서만 제공되고, 추가로 해당 계정에 “Claude Code on the web”이 활성화되어 있어야 루틴 메뉴가 열린답니다.
Pro 플랜의 일일 5회 한도를 초과하면 어떻게 되나요?
해당 일의 한도를 소진하면 새 루틴 실행이 제한돼요. Anthropic은 추가 사용량을 구매할 수 있는 옵션을 제공하고 있고, 반복적으로 한도를 넘긴다면 Max(15회) 또는 Team(25회) 플랜으로 업그레이드하는 편이 장기적으로 경제적이에요.
로컬 스케줄 작업(Local task)과 원격 루틴(Remote task)은 뭐가 다른가요?
로컬 스케줄 작업은 본인 PC의 Claude Code가 실행하는 기능이라 노트북이 꺼져 있으면 돌아가지 않아요. 반면 원격 루틴은 Anthropic 클라우드 인프라에서 실행되므로 기기 상태와 무관하게 24시간 작동해요. 그래서 백그라운드 자동화는 반드시 New remote task로 만들어야 해요.
GitHub 트리거를 설정했는데 아예 작동하지 않아요. 어디부터 확인해야 하나요?
가장 흔한 원인은 Claude GitHub App 미설치예요. CLI의 /web-setup 명령은 레포지토리 클론 권한만 부여하고, 이벤트 리스닝에 필요한 GitHub App은 별도 설치가 필요하거든요. 웹 UI의 GitHub 트리거 설정 화면에서 “Install GitHub App” 유도 다이얼로그를 끝까지 완료했는지 먼저 확인하세요.
Routines와 n8n, Zapier 같은 워크플로우 도구의 차이점은 뭔가요?
n8n·Zapier는 결정론적 스크립트를 실행하는 도구예요. 정해진 단계가 정해진 순서대로 돌아가죠. Routines는 LLM이 프롬프트를 보고 상황에 맞게 도구를 선택해서 실행하는 구조라, 해석과 판단이 필요한 업무(PR 리뷰, 이슈 분류, 원인 분석)에 더 적합한 편이에요. GitHub Actions의 결정론적 CI/CD 흐름과 병행해서 쓰는 조합이 실제 현장에서 자주 보여요.
루틴 실행 중에 권한 승인 프롬프트가 뜨나요?
뜨지 않아요. Routines는 full Claude Code 클라우드 세션을 자율 모드로 실행하는 기능이라, 중간에 permission-mode 선택이나 승인 다이얼로그가 전혀 없답니다. 그래서 프롬프트에 작업 범위·성공 조건·실패 시 동작을 명시적으로 박아두는 편이 안전해요.
결론
정리하면, 2026년 4월 14일 공개된 클로드 데스크톱 앱의 Routines 기능은 Claude Code 세션을 클라우드에서 자동 실행하는 자율 에이전트형 자동화예요. Pro 5회·Max 15회·Team/Enterprise 25회라는 일일 한도 안에서 Schedule·API·GitHub 세 가지 트리거를 조합할 수 있고, 백로그 정리, PR 리뷰, 배포 검증, 문서 드리프트 체크 같은 해석형 반복 업무에 특히 잘 맞는 편이랍니다.
처음 도입한다면 읽기 전용 권한 + 드래프트 PR만 열도록 범위를 좁힌 주간 PR 리뷰 루틴부터 시작해보세요. 2주 정도 결과물을 관찰하면 프롬프트의 어떤 부분이 품질을 결정하는지 감이 잡힐 거예요. 그 뒤에 권한과 트리거를 확장하는 순서로 가는 편이 사고 없이 자동화 범위를 넓히는 가장 실전적인 경로랍니다.
댓글
댓글 쓰기