Claude Code /loop vs /schedule 差別完整解析（2026 實測）

TL;DR

- 本文解決：Claude Code 的 /loop 跟 /schedule 名字都像排程，但用途完全不同，搞混會白燒 token

- 推薦給：用 Claude Code Pro / Max 想跑「定時任務」或「無人值守任務」的工程師

- 讀完你會知道：兩個指令各跑在哪、最小間隔差多少、什麼情境用哪一個、為什麼不能互相代替

📌 目錄

🎯 這篇在講什麼

Claude Code 從 2026 開始陸續放出兩個跟「自動化」有關的 slash command：/loop 跟 /schedule。我自己第一次看到時直覺以為是同一件事的兩種寫法 — 一個短間隔、一個長間隔。實際翻完官方文件才發現完全不是 — 一個是 session 綁住的計時器，另一個是 跑在 Anthropic 雲端的常駐 agent。

混用的下場很實際：你以為設了 /schedule 關電腦它會自己跑，結果用了 /loop 設成每 5 分鐘 — 關 terminal 就停了。或反過來，你想 session 內每 5 分鐘看一次 build 狀態，結果用 /schedule，發現最小間隔是 1 小時，還佔用每天 routine 配額。

這篇把兩個指令攤開來對照。

🧠 一句話差別

• /loop = 本機 session 內反覆送 prompt 的計時器，關掉 terminal 就停
• /schedule = 在 Anthropic 雲端建立一個常駐 Routine，電腦關機照跑

⚡ /loop 是什麼

/loop 是 session 內 的指令排程器。在你開著 Claude Code 的這個 terminal session 裡，叫它定時對自己送 prompt。

基本用法

/loop 5m 看一下 npm run build 跑完沒

或用 cron 表達式：

/loop --cron "*/15 * * * *" 檢查 staging 環境健康

關鍵特性

• 間隔單位：s（秒）、m（分）、h（時）、d（天）都可以
• 預設間隔：沒寫就是 10m
• 第一次立刻跑，之後等間隔再跑
• process-bound：跟你這個 session 綁死，關 terminal、SSH 斷線、筆電休眠 → 立刻停
• 每次 iteration 都吃 token：每一次觸發都是一次完整的 Claude 回合

適合的場景

• session 還開著，想叫 Claude 自己定時做小事（盯 build、看 log、輪詢 API）
• 短間隔（秒、分鐘級）的監控
• 一次性任務（看一晚上、不需要永久存在）

不適合的場景

• 你要關電腦了
• 跨天、跨週的定時工作
• 想用 webhook 或 GitHub event 觸發

☁️ /schedule 是什麼

/schedule 在 Anthropic 雲端建立一個 Routine — 把 prompt + repo + 環境 + 連接器打包成設定，存在你 claude.ai 帳號下，由 Anthropic 雲端基礎設施執行。

基本用法

/schedule daily PR review at 9am

或一次性：

/schedule tomorrow at 9am, summarize yesterday's merged PRs

關鍵特性

• 跑在 Anthropic 雲端：你關電腦、關 terminal 都不影響
• 最小間隔 1 小時：cron 表達式設成更短會被拒絕
• 三種觸發方式：

• 跨設備同步：CLI / Web / Desktop 三邊看到的是同一個帳號的 Routines
• 每日 run 上限：Pro 5 次 / 天、Max 15 次 / 天、Team / Enterprise 25 次 / 天
• branch 預設限制：Claude 預設只能 push 到 claude/ 開頭的分支，避免亂改 main
• 狀態還在 research preview：行為跟限制可能會變，目前 API 走 experimental-cc-routine-2026-04-01 beta header

適合的場景

• 無人值守的長期任務（每晚跑 PR review、每週掃 docs drift）
• 事件驅動（PR 開了就跑、CI 跑完打 webhook）
• 你不想開電腦也要它跑

不適合的場景

• 短間隔（< 1 小時）
• session 內的即時輪詢
• 一次性的 5 分鐘後跑

⚖️ /loop vs /schedule 完整比較

🎬 什麼情境用哪一個

我整理三組常見需求對應到指令：

用 /loop 的場景

• 「我跑了一個 30 分鐘的 build，叫 Claude 每 5 分鐘看一下跑完沒」
• 「這個 staging 我擔心會掛，接下來這小時 Claude 你每分鐘 ping 一次給我看」
• 「我在 debug 一個間歇性 bug，Claude 每 30 秒抓一次 log 找關鍵字」

用 /schedule 的場景

• 「每天早上 9 點，Claude 幫我 review 昨天 merge 的 PR，產一份摘要丟到 Slack」
• 「PR 一開出來，Claude 自動跑我們 team 的 review checklist，留 inline comment」
• 「我們 CD pipeline 每次 deploy 完打 webhook 給 Claude，跑 smoke test 跟掃 error log」
• 「兩週後幫我開 PR 把這個 feature flag 拔掉」（一次性 Routine）

兩個都不適合的場景

• 「我想用排程跳過配額限制」 — 兩個都跟本機 session 共用同一個訂閱配額池，雲端跑 ≠ 額外配額。這個誤會我自己也犯過，想說 Routines 跑在 Anthropic 那邊應該是分離的，官方文件原話是 "draw down subscription usage the same way interactive sessions do"。配額橋接要走 extra usage 或社群套件，不是這兩個指令的事。
• 「我想要 session 內每秒輪詢 API」 — /loop 雖然支援秒級，但每次 iteration 都是完整 Claude 回合，幾秒一次配額瞬間爆。這種需求應該寫一個普通腳本，不要用 Claude 跑。

