본문 바로가기

인공지능

Claude Code 웹 예약 실행 기능으로 반복 개발 업무 자동화하기

728x90
반응형
728x170

이번 글에서는 Claude Code의 웹 기반 예약 실행 기능을 중심으로, 반복적인 개발 업무를 어떻게 자동화할 수 있는지 정리합니다. 클라우드 환경에서 작업을 예약해 실행하는 방식부터, 예약 옵션의 차이, 실제 생성 절차, 커넥터 연동과 관리 방법까지 단계별로 살펴봅니다. 특히 컴퓨터가 꺼져 있어도 동작하는 자동화 워크플로우를 어떻게 구축할 수 있는지에 초점을 맞춥니다.

반응형

Claude Code 웹 예약 실행 기능이란

Claude Code의 웹 예약 실행 기능은 반복되는 개발·운영 작업을 일정에 맞춰 자동으로 실행할 수 있도록 제공되는 기능입니다.
클라우드 기반으로 동작하기 때문에 사용자의 로컬 컴퓨터 상태와 무관하게 작업이 실행되며, 백그라운드에서 안정적으로 유지됩니다.

이 기능은 Anthropic이 관리하는 인프라에서 실행되며, **Claude Code on the web의 모든 사용자(Pro, Max, Team, Enterprise)**가 사용할 수 있습니다.

대표적인 활용 예시는 다음과 같습니다.

  • 매일 아침 Pull Request 자동 검토
  • 야간 CI 실패 로그 분석
  • 문서 동기화 및 업데이트
  • 주간 의존성 감사 작업

이처럼 사람이 직접 챙기지 않아도 되는 반복 업무를 자동화하는 데 목적이 있습니다.


예약 실행 방식 비교: Cloud, Desktop, /loop

Claude Code는 세 가지 예약 실행 방식을 지원하며, 실행 위치와 설정 단위가 다릅니다.

Cloud 방식

  • Anthropic 클라우드에서 실행
  • 컴퓨터가 꺼져 있어도 동작
  • 최소 실행 간격은 1시간 단위
  • 권한 프롬프트 없이 자동 실행

Desktop 방식

  • 로컬 머신에서 실행
  • 파일 접근이 필요한 작업에 적합
  • 최소 실행 간격은 1분 단위
  • 작업별 권한 설정 가능

/loop 방식

  • CLI 세션 내에서 경량 반복 실행
  • 로컬 환경 기반
  • 빠른 주기의 간단한 반복 작업에 적합

업무 자동화를 장기적으로 안정 운영하려면 Cloud 방식이 가장 활용도가 높습니다.


웹에서 예약 작업 생성하는 방법

예약 작업은 웹, 데스크톱 앱, CLI 세 가지 경로에서 생성할 수 있습니다.

웹에서 생성

  • claude.ai/code/scheduled 접속
  • New scheduled task 클릭

데스크톱 앱

  • Schedule 페이지에서 New remote task 선택

CLI

  • /schedule 명령으로 대화형 설정
  • 또는
    /schedule daily PR review at 9am
    처럼 자연어로 직접 지정 가능

예약 작업 생성 단계 상세

예약 작업 생성 시에는 다음 단계를 거칩니다.

1. 작업 이름 및 프롬프트 작성

  • 예약 작업은 자율 실행되므로 명확하고 완결된 프롬프트가 필요합니다.
  • 사람이 개입하지 않아도 이해 가능한 지시문 형태가 중요합니다.

2. 저장소 선택

  • GitHub 저장소를 추가하면 기본 브랜치에서 클론 후 작업을 수행합니다.
  • 변경 사항은 claude/ 접두 브랜치로 푸시됩니다.

3. 환경 선택

  • 네트워크 접근 여부
  • 환경 변수
  • 의존성 설치 스크립트 포함 여부
    이 모두를 사전에 정의할 수 있습니다.

4. 주기 설정

  • 기본값은 현지 시간 기준 매일 오전 9시
  • CLI의 /schedule update 명령으로 세부 조정 가능

5. 커넥터 검토

  • Slack, Linear, Google Drive 등 MCP 커넥터 연동 여부 선택
  • 필요 없는 커넥터는 제외 가능

6. 생성 완료

  • 생성 후 Scheduled 목록에 표시
  • 다음 예약 시간에 자동 실행
  • Run now 버튼으로 즉시 실행도 가능

실행 주기 옵션과 시간대 처리

예약 실행은 시간대 자동 변환을 지원합니다.
즉, 사용자가 지정한 현지 시간 기준으로 실행됩니다.

기본 제공 주기는 다음과 같습니다.

  • Hourly: 매시간 실행
  • Daily: 하루 1회 (기본 9:00 AM)
  • Weekdays: 평일만 실행
  • Weekly: 주 1회, 요일 및 시간 지정

2시간마다 실행, 매월 1일 실행과 같은 맞춤 주기는 CLI에서 설정할 수 있습니다.


저장소와 브랜치 권한 관리

  • 매 실행 시 저장소를 새로 클론
  • 기본 브랜치에서 시작
  • 기본적으로 claude/ 접두 브랜치에만 푸시 가능

보호 브랜치 수정이 필요한 경우에는
Allow unrestricted branch pushes 옵션을 통해 제한을 해제할 수 있습니다.


MCP 커넥터로 외부 서비스 연동

예약 작업은 MCP 커넥터를 통해 외부 서비스와 상호작용할 수 있습니다.

예시:

  • Slack 채널의 지원 요청을 읽고 Linear에 이슈 자동 생성
  • Google Drive 문서 동기화

커넥터는 다음 위치에서 관리할 수 있습니다.

  • 작업 생성 폼
  • Settings > Connectors
  • CLI /schedule update

예약 작업 관리와 실행 이력 확인

Scheduled 목록에서 작업을 클릭하면 상세 관리가 가능합니다.

확인 가능한 정보

  • 저장소
  • 프롬프트
  • 주기
  • 커넥터
  • 과거 실행 내역

실행 이력(run) 관리

  • 각 실행은 전체 세션으로 열림
  • Claude의 수행 내용 및 변경 사항 확인
  • Pull Request 생성 및 대화 이어가기 가능

작업 제어

  • Run now로 즉시 실행
  • Repeats 토글로 일시 중지 또는 재개
  • 이름, 프롬프트, 주기, 환경, 커넥터 수정
  • 작업 삭제 (기존 세션은 유지)

CLI에서도 /schedule list, /schedule run, /schedule update 명령으로 동일한 관리가 가능합니다.


728x90

Claude Code의 웹 예약 실행 기능은 반복적인 개발·운영 업무를 안정적으로 자동화할 수 있는 도구입니다.
특히 클라우드 기반 실행을 통해 컴퓨터 상태에 의존하지 않고, 코드 리뷰·CI 분석·문서 관리 같은 작업을 지속적으로 수행할 수 있다는 점이 핵심 장점입니다.

이 기능을 활용하면 개발자는 단순 반복 작업에서 벗어나, 더 중요한 설계와 문제 해결에 집중할 수 있는 환경을 만들 수 있습니다. 장기적으로는 자동화된 워크플로우를 통해 개발 품질과 생산성을 동시에 높일 수 있다는 점에서 의미 있는 변화라고 볼 수 있습니다.

300x250

https://code.claude.com/docs/en/web-scheduled-tasks

 

Schedule tasks on the web - Claude Code Docs

Automate recurring work with cloud scheduled tasks

code.claude.com

728x90
반응형
그리드형