Claude Code Routines 全攻略：雲端自動化系統的完整設定與案例（前 Cloud Scheduled Tasks）

TL;DR Routines 是 Claude Code 的雲端自動化系統（前身 Cloud Scheduled Tasks）。除了 cron 排程，還能用 API 端點或 GitHub 事件觸發——掃 issue、審 PR、跑檢查、開 PR，電腦關了也會跑。

#claude-code #routines #scheduled-tasks #remote-agent #automation #cron #dx

三種排程方式
Routines 是什麼
三種 Trigger
管理 routine
實際案例：daodao-auto-dev
Prompt 設計原則
限制
排程之外：goal mode（/goal）
整體來說
參考資料
更新紀錄

系列: Claude Code 深入介紹 (22 / 38)

Claude Code Channels 怎麼運作：外部事件、reply tools 與 sender gating Claude Code /loop：把 AI 變成背景 worker 的排程功能（v2.1.72+ 新版）

🌏 English version

你寫了一個 prompt 告訴 Claude「掃描這四個 repo 的 GitHub issues，有標 auto 的就實作，完成後開 PR」。然後設定每 2 小時跑一次。

接下來你去睡覺。半夜 2 點、4 點、6 點，Claude 自己 clone repo、讀 issue、寫 code、跑測試、開 PR。你早上起來，收件匣裡躺著三個等你 review 的 PR。

這就是 Claude Code Routines 做的事。

更名提醒：Routines 就是過去的 Cloud Scheduled Tasks。功能擴充後改名——除了排程之外，還新增 API trigger 和 GitHub event trigger 兩種觸發方式，三者可以組合在同一個 routine 上。

目前 Routines 處於 research preview，行為、限制、API 介面可能還會變。

三種排程方式

Claude Code 提供三種排程機制，適合不同場景：

	Routines（雲端）	Desktop scheduled tasks	`/loop`
跑在哪	Anthropic 雲端	你的電腦	你的電腦
電腦要開著嗎	不用	要	要
需要開著 session 嗎	不用	不用	要
重啟後還在嗎	在	在	`--resume` 還可還原（7 天內）
能讀本地檔案嗎	不能（每次 fresh clone）	能	能
MCP 支援	Connectors（每個 routine 設定）	config files + connectors	繼承 session
權限提示	沒有（自主執行）	每個任務可設定	繼承 session
觸發方式	Schedule / API / GitHub	排程	排程
最短間隔	1 小時	1 分鐘	1 分鐘

Routines：不需要你的電腦在線，適合跨時區團隊和長期自動化。每次 run 都是 fresh clone，獨立乾淨。

Desktop scheduled tasks：需要電腦在線但不需要開 session，能讀寫本地檔案。適合需要本地環境的任務。

/loop：最輕量，session 內的快速排程。適合「部署完通知我」這種短期監控。新 session 就消失，開了 --resume 才會還原。

這篇專注介紹 Routines。/loop 的語法細節見實作篇 /loop 排程功能，Remote Agent 的完整流水線見 Remote Agent 自動開發。排程之外，想讓 Claude 不停工直到條件達成，文末另有一節介紹 goal mode。

Routines 是什麼

一個 routine 就是一份打包好的 Claude Code 設定：prompt + 一或多個 GitHub repo + connectors + 一或多個 trigger。打包一次，自動跑無數次。

可用方案：Pro、Max、Team、Enterprise 並啟用 Claude Code on the web。Team / Enterprise 需 Owner 從 admin settings 開啟 Routines toggle——關閉時既有 routine 也會停跑。

每個 routine 跑起來等於一個完整的 Claude Code cloud session：自主執行、沒有權限提示、可以跑 shell、用 skills、呼叫 connectors。能碰到什麼完全由你選的 repo、environment、connectors 決定，所以這三項一定要設緊一點。

建立方式

三個入口寫到同一個雲端帳號，介面互通：

Web：到 claude.ai/code/routines 點 New routine
Desktop App：Routines 頁面 → New routine → 選 Cloud（選 Local 就變成 Desktop scheduled task）
CLI：在 session 中打 /schedule，Claude 會用對話引導你設定

CLI 的 /schedule（別名 /routines，需 v2.1.225+）只能建立排程型 routine。要加 API trigger 必須回 Web 編輯；GitHub trigger 則 Web 和 CLI 都能加。

