studiosoluta

먼저 볼 카드 — GitHub에 프로젝트 처음 저장하기

실습 Routines

정해진 시각에 혼자 돌리기

이 카드를 다루는 수업 좋은 프롬프트로 이미지와 영상 만들기 파리 거리에서 자전거 타기

  • Routine: 맡길 일을 한 번 저장하면 정해진 시각이나 조건에서 Claude가 혼자 실행하는 기능

  • 예: “매주 월요일 9시에 지난주 자료를 정리해 보고서 파일로 남겨 줘”

  • 실행 위치: 앤트로픽의 서버. 내 노트북이 꺼져 있어도 결과가 쌓입니다

  • 앞 단계까지는 실행 버튼을 누르는 사람이 있었지만, Routine에는 실행 중에 확인해 줄 사람이 없습니다

  • Routine의 세 조각: 실행할 프롬프트, 작업할 GitHub 저장소(파일을 올려 두고 바뀐 이력을 남기는 온라인 폴더), 실행을 시작시키는 트리거

  • 트리거 종류: 정해진 주기로 도는 일정, 다른 프로그램이 정해진 주소로 실행을 요청하는 API, 저장소에 파일이 올라오는 것 같은 변화에 반응하는 GitHub 이벤트

  • 하나의 Routine에 트리거 여러 개를 함께 걸 수 있습니다

Routine 프롬프트 GitHub 저장소 트리거 일정 API GitHub 이벤트 Anthropic 서버에서 실행 노트북이 꺼져 있어도 돕니다 claude/ 새 브랜치에 결과 사람이 보고 읽고 결정
강조 상자부터는 확인해 줄 사람이 없으므로, 되돌리기 어려운 동작은 마지막 상자의 사람에게 남깁니다.

프롬프트는 되묻지 않아도 끝까지 가야 합니다

  • 대화 세션에서는 애매한 지점에서 Claude가 되묻고 사람이 답하지만, Routine 실행에는 그 사람이 없습니다

  • 프롬프트에 적을 것: 무엇을 할지, 무엇을 성공으로 볼지, 조건이 안 맞으면 어떻게 할지

  • 이 셋이 없으면 실행이 중간에 멈추거나 엉뚱한 방향으로 갑니다

  • 되돌리기 어려운 동작은 넣지 않습니다: 파일 삭제, 배포, 메시지 발송, 결제

  • Routine에는 확인하고 정리해서 보고하는 데까지만 시키고, 실행 여부는 보고를 읽고 사람이 정합니다

조건을 먼저 확인합니다

  • 이용 조건: Pro·Max·Team·Enterprise 플랜, 웹 Claude Code 켜짐

  • 회사 계정이라면 관리자가 조직 전체에서 꺼 두었을 수 있습니다

  • GitHub 저장소가 필요합니다

  • 저장소는 실행마다 기본 브랜치(저장소의 기준이 되는 버전)에서 새로 내려받고, 변경 사항은 claude/로 시작하는 새 브랜치에 쌓여 기존 작업을 직접 덮어쓰지 않습니다

  • 기본 환경은 패키지 저장소나 일반적인 개발용 주소처럼 미리 정해진 목록에만 연결됩니다

  • 사내 서비스나 목록 밖 주소에 닿아야 하면 환경의 네트워크 설정을 먼저 손봅니다

  • 환경 변수(실행할 때 넘겨주는 설정값)는 그 환경을 쓰는 사람 모두에게 보이므로, 자격증명을 넣어도 되는 곳인지 판단한 뒤 넣습니다

  • 상태: 리서치 프리뷰(정식 출시 전 시험 공개)

  • 동작과 제한, 외부 호출 방식이 예고 없이 바뀔 수 있어 지금 확인한 화면과 다음 달 화면이 다를 수 있습니다

저장한 뒤 바로 한 번 돌려 봅니다

  • 저장 화면만 보고 예정 시각을 기다리면 프롬프트가 잘못돼 있어도 다음 실행까지 알 수 없습니다

  • 저장 직후 직접 한 번 실행해 결과 세션을 열고, 요청한 산출물이 나왔는지와 어디서 막혔는지 확인합니다

  • 여기서 고친 프롬프트가 이후 모든 실행에 그대로 적용됩니다

  • 실습: 순서를 따라 Routine 하나를 저장하고, 예정 시각을 기다리지 말고 그 자리에서 직접 실행해 결과를 확인합니다

