예약 실행

이 장에서 배우는 것 예약 실행으로 무엇을 맡기고, 사람이 안 볼 때 무엇을 다르게 설계해야 하는지.

무엇을 맡기나

정해둔 시간에 업무를 시작하거나 명령을 실행합니다.

전형적인 것들입니다.

공통점은 사람이 기억하고 있어야 하는 일이라는 것입니다. 그걸 시간에 맡깁니다.

어디서 켜나

업무를 새로 만드는 화면에서 예약을 켜면 주기 선택이 나옵니다.

목록에 없는 주기는 직접 입력으로 바꾸면 크론 식(0 9 * * * 형태)을 그대로 쓸 수 있습니다. 기본값은 0 9 * * * — 매일 오전 9시입니다.

예약으로 만든 업무는 회차마다 별도의 업무로 쌓입니다. 이름을 따로 안 주면 예약의 이름을 물려받으므로, 목록에서 구분하려면 예약에 이름을 주세요.

사람이 안 볼 때의 설계

이게 이 장의 핵심입니다. 예약 실행은 아무도 지켜보지 않을 때 돕니다. 그래서 평소 업무와 다르게 설계해야 합니다.

1. 실패했을 때를 적으세요

틀린 결과를 내는 것보다 안 하는 게 낫습니다. 아무도 안 보고 있으니 틀린 게 그대로 굳습니다.

2. 전제 조건을 확인하게 하세요

앞선 Phase 2 진단에서 데이터 갱신 주기를 확인하라고 한 것이 여기서 그대로 쓰입니다.

3. 자율성은 낮게 시작하세요

자율성 수준에서 "전부 자동"은 검증된 반복 작업에 쓰라고 했습니다. 예약 실행은 반복 작업이지만 처음에는 검증되지 않았습니다.

4. 결과를 어디로 보낼지 정하세요

아무도 안 보는 결과는 없는 것과 같습니다.

예약이 쌓일 때

예약이 늘어나면 관리가 필요해집니다.

두 번째가 흔합니다. 프로젝트가 끝났는데 그 프로젝트용 예약이 계속 돌고 있습니다.

비용 감각

예약 실행은 매일 돕니다. 한 번에 드는 비용이 작아도 누적됩니다.

큰 돈은 아니지만 예약이 열 개면 다릅니다. 모델 라우팅처럼 단순 반복에는 가벼운 모델을 쓰는 게 맞습니다.

Claude Code 내장 예약과 무엇이 다른가

Claude Code 자체에도 반복 실행이 있습니다 — /loop 과 /schedule. 하는 일이 비슷해 보여서 헷갈리는데, 어디서 도느냐로 깔끔하게 갈립니다.

/loop — 지금 앉아서 지켜볼 때

"배포 끝날 때까지 5분마다 확인해줘" 같은 일입니다. 대화 맥락을 그대로 들고 다음 회차로 가니까 매번 상황을 다시 설명할 필요가 없습니다. 대신 그 대화가 닫히면 같이 사라집니다.

HyperTeams 업무 안에서는 쓰지 마세요. 업무는 답을 마치면 세션이 닫힙니다. 반복 예약은 등록되지만 깨울 자리가 없어서 아무 일도 일어나지 않고, 오류도 안 납니다. 조용히 아무것도 안 하는 쪽이라 발견이 늦습니다.

/schedule — 컴퓨터를 꺼도 돌아야 할 때

클라우드에서 도는 루틴입니다. 노트북을 닫아도 정해진 시각에 돕니다. 대신 내 컴퓨터를 못 봅니다 — 저장소에 커밋된 것만 보입니다.

PR 요약, 이슈 정리, 의존성 점검처럼 저장소만 보면 되는 일에 맞습니다.

저장소에 커밋을 미는 루틴이라면 한 가지 더 보세요. 그 저장소를 내 컴퓨터가 자동 배포하고 있다면, 클라우드 루틴이 민 코드가 결국 내 컴퓨터에서 돕니다. push 권한을 주는 것이 곧 간접 실행권을 주는 것입니다.

예약 실행 — 그 폴더가 필요할 때

나머지 둘이 원리상 못 하는 것을 합니다. 그 작업 폴더에서, 정해둔 권한으로, 터미널 명령까지 돌립니다. 이 장이 다루는 일들 — 로그 정리, 백업, 주간 보고 — 은 전부 여기에 속합니다.

한 줄 기준입니다.

• 지금 앉아서 지켜보는 중 → /loop
• 컴퓨터가 꺼져 있어도 돌아야 하고, 저장소만 보면 됨 → /schedule
• 내 컴퓨터의 그 폴더가 필요함 → 예약 실행

자주 하는 실수

실패를 안 알립니다

가장 흔합니다. 조용히 실패하면 몇 주 뒤에 "그거 요즘 안 오네?"로 발견합니다. 실패도 알리게 하세요.

잘 도는지 확인을 안 합니다

만들어두고 잊습니다. 처음 1~2주는 매일 결과를 확인하세요. 그 뒤에 손을 떼도 됩니다.

시간대를 안 맞춥니다

컴퓨터가 꺼져 있으면 예약도 안 돕니다. 백그라운드 실행이나 시작 항목 등록이 되어 있어야 예약이 의미가 있습니다.

컴퓨터를 계속 켜 둘 수 없다면 /schedule(클라우드 루틴)이 맞는지 먼저 보세요. 다만 그쪽은 작업 폴더를 못 봅니다 — 위의 표를 보고 고르세요.

---

확인

1. 예약 실행에서 "실패했을 때"를 반드시 적어야 하는 이유는?

답

아무도 지켜보지 않기 때문입니다. 틀린 결과를 내면 그게 그대로 굳습니다. 틀린 결과를 내는 것보다 안 하고 실패를 알리는 게 낫습니다.

2. 예약 실행의 자율성을 처음부터 "전부 자동"으로 두면 안 되는 이유는?

답

반복 작업이긴 하지만 처음에는 검증되지 않았기 때문입니다. 계획만 → 파일 편집 자동 승인 → 전부 자동 순으로 며칠씩 확인하며 올립니다.

3. 예약이 쌓였을 때 가장 흔한 문제는?

답

목적이 사라진 예약이 계속 도는 것입니다. 프로젝트가 끝났는데 그 예약은 남아 매일 비용을 씁니다.

4. 컴퓨터를 꺼 둔 채로도 매일 아침 돌아야 하는 일이 있습니다. 예약 실행으로 되나요?

답

안 됩니다. 예약 실행은 내 컴퓨터에서 돌기 때문입니다. 저장소에 커밋된 것만 보면 되는 일이라면 /schedule(클라우드 루틴)이 맞고, 내 작업 폴더가 필요하면 컴퓨터를 켜 두는 것 말고는 방법이 없습니다.

---

예약을 늘리기 전에 한도부터 봅니다 → 사용량 한도 다루기