Claude Code의 Routines: 클라우드에서 도는 것, 내 컴퓨터에 남는 것, 그리고 고르는 법

이제 Claude Code에는 여러분이 직접 입력하지 않고도 프롬프트를 실행하는 방법이 세 가지 있고, 이름이 서로 겹쳐서 누구라도 헷갈릴 만합니다. Routines, 데스크톱 앱의 예약 작업, 그리고 /loop입니다. 데스크톱 앱은 앞의 두 가지를 같은 페이지에서 만들기까지 합니다. 셋은 작업을 자동화할 때 중요한 단 하나의 지점에서 다릅니다. 에이전트가 어디서 돌아가는지, 그래서 무엇을 볼 수 있는지입니다.

이 가이드는 문서에 적힌 제약과 함께 셋을 차례로 살펴봅니다(2026년 10월 4일 확인. Routines는 리서치 프리뷰 단계이며, Anthropic은 동작, 제약, API가 바뀔 수 있다고 밝힙니다). 그다음 저희가 직접 하는 방식을 설명합니다. 저희 쪽에서는 매일 저녁 에이전트 일곱 개가 시작되는데, 그중 어느 것도 routine이 아닙니다. 이유는 구체적이고, 여러분에게 해당할 수도 아닐 수도 있습니다.

routine이란 무엇인가

routine은 저장된 Claude Code 설정입니다. 프롬프트, 하나 이상의 GitHub 저장소, 커넥터 묶음을 한 번 꾸려 두고 자동으로 실행합니다. Anthropic이 관리하는 클라우드 인프라에서 돌아가며, 조직이 그쪽으로 보내는 경우에는 조직의 자체 호스팅 환경에서 돌아갑니다. 노트북은 닫혀 있어도 됩니다.

각 실행은 완전한 cloud session입니다. 여기서 네 가지 결과가 따라오며, 기억해 둘 것은 바로 이 넷입니다.

• 매번 새로운 클론. 각 저장소는 실행이 시작될 때 기본 브랜치에서 클론됩니다. 프롬프트에서 달리 지시하지 않는 한, Claude는 작업을 claude/로 시작하는 브랜치에 푸시합니다. 여러분의 컴퓨터에서 커밋되지 않은 것은 routine에게 존재하지 않습니다.
• 권한 확인 없음. 권한 모드를 고르는 선택지가 없습니다. 세션은 셸 명령을 실행하고, 저장소에 커밋된 skills를 쓰고, 포함된 모든 커넥터의 모든 도구를 쓰기 작업까지 포함해 멈춰서 묻지 않고 호출합니다.
• 로컬 MCP 서버가 아니라 커넥터. claude.ai 계정의 모든 커넥터가 기본으로 포함되며, 문서는 routine에 필요 없는 것을 빼라고 권합니다. claude mcp add로 로컬에 추가한 서버는 여러분의 컴퓨터에 있어서 이 목록에 들어가지 않습니다. 커밋된 .mcp.json이 또 하나의 통로입니다.
• 여러분으로서 행동합니다. Routines는 개인 계정에 속합니다. 커밋과 풀 리퀘스트에는 여러분의 GitHub 사용자가 찍히고, Slack 메시지와 Linear 티켓은 연결된 여러분의 계정을 씁니다.

Routines는 Pro, Max, Team, Enterprise 요금제에서 쓸 수 있습니다. claude.ai/code/routines에서, 데스크톱 앱(Code 탭, Routines, New routine, Cloud)에서, 또는 CLI에서 만듭니다.

세 가지 트리거

routine 하나에 트리거를 하나만 달 수도 있고, 여러 개를 함께 달 수도 있습니다.

예약. 매시간, 매일, 평일, 매주 중 하나를 여러분의 현지 시각 기준으로, 또는 미래의 특정 시각에 한 번만 실행합니다. 최소 간격은 1시간입니다. 문서에 나온 알아 둘 만한 세부 사항이 하나 있습니다. 정각에 딱 맞춰 예약한 실행은 몇 분 늦게 시작될 수 있으니, 시각이 중요하다면 9:00 대신 9:07을 고르세요.

