Claude Code routines: 노트북을 닫아도 반복 작업이 이어지는 이유 | DAKER 커뮤니티

반복 작업은 대개 어렵지 않지만, 시작 버튼을 사람이 매번 눌러야 한다는 점에서 자주 끊깁니다. 문서 드리프트를 확인하고, 배포 뒤 상태를 살피고, 이슈를 읽어 PR을 여는 일은 이미 절차가 정해져 있어도 세션을 띄우는 순간부터 손이 갑니다.

이번 글은 새 모델 발표가 아니라, 그 시작 순서를 바꾸는 이야기입니다. Claude Code의 routines는 프롬프트와 저장소, 커넥터, 트리거를 저장해 두고 스케줄이나 이벤트가 먼저 세션을 열게 합니다. 노트북을 닫아도 세션은 클라우드에서 이어집니다.

참고 영상은 Claude 채널의 Build a proactive agent workflow with Claude Code입니다. 발표는 앤스로픽 응용 AI 팀의 Maya입니다. 공식 문서는 Automate work with routines, 제품 소개는 2026년 4월 14일 Introducing routines in Claude Code, 웹 관리 화면은 claude.ai/code/routines입니다. 이 글은 컨퍼런스 중계가 아니라, 팀 저장소에 루틴 하나를 만들어 반복 작업을 엔터 없이 한 번 돌려 보는 최소 실험에 가깝습니다.

영상이 보여 준 핵심은 무엇인가

영상은 먼저 기존 방식의 불편을 짚습니다. Claude Code를 cron에 올리거나 별도 인프라로 자동화를 만들면, 세션을 어디에 둘지부터 직접 정해야 합니다. 노트북을 닫거나 배터리가 끊기면 로컬 세션은 끝나고, 호스팅과 상태 저장, 인증을 프롬프트 바깥에서 따로 다뤄야 합니다. 언제 시작할지도 cron이나 엔드포인트 POST처럼 직접 만들어야 하고, 헤드리스로 켠 세션을 실시간으로 보고 방향을 고치거나 이어서 열기도 쉽지 않습니다.

routines는 이 세 문제를 제품 안으로 가져옵니다. 정의는 짧습니다. 원격 Claude Code 세션을 켜는 자동화입니다. 사용자는 프롬프트, 연결할 저장소, 사용할 커넥터, 트리거를 정하고 나머지는 Claude Code가 맡습니다.

반복 작업의 핵심은 더 똑똑한 프롬프트보다, 세션을 누가 언제 시작하느냐에 있습니다.

영상에서 말한 설계 원칙도 분명합니다. 첫째, 항상 켜져 있을 것. 관리형 인프라가 호스팅과 세션 상태, 커넥터를 다루므로 노트북이 열려 있을 필요가 없습니다. 둘째, 능동적으로 시작할 것. 시간 스케줄, GitHub 이벤트, 직접 만든 웹훅과 엔드포인트 POST로 세션을 열 수 있습니다. 셋째, 일반 세션처럼 조작 가능할 것. 루틴으로 켜진 세션도 웹과 CLI, 데스크톱에서 열고 보고 이어서 말하고 방향을 고치고 재개할 수 있습니다.

문서 유지 데모가 보여 준 사용 방식

영상의 내부 사례는 문서 유지입니다. Maya는 연초 이후 Claude Code 주간 PR이 200% 늘었다고 말합니다. 이 숫자는 영상의 설명이며, 공식 실적으로 옮겨 적을 값은 아닙니다. 다만 문서와 에이전트 SDK 문서를 유지하는 엔지니어 한 명에게 반복 부담이 컸고, 그 엔지니어가 루틴을 일찍 쓰기 시작했다는 맥락은 분명합니다.

터미널 데모는 /schedule로 시작합니다. 영상에서 입력한 문장은 일주일에 한 번, main에 병합된 새 변경을 문서 저장소와 맞춰 보고 차이가 있으면 문서를 고치는 PR을 만들어 달라는 요청입니다. Claude는 매주 몇 시에 켤지, PR을 만든 뒤 Slack으로 알릴지 같은 후속 질문을 하고, 답을 받으면 웹의 routines 목록에 항목이 생깁니다.

여기서 중요한 것은 어떤 루틴이든 세 가지 결정을 먼저 고른다는 점입니다. 트리거, 컨텍스트, 조종입니다. 트리거는 시간일 수도 있고 이벤트일 수도 있습니다. 주간 문서 검토는 시간 기반이고, 릴리스 브랜치가 잘릴 때 문서를 비교하는 일이나 need docs 라벨이 붙은 PR 병합 시 세션을 여는 일은 이벤트 기반입니다.

컨텍스트는 에이전트가 성공하려면 무엇을 볼 수 있어야 하는가에 대한 결정입니다. 문서 예시에서는 소스 저장소와 문서 저장소가 둘 다 필요합니다. 마케팅 문구를 맞추려면 Google Drive 커넥터가, PR 뒤 알림을 보내려면 Slack 커넥터가 필요합니다. Maya는 컨텍스트가 성공의 천장이라고 말합니다.

