▲

Claude Code Routines 공개

 (code.claude.com)
2P by GN⁺ 4시간전 | ★ favorite | 댓글 1개
  • 일정, API 호출, GitHub 이벤트에 따라 자동 실행되는 클라우드 기반 코드 자동화 기능으로, Anthropic 인프라에서 동작
  • 루틴은 프롬프트, 저장소, 커넥터, 트리거로 구성되며, 노트북이 꺼져 있어도 실행 지속
  • 트리거는 스케줄, API, GitHub 이벤트 세 가지 유형을 지원하며, 하나의 루틴에 복수 트리거 결합 가능
  • 웹, CLI, 데스크톱 앱에서 생성 및 관리할 수 있고, GitHub·Slack·Linear 등 외부 서비스 커넥터를 통해 작업 수행
  • Pro 이상 요금제에서 제공되며, 현재 리서치 프리뷰 단계로 기능과 API 사양은 변경될 수 있음

루틴으로 작업 자동화

  • Claude Code 루틴은 일정, API 호출, GitHub 이벤트에 따라 자동 실행되는 저장된 코드 구성으로, Anthropic이 관리하는 클라우드 인프라에서 동작
  • 루틴은 프롬프트, 저장소, 커넥터 세트로 구성되며, 노트북이 꺼져 있어도 실행 지속
  • 트리거 유형은 스케줄, API, GitHub 이벤트 세 가지이며, 하나의 루틴에 여러 트리거를 결합 가능
  • 루틴은 Pro, Max, Team, Enterprise 요금제에서 사용 가능하며, 웹 또는 CLI(/schedule)로 생성 및 관리
  • 현재 리서치 프리뷰 단계로, 동작과 API 사양은 변경될 수 있음

루틴의 주요 활용 사례

  • 백로그 유지관리: 일정 트리거가 매일 밤 이슈 트래커를 점검해 라벨 추가, 담당자 지정, Slack 요약 게시
  • 알림 분류: 모니터링 도구가 오류 발생 시 API 트리거 호출, 루틴이 스택 트레이스 분석 후 수정 PR 생성
  • 맞춤 코드 리뷰: GitHub 트리거가 PR 생성 시 실행되어 보안·성능·스타일 검토 코멘트 자동 추가
  • 배포 검증: CD 파이프라인이 배포 후 API 트리거 호출, 루틴이 스모크 테스트와 로그 검사 수행
  • 문서 동기화: 주간 스케줄 트리거로 병합된 PR을 스캔해 변경된 API 관련 문서 업데이트 PR 생성
  • 라이브러리 포팅: PR 병합 시 GitHub 트리거가 다른 언어 SDK로 변경사항 포팅

루틴 생성 방법

  • 루틴은 웹, 데스크톱 앱, CLI에서 생성 가능하며, 모든 인터페이스는 동일한 클라우드 계정에 연결
  • 루틴 생성 시 설정 항목: 프롬프트, 저장소, 환경, 커넥터, 트리거
  • 루틴은 자동 실행 세션으로, 권한 승인 없이 명령 실행 및 커넥터 호출 가능
  • 루틴은 개인 계정 소유이며, 팀과 공유되지 않음. 실행 횟수는 계정의 일일 한도에 포함
  • GitHub, Slack, Linear 등 커넥터를 통해 수행된 작업은 모두 사용자의 연결된 계정으로 표시

  • 웹에서 생성

    • claude.ai/code/routines에서 New routine 클릭
    • 루틴 이름과 프롬프트 작성, 모델 선택
    • 저장소 선택: GitHub 저장소 추가, claude/ 접두 브랜치 사용
    • 환경 선택: 네트워크 접근, 환경 변수, 설치 스크립트 설정
    • 트리거 선택: 스케줄, GitHub 이벤트, API 중 선택 또는 조합
    • 커넥터 검토 후 필요 없는 항목 제거
    • Create 클릭 시 루틴 생성 및 즉시 실행 가능

  • CLI에서 생성

    • /schedule 명령으로 대화형 생성 가능 (/schedule daily PR review at 9am)
    • CLI에서는 스케줄 트리거만 생성 가능, API·GitHub 트리거는 웹에서 추가
    • /schedule list, /schedule update, /schedule run으로 관리 가능

  • 데스크톱 앱에서 생성

    • Schedule 페이지에서 New remote task 선택
    • 로컬 스케줄 작업과 루틴을 함께 표시