API. routine마다 전용 엔드포인트와 전용 bearer 토큰이 있으며, 토큰은 웹에서 발급합니다(CLI로는 토큰을 만들거나 폐기할 수 없습니다). POST 한 번으로 세션이 시작되고 그 URL이 돌아옵니다.

curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \
  -H "Authorization: Bearer sk-ant-oat01-xxxxx" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod."}'

text 필드는 지시로서 routine에 도착하지 않습니다. 신뢰할 수 없는 데이터라고 표시하는 블록에 감싸여 도착하므로, 저장된 프롬프트 쪽에서 이를 쓰라고 명시해야 합니다("routine-fire-payload 블록에 적힌 알림을 조사해 줘"). 그렇지 않으면 이 텍스트는 아무 작용도 하지 않는 컨텍스트로 남습니다. 올바른 기본값입니다. 토큰을 가진 사람이면 누구나 텍스트를 보낼 수 있으니까요.

GitHub. 풀 리퀘스트 이벤트와 릴리스 이벤트이며, 작성자, 제목, 본문, 베이스 브랜치, 헤드 브랜치, 라벨, 초안 상태와 병합 상태로 걸러 낼 수 있습니다. 저장소에 Claude GitHub App이 설치되어 있어야 합니다. 이벤트마다 별도의 세션이 시작되며, 시간당 상한을 넘은 이벤트는 버려집니다.

CLI에서: /schedule

/schedule은 대화를 통해 예약된 routine을 만들고, /routines는 그 별칭입니다.

/schedule daily PR review at 9am
/schedule in 2 weeks, open a cleanup PR that removes the feature flag
/schedule list
/schedule update
/schedule run

원하는 cron 표현식을 넣는 곳은 /schedule update입니다. CLI에서 GitHub 트리거를 추가하려면 Claude Code v2.1.225 이상이 필요하며, API 트리거는 웹에서만 만들 수 있습니다.

/schedule이 "Unknown command"라고 답한다면 흔한 원인은 인증입니다. 이 명령은 claude.ai 구독 로그인을 요구합니다. 셸의 ANTHROPIC_API_KEY, settings.json의 apiKeyHelper, 또는 Bedrock이나 Vertex 로그인이 있으면 이 명령이 숨겨집니다.

믿고 맡기기 전에 알아 둘 제약

Routines는 다른 대화형 세션과 똑같이 구독 사용량을 소모합니다. 여기에 더해, 실행을 시작하는 방식마다 시간당 상한이 있으며 초과 사용은 없습니다.

문서에는 실제로 발목을 잡는 점이 세 가지 더 있습니다. GitHub 연결이 없거나 만료되면 routine은 최대 72시간 동안 실행을 건너뛰고, 그 뒤 스스로 꺼집니다. 구독을 일시 중지하면 Routines도 보류됩니다. 그리고 초록색 실행은 작업이 성공했다는 뜻이 아닙니다. 세션이 인프라 오류 없이 시작되고 종료되었다는 뜻입니다.

로컬 선택지 두 가지

데스크톱 앱의 예약 작업은 같은 New routine 버튼의 Local 선택지입니다. 여러분의 컴퓨터에서, 파일을 지금 있는 그대로 가지고 돌아가며, worktree 옵션을 체크하지 않는 한 커밋되지 않은 변경도 포함됩니다. 작업마다 자체 권한 모드가 있습니다. 함정은 문서의 한 문장에 있습니다. 작업은 데스크톱 앱이 실행 중이고 컴퓨터가 깨어 있을 때만 돌아갑니다. 잠자기 중에 걸린 실행은 건너뛰고, 깨어나면 앱은 지난 7일 중 가장 최근에 놓친 시각에 대해 정확히 한 번의 따라잡기 실행을 시작합니다. 프롬프트는 ~/.claude/scheduled-tasks/<task-name>/SKILL.md에 있습니다.

**/loop**는 열려 있는 CLI 세션 하나 안에서 프롬프트를 반복합니다: /loop 5m check the deploy. 세션의 권한과 MCP 서버를 물려받고, 작업을 최대 50개까지 담으며, 반복 작업은 7일 뒤 만료됩니다. 터미널을 닫으면 멈춥니다. 오후 한나절 동안 빌드나 풀 리퀘스트를 지켜보는 용도이지, 야간 작업용이 아닙니다.