CLI 也能管理現有的：/schedule list、/schedule update、/schedule run。

設定的內容

建立表單上的關鍵欄位：

1. 名稱與 prompt

prompt 是核心，Routines 完全自主執行、沒有人類互動，所以 prompt 必須自足、明確、可驗證。prompt 輸入框可以選用的 model，每次 run 用同一個。

2. Repositories

一或多個 GitHub repo。每次 run 都會 fresh clone default branch，Claude 只能 push 到 claude/ 前綴的 branch（除非開 Allow unrestricted branch pushes）。

3. Environment（雲端環境）

控制這個 routine 能碰到什麼：

Network access：預設是 Trusted，只開放 npm/PyPI 之類的常見套件源、雲端 API、容器 registry，其他全擋（回 403 host_not_allowed）。要打你自己的服務改 Custom 並列出網域，或設 Full 完全放行
Environment variables：API key、token 之類的 secret
Setup script：安裝依賴。結果會 cache，不是每次重跑

Connector 流量走 Anthropic server，不需要把 connector 的 host 加進 Allowed domains。

4. Connectors

連 MCP 服務（Slack、Linear、Google Drive 等）。建立時預設帶入你已連接的所有 connector，用不到的記得拿掉——run 中 Claude 不會問權限就直接呼叫工具，包含寫入。

5. Triggers（一或多個）

下一節詳述。

Web 表單實際長什麼樣（2026-08-27 實測）

實際打開 claude.ai/code/routines/new 看到的，比官方文件多幾個細節：

自然語言草擬入口：列表頁有一個「What do you want automated?」輸入框，打一句話按 Draft routine 就幫你把表單填好；下面另有 8 個模板（Briefing、Email triage、System health check、Issue triage、PR review digest、Dependency update check、Release notes drafter、Flaky test tracker）。模板預設時間是 UTC 換算過來的，例如 Briefing 顯示「平日 20:30 GMT+8」，要自己改成早上。
Schedule trigger 有六個快捷鈕：Once / Hourly / Daily / Weekdays / Weekly / Custom，加一個時間框；旁邊直接寫「Runs are staggered by a few minutes to spread server load」。
GitHub event trigger 在你選 repo 之前是灰的，按鈕上寫「Select a repository first」。
表單下方三個分頁：Connectors（預設塞進你所有已連接的 connector，實測一口氣帶了 12 個）、Behavior（只有一個 Auto-fix pull requests 開關，預設關）、Notifications（完成通知預設開，通道 Push／Email／Slack，預設只勾 Push）。

完整逐項紀錄見 .research/2026-08-27-claude-code-routines-web-ui-walkthrough.md。

實際建一個唯讀測試 routine 跑一次之後，再補三件事：

Repository 清單只列裝了 Claude GitHub App 的 org。我的清單只有公司 org 的 16 個 repo，個人帳號的 repo 搜不到——要先去 GitHub 裝 App。Model 下拉有 Default／Fable 5／Opus 5／Sonnet 5／Haiku 4.5／Opus 4.8～4.6／Sonnet 4.6；Schedule 選 Custom 會看到 cron 框，而且 09:00 GMT+8 存成 0 1 * * *——cron 是 UTC。
Connector 有載入時序陷阱：表單剛開時只顯示 1 個 connector，我移除後按 Create，細節頁卻掛了 13 個（其餘是之後才載入並自動附上的）。建立後務必回細節頁看 Runs with 區塊，不對就 Edit 清掉。
通知是模型判斷的：run 的 transcript 開頭是「This was a routine, no-op verification — no anomalies to report, so no notification needed.」，表示 run 內有一層指示讓 Claude 決定要不要推播；session 頁還會顯示 Effort: High、Fast mode off，run 列表標 Manual／Cloud。

三種 Trigger

一個 routine 可以同時掛多種 trigger。例如「每晚跑一次 + 部署腳本叫一次 + 新 PR 開了就跑一次」可以全綁在同一個 routine 上。

Schedule trigger

預設選項：Hourly / Daily（預設 9:00）/ Weekdays / Weekly。時間用本機時區輸入，自動轉換。

自訂 cron：在 Web 表單先選最接近的預設，再用 CLI 跑 /schedule update 設精確的 cron 表達式。最短間隔 1 小時——比這還密的會被擋掉。

