Claude Routine: 직접 사용해 본 리뷰

Anthropic이 최근 Claude 관련 업데이트를 여러 가지 발표했습니다.

1. Claude Code 데스크톱 리디자인 — 하나의 창에서 여러 Claude 세션을 나란히 관리할 수 있고, 전환을 위한 새 사이드바가 추가되었습니다.
2. Routines 기능 출시 (연구 프리뷰) — Claude Code 작업을 이제 Anthropic의 자체 클라우드에서 실행할 수 있어 컴퓨터를 켜둘 필요가 없습니다.
3. 데스크톱과 웹의 사소한 변경 사항 (멀티 세션 관리, 세션 공유 등).

제가 가장 주목한 것은 두 번째, Routines입니다.

이유는 간단합니다. 저는 OpenClaw와 Claude Desktop을 모두 가지고 있지만, 가벼운 사용자에게 클라우드 기반 작업은 주로 동영상이나 텍스트 클리핑 정도로 제한적입니다. OpenClaw를 사용하는 것은 닭 잡는 데 소를 쓰는 격입니다. Claude Desktop은? 로컬에서 실행되는 “예약 작업” 기능이 있지만 컴퓨터가 켜져 있고 데스크톱 앱이 실행 중이어야 합니다. MacBook Air를 24시간 켜두고 싶지 않습니다. 어느 쪽도 답이 아니었습니다!

Routines는 이 빈틈을 완벽하게 채워줍니다.

세 가지 방식을 비교하면 다음과 같습니다.

데스크톱 예약 작업은 과도기적 솔루션이고, OpenClaw는 커뮤니티 주도 솔루션이며, Routines는 공식적인 새 클라우드 솔루션입니다. Anthropic은 서드파티 프레임워크가 자사 API를 호출하기 어렵게 만드는 동시에 Routines를 홍보하고 있습니다. 의도는 분명합니다. 자체적인 OpenClaw를 만들려는 것입니다.

Routines로 무엇을 할 수 있나요?

공식 사용 사례는 주로 개발자 시나리오입니다. 이슈 트래커를 밤마다 스캔하여 레이블 추가, 새 PR마다 자동 코드 리뷰, CD 배포 후 스모크 테스트 실행하여 오류 로그 확인, 매주 병합된 PR을 스캔하여 문서 업데이트 등입니다. 이는 비개발자에게는 다소 동떨어진 이야기입니다.

일반 사용자에게는 다음과 같은 시나리오가 더 적합합니다.

• 매일 아침 자동으로 일일 금융 브리핑 가져오기 (업종별 움직임, 상승/하락 종목 등), 이를 저장소에 커밋하여 일어나서 읽기.
• Bilibili/YouTube 동영상을 자동으로 텍스트 노트로 변환하기 (이 글에서 하는 작업) — 링크를 공유하면 몇 분 후에 저장소에 Markdown 파일이 나타납니다.
• 주간 업계 조사 보고서 또는 주간 리뷰 생성하기 — 공개 정보를 자동으로 컴파일하여.
• GitHub에서 별표 표시한 저장소 모니터링 — 오픈소스 프로젝트가 업데이트되면 Routine이 자동으로 diff를 가져와 중국어 요약을 제공합니다.

오늘 저는 두 번째인 Bilibili 동영상을 텍스트로 변환하는 것을 시도했습니다.

환경 설정

환경 설정은 약간 번거롭지만, 한 번만 하면 됩니다. 그 후에는 새 Routine을 만들 때 재사용할 수 있습니다.

다음 네 가지를 준비해야 합니다.

• GitHub 계정 — 비공개 저장소를 사용합니다 (이유는 아래 설명).
• Max 또는 Pro 구독 — 무료 계정은 아직 Routines를 사용할 수 없습니다.
• 로컬에 Claude Code CLI 설치 — 이후 대부분의 단계를 Claude가 처리하도록 할 것입니다.
• 코딩 기술 불필요 — 명령줄이 익숙하지 않다면 Claude Code에게 “Routine 설정 도와줘"라고 말하면 단계별로 안내해 줍니다.

이제 설정을 시작합니다.

할당량 및 진입점 확인

먼저 claude.ai에서 사용량 페이지를 엽니다. 구독 사용량에 routine 항목이 새로 추가된 것을 볼 수 있습니다. 저는 Max 계정이므로 하루에 15회 실행 가능합니다.

구체적인 할당량:

• Pro: 하루 5회
• Max: 하루 15회
• Team/Enterprise: 하루 25회
• 그 이상은 종량제로 추가 사용 가능합니다.