문서가 정리한 대로 나란히 놓으면 다음과 같습니다.

어떻게 고를까

세 가지 질문이면 정해집니다.

작업이 저장소 안과 커넥터 너머에서 전부 해결되나요? 이슈에 라벨 달기, 새 풀 리퀘스트마다 리뷰하기, 병합된 변경과 문서를 대조하기: 이런 일에는 routine이 맞는 도구입니다. 깨워 둘 것이 없고, 결과는 브랜치로 도착합니다.

작업에 여러분의 컴퓨터에만 있는 무언가가 필요한가요? VPN 뒤의 데이터베이스, 로그인해 둔 브라우저, 커밋되지 않은 파일, 로컬 MCP 서버: 그렇다면 로컬에 머무르세요. routine은 그중 아무것도 없는 클론에서 시작합니다.

1시간보다 자주 돌아야 하거나, 1분 안에 반응해야 하나요? 이 경우도 로컬입니다. 외부 시스템이 호출할 수 있다면 API 트리거도 방법입니다.

저희의 야간 에이전트 일곱 개가 Routines가 아닌 이유

저희는 매일 저녁 20:00에 Mac mini에서 예약된 에이전트 일곱 개를 돌립니다. 그날의 커밋을 읽고, 버그를 고치고, 이 웹사이트를 바로잡고, 소셜 네트워크에 게시하고, 보고서를 이메일로 보냅니다. 전체 구성과 프롬프트는 별도의 글에 있습니다. Routines가 나왔을 때 저희는 당연한 질문을 던졌습니다. 왜 컴퓨터를 켜 둬야 하지?

이유는 네 가지이며, 모두 위의 문서와 대조해 확인했습니다.

1. 공유된, 커밋되지 않은 트리에서 작업합니다. 에이전트들은 풀을 받고, 그날 밤 서로의 보고서를 읽고, 일하는 중간중간 커밋합니다. 여러 에이전트가 같은 시간대에 같은 체크아웃을 건드립니다. 실행마다 새 클론을 쓰면 같은 팀의 두 단계 사이에서 넘겨주는 연결이 끊어집니다.
2. 그중 하나는 실제 브라우저에서 게시합니다. 소셜 담당 에이전트는 세 개의 네트워크에 로그인된 Chrome 세션에서 게시합니다. 그 세션은 이 컴퓨터에 있습니다. 클라우드 VM에는 그런 브라우저가 없습니다.
3. 로컬 MCP 도구를 씁니다. 백로그, 프로젝트 메모리, 프롬프트 라이브러리, 개발용 명령은 그 컴퓨터에서 돌아가는 앱의 MCP 서버입니다. claude.ai 커넥터가 아닙니다.
4. 전부 Claude Code는 아닙니다. routine은 claude.ai 구독으로 Claude Code를 실행합니다. 저희 스케줄러는 작업이 지정하는 CLI라면 무엇이든 실행합니다.

그래서 저희는 AgentsRoom의 예약 작업을 씁니다. 트리거는 프롬프트, 에이전트 또는 팀, 그리고 빈도로 이루어지며, 저희가 고른 컴퓨터에서 실행됩니다. 서버가 아니라 앱 안의 스케줄러입니다. 그 컴퓨터에서 AgentsRoom이 열려 있는 동안 발동하고, 놓친 실행은 다음 실행 때 따라잡으며, 다음 실행을 위해 운영체제의 깨우기 타이머를 설정할 수 있습니다. Claude 데스크톱 앱의 예약 작업과 같은 제약이지만, 에이전트가 Codex, Antigravity 또는 다른 어떤 CLI라도 될 수 있고, 트리거가 웹훅이나 티켓 배포 시점에 발동할 수도 있다는 점이 다릅니다.

그렇다고 Routines가 잘못된 선택이 되는 것은 아닙니다. 저희의 야간 작업이 "모든 풀 리퀘스트를 저희 체크리스트로 리뷰하기"였다면, GitHub 트리거를 단 routine으로 돌리고 Mac mini는 꺼 두었을 겁니다. 그리고 필요한 것이 반복 작업이 아니라 한 가지 일을 위한 일회용 머신이라면, 그것은 또 다른 도구이며 "Claude remote agents"가 뜻하는 것에서 설명합니다.