트리거 구성

  • 루틴은 스케줄, API, GitHub 트리거 중 하나 이상을 가질 수 있음
  • 트리거는 언제든 추가·삭제 가능

  • 스케줄 트리거

    • 시간대에 맞춰 시간별, 일별, 주중, 주간 실행
    • 최소 실행 간격은 1시간
    • CLI에서 /schedule update로 cron 표현식 설정 가능

  • API 트리거

    • 루틴별 HTTP 엔드포인트 제공, Bearer 토큰으로 인증
    • POST 요청 시 새 세션 생성 및 URL 반환
    • 요청 본문 text 필드로 실행 맥락 전달 가능
    • 토큰은 한 번만 표시되며, 재발급 또는 폐기 가능
    • /fire 엔드포인트는 experimental-cc-routine-2026-04-01 베타 헤더 필요

  • GitHub 트리거

    • 연결된 저장소의 이벤트 발생 시 자동 실행
    • Claude GitHub App 설치 필요
    • 웹 UI에서만 설정 가능
    • 이벤트 초과 시 시간당 제한 적용

    • 지원 이벤트

      • Pull request, Push, Release, Issues, Discussion 등 20여 가지 GitHub 이벤트 지원
      • 각 이벤트는 세부 액션(opened, closed, edited 등)에 반응 가능

    • PR 필터링

      • 작성자, 제목, 본문, 브랜치, 라벨, 병합 여부, 포크 여부 등으로 필터링
      • 예: is draft=false → 리뷰 준비된 PR만 실행, labels include needs-backport → 특정 라벨 시만 트리거

    • 세션 매핑

      • 각 이벤트는 독립 세션으로 실행, 이벤트 간 세션 재사용 불가

루틴 관리

  • 루틴 목록에서 클릭 시 상세 페이지 표시
  • 저장소, 커넥터, 프롬프트, 트리거, 실행 이력 확인 가능

  • 실행 보기 및 상호작용

    • 각 실행은 세션 형태로 열리며, 변경사항 검토·PR 생성·대화 지속 가능
    • 세션 메뉴에서 이름 변경, 보관, 삭제 가능

  • 편집 및 제어

    • Run now로 즉시 실행
    • Repeats 토글로 일시 중지/재개
    • Edit routine에서 이름, 프롬프트, 저장소, 환경, 트리거 수정
    • 삭제 시 과거 세션은 유지

저장소 및 브랜치 권한

  • 루틴은 GitHub 인증 필요, /web-setup으로 연결 설정
  • 기본적으로 claude/ 접두 브랜치에만 푸시 가능
  • Allow unrestricted branch pushes 옵션으로 제한 해제 가능

커넥터

  • 루틴은 MCP 커넥터를 통해 Slack, Linear, Google Drive 등 외부 서비스 접근
  • 기본적으로 모든 연결된 커넥터 포함, 필요 없는 항목 제거 권장
  • Settings > Connectors 또는 /schedule update로 관리 가능

환경 설정

  • 각 루틴은 클라우드 환경에서 실행
  • 환경은 네트워크 접근, 환경 변수, 설치 스크립트 제어
  • API 접근, 의존성 설치, 네트워크 제한 등을 사전 구성 가능

사용량 및 제한

  • 루틴 실행은 일반 세션과 동일하게 구독 사용량 차감
  • 계정당 일일 실행 한도 존재
  • 초과 사용량 허용 시 과금형 초과 실행 가능
  • 사용량은 claude.ai/settings/usage에서 확인

관련 자료

함께 보면 좋은 글 β