15회는 트리거 횟수이며, Routine의 총 개수가 아닙니다. 여러 Routine을 만들어 이 할당량을 공유할 수 있습니다.

진입점은 claude.ai/code/routines입니다.

웹, 데스크톱, CLI 모두 동일한 작업 풀을 공유합니다. CLI에서 만든 작업은 웹에서도 볼 수 있습니다.

GitHub 비공개 저장소 연결 필수

Routines는 반드시 GitHub 저장소에 연결되어야 합니다. 이것은 필수 요구 사항이며, 없으면 만들 수 없습니다.

왜 이렇게 설계되었을까요? 작업이 시작될 때마다 클라우드가 Claude의 작업 디렉터리를 할당하기 때문입니다. 구체적으로는, 지정된 GitHub 저장소를 복제하여 “데스크톱"으로 사용합니다. Claude는 이 데스크톱 안에서 파일을 수정하고, 명령을 실행하고, 커밋하고, 푸시합니다. 작업이 끝나면 데스크톱은 정리되고, 저장소에는 결과물만 남습니다.

따라서 먼저 GitHub 저장소를 준비해야 합니다.

GitHub는 프로그래머들 사이에서 가장 인기 있는 “코드 저장 + 버전 관리 + 협업 플랫폼"이며, 전 세계 오픈소스 코드의 대부분을 호스팅합니다. 비개발자에게는 무료이며 버전 관리가 되는 클라우드 기반 개인 폴더로 사용할 수도 있습니다.

계정 생성은 간단합니다. github.com에 가입한 후, 오른쪽 상단의 “+” → New repository를 클릭하고, 원하는 이름(예: claude-routines)을 입력합니다.

저장소를 만들 때 Private (비공개)를 체크하고 Add a README도 체크해야 합니다. 그렇지 않으면 저장소가 완전히 비어 있고 기본 브랜치가 없어 Routine이 처음 복제할 때 실패합니다. 제가 이미 그 함정에 빠졌습니다.

이 단계가 낯설다면 Claude Code에게 던져버리세요: “Routine을 위한 GitHub 저장소를 만들어 줘” — 그러면 가입, 저장소 생성, 권한 부여를 단계별로 안내합니다.

클라우드 환경 생성

다음은 이미 비공개 저장소를 만들었다고 가정합니다.

각 Routine은 Anthropic 샌드박스 머신에서 실행됩니다. 이 머신에는 Python, Node, git 같은 기본 도구가 미리 설치되어 있지만, 사용자 정의 종속성(yt-dlp, ffmpeg 등)은 없습니다. 따라서 사용자 정의 환경을 만들어 각 실행 전에 설치할 항목과 로드할 API 키를 지정해야 합니다. 여기서 오른쪽 하단의 Add environment 버튼을 클릭합니다.

환경 설정에는 Network access 필드가 있으며, None, Trusted, Full 세 가지 옵션이 있습니다. 일반적인 함정이 있습니다.

기본값은 Trusted로, 공식 화이트리스트에 있는 웹사이트(주로 GitHub, PyPI, npm 같은 패키지 저장소)에만 접근을 허용합니다. bilibili.com과 youtube.com은 화이트리스트에 없습니다. 따라서 여기서는 Full을 선택합니다.

그런 다음 Setup script 필드에는 시작할 때마다 실행할 명령어(ffmpeg, yt-dlp 설치 등)를 입력하고, Environment variables에는 필요한 API 키(GEMINI_API_KEY 등)를 입력합니다.

여기 있는 내용을 이해하지 못해도 괜찮습니다. 단지 무엇을 입력해야 하는지 보여주는 것입니다. 실제로는 AI에게 하고 싶은 일을 말하고, 복사해서 붙여넣을 수 있는 스크립트를 요청하면 됩니다. 그냥 복사해서 붙여넣으면 됩니다.

환경 변수는 Anthropic의 환경 구성 데이터베이스에 저장됩니다. 공식 문서에 따르면 “해당 환경을 편집할 수 있는 모든 사람이 볼 수 있습니다”. 이 부분은 “주의사항” 섹션에서 더 자세히 다루겠습니다.

환경 ID 얻기 및 GitHub 권한 부여

환경을 만든 후, 로컬 Claude Code로 돌아가서 다음을 입력합니다.

/remote-env

그러면 클라우드에서 생성한 모든 환경과 해당 ID가 나열됩니다.

bili-sandbox에 해당하는 줄을 복사하여 Claude에게 전달합니다. 그러면 Claude가 작업에 사용할 환경을 알게 됩니다.