🔑 常見誤會

誤會 1：/schedule 是 /loop 的長間隔版本

錯。兩個跑在不同地方。/loop 跑在你本機這個 session，/schedule 跑在 Anthropic 雲端。間隔差距只是表象，本質是執行環境不同。

誤會 2：/schedule 跑在雲端 → 不吃我的訂閱配額

錯。Routines 跟本機 session、claude.ai chat 共用同一個訂閱配額池。雲端只代表「不需要你電腦開機」，不代表「不算錢」。

誤會 3：兩個都能解「我想關電腦它繼續跑」

只有 /schedule 能。/loop 跟 session 綁死，關 terminal 就停。要關電腦繼續跑，只能用 /schedule，且間隔至少 1 小時。

誤會 4：/schedule 設好就無限跑

有上限。Pro 一天 5 個 routine run、Max 15 個、Team 25 個。一次性 Routine（one-off）不算這個 daily cap，但仍吃訂閱配額。

💻 實際下指令範例

/loop 範例

session 內盯 build：

/loop 3m 跑 npm run build，把錯誤行貼出來，沒錯誤就回「OK」

session 內每 30 秒輪詢 API：

/loop 30s 用 curl 打 https://staging.example.com/health，狀態碼非 200 就喊我

cron 表達式：

/loop --cron "*/15 9-18 * * 1-5" 工作日上班時間每 15 分鐘檢查 issue tracker

/schedule 範例

每天早上 9 點 PR review（CLI 內自然語言描述）：

/schedule daily PR review at 9am — 列出昨天合併的 PR，產出當週技術摘要

兩週後開清理 PR：

/schedule in 2 weeks, open a cleanup PR that removes the LEGACY_AUTH feature flag

管理已存在 Routine：

/schedule list                    # 列出所有 routines
/schedule update                  # 改某一個
/schedule run                     # 立即觸發一次

API trigger（CLI 不能設，要從 web）：

curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_xxx/fire \
  -H "Authorization: Bearer sk-ant-oat01-xxxxx" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod."}'

GitHub trigger 只能從 web UI 設（CLI 不能改）。

📝 踩到的坑

坑 1：以為 /loop 關 terminal 後還會繼續

我第一次用 /loop 10m 監控 deploy 然後把 terminal 關了去吃飯。回來發現完全沒紀錄 — /loop 是 process-bound，session 一結束指令就死了。要關電腦的場景必須用 /schedule。

坑 2：/schedule 設秒級被打槍

直覺把 cron 寫成 */5 * * * *（每 5 分鐘），存的時候被拒絕。Routines 最小間隔 1 小時，比 1 小時短的 cron 一律不收。要短間隔只能用 /loop。

坑 3：以為 Routines 是分離配額池

最常見的誤會（我也犯過）。Routines 跑在雲端 → 直覺認為是另一個池。實際上 Anthropic 文件明寫「draw down subscription usage the same way interactive sessions do」。雲端執行 ≠ 額外配額，只是省掉「你電腦要開機」這件事。

坑 4：CLI 設 /schedule 只能設時間排程

/schedule 在 CLI 只能建時間觸發的 Routine。要加 API trigger 或 GitHub trigger，必須去 claude.ai/code/routines 編輯。CLI 不能產 / 不能撤銷 token。

坑 5：Routine 預設不能 push 到 main

第一次建 Routine 跑完發現 PR 都是開到 claude/xxx 分支。這是預設保護 — 要改成可推任意分支，要在 web UI 編輯時開 Allow unrestricted branch pushes。

❓ 常見問題

/loop 跟 /schedule 最核心的差別是什麼？

執行環境。/loop 跑在你本機 Claude Code session 裡，session 結束就停；/schedule 跑在 Anthropic 雲端，建立一個常駐 Routine，電腦關機照跑。所以 /loop 是 session 計時器，/schedule 是雲端排程器。

/loop 最小間隔多少？/schedule 呢？

/loop 支援秒級（例如 30s），但每次 iteration 都吃完整 token，太短會瞬間燒爆配額。/schedule 最小間隔 1 小時，比 1 小時短的 cron 表達式會被拒絕。

用 /schedule 能跳過 5 小時用量限制嗎？

不能。Routines 跟本機 session、claude.ai 聊天共用同一個訂閱配額池。雲端執行只解決「電腦不用開機」，不解決配額限制。要真正橋接配額視窗要走別的路（社群的 retry 套件、開 extra usage 切 API 計費）。

/schedule 一天能跑幾次？

Pro 一天 5 個 routine run、Max 15 個、Team / Enterprise 25 個。一次性 Routine（one-off）不算這個 daily cap，但仍會吃訂閱配額。

我關電腦了 /loop 還會繼續嗎？

不會。/loop 是 process-bound，跟你的 Claude Code session 綁死。terminal 關了、SSH 斷了、筆電休眠 — /loop 立刻停。要關電腦繼續跑只能用 /schedule。

/schedule 設了之後怎麼改？

CLI：/schedule list 看清單、/schedule update 改設定、/schedule run 立即觸發、用 toggle 暫停。Web：claude.ai/code/routines 可以改全部設定，包含加 API trigger 跟 GitHub trigger（這兩個 CLI 不能設）。

🔗 延伸資源

• Automate work with routines — Claude Code 官方文件
• What Is the Claude Code /loop Command — MindStudio
• Models, usage, and limits in Claude Code — Anthropic Help Center
• claude.ai/code/routines — Routines 管理頁