실행 순서

  1. 조건부터 확인합니다. Routines는 Pro·Max·Team·Enterprise 플랜에서 웹 Claude Code가 켜져 있어야 쓸 수 있고, 회사 계정이면 관리자가 꺼 두었을 수 있습니다. 데스크톱 앱에서는 Code 탭 사이드바의 Routines에서 New routine을 누르고 Cloud를 고릅니다. Local을 고르면 클라우드가 아니라 내 컴퓨터에서 도는 예약 작업이 됩니다.

    Routines 관리 화면 열기

    확인Routine 목록 화면이 열립니다. 정책으로 꺼져 있으면 사용할 수 없다는 안내가 대신 나옵니다.

  2. 새 Routine을 만들고 이름과 프롬프트를 적습니다. 실행 중에 되물을 사람이 없으므로, 무엇을 하고 무엇이 성공인지까지 프롬프트 안에 다 적습니다.

    확인이름·프롬프트·모델을 고르는 입력 화면이 나옵니다.

  3. 실행할 GitHub 저장소를 지정합니다. 저장소는 실행이 시작될 때마다 기본 브랜치에서 새로 내려받고, 변경 사항은 claude/로 시작하는 새 브랜치에 쌓입니다.

    확인지정한 저장소가 목록에 붙고, 기존 브랜치를 직접 덮어쓰지 않는다는 것을 확인할 수 있습니다.

  4. 실행 환경을 고릅니다. 기본 환경은 정해진 목록의 주소에만 연결되므로, 사내 서비스처럼 목록 밖 주소가 필요하면 환경을 먼저 손봅니다.

    확인네트워크 범위·환경 변수·준비 스크립트를 정하는 항목이 보입니다.

  5. 트리거를 고릅니다. 정해진 주기로 도는 일정, 외부에서 호출하는 API, 저장소 이벤트 세 가지가 있고 함께 걸 수도 있습니다. 처음에는 주 1회 일정 하나로 시작합니다.

    확인선택한 트리거가 Routine에 붙고, 다음 실행 예정 시각이 표시됩니다.

  6. 맨 아래 Connectors 목록을 확인합니다. 연결해 둔 커넥터가 모두 기본으로 들어가고, 실행 중에는 쓰기 작업도 묻지 않고 하므로 이 Routine에 필요 없는 커넥터는 뺍니다.

    확인Routine에 필요한 커넥터만 목록에 남습니다.

  7. 저장한 뒤 한 번 직접 실행해 결과를 확인합니다. 예정된 시각까지 기다렸다가 처음 결과를 보면, 잘못된 프롬프트가 그대로 반복됩니다.

    확인실행 기록에 세션 하나가 남고, 그 안에서 요청한 산출물과 실패 지점을 볼 수 있습니다.

대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.

이 순서를 한 번에 실행
무인으로 도는 Routine에 넣을 프롬프트를 쓰려고 해. 주제는 [여기에 반복 작업]이야. 실행 중에 나한테 되물을 수 없다는 조건으로, 무엇을 할지와 무엇이 성공인지까지 담긴 자립적인 프롬프트를 만들어 줘. 사람 확인이 필요한 부분은 실행하지 말고 보고만 하도록 적어 줘.

직접 해보기

대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.

내 상황에 맞춰
내가 매주 반복하는 점검이 있어: [여기에 점검 내용]. 이걸 Routine으로 옮길 값이 있는지 먼저 판단해 줘. 설정에 드는 시간이 아끼는 시간보다 크면 옮기지 말라고 알려 주고, 옮길 만하면 주기와 성공 기준을 제안해 줘.
한 단계 더
지금 만들려는 Routine 프롬프트를 검토해 줘: [여기에 프롬프트]. 사람이 없는 상태에서 실행됐을 때 되돌리기 어려운 동작을 하게 되는 지점이 있는지 찾아서, 보고로 바꿔야 할 문장을 짚어 줘.

매주 반복하는 점검 하나를 골라 Routine으로 저장하고, 예정 시각을 기다리지 말고 그 자리에서 한 번 직접 실행해 결과를 확인해 보세요.

헷갈리기 쉬운 것

Routines는 리서치 프리뷰라 동작과 제한이 예고 없이 바뀔 수 있습니다. 실행 중에는 확인을 받을 사람이 없으므로, 삭제·배포·메시지 발송·결제처럼 되돌리기 어려운 동작은 프롬프트에 넣지 말고 보고까지만 시킵니다. 환경 변수는 그 환경을 쓰는 사람 모두에게 보이므로 자격증명을 넣을 때 이 점을 감안합니다. API 트리거 토큰은 생성 직후 한 번만 보이고 나중에 다시 볼 수 없습니다. 실행에 GitHub 저장소가 필요하므로, 저장소 없이 문서만 다루는 업무에는 맞지 않습니다.

용어 풀이

전체 용어집 →
Routine
프롬프트와 저장소, 연결 도구를 한 벌로 저장해 두고 정해진 조건에서 자동 실행되게 만든 설정입니다.
리서치 프리뷰
정식 출시 전 단계입니다. 동작과 제한이 예고 없이 바뀔 수 있습니다.
저장소
GitHub에 올려 둔 프로젝트 폴더입니다. Routine은 실행할 때마다 이 폴더를 새로 내려받아 작업합니다.

2026-09-22 기준 · 출처 · Claude Code — Automate work with routines, Claude Code on the web