조종은 출력을 어떻게 붙잡을지에 관한 문제입니다. 영상은 생성과 비판을 나누는 패턴을 보여 줍니다. 문서 PR을 만드는 루틴 하나, 그 PR이 생기면 코멘트를 다는 루틴 하나를 두는 식입니다. 사람 없이 돌리되 필요할 때는 웹에서 라이브 세션을 열어 중간 질문을 하거나 방향을 바꿀 수 있고, 지난 세션을 이어서 열 수도 있습니다. 마지막에는 바뀐 페이지를 렌더해 사람이 기대와 같은지 확인합니다.

트리거를 고르고, 성공에 필요한 컨텍스트를 붙이고, 출력을 어떻게 조종할지 정하면 루틴의 뼈대가 잡힙니다.

웹 화면과 이벤트 데모에서 확인된 점

웹 화면에서 연 주간 루틴에는 저장소 두 개, 매주 월요일 오전 10시, GitHub와 Slack 연결이 들어 있습니다. 오른쪽 지시문은 처음 프롬프트와 후속 답을 바탕으로 Claude가 생성한 문장입니다. 세션을 열면 이 지시문이 첫 프롬프트로 들어가고, Claude는 소스의 최근 병합과 변경 로그를 읽어 문서 저장소와 비교한 뒤 차이를 찾아 PR을 엽니다.

두 번째 데모는 GitHub 이슈가 열릴 때를 다룹니다. 이슈를 조사하고 문서 공백이면 PR을 연 뒤 지정한 채널에 알리라는 지시입니다. 트리거 종류는 스케줄과 이벤트이며, 이벤트 안에서는 네이티브 GitHub와 직접 POST가 있습니다. 새 이슈를 만들자 실행이 붙고, 이슈 본문이 추가 맥락으로 들어갑니다. Maya는 이미 같은 내용의 PR이 있다고 말하며 세션을 멈춥니다. 루틴이 켜진 뒤에도 실시간으로 방향을 고칠 수 있다는 장면입니다.

적용 예로는 배포 검증도 나옵니다. 트리거는 CD가 배포 뒤 보내는 POST이고, 컨텍스트는 방금 배포한 서비스 소스와 Datadog이나 Grafana 같은 모니터링, 문제가 있으면 Slack이나 이메일, Twilio로 알리는 도구입니다. 조종은 먼저 조사와 go/no-go를 사람이 맡기고, 웹에서 분석을 읽은 뒤 롤백을 함께 하다가, 신뢰가 쌓이면 모니터링 데이터만으로 롤백까지 맡기는 순서입니다. 온콜 조사나 백로그 이슈를 주간으로 읽어 우선순위를 매기고 PR을 여는 일도 같은 세 결정으로 나눌 수 있습니다.

공식 문서가 보태는 운영상의 조건

공식 문서는 routines를 연구 프리뷰로 설명합니다. 동작과 한도, API 표면은 바뀔 수 있습니다. 루틴은 저장한 Claude Code 구성으로, 프롬프트와 저장소 하나 이상, 커넥터 집합으로 이뤄집니다. 실행 위치는 앤스로픽이 관리하는 클라우드이거나 조직의 자체 호스팅 환경입니다.

트리거는 세 종류입니다. 시간 스케줄, API POST, GitHub 이벤트입니다. 한 루틴에 여러 트리거를 붙일 수 있습니다. 사용 조건은 Pro, Max, Team, Enterprise이며 Claude Code on the web이 켜져 있어야 합니다. 생성은 웹과 데스크톱, CLI가 같은 계정에 씁니다. CLI에서는 /schedule을 사용하고, 별칭은 /routines입니다. CLI의 /schedule은 스케줄 루틴을 만들고, API 트리거는 웹에서 추가합니다. GitHub 트리거는 웹 또는 Claude Code v2.1.225 이상 CLI에서 다룹니다.

실행 중에는 권한 모드 선택이나 승인 프롬프트가 없습니다. 셸 명령, 저장소에 커밋된 스킬, 포함한 커넥터를 호출할 수 있습니다. 도달 범위는 고른 저장소, 환경의 네트워크와 변수, 포함한 커넥터로 정해집니다. 루틴은 개인 claude.ai 계정에 속하며 팀과 공유되지 않고 일일 실행 한도에 잡힙니다. GitHub 커밋과 PR, Slack 메시지, Linear 티켓은 연결된 본인 계정으로 보입니다.

프롬프트는 특히 중요합니다. 후속 질문이 없으므로 할 일과 성공 기준을 스스로 완결되게 적어야 합니다. 트리거가 켜지면 저장한 프롬프트가 할당된 작업으로 들어갑니다. API로 보내는 text는 신뢰하지 않는 데이터 블록으로 감싸이며, 저장한 프롬프트가 그 블록을 쓰라고 명시하지 않으면 내용은 참고만 됩니다.

저장소는 실행마다 기본 브랜치에서 클론되고, 변경은 claude/ 접두 브랜치로 올라갑니다. 커넥터는 계정에 연결된 것이 기본으로 모두 들어가므로 쓰지 않는 것은 빼는 편이 좋습니다. 실행 중에는 쓰기 도구도 묻지 않고 호출됩니다. 로컬에서 claude mcp add로 넣은 서버는 이 목록에 없고, 루틴에서 쓰려면 claude.ai 커넥터로 추가하거나 저장소에 .mcp.json을 커밋해야 합니다.