每次 run 會有幾分鐘的隨機延遲（stagger），避免所有人同時打 API。同一個 routine 偏移量固定。

One-off run（單次觸發）

Schedule 也能設一次性：在指定時間跑一次，跑完自動 disable，UI 顯示為 Ran。

CLI 可以用自然語言：

/schedule tomorrow at 9am, summarize yesterday's merged PRs
/schedule in 2 weeks, open a cleanup PR that removes the feature flag

One-off run 不算進每日 routine 上限，只算進你方案的一般使用量。

API trigger（新）

每個 routine 可以掛一個 HTTP 端點，POST 過去就觸發一次 run，回傳 session URL。把 Claude Code 接進告警系統、CD pipeline、內部工具都靠這個。

設定流程（只能在 Web 設，CLI 不能建立或撤銷 token）：

編輯 routine → Select a trigger → Add another trigger → API
存檔後 modal 顯示 URL 和 sample curl
點 Generate token，token 只會出現一次，當下複製存好

範例呼叫：

curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/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. Stack trace attached."}'

回傳：

{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}

text 欄位是 freeform 字串（不會 parse 結構），會跟 routine 原本的 prompt 一起餵給 Claude。傳 JSON 進去 Claude 會看到字面字串。

安全設計要知道：text 不是以裸訊息送達，而是包在 <routine-fire-payload> 區塊裡，標記為不可信任資料。routine 的 prompt 必須明確寫出要處理這個 payload（例如「調查 routine-fire-payload 區塊中描述的告警」），否則 Claude 會把它當惰性上下文不動作。Web UI 用 Run now 附帶的文字也走同樣的包裝——任何人拿到 bearer token 都能送 text，這層包裝確保洩漏的 token 只會送進「標了不可信任」的資料，而不是直接對你的 routine 下指令。

Beta header 是 experimental-cc-routine-2026-04-01。research preview 期間可能改變，但 Anthropic 承諾舊 header 還會支援前兩個版本給時間遷移。/fire 端點只給 claude.ai 帳號用，不在 Claude Platform API 表面。

GitHub event trigger（新）

GitHub 事件直接觸發一次 run，每個事件獨立開新 session（沒有 session reuse）。

設定步驟（Web 或 CLI 都能設，CLI 路徑需 v2.1.225+）：

編輯 routine → Add another trigger → GitHub event（CLI 則先從 GitHub App 頁面裝 App，再叫 Claude 加 trigger，例如 /schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp）
無論哪條路，都必須先安裝 Claude GitHub App（CLI 的 /web-setup 只給 clone 權限，不會裝 App，也不會啟用 webhook）
選 repo、選事件、選 filter

支援事件：

類別	觸發時機
Pull request	PR 開、關、指派、貼 label、push 新 commit、其他更新
Release	release 建立、發布、編輯、刪除

每類都能挑特定 action（如 pull_request.opened）或全部 action。

PR filter 欄位很豐富：Author、Title、Body、Base branch、Head branch、Labels、Is draft、Is merged。每個欄位可選 operator：equals、contains、starts with、is one of、is not one of、matches regex。

matches regex 比對整個值不是 substring。要找 title 包含 hotfix 寫 .*hotfix.*，或乾脆用 contains。

幾個範例組合：

Auth 模組 review：base = main AND head 包含 auth-provider
跳過 draft：Is draft = false
Label gating：Labels 包含 needs-backport

Research preview 期間，GitHub webhook 有每個 routine 和每個帳號的小時上限，超過就丟掉到下個窗口才復原。

管理 routine

在 claude.ai/code/routines 點 routine 進細節頁：

Run now：立即手動觸發一次
Pause/Resume：用 Repeats 區塊的 toggle 暫停排程，設定保留
Edit：改名稱、prompt、repo、environment、connectors、triggers
Delete：刪除 routine（過去的 session 還在）
Runs 歷史：每次 run 都是完整 session，點開可看 Claude 做了什麼、改了什麼、決定要不要開 PR

重要：run list 的綠燈只代表「session 順利啟動沒爆 infrastructure 錯誤」，不代表 prompt 任務真的成功。網路被擋、connector tool 缺、邏輯失敗都要進 transcript 才看得到。

