Claude Code v2.1.77 기준
Claude Code /loop,
쓸 수 있는 조건 따로 있습니다
2026년 3월 7일 출시된 /loop 기능 — “세션 닫으면 전부 사라진다”는 게 핵심입니다. 공식 문서와 실측 데이터로 직접 확인한 내용을 정리했습니다.
/loop가 뭔지, 결론부터 말하면
Claude Code /loop는 2026년 3월 7일 조용히 배포된 기능입니다. “AI 어시스턴트에게 반복 점검을 맡기고 나는 다른 일을 한다” — 딱 이 시나리오를 위해 설계됐습니다. 명령어 한 줄이면 배포 모니터링, PR 상태 감시, 에러 로그 스캔을 일정 간격으로 자동 실행할 수 있습니다.
내부 구조는 단순합니다. 자연어로 입력한 시간 표현을 Claude가 cron 표현식으로 변환하고, 세션 내부 스케줄러에 작업을 등록합니다. 터미널을 열어둔 채로 두면 정해진 시간마다 같은 프롬프트를 재실행하고 결과를 채팅창에 띄워줍니다. 직접 써봤을 때 “배포 끝났는지 15분마다 확인해줘”를 /loop에 넘기고 딴 일 하다 보면 — 정말로 15분 뒤에 결과가 올라옵니다.
💡 공식 문서 원문과 실측 데이터를 같이 놓고 보니 이런 그림이 나왔습니다: /loop는 “세션 안의 cron 데몬”이지, 시스템 서비스가 아닙니다. 터미널을 닫는 순간 모든 스케줄이 사라지는 이유가 여기 있습니다.
기본 사용법과 시간 표기 규칙
기본 문법은 이렇습니다: /loop [간격] [할 작업 설명]. 간격을 생략하면 기본값으로 10분마다 실행됩니다 — 공식 문서에 딱 이렇게 나옵니다. (출처: Claude Code 공식 문서 code.claude.com/docs/ko/scheduled-tasks)
| 표기 방식 | 예시 | 실제 동작 |
|---|---|---|
| 숫자+단위 | /loop 30m check the build | 30분 간격 실행 |
| every 문법 | /loop check every 2 hours | 2시간 간격 실행 |
| 자연어 단발성 | remind me at 3pm to push | 1회 실행 후 자동 삭제 |
| 간격 생략 | /loop check git status | 기본값 10분 간격 |
단위는 s(초), m(분), h(시간), d(일)을 지원합니다. 단, 초 단위는 최소 1분으로 올림 처리됩니다 — cron 자체가 1분이 최소 단위라서 그렇습니다. “90분마다”처럼 cron 표준에서 직접 표현이 불가능한 간격은 Claude가 알아서 근사값으로 조정합니다.
생성된 작업은 cron list로 확인하고, cron delete [작업ID]로 취소합니다. 자연어로 “지금 실행 중인 작업 보여줘”, “배포 감시 취소해줘”라고 말해도 됩니다.
세션 닫으면 전부 사라집니다 — 이게 진짜 문제
/loop 작업은 세션에 묶여 있습니다. 터미널을 닫거나, VS Code를 종료하거나, 노트북 덮개를 닫으면 — 그 순간 등록된 모든 루프가 사라집니다. 복구 옵션도 없고, 재시작 후 “이전 루프 재개” 같은 프롬프트도 없습니다. (출처: Claude Code 공식 문서 code.claude.com/docs/ko/scheduled-tasks)
3개 루프를 정성껏 설정해뒀어도 노트북이 절전 모드로 들어가면 전부 초기화됩니다. 재등록하려면 처음부터 다시 입력해야 합니다. 루프 명령어를 loops.md 같은 파일에 따로 저장해두는 게 현실적인 대안입니다.
세션 의존성 외에 공식 문서가 명시하는 제약이 두 가지 더 있습니다. 첫째, 3일(72시간) 최대 실행 한도 — 계속 세션을 유지해도 72시간 후에는 자동 만료됩니다. 둘째, 세션당 최대 50개 작업 제한. 이것들은 토큰 과소비를 막기 위한 안전장치라고 공식 문서에서 설명합니다.
그리고 또 하나 — 작업 누락 시 보정이 없습니다. Claude가 복잡한 요청을 20분 동안 처리하고 있을 때 5분짜리 루프가 4번 지나쳤다면, Claude가 한가해지는 순간 딱 1번만 실행되고 나머지 3번은 그냥 사라집니다. 놓친 만큼 재실행하지 않습니다.
루프 한 번 실행될 때마다 토큰이 이만큼 나갑니다
실제로 측정해본 사람이 있습니다. API 게이트웨이 프록시를 직접 구축해 10개 세션, 223회 LLM 호출을 기록한 데이터에 따르면, Claude Code는 첫 메시지 전에 이미 82.6KB 크기의 시스템 프롬프트와 툴 스키마를 매 호출마다 API로 보냅니다. (출처: Shubham Thorat, Medium “Your Hello Costs 20,000 Tokens”, 2026.03.17)
💡 숫자로 환산하면 이렇습니다. 세션 첫 요청 기준 시스템 프롬프트 약 3,800 토큰 + 25개 툴 스키마 약 16,856 토큰 = 고정 기반 비용 약 20,656 토큰입니다. 내가 타이핑한 “배포 끝났어?”라는 질문은 그 중 0.088%에 불과합니다. 루프가 10분마다 실행된다면, 8시간 동안 48번 발화하고 각 회차마다 이 기반 비용이 붙습니다.
루프 3~4개를 동시에 돌리며 헤비하게 사용한 경우, 비슷한 작업량 대비 토큰 소비가 약 40% 증가했다는 실사용 보고가 있습니다. (출처: mejba.me, “Claude Code Loop: Cron Scheduling Inside Your IDE”, 2026.03.07) 이게 단독으로 요금을 올리지는 않지만 — 구독제의 주간 한도를 예상보다 빠르게 소진시키는 원인이 됩니다. 루프 간격을 처음엔 1시간으로 시작하고, 실제 소비 패턴을 확인한 후 줄여가는 방식이 안전합니다.
장시간 루프 운용 시에는 “응답 품질 저하” 현상도 실측됩니다. 세션이 길어질수록 대화 히스토리가 누적되면서 컨텍스트 윈도우가 채워지고, 초기에 정확했던 루프 응답이 6시간 이후부터 점점 뭉뚱그려집니다. 4~6시간마다 루프를 재생성하는 것이 품질 유지에 효과적입니다.
/loop vs Scheduled Tasks — 어떤 상황에 어떤 걸 써야 하나
Anthropic은 두 가지 스케줄링 시스템을 별도로 운영합니다. /loop는 세션 안에서만 사는 임시 도우미이고, Scheduled Tasks는 재부팅 후에도 살아남는 지속형 자동화입니다. 현재 Scheduled Tasks는 데스크탑 앱(macOS·Windows)에서만 사용 가능합니다. 리눅스 터미널 유저라면 아직 선택지가 없습니다.
| 항목 | /loop | Scheduled Tasks |
|---|---|---|
| 지속성 | 세션 종료 시 삭제 | 재부팅 후에도 유지 |
| 최대 실행 기간 | 3일 (72시간) | 무제한 |
| 누락 보정 | 없음 (1회 catch-up만) | 있음 |
| 설정 난이도 | 자연어, 즉시 시작 | 데스크탑 앱 GUI |
| 지원 환경 | 터미널·VS Code·데스크탑 | 데스크탑 앱만 (현재) |
팀 단위로 의존하는 배포 알람, 매일 아침 9시 코드 품질 요약 같은 것들은 /loop로 처리하면 재시작 때마다 수동 복구해야 합니다. 이런 용도는 Scheduled Tasks나 GitHub Actions의 `schedule` 트리거가 맞습니다. “현재 작업 세션 동안만 필요한 것” 대 “터미널 꺼도 계속 돌아야 하는 것” — 이 기준으로 나누면 헷갈리지 않습니다.
지금 당장 쓸 수 있는 패턴 4가지
실제 워크플로우에 붙여쓸 수 있는 명령어 형태로 정리했습니다. 처음 쓸 때는 루프 1개부터, 간격은 넉넉하게 시작하는 게 토큰 관리에 낫습니다.
/loop every 10 minutes run kubectl get pods -n staging and check for any pods not in Running state. One-line summary if healthy, detailed breakdown if something is wrong.
“이상 없으면 한 줄, 이상 있으면 자세히”로 지시하지 않으면 매 10분마다 장황한 정상 보고가 쌓입니다.
/loop 30m check the status of my open pull requests. Report only if something changed since last check — stay silent if nothing is new.
“변경 없으면 조용히”가 없으면 30분마다 “변동 없음” 알림이 쌓입니다.
remind me at 4:45 PM to tag the release candidate before the deploy window closes
지정 시각에 1회 실행 후 자동 삭제 — 별도 정리가 필요 없습니다.
/loop 2h scan error logs in ./logs/app.log for new FATAL entries since last check. If any are fixable, open a PR with the fix.
툴 연동이 돼 있으면 로그 발견 → PR 생성까지 자동으로 연결됩니다.
오프피크 2배 혜택 — 3월 27일까지 실제로 되는 것
현재(2026.03.22 기준) Anthropic은 오프피크 시간대에 Claude 전 플랜의 사용량 한도를 2배로 운영 중입니다. 기간은 2026년 3월 13일~27일. 무료, Pro, Max, Team 플랜 모두 해당되고, Enterprise는 제외입니다. (출처: Anthropic 공식 발표, Believemy 정리 2026.03.20)
💡 배경이 흥미롭습니다. Anthropic이 미 국방부 요청에 AI 윤리 기준 완화를 거부한 후 연방 계약을 잃었고, 이에 반발한 사용자들이 ChatGPT에서 Claude로 대거 이동했습니다. 클로드가 App Store 무료 앱 1위(ChatGPT 최초 탈환)를 기록하면서 서버 피크 부하가 급증했고 — 오프피크 2배 혜택은 이 부하를 분산하기 위한 조치입니다. 보너스 사용분은 주간 한도에 포함되지 않습니다.
| 시간대 | 피크 (한국시간) | 오프피크 (2배 적용) |
|---|---|---|
| 한국 (KST, UTC+9) | 오후 9시 ~ 오전 3시 | 오전 3시 ~ 오후 9시 |
| 주말 (토·일) | 없음 | 24시간 전체 2배 |
한국 기준으로는 오전 3시 이후부터 저녁 9시까지가 오프피크입니다. 평일 낮 시간대에 /loop를 적극 활용하기 좋습니다. 현재 사용량은 Claude Code 세션 내에서 /stats session 명령어로 실시간 확인할 수 있습니다.
Q&A
Q. 터미널을 안 닫고 백그라운드로 내려두면 루프가 계속 돌아가나요?
세션이 활성 상태를 유지한다면 루프는 계속 실행됩니다. 하지만 macOS 노트북 덮개를 닫거나 절전 모드로 진입하면 세션이 끊기면서 루프도 같이 사라집니다. 외부 서버에서 돌리거나 tmux로 세션을 유지하면 더 오래 살아있습니다.
Q. /loop를 여러 개 동시에 돌리면 어떻게 되나요?
최대 50개까지 등록 가능하고, 동시 실행도 됩니다. 다만 루프가 많을수록 대화 히스토리가 빠르게 쌓여 컨텍스트 품질이 저하됩니다. 실사용에서 동시 2~3개가 하루치 세션에서 품질을 유지하는 현실적인 한계로 확인됐습니다.
Q. 무료 플랜에서도 /loop가 됩니까?
/loop 기능 자체는 플랜과 상관없이 Claude Code에서 사용 가능합니다. 단, 무료 플랜의 사용량 한도 안에서 소비됩니다. 루프가 잦을수록 한도가 빠르게 줄어드는 건 무료 플랜에서 더 체감됩니다. 현재 오프피크 2배 프로모션은 무료 플랜도 해당됩니다.
Q. 정각(:00, :30)을 피해서 스케줄을 잡으라는 말이 있던데 왜 그런가요?
공식 문서에 따르면 정각 또는 :30에 등록된 1회성 작업은 최대 90초 일찍 실행될 수 있고, 반복 작업은 주기의 최대 10%(15분 상한)까지 늦게 실행될 수 있습니다. 릴리즈 윈도우처럼 정확한 시간이 중요한 경우 0 9 * * * 대신 3 9 * * *처럼 정각을 피해 설정하는 게 낫습니다.
Q. 팀 환경에서 루프를 제한하거나 비활성화하는 방법이 있나요?
있습니다. 환경변수 CLAUDE_CODE_DISABLE_CRON=1을 설정하면 해당 세션에서 /loop와 cron 기능 전체가 비활성화됩니다. CI 파이프라인이나 공유 서버처럼 루프가 의도치 않게 토큰을 소비하면 안 되는 환경에서 유용합니다.
마치며 — 솔직한 총평
/loop는 쓸 만합니다. “배포 끝났나?”, “CI 왜 이렇게 오래 걸리나?”, “PR 코멘트 달렸나?”처럼 손이 가던 반복 점검을 AI에게 넘기고 나서, 같은 시간 동안 다른 일에 집중할 수 있다는 건 실제로 체감됩니다. 기대했던 것과 다른 부분은 “자동화”라는 단어가 주는 인상입니다. 세션 의존형이라는 구조 때문에, 터미널을 닫으면 전부 날아간다는 걸 처음 경험하면 좀 허탈합니다.
솔직히 말하면, v1 기능입니다. 세션 지속성, 누락 보정, 세션 간 통합 관리 — 이 세 가지가 없다는 게 뭉뚱그려 “불편한 점” 정도가 아니라, 특정 용도에서는 아예 쓸 수 없는 이유가 됩니다. 그 용도를 미리 파악하고 쓰는 사람과 모르고 쓰다가 허탈해하는 사람 사이의 차이는 꽤 큽니다.
현재 오프피크 2배 혜택(3월 27일까지)이 남아 있는 동안, 토큰 걱정 없이 /loop 패턴을 실험해볼 수 있는 타이밍입니다. 간격은 넉넉하게, 루프는 2개 이하로 시작하고 — 명령어는 반드시 어딘가에 따로 저장해두는 것, 이 세 가지면 충분합니다.
본 포스팅 참고 자료
- Claude Code 공식 문서 — 예약 작업(Scheduled Tasks): code.claude.com/docs/ko/scheduled-tasks
- Anthropic Claude Code 공식 개요 문서: docs.anthropic.com/ko/docs/claude-code
- Mejba.me — “Claude Code Loop: Cron Scheduling Inside Your IDE” (2026.03.07): mejba.me/blog/claude-code-loop-cron-scheduling
- Shubham Thorat, Medium — “Your Hello Costs 20,000 Tokens” (2026.03.17): medium.com/@shubhamatucsd
- Believemy — “Claude Code is temporarily doubling its usage limits” (2026.03.20): believemy.com
※ 본 포스팅은 2026년 3월 22일 기준으로 작성되었습니다. Claude Code /loop 기능의 스펙, 제한 조건, 오프피크 프로모션 일정 등은 Anthropic의 업데이트에 따라 변경될 수 있습니다. 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있으므로, 최신 정보는 공식 문서(docs.anthropic.com)에서 확인하시기 바랍니다.
댓글 남기기