메뉴
HN
Hacker News 46일 전

클로드 코드 루틴(Routines) 출시

IMP
8/10
핵심 요약

앤스로픽(Anthropic)이 클로드 코드(Claude Code)에 작업을 자동화하는 '루틴(Routines)' 기능을 추가했습니다. 루틴은 프롬프트, 리포지토리, 커넥터를 하나로 묶어 클라우드 환경에서 주기적 또는 이벤트 발생 시 자동으로 실행되도록 구성할 수 있습니다. 이를 통해 개발자는 노트북을 닫아도 백로그 관리, 경고 분류, 코드 리뷰, 배포 검증 등 반복적이고 무인으로 처리 가능한 업무를 손쉽게 자동화할 수 있습니다.

번역된 본문

메인 콘텐츠로 건너뛰기 클로드 코드(Claude Code) 문서 홈페이지 영어 검색... ⌘ K AI 검색... 탐색 클로드 코드 웹 버전 루틴(Routines)으로 작업 자동화하기

시작하기, Claude Code로 빌드, 배포, 관리, 설정, 참고 문서, Agent SDK, 새로운 소식, 리소스

시작하기 개요, 빠른 시작, 변경 로그 핵심 개념 Claude Code 작동 방식, Claude Code 확장, .claude 디렉터리 탐색, 컨텍스트 윈도우 탐색, Claude Code 사용법, 지침 및 메모리 저장, 권한 모드 일반적인 워크플로우 모범 사례

플랫폼 및 통합 개요, 원격 제어, 웹 버전 Claude Code, 시작하기, 참고 문서, 클라우드에서 계획하기 데스크톱 앱, Chrome 확장 프로그램(베타), 컴퓨터 사용(프리뷰), Visual Studio Code, JetBrains IDEs 코드 리뷰 및 CI/CD, Slack에서 Claude Code 사용

현재 페이지 예제 사용 사례 루틴 만들기 웹에서 만들기, CLI에서 만들기, 데스크톱 앱에서 만들기 트리거 구성하기 예약 트리거 추가, API 트리거 추가, 루틴 API 참고 문서 GitHub 트리거 추가 (지원 이벤트, 풀 리퀘스트 필터링, 세션이 이벤트에 매핑되는 방식) 루틴 관리 (실행 확인 및 상호작용, 루틴 편집 및 제어, 리포지토리 및 브랜치 권한) 커넥터, 환경, 사용량 및 한도 관련 리소스


루틴(Routines)은 현재 연구 프리뷰(Research Preview) 단계입니다. 동작 방식, 한도 및 API 구성이 변경될 수 있습니다.

루틴은 저장된 Claude Code 구성을 의미합니다. 즉, 하나의 프롬프트, 하나 이상의 리포지토리, 그리고 일련의 커넥터(Connectors)를 하나로 묶어 패키지화한 뒤 자동으로 실행하는 것을 말합니다. 루틴은 Anthropic이 관리하는 클라우드 인프라에서 실행되므로, 노트북을 닫아도 작업이 계속해서 진행됩니다.

각 루틴에는 하나 이상의 트리거를 연결할 수 있습니다.

  • 예약(Scheduled): 매시간, 매일 밤, 또는 매주와 같이 정기적인 주기로 실행됩니다.
  • API: Bearer 토큰과 함께 개별 루틴 전용 엔드포인트로 HTTP POST 요청을 보내 필요할 때마다 실행(On-demand)할 수 있습니다.
  • GitHub: 풀 리퀘스트(Pull Request), 푸시(Push), 이슈(Issue) 또는 워크플로우 실행과 같은 리포지토리 이벤트에 응답하여 자동으로 실행됩니다.

단일 루틴에 여러 트리거를 조합할 수 있습니다. 예를 들어, PR 리뷰 루틴은 매일 밤 실행되도록 예약할 수도 있고, 배포 스크립트에서 트리거할 수도 있으며, 새로운 PR이 생성될 때마다 반응하도록 설정할 수도 있습니다.

루틴은 웹 버전의 Claude Code가 활성화된 Pro, Max, Team, Enterprise 요금제에서 사용할 수 있습니다. claude.ai/code/routines에서 루틴을 생성하고 관리하거나, CLI에서 /schedule 명령어를 통해 관리할 수 있습니다. 이 문서에서는 루틴 생성 방법, 각 트리거 유형 구성, 실행 관리 방법 및 사용량 한도가 적용되는 방식을 다룹니다.