▲
GN⁺ 4시간전  [-]
Hacker News 의견들

  • LLM과 그 제공사는 여전히 거대한 블랙박스임
    나는 그들로부터 많은 가치를 얻고 있지만, Anthropic이 내놓는 새로운 기능들은 신뢰가 가지 않음
    기능이 너프되거나 사라질 가능성, 회사의 장기적 존속성 모두 믿기 어려움
    그래서 플랫폼 위에 비즈니스나 개발 흐름을 얹을 생각은 없음
    Claude Code 정도까지만 쓰고, 문제가 생기면 OpenCode나 Codex로 옮길 수 있게 최소한의 락인만 유지하고 싶음

    • 나도 같은 생각임. 최근 몇 주간 Claude Code 의존도가 높아지는 걸 보고 사용을 줄이기 시작했음
      특히 "Memory" 기능이 결정적이었음. 로컬 경로에만 학습 데이터를 저장해서 git에는 남지 않음
      게다가 새 약관에서 다른 CLI 사용을 금지한다고 해서, 회사에서 실험하던 자동 디버그 에이전트가 막혀버림
      결국 “so long Claude”임
    • 나 역시 모델 독립적으로 유지하려 했지만, Anthropic의 락인 전략이 점점 노골적이라 피하기 어려움
      MCP나 Skills처럼 이식 가능한 기능만 쓰고 있음
      실리콘밸리식 모트 전략이 반복되는 걸 보고 다시는 당하고 싶지 않음
    • 오히려 그들은 기능을 너프할 기회만 생기면 바로 그렇게 함
    • 나는 락인 걱정이 과거의 유산이라고 봄. 요즘은 에이전트 마이그레이션이 쉬워서, 벤더 간 이동이 몇 시간 내 가능함
      주요 LLM 제공사들이 기능을 서로 복제하니, 결국 공통 표준 위에서 움직이는 셈임
      문제가 생기면 lift-and-shift로 금방 옮길 수 있을 것이라 생각함
    • 이 논의가 예전 멀티 클라우드 전략을 떠올리게 함
      당시에도 락인 우려가 컸지만, 실제로는 AWS 같은 곳에서 예측만큼 심각하지 않았음
      LLM도 비슷하게 흘러갈 것 같고, 나는 굳이 신경 쓰지 않음

  • ToS가 헷갈림. claude -p를 cron에서 돌리는 건 괜찮지만, Telegram 봇에 넣으면 위반이라는 건가?
    Routines 기능은 구독에서도 작동하고 API 콜백도 있는데, 그럼 봇이 API를 호출하면 계정이 정지되는 건지 모르겠음

    • Anthropic이 이걸 명확히 안 해서 혼란이 큼. 문서마다 말이 달라서 답답함
    • 이건 의도된 모호함 같음. Microsoft의 볼륨 라이선스처럼, 사용자가 구독을 과도하게 쓰지 않게 겁주는 전략임
    • 최근 한 달간의 혼란은 이랬음
      • SDK에서 OAuth 인증 허용
      • 문서에서 “OAuth 쓰지 말라”로 수정
      • 직원이 트윗으로 “개인용은 괜찮다” 발언
      • 이후 전체 메일로 “절대 쓰지 말라” 통보
        관련 링크: SDK 문서, Reddit 업데이트, HN 공지
    • claude -p를 다른 도구와 함께 못 쓴다는 게 이해 안 됨
      IDE에 ClaudeCode를 통합하려는데, 어디까지가 “3rd party harness”인지 전혀 모르겠음

  • 최근 Claude 성능 저하가 심해서 어쩔 수 없이 다른 모델로 옮겼음
    기본적인 Python 스크립트조차 문법 오류로 재실행되는 수준임
    예전엔 컴퓨터가 항상 명령대로 움직였는데, 이제는 그렇지 않음

    • marginlab.ai의 Claude Code 성능 추적기 참고
    • Codex 5.4 xhigh를 쓰고 있음. 커뮤니케이션은 서툴지만 일은 함
    • 나도 “모델이 멍청해졌다”는 말을 안 믿었는데, 이번 주는 인정할 수밖에 없음. Opus가 Sonnet보다 더 힘들어함

  • Anthropic은 매주 거의 같은 기능을 새 이름으로 내놓는 듯함

    • 경영진이 지난주 프로젝트를 전부 취소하고 이번엔 Routines를 밀고 있음
      DevOps는 Routines Hub를 중앙화한다고 발표함. 못 따라오면 교체된다고 함
    • “7일이면 컨텍스트 윈도우에서 벗어나니까…”라는 농담이 나올 정도임
    • 이게 여러 세션에 걸친 vibecoding의 정의일지도 모름
    • 다음 주엔 또 뭔가 조용히 깨진 기능들이 GitHub 이슈로 올라올 듯함
      오늘 Sonnet 4.6이 완전 엉뚱한 답을 내서 실망했음. Opus 4.6을 다시 시도해볼 예정
    • 이미 내가 만든 기능과 이름이 겹치는 경우도 많음. “dispatch”를 상표 등록했어야 했음

  • 최근 Claude Code 사용 제한 축소가 있었다는 소문이 있음
    (관련 링크)
    이런 제약 속에서 자율형 도구들이 제대로 작동할 수 있을지 의문임

    • 친구들과 이야기해보니, 문제의 근원은 1M 토큰 컨텍스트 윈도우 도입임
      처음엔 놀라운 결과를 냈지만, 이후 부하가 커져서 계속 조정 중임
      “High” 모드가 사실상 예전 “Medium”이 되었고, 숨겨진 설정으로만 진짜 고성능을 쓸 수 있음
      사용자가 직접 컨텍스트 윈도우 크기를 조절할 수 있게 해야 한다고 생각함
      관련 링크: HN 토론, 버전 다운그레이드 해결법
    • 지금의 AI 경쟁은 부채 게임 같음. 결국 누군가는 대가를 치르게 될 것임
    • 이제 댓글이 복구되어 보임
    • 실제로 제한이 맞음: ghacks.net 기사

  • 만약 계산 자원이 부족하다면, 자동화 기능을 더 내놓는 게 이상함

    • 아마 부하 예측을 위해 스케줄링을 유도하는 것 같음. 야간 실행으로 분산시키려는 의도일 수도 있음
    • 하지만 본질은 락인 강화임. 되돌리기 어려운 통합을 유도하려는 전략임
    • Max 계정은 하루 15회 실행이 포함되고, 초과분은 추가 과금됨
    • 단순 사용량보다는 전략적 사용 패턴을 유도하려는 듯함. 코드 작성 로그가 훨씬 가치 있음
    • 결국 사용자들을 자사 에코시스템에 묶어두려는 방식임

  • 지금이 바로 AI 클라우드 시대의 시작이라 생각함
    모델 위에 고급 서비스를 얹고, 락인을 통해 수익을 확보하려는 흐름임

  • 나는 예전에 claude-code-action GitHub Action으로 PR 리뷰를 자동화했음
    하지만 포크된 저장소에서는 작동하지 않아 직접 수정해야 했음
    Routines 기능이 이 문제를 해결해줄 것 같음
    다만 하루 15회 자동 실행 제한은 너무 적음. OpenWrt 프로젝트에서 하루 20개 PR이 생기는데 모두 돌리기 어려움
    수정 후 재검사 기능도 필요함
    일일 실행 횟수 확대나 7일 이월 기능이 있으면 좋겠음
    루틴 편집 중 창이 닫히는 버그도 두 번 발생했음

  • Claude Code를 자동 조종 모드로 돌릴 수 있음.
    스케줄, API 트리거, GitHub 이벤트에 반응하도록 루틴을 정의하는 개념임
    이걸 뭐라고 부를까? “소프트웨어 엔지니어링”? “프로그래밍”?

    • 단순히 에이전트 설정일 뿐, 프로그래밍이라 부를 수준은 아님
    • “openclawing”이 더 어울림
    • “promptramming”이라는 말이 나왔음
    • “vibe coding”도 괜찮은 후보임
    • 그냥 “gramming”이라고 부르자는 의견도 있음

  • 예전 이름은 “Scheduled”였던 기능을 꽤 오래 써왔음
    버그가 있었지만 지금은 안정적임
    내가 활용한 사례는 다음과 같음

    1. Slack 피드백 채널을 모니터링해 이슈를 자동 생성하고, 간단한 건 직접 수정 후 PR 링크로 답변
    2. 코드 외 업무용으로, GitHub·Slack·이메일 활동을 요약해주는 일일 리포트 생성
      CoWork로도 시도했지만 Claude Code의 GitHub 커넥터가 훨씬 정확했음
      작동만 잘 되면 꽤 유용한 자동화 도구임
답변달기
긱뉴스에 GeekBadge 기능이 추가되었습니다. 긱배지로 자신을 표현해 보세요.