實際案例：daodao-auto-dev

這是我實際在跑的 routine，用來自動開發 daodao 專案。

設定

名稱：daodao-auto-dev
Repositories：4 個 repo——daodaoedu/daodao-server、daodaoedu/daodao-f2e、daodaoedu/daodao-ai-backend、daodaoedu/daodao-storage
Trigger：Schedule，custom cron 0 */2 * * *（每 2 小時）
狀態：可以隨時 Pause/Resume

Prompt 設計

prompt 告訴 Claude：

先探索工作環境，找到四個 repo 的路徑
掃描 GitHub issues，找有 auto label 的
按優先順序實作：建 branch → 寫 code → 跑測試 → 開 PR
檢查已開的 PR 有沒有 review feedback，有的話自動修

這個 prompt 大概 200 行，包含每個 repo 的tech stack說明、coding convention、PR 格式規範。寫得越具體，AI 的產出品質越好。

運作結果

從 Runs 歷史可以看到：

每 2 小時自動執行一次（2:01 AM、4:04 AM、6:02 AM）
也支援手動觸發（MANUAL 標記）
每次 run 都是獨立 session，可以展開看完整對話

實際效果：

半夜 → Claude 掃到 3 個 auto issue
    ↓
自動建 branch、寫 code、跑測試
    ↓
開 3 個 PR（各帶 +177/-0、+121/-18 等改動）
    ↓
早上起來 → review 3 個 PR → merge

人類的角色從「寫 code」變成「寫 issue + review PR」。

搭配 GitHub trigger 讓 PR review 即時化

Schedule 跑得是「批次」。要讓 review 即時化，可以再掛一個 GitHub trigger 在同一個 routine（或另開一個專做 review 的 routine）：

Trigger：pull_request.opened，filter is draft = false
一開 PR 就跑一次 review，留 inline comment

排程處理 backlog、GitHub trigger 處理即時事件，組合在一起變成完整的開發代理。

搭配 /file-bug-issue

/file-bug-issue skill 可以在 debug 時直接開 GitHub issue。如果判斷 AI 能修，手動加上 auto label，下一輪 routine 就會自動接手。

Debug → /file-bug-issue → GitHub Issue (bug label)
    ↓
人類判斷能自動修 → 加 auto label
    ↓
Routine 下一輪掃到 → 自動修 → 開 PR

Prompt 設計原則

Routines 最大的挑戰是 prompt 品質。它完全自主執行，run 中沒有權限提示也不會停下來問你——你不在場。

要自足。 不能假設任何上下文。每次 run 都是 fresh clone，session 之間沒有記憶。所有需要的資訊都要寫在 prompt 裡。

要具體。 「幫我處理 issue」太模糊。「掃描 auto label 的 issue，按 priority 排序，一次處理一個，建 claude/<issue-number> branch，完成後跑 pnpm test，通過才開 PR」才是好的。

要有邊界。 告訴 Claude 什麼不該做：不要改 CI config、不要 force push、不要 merge PR。Connector 拿掉用不到的，network access 不要直接開 Full。

要考慮失敗。 「如果測試失敗，停止該 issue 的處理，在 PR 留言說明失敗原因，繼續處理下一個」。不處理失敗路徑的 prompt 會讓 Claude 卡住。

迭代改進。 前幾次 run 一定會有問題。看 session 記錄，調整 prompt，再跑。幾輪之後就穩了。

限制

每次 fresh clone。 沒有 cache（setup script 結果有，但檔案系統狀態沒有）。大 repo 的 clone 時間長。也不能存狀態（例如「上次處理到哪個 issue」），需要靠外部系統（GitHub labels、issue 狀態）追蹤進度。

Branch 限制。 預設只能 push 到 claude/ 前綴的 branch。合理的安全設計，但如果你的 workflow 需要 push 到其他 branch，要明確開 Allow unrestricted branch pushes。

最短間隔 1 小時。 Routines 不適合高頻監控。需要分鐘級輪詢的用 Desktop scheduled task 或 /loop，或改用 GitHub trigger 把「定時掃」變成「事件驅動」。

沒有本地檔案存取。 跑在 Anthropic 雲端，看不到你電腦上的檔案。需要本地環境的任務用 Desktop scheduled task。