예제 사용 사례 (Example use cases)

각 예제는 트리거 유형과 루틴에 적합한 작업(무인 작동, 반복 가능, 명확한 결과물 수반)을 짝지어 보여줍니다.

  • 백로그 유지보수 (Backlog maintenance): 예약 트리거가 커넥터를 통해 이슈 트래커에 매주 평일 밤 실행됩니다. 루틴은 마지막 실행 이후 등록된 이슈를 읽고 라벨을 적용하며, 참조된 코드 영역을 기반으로 담당자를 할당하고, 팀이 하루를 시작할 때 정리된 대기열을 확인할 수 있도록 Slack에 요약을 게시합니다.
  • 알림 분류 (Alert triage): 모니터링 도구가 오류 임계값을 초과할 때 루틴의 API 엔드포인트를 호출하고, 알림 본문을 텍스트로 전달합니다. 루틴은 스택 트레이스를 추출해 리포지토리의 최근 커밋과 상관관계를 분석한 뒤, 수정 제안이 포함된 초안 풀 리퀘스트(PR)를 열고 알림에 대한 링크를 남깁니다. 당직(On-call) 엔지니어는 빈 터미널에서부터 시작할 필요 없이 해당 PR을 검토하면 됩니다.
  • 맞춤형 코드 리뷰 (Bespoke code review): GitHub 트리거가 pull_request.opened 이벤트에서 실행됩니다. 루틴은 팀만의 리뷰 체크리스트를 적용하고, 보안, 성능 및 스타일 문제에 대한 인라인 코멘트를 남기며 요약 코멘트를 추가하여, 사람 리뷰어가 기계적인 확인 작업 대신 설계 자체에 집중할 수 있도록 돕습니다.
  • 배포 검증 (Deploy verification): CD 파이프라인이 프로덕션 배포 후 루틴의 API 엔드포인트를 호출합니다. 루틴은 새 빌드에 대해 스모크 테스트(Smoke check)를 실행하고 오류 로그를 스캔해 회귀(Regression) 여부를 확인한 뒤, 배포 기간이 끝나기 전에 릴리즈 채널에 Go 또는 No-Go 여부를 게시합니다.
  • 문서 드리프트 (Docs drift): 예약 트리거가 매주 실행됩니다. 루틴은 마지막 실행 이후 병합된 PR을 스캔하고, 변경된 API를 참조하는 문서를 표시한 다음, 에디터가 검토할 수 있도록 문서 리포지토리에 업데이트 PR을 엽니다.
  • 라이브러리 포팅 (Library port):