자주 묻는 질문

Claude Code의 Routines는 예약 작업과 같은 것인가요?

꼭 그렇지는 않습니다. routine은 클라우드에서, 저장소를 새로 클론한 완전한 Claude Code cloud session으로 돌아가며, 예약 시각에, API 호출로, 또는 GitHub 이벤트로 시작될 수 있습니다. 데스크톱 앱의 예약 작업은 여러분의 컴퓨터에서 로컬 파일을 가지고 돌아가며, Claude 데스크톱 앱이 열려 있고 컴퓨터가 깨어 있는 동안에만 실행됩니다. /loop는 열려 있는 CLI 세션 하나 안에서 프롬프트를 반복합니다. 데스크톱 앱의 Routines 페이지는 앞의 두 가지를 만듭니다: New routine을 누른 뒤 Cloud 또는 Local을 고릅니다.

Claude Code routine은 얼마나 자주 실행할 수 있나요?

예약 트리거의 최소 간격은 1시간이며, 그보다 자주 발동하는 cron 표현식은 거부됩니다. 미리 정해진 선택지는 매시간, 매일, 평일, 매주이고, /schedule update로 원하는 cron 표현식을 설정할 수 있습니다. 구독 사용량과는 별도로, 한 계정이 시작할 수 있는 예약 실행은 시간당 100회이고, Run now와 API 호출은 routine마다 시간당 30회로 제한됩니다. 데스크톱 앱의 예약 작업과 /loop는 1분까지 내려갑니다.

Routines를 돌리려면 컴퓨터가 켜져 있어야 하나요?

아니요. routine은 Anthropic이 관리하는 클라우드 인프라에서, 또는 조직이 그쪽으로 보내는 경우 자체 호스팅 환경에서 돌아가므로, 노트북을 닫아도 계속 작동합니다. 대가는 여러분의 컴퓨터를 보지 못한다는 점입니다. 기본 브랜치를 새로 클론한 상태에서 시작하며, claude.ai 계정의 커넥터와 해당 클라우드 환경의 네트워크 접근만 가집니다. claude mcp add로 로컬에 추가한 MCP 서버는 커넥터로 추가하거나 .mcp.json을 커밋하지 않는 한 쓸 수 없습니다.

Routines는 추가 비용이 드나요?

문서에 별도 가격은 없습니다. Routines는 Pro, Max, Team, Enterprise 요금제에서 대화형 세션과 똑같이 구독 사용량을 소모합니다. routine이 사용량 한도에 닿으면 기간이 초기화될 때까지 이후 실행은 거부되며, 사용량 크레딧이 켜져 있다면 예외적으로 종량제 초과 사용으로 계속 실행됩니다. 시간당 실행 상한에는 초과 사용이 없습니다.

routine으로 Codex, Antigravity 또는 다른 CLI를 실행할 수 있나요?

아니요. routine은 저장된 Claude Code 설정이며, /schedule은 claude.ai 구독 로그인을 요구합니다. Claude Code가 API 키나 클라우드 공급자를 통해 인증되어 있으면 이 명령은 숨겨집니다. 다른 CLI를 예약하려면 Claude Code 바깥의 스케줄러가 필요합니다. cron과 CLI의 헤드리스 모드, CI 일정, 또는 어떤 CLI의 에이전트든 실행하는 도구가 그것이며, AgentsRoom의 예약 작업이 바로 그 일을 합니다.

아무것도 하지 않았는데 routine이 초록색으로 표시되는 이유는 무엇인가요?

상태가 작업이 아니라 세션을 나타내기 때문입니다. 문서는 이렇게 분명히 말합니다. 초록색 상태는 세션이 인프라 오류 없이 시작되고 종료되었다는 뜻이지, 프롬프트에 적은 작업이 성공했다는 뜻이 아닙니다. 차단된 네트워크 요청, 빠진 커넥터 도구, 작업 수준의 실패는 트랜스크립트에만 나타납니다. 실행을 열어 보거나 CLI에 물어보세요. Claude Code v2.1.227 이상에서는 /schedule 뒤에 routine에 관한 질문을 붙이면 최근 실행 목록을 보여 주고 로그를 읽어 줍니다.