載入中

排程任務與無頭模式

第 6 課7 分鐘
載入中

排程任務與無頭模式

一旦您信任 Claude 能夠完成某項任務,下一步就是停止手動執行它。如果是相同的提示在重複觸發器上執行,您不應該每次都坐在那裡自己啟動它。本課程涵蓋兩種交接這項工作的方式:雲端排程任務(以前稱為例行程序,routines),您完全不需要建構任何東西;以及無頭模式,您可以從自己的腳本中獲得完全的控制權。

把它想像成一個光譜。一端是在 Anthropic 的託管基礎設施上執行的雲端排程任務。另一端則是無頭模式和 Agent SDK,它們從您自己的程式碼中執行 Claude Code。讓我們從建構最少的那一端開始。

排程任務:在雲端執行的已儲存提示

雲端排程任務是自動化重複性工作最直接的方式。不需要腳本,也不需要伺服器。它將三件事綁在一起:一個提示、它所操作的儲存庫,以及它所需的任何連接器。然後,每當被觸發時,它就會在雲端執行該組合。

關鍵在於基礎設施是 Anthropic 的。您不需要讓自己的機器整夜開著,也沒有工作流程檔案需要您維護。您只需描述一次工作,它就會自動執行。

排程任務不一定需要排程。它可以在幾種觸發器上啟動:

  • 一個 cron 排程,例如每天早上 9 點。
  • 對其 API 端點發出 HTTP POST 請求,讓您自己的程式碼可以啟動它。
  • 一個 GitHub 事件,例如新的 pull request 建立。

任何在重複觸發器上使用相同提示的工作都很適合。例如早晨的依賴項稽核、在新的 pull request 出現時啟動的 PR 分類器,或是每日掃描您的 Sentry 工單以找出最緊急事項。

以下是排程任務將哪些元素綁在一起的心智模型:提示、儲存庫、連接器和觸發器。

建立排程任務的兩種方式

您可以在網頁 claude.ai/code/routines 上建立排程任務。您為它命名、撰寫描述 Claude 在每個工作階段中應執行內容的指示、選擇儲存庫,並選擇觸發器。

您也可以在 Claude Code 內建立排程任務,而無需離開終端機。只需執行 /schedule 指令,並用淺顯易懂的語言描述您想要的內容,例如:

/schedule daily dependency audit at 9am

無論從哪個入口點進入,概念都是一樣的。選擇最適合您工作流程的方式即可。

在依賴雲端排程任務之前要知道的三件事

在您將任何重要事項交由雲端排程任務處理之前,請牢記以下三項限制。

  • 雲端排程任務目前為研究預覽版。 行為和限制將持續變動,因此若有任何變化也請不要感到意外。
  • 重複排程最多每小時執行一次。 如果您需要更頻繁的執行,雲端排程任務並不是合適的工具。
  • 執行會從您預設分支的全新複本開始,並推送到 claude/ 分支,除非您的提示指定了其他分支。 當 GitHub pull request 事件觸發執行時,pull request 的儲存庫會改為從該 pull request 的 head commit 開始,前提是它是排程任務中的第一個儲存庫。若要控制執行可以推送到哪些分支,請在 GitHub 上使用分支保護規則或規則集。GitHub 會將這些規則套用到您所連接的 GitHub 存取權限,因此如果您的存取權限可以繞過某條規則,該規則就不會阻擋推送。

無頭模式:當您需要自己的環境時

當工作可以在 Anthropic 的基礎設施上執行時,雲端排程任務非常實用。但有時工作需要您自己的環境,或需要在執行周圍包裹一些邏輯。這時您就該改用無頭模式,文件現在將其稱為非互動模式。

無頭模式的核心是 -p 旗標(--print 的縮寫)。它會將 Claude Code 作為一次性指令執行,沒有互動式使用者介面。它讀取標準輸入並寫入標準輸出,因此可以像任何其他 shell 工具一樣進行管線串接:

claude -p "summarize the changes in this diff"

有一點值得注意:單獨使用時,-p 會載入與互動式工作階段相同的上下文,包括 hooks、skills、plugins、MCP 伺服器和 CLAUDE.md 檔案。若要跳過這一切,請加上 --bare,詳見下文說明。

取得結構化輸出

由於無頭模式可以像任何 shell 工具一樣進行管線串接,您通常會希望取得結構化資料而不是散文文字。您可以將 JSON schema 與 JSON 輸出格式搭配使用,Claude 將限制其輸出以符合您的 schema。

符合您 schema 的物件會出現在 JSON 回應的 structured_output 欄位中。因此您可以使用 jq 指令將其取出,並透過管線傳入資料庫或另一個腳本:

bash
claude -p "Extract the exported function names from src/core/style.js" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}' \
  | jq '.structured_output.functions'

這會讓您取得一個乾淨的陣列,可以交給後續任何流程處理。

使用工作階段進行多步驟自動化

對於跨多個步驟進行的工作,您不必把所有內容塞進一個指令中。從 JSON 輸出中擷取工作階段 ID,稍後再繼續該工作階段:

claude --resume "$(jq -r .session_id /tmp/plan.json)"

一個腳本啟動工作,另一個腳本稍後帶著完整的上下文繼續該工作。當第一輪產生一份計畫、第二輪負責執行時,這種方式就非常方便。

CI 的一致性執行

當 CI 需要在每台機器上都有相同的設定時,有一種模式正是為此而生。

--bare 旗標會跳過 hooks、skills、plugins、MCP 伺服器和 CLAUDE.md 檔案的自動探索。您會得到具備 Bash、檔案讀取和檔案編輯工具的 Claude,再加上您透過 --settings 或 --mcp-config 等旗標傳入的任何內容。因此每台機器都會從相同的設定開始,啟動速度也更快。Bare 模式不使用您的訂閱登入,因此請先設定 ANTHROPIC_API_KEY。

Agent SDK:將 Claude Code 嵌入您自己的應用程式

光譜上的最後一步是 Agent SDK。它提供一個函式庫,可將 Claude Code 嵌入您自己的 TypeScript 或 Python 應用程式中。

這兩種語言都提供了 query 函式,以及與 CLI 相同的基本元件。您傳入一個提示加上一些選項,例如:

  • allowedTools,用來控制 Claude 能做什麼,
  • 系統提示,
  • 以及權限模式。

接著您可以逐一處理 Claude 串流回傳的訊息,並依照您應用程式的需求來處理它們。這與 CLI 使用的是相同的引擎,只是可以從您的產品內部呼叫。

您應該選擇哪一種?

以下是快速決策指南:

  • 雲端排程任務是重複性工作的預設選擇。它們在 Anthropic 的基礎設施上執行,您無需託管任何東西。
  • 搭配 -p 的無頭模式適用於工作需要您的管線,且您想透過腳本傳遞資料的情況。
  • --bare 適用於 CI 需要在每台機器上都有相同設定的情況。
  • Agent SDK 適用於工作需要內嵌在您自己產品內部的情況。

從雲端排程任務開始。只有在工作需要額外控制時,才沿著光譜向下移動。