원문 보기
원문 보기 (영어)
Skip to main content Claude Code Docs home page English Search... ⌘ K Ask AI Search... Navigation Claude Code on the web Automate work with routines Getting started Build with Claude Code Deployment Administration Configuration Reference Agent SDK What's New Resources Getting started Overview Quickstart Changelog Core concepts How Claude Code works Extend Claude Code Explore the .claude directory Explore the context window Use Claude Code Store instructions and memories Permission modes Common workflows Best practices Platforms and integrations Overview Remote Control Claude Code on the web Get started Reference Routines Plan in the cloud Claude Code on desktop Chrome extension (beta) Computer use (preview) Visual Studio Code JetBrains IDEs Code review & CI/CD Claude Code in Slack On this page Example use cases Create a routine Create from the web Create from the CLI Create from the Desktop app Configure triggers Add a schedule trigger Add an API trigger Trigger a routine API reference Add a GitHub trigger Supported events Filter pull requests How sessions map to events Manage routines View and interact with runs Edit and control routines Repositories and branch permissions Connectors Environments Usage and limits Related resources Routines are in research preview. Behavior, limits, and the API surface may change. A routine is a saved Claude Code configuration: a prompt, one or more repositories, and a set of connectors , packaged once and run automatically. Routines execute on Anthropic-managed cloud infrastructure, so they keep working when your laptop is closed. Each routine can have one or more triggers attached to it: Scheduled : run on a recurring cadence like hourly, nightly, or weekly API : trigger on demand by sending an HTTP POST to a per-routine endpoint with a bearer token GitHub : run automatically in response to repository events such as pull requests, pushes, issues, or workflow runs A single routine can combine triggers. For example, a PR review routine can run nightly, trigger from a deploy script, and also react to every new PR. Routines are available on Pro, Max, Team, and Enterprise plans with Claude Code on the web enabled. Create and manage them at claude.ai/code/routines , or from the CLI with /schedule . This page covers creating a routine, configuring each trigger type, managing runs, and how usage limits apply. ​ Example use cases Each example pairs a trigger type with the kind of work routines are suited to: unattended, repeatable, and tied to a clear outcome. Backlog maintenance. A schedule trigger runs every weeknight against your issue tracker via a connector. The routine reads issues opened since the last run, applies labels, assigns owners based on the area of code referenced, and posts a summary to Slack so the team starts the day with a groomed queue. Alert triage. Your monitoring tool calls the routine’s API endpoint when an error threshold is crossed, passing the alert body as text . The routine pulls the stack trace, correlates it with recent commits in the repository, and opens a draft pull request with a proposed fix and a link back to the alert. On-call reviews the PR instead of starting from a blank terminal. Bespoke code review. A GitHub trigger runs on pull_request.opened . The routine applies your team’s own review checklist, leaves inline comments for security, performance, and style issues, and adds a summary comment so human reviewers can focus on design instead of mechanical checks. Deploy verification. Your CD pipeline calls the routine’s API endpoint after each production deploy. The routine runs smoke checks against the new build, scans error logs for regressions, and posts a go or no-go to the release channel before the deploy window closes. Docs drift. A schedule trigger runs weekly. The routine scans merged PRs since the last run, flags documentation that references changed APIs, and opens update PRs against the docs repository for an editor to review. Library port. A GitHub trigger runs on pull_request.closed filtered to merged PRs in one SDK repository. The routine ports the change to a parallel SDK in another language and opens a matching PR, keeping the two libraries in step without a human re-implementing each change. The sections below walk through creating a routine and configuring each of these trigger types. ​ Create a routine Create a routine from the web, the Desktop app, or the CLI. All three surfaces write to the same cloud account, so a routine you create in the CLI shows up at claude.ai/code/routines immediately. In the Desktop app, click New task and choose New remote task ; choosing New local task instead creates a local Desktop scheduled task , which runs on your machine and is not a routine. The creation form sets up the routine’s prompt, repositories, environment, connectors, and triggers. Routines run autonomously as full Claude Code cloud sessions: there is no permission-mode picker and no approval prompts during a run. The session can run shell commands, use skills committed to the cloned repository, and call any connectors you include. What a routine can reach is determined by the repositories you select and their branch-push setting, the environment’s network access and variables, and the connectors you include. Scope each of those to what the routine actually needs. Routines belong to your individual claude.ai account. They are not shared with teammates, and they count against your account’s daily run allowance. Anything a routine does through your connected GitHub identity or connectors appears as you: commits and pull requests carry your GitHub user, and Slack messages, Linear tickets, or other connector actions use your linked accounts for those services. ​ Create from the web 1 Open the creation form Visit claude.ai/code/routines and click New routine . 2 Name the routine and write the prompt Give the routine a descriptive name and write the prompt Claude runs each time. The prompt is the most important part: the routine runs autonomously, so the prompt must be self-contained and explicit about what to do and what success looks like. The prompt input includes a model selector. Claude uses the selected model on every run. 3 Select repositories Add one or more GitHub repositories for Claude to work in. Each repository is cloned at the start of a run, starting from the default branch. Claude creates claude/ -prefixed branches for its changes. To allow pushes to any branch, enable Allow unrestricted branch pushes for that repository. 4 Select an environment Pick a cloud environment for the routine. Environments control what the cloud session has access to: Network access : set the level of internet access available during each run Environment variables : provide API keys, tokens, or other secrets Claude can use Setup script : run install commands before each session starts, like installing dependencies or configuring tools A Default environment is provided. To use a custom environment, create one before creating the routine. 5 Select a trigger Under Select a trigger , choose how the routine starts. You can pick one trigger type or combine several. Schedule GitHub event API Pick a preset frequency: hourly, daily, weekdays, or weekly. See Add a schedule trigger for timezone handling, stagger, and custom cron intervals. Select the repository, the event to react to, and optional filters. See Add a GitHub trigger for the full list of supported events and filter fields. Select API here, then save the routine. The URL and token are generated after the routine is saved, since they depend on the routine ID. See Add an API trigger to copy the URL and generate a token. 6 Review connectors All of your connected MCP connectors are included by default. Remove any that the routine doesn’t need. Connectors give Claude access to external services like Slack, Linear, or Google Drive during each run. 7 Create the routine Click Create . The routine appears in the list and runs the nex