그런 다음 Claude는 “GitHub에 대한 액세스 권한이 필요합니다"라고 말하며 권한 부여 옵션을 제시합니다.

• A: /web-setup — 로컬 gh CLI 토큰을 claude.ai와 동기화하며, 30초 정도 소요됩니다.
• B: Claude GitHub App 설치 — GitHub 웹 페이지로 이동하여 특정 저장소를 선택하여 설치, 더 세분화된 제어가 가능합니다.

저는 샌드박스 테스트였기 때문에 A를 선택했습니다. 선택하면 웹 페이지가 다시 열리고, 거기에 GitHub 저장소가 보이면 권한 부여가 활성화된 것입니다.

권한 부여 후 로컬 환경으로 돌아옵니다. 이제 환경 설정이 완료되었습니다.

나중에 새 Routine을 만들 때 이 전체 구성을 다시 설정할 필요 없이 재사용할 수 있습니다.

AI가 작업 설정하기

여기서 Claude에게 “로컬에 있는 Bilibili-텍스트 변환 스킬을 Routine으로 옮기고 동영상 하나로 테스트해 줘"라고 알려줍니다.

그러면 Claude가 RemoteTrigger API를 호출하여 작업을 생성하고 트리거하는 모든 작업을 스스로 수행합니다. 완료되면 웹 페이지를 열면 작업이 이미 생성되어 있습니다.

그런 다음 Bilibili 동영상 링크를 찾아 AI에게 보내서 제대로 작동하는지 테스트합니다. 저는 Bilibili에서 “AI 지식 베이스"에 관한 6분짜리 동영상을 골랐습니다. 클라우드 Claude가 먼저 yt-dlp를 사용하여 오디오를 다운로드한 다음, Gemini를 호출하여 텍스트로 변환하고, 결과를 Markdown으로 작성하여 최종적으로 제 Claude-Routines 저장소에 커밋합니다.

최종 결과는 약 3,000자의 정확한 중국어 텍스트였습니다. 중국어-영어 혼용 용어(LLM-Wiki, RAG, Karpathy, NewType OS 등)가 모두 정확하게 보존되었으며, 단락도 완전했습니다. 이 모든 과정에서 제가 한 일은 Claude Code 대화 상자에 입력하는 것뿐이었습니다. 터미널을 열거나, 명령어를 실행하거나, GitHub 웹 페이지를 열지 않았습니다.

트리거 방법

위의 실행은 Claude Code가 Anthropic의 관리 API를 직접 호출하여 Routine을 만들고 한 번 트리거하도록 한 것입니다. 테스트 편의를 위해 AI가 모든 작업을 수행하도록 한 것입니다.

일상적인 사용을 위해 Routines는 세 가지 공식 트리거 방법을 지원합니다.

1. 예약 트리거 — 시간별/일별/주별 사전 설정과 최소 1시간 간격의 사용자 정의 cron 표현식을 지원합니다. 일반적인 시나리오: 매일 오전 9시에 어제의 자금 흐름과 뉴스를 자동으로 요약합니다.

2. API 트리거 — 각 Routine은 전용 HTTP 엔드포인트 + Bearer 토큰을 생성할 수 있습니다. 이 엔드포인트에 POST 요청을 보내면 즉시 작업이 트리거되며, 요청 본문에 임시 매개변수(예: URL)를 전달할 수 있습니다.

3. GitHub 이벤트 트리거 — 저장소에서 PR, push, issue, release 등의 이벤트가 발생하면 Routine이 자동으로 실행됩니다. 주로 개발자 시나리오용입니다.

세 가지 트리거 방법은 혼합하여 사용할 수 있습니다. 동일한 Routine이 예약에 따라 실행되고, API 호출을 수락하며, 동시에 GitHub 이벤트를 수신할 수 있습니다.

iPhone 단축어로 트리거하기까지

API 트리거의 가장 흥미로운 점은 클라이언트에 구애받지 않는다는 것입니다. HTTP POST를 보낼 수 있는 모든 것이 Routine을 트리거할 수 있습니다.

이런 시나리오를 상상해 보세요. Bilibili에서 좋은 동영상을 발견하고, 공유 버튼을 탭 → iPhone 단축어 → 자동으로 URL을 Routine의 엔드포인트에 POST로 전송합니다. 30초 후에 GitHub를 열면 텍스트가 이미 있습니다. Mac을 켜거나, Claude Code를 열거나, 한 글자도 입력할 필요가 없습니다.

설정은 간단합니다.