초록 상태는 인프라 오류 없이 실행이 끝났다는 뜻이지, 프롬프트의 일이 성공했다는 뜻은 아닙니다.

문서에 따르면 실행 목록의 초록 상태는 시작과 종료가 인프라 오류 없이 이뤄졌다는 의미입니다. 네트워크 차단, 빠진 커넥터, 작업 실패는 트랜스크립트를 열어야 보입니다. 남은 일일 실행 수는 claude.ai/code/routines와 사용량 페이지에서 확인할 수 있습니다. 원샷 스케줄은 문서 기준으로 일일 루틴 한도에 넣지 않으며, 구독 사용량은 일반 세션과 같이 차감됩니다.

이 글의 범위는 어디까지인가

이 글은 새 코딩 모델을 기다리는 글도, 벤치 점수를 다시 쓰는 글도 아닙니다. 오늘 바뀌는 것은 반복 작업을 엔터로 시작하던 순서입니다. 프롬프트를 저장하고 트리거가 세션을 켜게 하는 방식으로 옮겨 가는 이야기입니다.

또한 영상에서 말한 주간 PR 200%를 모든 팀의 성장률처럼 일반화하지 않습니다. 그 값은 영상 설명입니다. 오늘 팀이 재현한 실행 횟수와 PR 수만 팀 노트에 적으면 됩니다. 없는 절감률이나 설치 수, 별 숫자를 덧붙일 필요는 없습니다.

유튜브 화면을 본문에 넣지 않고 주소만 두는 이유도 같습니다. 이 글에서 중요한 것은 자극적인 소개가 아니라 재현 가능한 순서입니다. 트리거를 고르고, 컨텍스트를 붙이고, 조종 방법을 정한 뒤 /schedule 또는 웹에서 루틴 하나를 저장하는 일입니다.

마지막으로, 루틴 설정 화면만으로는 제출이 아닙니다. 루틴이 PR을 열었다면 그 PR의 공개 주소나 팀이 합의한 스테이징에서 같은 결과가 보여야 제출이라고 부를 수 있습니다.

오늘 바로 해 볼 수 있는 최소 실험

오늘 범위는 제품 전체 자동화가 아닙니다. 지금 쓰는 Claude Code 계정에 루틴 하나를 만들어, 이미 매주 손으로 하던 일 한 가지를 트리거에 맡겨 보는 정도면 충분합니다. 문서 드리프트 확인, 백로그 정리, 배포 후 스모크처럼 결과가 PR이나 채널 메시지로 드러나는 작업이 적당합니다.

터미널을 쓴다면 프로젝트 폴더에서 /schedule을 열고, 영상처럼 자연어 한 문장으로 주기와 할 일을 적으면 됩니다. 예를 들어 매주 월요일에 main 병합과 문서를 비교하고 차이가 있으면 PR을 열어 달라고 적는 방식입니다. 시각과 알림 채널 질문에 답하고 저장한 뒤, 웹 목록에 같은 항목이 보이는지 확인하면 됩니다.

처음에는 트리거를 한 종류만 붙이는 편이 좋습니다. 주간 작업이면 스케줄, 배포 파이프라인이면 웹의 API 트리거, PR이나 이슈면 GitHub 이벤트처럼 가장 단순한 경로부터 시작하면 됩니다. 저장소와 커넥터도 최소로 남겨야 합니다. 문서 동기화라면 소스와 문서 저장소, 필요하면 Slack 정도면 충분합니다.

프롬프트에는 성공 기준과 하지 말 일을 함께 적는 것이 좋습니다. 차이가 없으면 PR을 열지 않기, 이미 같은 주제의 PR이 열려 있으면 새 PR을 만들지 않고 멈추기 같은 조건이 여기에 들어갑니다. API로 불릴 루틴이라면 페이로드 블록을 조사하라고 명시해야 합니다.

저장 직후에는 Run now로 한 번 실행해 보는 편이 안전합니다. 초록 상태만 보고 끝내지 말고, 세션을 열어 트랜스크립트와 열린 PR, 알림을 사람이 확인해야 합니다. 방향이 어긋나면 웹에서 중간 지시를 남기고 프롬프트를 고친 뒤 다음 스케줄에 맡기면 됩니다.

첫 루틴의 목표는 모든 일을 자동화하는 것이 아니라, 이미 합의된 반복 작업 하나를 엔터 없이 돌려 보는 데 있습니다.

팀 README나 제출 노트에는 오늘 만든 루틴 이름, 트리거, 저장소, 커넥터, 검증한 세션 주소를 남겨 두는 편이 좋습니다. 채팅에만 남은 설정은 다음 사람이 재현하기 어렵기 때문입니다.

참고 자료

Build a proactive agent workflow with Claude Code
Claude
Automate work with routines
Introducing routines in Claude Code
claude.ai/code/routines

팀에서 먼저 맡겨 보고 싶은 반복 작업은 어떤 종류인지 궁금합니다.