會有幾分鐘的延遲。 Stagger 避免大家同時打 API，每次 run 會有一個小的隨機延遲。不影響實際使用，但不適合需要精確時間的場景。

每日跑次上限。 Routines 除了消耗訂閱用量，還有每帳號每日 run 上限。在 claude.ai/code/routines 或 settings/usage 看剩多少。打到上限：開 extra usage 走 metered overage，或等下個窗口。

身分共用問題。 Routine 屬於你個人 claude.ai 帳號，不會跟同事共享。Claude 透過你連的 GitHub 開的 PR、透過 Slack connector 發的訊息，都掛你的名字。這對團隊使用是一個要考慮的點。

API 還在 beta。 /fire endpoint 帶的 beta header 是 experimental-cc-routine-2026-04-01，request/response shape 還可能變。

排程之外：goal mode（`/goal`）

排程三兄弟解決「什麼時候跑」。goal mode 解決的是另一個問題：怎麼讓 Claude 不停工，直到條件達成為止。它不是排程——沒有間隔、不用等時間——每一輪做完立刻接下一輪。

用法是 /goal 後面接完成條件：

/goal all tests in test/auth pass and the lint step is clean

設定後 Claude 立刻開工（不用再另外下 prompt）。之後每一輪結束，一個小型快速模型會根據對話內容檢查條件，回傳三種判決之一：還沒到（Claude 參考評估理由繼續做）、已達成（清除目標並記錄成果）、不可能（判定條件永遠無法滿足，清除目標並記錄失敗原因）。出現你必須親自修的錯誤——認證失敗、額度用盡、auto-compaction 救不回的 context 溢出、模型不可用——也會清除目標並提示你修好後重新 /goal；一般的暫時性錯誤（rate limit、server overload）不會中斷目標。

適合的是有可驗證終點的大塊工作：模組遷移到所有 call site 都編譯過、照設計文件做到所有 acceptance criteria 成立、把一批 labeled issue 清到空。跟 /loop 的差別在驅動訊號：/loop 按時間間隔觸發下一輪，/goal 按「上一輪結束」觸發，完成與否由一個獨立的評估模型判斷，不是做工作本身的那個模型說了算。

幾個使用要點（依官方文件）：

一個 session 只能有一個 active goal。/goal 不帶參數看狀態（跑了多久、評估了幾輪、token 花費），/goal clear 取消（stop / off / reset / none / cancel 都是別名），/clear 開新對話也會一併清掉
條件最多 4,000 字元，要寫成 Claude 的對話輸出能證明的形式——評估模型自己不跑指令、不讀檔案，只看 transcript。「test/auth 的測試全過」有效，因為 Claude 跑完測試，結果就在對話裡
想限制跑多久，把條款寫進條件，例如 or stop after 20 turns
本質上是 session-scoped 的 prompt-based Stop hook 包裝，所以 hooks 被關閉或 workspace trust 未建立時會連帶停用
goal 在 session 結束時還 active 的話，--resume / --continue 會把它還原回來
非互動模式也能用：claude -p "/goal ..." 會一路跑到完成或清除，配 --output-format stream-json --verbose 才看得到進度

注意：設 goal 不會改變權限模式。要讓它無人值守地跑，搭配 auto mode 使用；Manual mode 下該問的工具呼叫還是會問。

整體來說

Routines 把 Claude Code 從「你問它答」的互動模式，變成了「設定好就自己跑」的自動化系統。

最大的心態轉變是：你不再需要坐在電腦前等 AI 做事。 寫好 prompt，掛上 trigger，AI 就變成一個全天候運行的開發者。從「寫 code 的人」變成「設計工作流程的人」。

而且現在不只是「定時跑」這一種——把告警接 API trigger、把 PR 開啟接 GitHub trigger，AI 就能在事件發生的當下立刻動作。

從簡單的開始：每天早上自動 review 前一天的 PR、每週跑一次 dependency audit。確認穩定了，再接 GitHub trigger 把 PR review 自動化、再接 API trigger 把告警自動 triage。

參考資料

更新紀錄

2026-08-27：補 Web 表單實測（草擬入口、模板、Behavior／Notifications 分頁）＋實際建立與跑一次的觀察（repo 清單、connector 時序、通知判斷）。
2026-08-26：刷新事實＋補 goal mode／與實作篇互鏈。