Claude 루틴(Routines) 입문: 로컬·원격 설정과 자동화 워크플로

핵심 메시지

• Claude 루틴은 n8n 같은 결정형 자동화와 달리, 매 실행마다 Claude가 단계를 추론하는 '판단형' 자동화다.
• 로컬 루틴은 이름·설명·지시·일정 네 칸만 채우면 끝나며, 내 컴퓨터가 켜져 있는 동안 동작한다.
• 원격 루틴은 Anthropic 클라우드에서 돌아가 노트북을 닫아도 실행되지만, GitHub 저장소·환경변수·커넥터가 필요하다.
• 비밀키는 반드시 환경변수 패널에 넣어야 하며, .env 파일은 클라우드에 전달되지 않아 조용히 실패한다.
• 일정 트리거의 최소 간격은 1시간이며, 더 잦은 실행이 필요하면 API 트리거를 외부 도구로 호출한다.

쉽게 이해하기

발표자는 'AI 에이전트가 백그라운드에서 사업을 돌린다'는 약속이 그동안 VPS·도커·항상 켜진 맥미니 같은 장벽에 막혀 있었다고 지적한다. 그런데 Anthropic이 내놓은 Claude 루틴은 개발자가 아니어도 5분 안에 진짜 자율 에이전트를 띄울 수 있는, 서버도 코드도 노트북 상시 가동도 필요 없는 첫 사례라고 소개한다.

핵심 차이는 결정형 자동화와의 대비다. n8n 같은 도구는 노드를 연결해 같은 입력이 늘 같은 출력을 내는 방식이라 데이터 이동에는 강하지만, '40개 이메일 중 어디에 답해야 하나' 같은 판단이 필요한 순간 벽에 부딪힌다. 루틴은 원하는 일을 문단으로 적으면 Claude가 매 실행마다 단계를 추론하므로, 같은 목표라도 입력이 달라지면 추론 경로가 달라진다. 발표자는 이를 근본적 전환이라고 표현한다. 루틴은 2026년 4월 14일 공개된 리서치 프리뷰이며, claude.ai/code/routines 또는 Claude 데스크톱 앱에서 접근한다.

루틴을 만들 때 가장 먼저 묻는 것은 '로컬이냐 원격이냐'다. 로컬 루틴은 내 컴퓨터의 CPU·메모리·인터넷으로 돌고, 컴퓨터가 켜져 있고 Claude code가 실행 중일 때만 작동한다. 대신 설정이 전혀 없어서 이름·설명·지시·일정 네 칸만 채우면 2분 안에 가동된다. 지시 칸에는 코드가 아니라 '매 평일 아침 지난 24시간의 주요 AI 뉴스를 검색해 세 꼭지로 요약하라' 같은 문단을 적으면 되고, 결과는 오른쪽 세션 로그 패널에 쌓인다.

원격 루틴은 Anthropic 클라우드에서 실행돼 노트북을 닫아도 동작한다는 점이 장점이다. 대신 작업 공간으로 쓸 GitHub 저장소(비밀 저장소로 빈 폴더 하나면 충분), 비밀값을 담는 클라우드 환경변수, 도구 연결용 커넥터가 더해진다. 클라우드 환경은 매번 새로 띄워지는 4 vCPU·16GB·30GB 디스크의 리눅스 머신이며, 트리거는 일정·API·GitHub 이벤트 세 가지다. 일정은 최소 1시간 간격이고, 더 잦게 돌리려면 전용 HTTPS 엔드포인트와 베어러 토큰이 주어지는 API 트리거를 외부 크론·웹훅으로 호출한다. 커넥터로는 Slack·Gmail·GitHub·Notion·Linear 등을 연결해 Claude가 직접 메시지를 올리거나 메일 초안을 작성하게 할 수 있다.

발표자는 가장 아프게 겪을 순서대로 함정들을 정리한다. 가장 중요한 것은 '.env 함정'이다. 로컬에서는 Claude code가 .env에서 비밀키를 읽지만, .env는 깃 무시 목록에 있어 GitHub와 클라우드에 전달되지 않으므로 원격 루틴은 키를 못 찾고 조용히 실패한다. 해결책은 모든 비밀값을 클라우드 환경변수 패널에 넣고, 프롬프트에 '키는 환경변수로 제공되니 .env를 찾지 말라'고 명시하는 것이다.

주요 인사이트

• 루틴의 본질적 차이는 '생각하는 노드'를 드래그할 수 없는 결정형 자동화의 한계를 넘어, 판단이 필요한 작업을 매 실행 추론으로 처리한다는 점이다.
• 시작은 로컬로 로직을 검증하고, 노트북을 꺼도 되는 보장이나 Gmail·Slack 커넥터가 필요해지면 원격으로 '승격'하는 흐름이 권장된다.
• 구조화된 맥락은 프롬프트에 하드코딩하지 말고 저장소의 파일(예: clients.txt)로 주입하면, 내용이 바뀌어도 프롬프트는 그대로 유지돼 유지보수가 쉬워진다.
• 원격 실행은 매번 상태가 초기화된다. 실행 간에 무언가를 기억하려면 GitHub에 파일을 푸시하거나 API로 DB에 쓰거나 커넥터로 상태를 보내야 한다.
• Claude는 기본적으로 'claude/' 접두사 브랜치에만 푸시할 수 있어 main을 건드리지 못한다. 이 가드레일은 사람이 병합 전에 검토하는 단계를 보장하므로 켜 두는 편이 안전하다.

자주 묻는 질문

관련 AI 소식