• Routine 구성 페이지에서 API 토큰을 생성합니다.
• iPhone에서 공유 URL을 입력으로 받아들이는 단축어를 만듭니다.
• “URL 콘텐츠 가져오기” 동작을 사용하여 POST 요청을 보내고, 본문에 URL을 Routine에 전달합니다.
• Routine 프롬프트에서 요청 본문에서 URL을 읽은 다음 yt-dlp + Gemini를 호출하여 텍스트를 변환합니다.

이 조합은 “클라우드 AI 워크플로"와 “모바일 트리거"를 연결합니다. 일반인이 처음으로 컴퓨터를 켜지 않고도 AI에게 특정 작업을 시킬 수 있게 되었습니다.

결과 확인

텍스트 변환 결과는 GitHub 저장소의 새 브랜치에 커밋으로 저장되며, GitHub 웹 페이지에서 직접 볼 수 있습니다. 하지만 일반 사용자라면 로컬로 가져오고 싶을 것입니다. 세 가지 방법이 있습니다.

• GitHub 웹 페이지에서 직접 읽거나 클릭하여 다운로드.
• 한 줄 명령어로 로컬 디렉터리로 가져오기 (예: Obsidian 받은 편지함에 직접 동기화).
• 동기화 스크립트 설정 (예: launchd 예약 git pull, 또는 클릭 한 번으로 가져오는 Obsidian 플러그인 생성).

주의사항

Routines는 훌륭하지만 몇 가지 주의할 점이 있습니다.

GitHub 권한 세분화

Claude GitHub App을 사용하는 것이 /web-setup을 사용하는 것보다 안전합니다. 전자는 Claude가 선택한 특정 저장소에만 접근하도록 허용하는 반면, 후자는 gh CLI에 표시되는 모든 저장소에 대한 액세스 권한을 사실상 넘겨줍니다. 샌드박스 테스트에는 옵션 A도 괜찮지만, 일상적인 작업에는 App을 사용하는 것이 좋습니다.

API 키가 클라우드에 노출됩니다.

환경 변수의 내용은 Anthropic의 환경 구성 데이터베이스에 저장됩니다. 공식 표현은 “해당 환경을 편집할 수 있는 모든 사람이 볼 수 있다"는 뜻으로, 환경을 편집할 수 있는 사람이라면 누구나 볼 수 있습니다. 개인 계정의 경우 기본적으로는 본인만 볼 수 있지만, 권한이 부여된 Anthropic 내부 직원도 이론적으로 접근할 수 있습니다.

따라서 할당량이 높은 프로덕션 API 키는 넣지 말고, 할당량이 낮거나 취소 가능한 하위 키를 사용하세요.

저장소를 비공개로 유지하세요.

각 Routine 커밋은 사용자의 GitHub 아이덴티티를 사용합니다. 저장소가 공개되면 텍스트 변환 결과가 GitHub 검색 및 인덱싱에 포착됩니다. 샌드박스 저장소를 만들 때는 Private을 망설임 없이 체크하세요.

요약

Routines는 Anthropic이 자동화 작업을 공식적으로 클라우드로 옮기는 첫 번째 단계입니다. 일반 사용자에게는 “예약 작업에 컴퓨터가 켜져 있어야 하는” 오래된 문제를 해결해 주고, Anthropic에게는 자체 생태계를 구축하고 서드파티 API 접근을 제한하는 핵심 요소입니다.

오늘 배운 내용:

1. Routines는 Claude Code의 클라우드 작업 스케줄링 시스템으로, 2026년 4월 14일에 연구 프리뷰로 출시되었습니다.
2. 요구 사항: Max/Pro 구독 + GitHub 저장소 + Claude Code CLI.
3. 세 가지 공식 트리거 방법: 예약, API, GitHub 이벤트. 혼합 사용 가능. iPhone 단축어와 결합하면 “휴대폰에서 URL 공유 → 클라우드에서 자동 실행 → GitHub에서 결과 수신"의 완전한 체인을 구현할 수 있습니다.
4. GitHub 저장소 연결 필수 및 기본 제한된 네트워크는 적응해야 할 제약 사항입니다.

핵심 포인트:

• GitHub 저장소를 만들 때는 반드시 Private과 Add a README를 체크하세요.
• 클라우드 환경에서 Network access를 Full로 설정하지 않으면 많은 일반 웹사이트에 접근할 수 없습니다.
• API 키는 Anthropic의 환경 구성에 저장되므로 프로덕션 키를 넣지 마세요.
• 첫 번째 환경 설정은 약간 번거롭지만, 한 번 구성하면 계속 재사용할 수 있어 이후 Routine 생성이 훨씬 쉬워집니다.