核心概念

Claude Code Routines 是 Anthropic 於 2026 年 4 月推出的雲端自動化功能(research preview),讓使用者將 prompt、repository 與 MCP connectors 打包成一個可重複執行的配置,由 Anthropic 託管的雲端基礎設施自動執行。關鍵特性是筆電關閉後仍持續運作——不再受限於本機 session 生命週期。

每個 Routine 支援三種觸發方式,且可混合使用:

  • Schedule(排程):按週期執行(每小時、每日、工作日、每週),最小間隔一小時,支援自訂 cron 表達式
  • API:提供專屬 HTTP POST endpoint + bearer token,可被監控系統、部署 pipeline、內部工具觸發
  • GitHub:回應 repository 事件(Pull Request 開啟/關閉/標籤、Release 發布等),支援欄位級篩選器

Routine 的執行環境是完整的 Claude Code 雲端 session——沒有權限確認對話框,Agent 自主決定如何達成 prompt 目標。這與傳統 CI/CD script 根本不同:script 定義步驟,Routine 定義目標。

關鍵要點

  • Cloud Environment 三要素:網路存取層級、環境變數(API keys / secrets)、setup script(安裝依賴),在建立 Routine 前需先配置
  • 分支安全:預設只能 push 到 claude/ 前綴分支,避免 Routine 意外修改 protected branch;可針對特定 repo 開啟不限制模式
  • Connectors 預設全開:建立時所有已連接的 MCP connector(Slack、Linear、Google Drive 等)自動納入,應移除不需要的以限縮 Agent 權限——這呼應最小權限原則
  • GitHub 觸發器篩選:支援 author、title、body、base/head branch、labels、is draft、is merged、from fork 等欄位,搭配 equals / contains / regex 等運算子
  • 每日執行上限:Pro 5 次、Max 15 次、Team/Enterprise 25 次(與互動 session 共用配額),超額需啟用 extra usage 計費

API 觸發範例

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

成功回傳 claude_code_session_id 與 session URL,可即時觀看執行過程。

實務應用

場景 觸發方式 做什麼
Backlog 整理 Schedule(每晚) 讀 issue tracker → 標籤 + 指派 → Slack 摘要
Alert 分診 API(監控系統呼叫) 讀 stack trace → 關聯 commit → 開 draft PR
客製 Code Review GitHub(PR opened) 依團隊 checklist 逐條審查 → inline 留言
部署驗證 API(CD pipeline 呼叫) smoke test → 錯誤掃描 → 發 go/no-go 到 release channel
文件漂移偵測 Schedule(每週) 掃已合併 PR → 找過時文件 → 開更新 PR

建立方式:Web(claude.ai/code/routines)、CLI(/schedule)、Desktop app(New remote task)三處同步。CLI 目前僅支援 schedule trigger,API 和 GitHub trigger 需在 Web UI 設定。

延伸觀點

Routines 的出現代表 AI 編碼工具從「互動式助手」正式進入「自主 Agent 排程」時代。多個來源交叉驗證出一個清晰的四層自動化光譜:

  1. /loop(session 內):最輕量,適合開發中的短期輪詢,session 關閉即消失
  2. Desktop Tasks(本機排程):可存取本地檔案與瀏覽器設定,但需機器持續運行
  3. Routines(雲端排程):不依賴本機,支援三種觸發方式,適合無人值守的跨 repo 操作
  4. GitHub Actions(CI/CD 原生):audit log 留在 repo,適合 build gate 與測試自動化

選擇依據的核心軸線是執行環境的所有權:「如果任務依賴本機資源,就讓本機擁有自動化;如果任務只需 repo 和外部服務,就讓雲端接管。」

2026 年 Agentic Coding 的更廣趨勢指向顯式狀態機架構(INTENT → SPEC → PLAN → IMPLEMENT → VERIFY → REVIEW → RELEASE),Harness 負責銜接各階段的確定性驗證閘門。Routines 在此框架中扮演 MONITOR 和 ITERATE 階段的自動化執行器,讓開發者從「逐行寫 code」轉型為「指揮 Agent 團隊」的角色——但前提是具備規格撰寫與輸出審核的能力。

反向連結

以下頁面引用了本頁: