4 4
5# 使用例行程序自動化工作5# 使用例行程序自動化工作
6 6
7> 讓 Claude Code 自動運行。定義在排程上運行、在 API 呼叫時觸發或對來自 Anthropic 管理的雲端基礎設施的 GitHub 事件做出反應的例行程序。7> 讓 Claude Code 自動運行。定義在排程上運行、在 API 呼叫時觸發或對來自雲端基礎設施的 GitHub 事件做出反應的例行程序。
8 8
9<Note>9<Note>
10 例行程序處於研究預覽階段。行為、限制和 API 表面可能會變更。10 例行程序處於研究預覽階段。行為、限制和 API 表面可能會變更。
11</Note>11</Note>
12 12
13例行程序是一個已保存的 Claude Code 配置:一個提示、一個或多個存儲庫,以及一組 [connectors](/zh-TW/mcp),打包一次並自動運行。例行程序在 Anthropic 管理的雲端基礎設施上執行,因此當您的筆記本電腦關閉時它們仍會繼續運行。13例行程序是一個已保存的 Claude Code 設定:一個提示、一個或多個存儲庫,以及一組 [connectors](/docs/zh-TW/mcp),打包一次並自動運行。例行程序在 Anthropic 管理的雲端基礎設施上執行,或在您組織的 [自託管環境](/docs/zh-TW/self-hosted-environments) 上執行(當路由到該處時),因此當您的筆記本電腦關閉時它們仍會繼續運行。
14 14
15每個例行程序可以附加一個或多個觸發器:15每個例行程序可以附加一個或多個觸發器:
16 16
20 20
21單個例行程序可以組合觸發器。例如,PR 審查例行程序可以每晚運行、從部署腳本觸發,也可以對每個新 PR 做出反應。21單個例行程序可以組合觸發器。例如,PR 審查例行程序可以每晚運行、從部署腳本觸發,也可以對每個新 PR 做出反應。
22 22
23例行程序在啟用了 [Claude Code on the web](/zh-TW/claude-code-on-the-web) 的 Pro、Max、Team 和 Enterprise 計劃上可用。在 [claude.ai/code/routines](https://claude.ai/code/routines) 創建和管理它們,或使用 CLI 中的 `/schedule` 命令。23例行程序在 Pro、Max、Team 和 Enterprise 計劃上可用。在 [claude.ai/code/routines](https://claude.ai/code/routines) 創建和管理它們,或使用 CLI 中的 `/schedule` 命令。
24 24
25Team 和 Enterprise 管理員可以在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 的例行程序切換中為所有成員禁用例行程序。禁用後,現有例行程序停止運行,成員無法創建新的。25Team 和 Enterprise 擁有者可以在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 的例行程序切換中為所有成員禁用例行程序。禁用後,現有例行程序停止運行,成員無法創建新的。
26 26
27本頁涵蓋創建例行程序、配置每種觸發器類型、管理運行以及使用限制如何應用。27本頁涵蓋創建例行程序、設定每種觸發器類型、管理運行以及使用限制如何應用。
28 28
29<h2 id="example-use-cases">29<h2 id="example-use-cases">
30 示例用例30 示例用例
32 32
33每個示例將觸發器類型與例行程序適合的工作類型配對:無人值守、可重複且與明確結果相關。33每個示例將觸發器類型與例行程序適合的工作類型配對:無人值守、可重複且與明確結果相關。
34 34
35**待辦事項維護。** 排程觸發器每個工作日晚上針對您的問題跟蹤器通過 connector 運行。例行程序讀取自上次運行以來打開的問題、應用標籤、根據引用的代碼區域分配所有者,並將摘要發佈到 Slack,以便團隊以整理好的隊列開始新的一天。35**待辦事項維護。** 排程觸發器每個工作日晚上針對您的問題追蹤器通過 connector 運行。例行程序讀取自上次運行以來打開的問題、應用標籤、根據引用的代碼區域分配所有者,並將摘要發佈到 Slack,以便團隊以整理好的隊列開始新的一天。
36 36
37**警報分類。** 您的監控工具在錯誤閾值被超過時調用例行程序的 API 端點,將警報正文作為 `text` 傳遞。例行程序提取堆棧跟蹤、將其與存儲庫中的最近提交相關聯,並打開一個帶有建議修復和返回警報鏈接的草稿拉取請求。值班人員審查 PR 而不是從空白終端開始。37**警報分類。** 您的監控工具在錯誤閾值被超過時調用例行程序的 API 端點,將警報正文作為 `text` 傳遞。例行程序的提示告訴 Claude 調查警報中的火警負載,因此它提取堆棧追蹤、將其與存儲庫中的最近提交相關聯,並打開一個帶有建議修復和返回警報鏈接的草稿拉取請求。值班人員審查 PR 而不是從空白終端開始。
38 38
39**定製代碼審查。** GitHub 觸發器在 `pull_request.opened` 上運行。例行程序應用您團隊自己的審查檢查清單,為安全性、性能和風格問題留下內聯評論,並添加摘要評論,以便人工審查者可以專注於設計而不是機械檢查。39**定製代碼審查。** GitHub 觸發器在 `pull_request.opened` 上運行。例行程序應用您團隊自己的審查檢查清單,為安全性、性能和風格問題留下內聯評論,並添加摘要評論,以便人工審查者可以專注於設計而不是機械檢查。
40 40
41**部署驗證。** 您的 CD 管道在每次生產部署後調用例行程序的 API 端點。例行程序針對新構建運行煙霧測試、掃描錯誤日誌以查找回歸,並在部署窗口關閉前向發佈頻道發佈是否可以部署。41**部署驗證。** 您的 CD 管道在每次生產部署後調用例行程序的 API 端點。例行程序針對新構建運行煙霧測試、掃描錯誤日誌以查找回歸,並在部署窗口關閉前向發佈頻道發佈是否可以部署。
42 42
43**文檔漂移。** 排程觸發器每週運行。例行程序掃描自上次運行以來合併的 PR、標記引用已更改 API 的文檔,並針對文檔存儲庫打開更新 PR 供編輯者審查。43**文件漂移。** 排程觸發器每週運行。例行程序掃描自上次運行以來合併的 PR、標記引用已更改 API 的文件,並針對文件存儲庫打開更新 PR 供編輯者審查。
44 44
45**庫移植。** GitHub 觸發器在 `pull_request.closed` 上運行,篩選為一個 SDK 存儲庫中的合併 PR。例行程序將更改移植到另一種語言的並行 SDK,並打開匹配的 PR,使兩個庫保持同步,而無需人工重新實現每個更改。45**庫移植。** GitHub 觸發器在 `pull_request.closed` 上運行,篩選為一個 SDK 存儲庫中的合併 PR。例行程序將更改移植到另一種語言的並行 SDK,並打開匹配的 PR,使兩個庫保持同步,而無需人工重新實現每個更改。
46 46
47下面的部分將逐步介紹創建例行程序和配置每種觸發器類型。
48
49<h2 id="create-a-routine">47<h2 id="create-a-routine">
50 創建例行程序48 建立例行工作
51</h2>49</h2>
52 50
53從 Web 的 [claude.ai/code/routines](https://claude.ai/code/routines)、Desktop 應用或 CLI 創建例行程序。所有三個界面都寫入同一個雲帳戶,因此您在其中一個創建的例行程序會立即顯示在其他界面中。在 Desktop 應用中,點擊側邊欄中的 **Routines**,然後點擊 **New routine**,並選擇 **Remote**;選擇 **Local** 會創建一個 [Desktop scheduled task](/zh-TW/desktop-scheduled-tasks),它在您的機器上運行,而不是在雲中運行。51在 [claude.ai/code/routines](https://claude.ai/code/routines) 網頁、Desktop 應用程式或 CLI 中建立例行工作。這三個介面都會寫入同一個雲端帳戶,因此您在其中一個介面建立的例行工作會立即出現在其他介面中。在 Desktop 應用程式的 **Code** 標籤中,按一下側邊欄或側邊欄的 **More** 選單中的 **Routines**,然後按 **New routine**,並選擇 **Cloud**;選擇 **Local** 則會建立 [Desktop 排程工作](/docs/zh-TW/desktop-scheduled-tasks),該工作在您的機器上執行,而不是在雲端執行。
54 52
55創建表單設置例行程序的提示、存儲庫、環境、connectors 和觸發器。53建立表單會設定例行工作的提示、儲存庫、環境、連接器和觸發器。
56 54
57例行程序作為完整的 Claude Code 雲會話自主運行:沒有權限模式選擇器,運行期間也沒有批准提示。會話可以運行 shell 命令、使用 [skills](/zh-TW/skills) 提交到克隆的存儲庫,並調用您包含的任何 connectors。例行程序可以到達的內容由您選擇的存儲庫及其分支推送設置、[環境的](/zh-TW/claude-code-on-the-web#the-cloud-environment)網絡訪問和變量,以及您包含的 connectors 決定。將每個範圍限制在例行程序實際需要的內容。55例行工作以完整的 Claude Code 雲端工作階段自主執行:執行期間沒有權限模式選擇器,也沒有核准提示。工作階段可以執行 shell 命令、使用 [skills](/docs/zh-TW/skills) 提交到複製的儲存庫,以及呼叫您包含的任何連接器。例行工作可以存取的內容由您選擇的儲存庫、[環境](/docs/zh-TW/cloud-environments)的網路存取和變數,以及您包含的連接器決定。將這些範圍限制在例行工作實際需要的內容。
58 56
59例行程序屬於您的個人 claude.ai 帳戶。它們不與隊友共享,並且計入您帳戶的每日運行配額。例行程序通過您連接的 GitHub 身份或 connectors 執行的任何操作都顯示為您:提交和拉取請求帶有您的 GitHub 用戶,Slack 消息、Linear 票證或其他 connector 操作使用您為這些服務鏈接的帳戶。57例行工作屬於您的個人 claude.ai 帳戶。它們不會與隊友共享,並且會計入您帳戶的每日執行配額。例行工作透過您連接的 GitHub 身分或連接器執行的任何操作都會顯示為您:提交和拉取請求會帶有您的 GitHub 使用者,Slack 訊息、Linear 票證或其他連接器操作會使用您為這些服務連接的帳戶。
60 58
61<h3 id="create-from-the-web">59<h3 id="create-from-the-web">
62 從 Web 創建60 從網頁建立
63</h3>61</h3>
64 62
65<Steps>63<Steps>
66 <Step title="打開創建表單">64 <Step title="開啟建立表單">
67 訪問 [claude.ai/code/routines](https://claude.ai/code/routines) 並點擊 **New routine**。65 造訪 [claude.ai/code/routines](https://claude.ai/code/routines) 並按一下 **New routine**。
68 </Step>66 </Step>
69 67
70 <Step title="命名例行程序並編寫提示">68 <Step title="命名例行工作並撰寫提示">
71 給例行程序一個描述性名稱並編寫 Claude 每次運行的提示。提示是最重要的部分:例行程序自主運行,因此提示必須是自包含的,並明確說明要做什麼以及成功是什麼樣子。69 為例行工作提供描述性名稱,並撰寫 Claude 每次執行的提示。提示是最重要的部分:例行工作自主執行,因此提示必須是自成一體的,並明確說明要做什麼以及成功的樣子。
70
71 當觸發器觸發時,工作階段會收到例行工作的已儲存提示作為其指派的工作,並執行它,而不是將其視為在對話中途到達的不受信任的內容。觸發器只證明提示是由您帳戶上的授權工作階段提前儲存的,因此觸發的提示不是即時使用者輸入,無法作為執行期間操作的核准或同意。工作階段在執行期間擷取的內容保持其正常處理。在 v2.1.213 之前,工作階段收到的提示被框架化為不受信任的背景通知,可能會拒絕對其採取行動。
72 72
73 提示輸入包括一個模型選擇器。Claude 在每次運行時使用選定的模型。73 提示輸入包括模型選擇器。Claude 在每次執行時都會使用選定的模型。
74 </Step>74 </Step>
75 75
76 <Step title="選擇存儲庫">76 <Step title="選擇儲存庫">
77 添加一個或多個 GitHub 存儲庫供 Claude 在其中工作。每個存儲庫在運行開始時從默認分支克隆。Claude 為其更改創建 `claude/` 前綴的分支。77 為 Claude 新增一個或多個 GitHub 儲存庫以在其中工作。每個儲存庫在執行開始時會從預設分支複製。Claude 為其變更建立 `claude/` 前綴分支。
78 </Step>78 </Step>
79 79
80 <Step title="選擇環境">80 <Step title="選擇環境">
81 為例行程序選擇一個 [cloud environment](/zh-TW/claude-code-on-the-web#the-cloud-environment)。環境控制雲會話可以訪問的內容:81 為例行工作選擇 [雲端環境](/docs/zh-TW/cloud-environments)。環境控制雲端工作階段可以存取的內容:
82 82
83 * **Network access**:設置每次運行期間可用的互聯網訪問級別83 * **網路存取**:設定每次執行期間可用的網際網路存取層級
84 * **Environment variables**:提供 API 密鑰、令牌或其他 Claude 可以使用的機密84 * **環境變數**:提供 Claude 在每次執行期間可以使用的值。它們[對使用環境的任何人都可見](/docs/zh-TW/cloud-environments#what-carries-over-from-your-setup),因此在 Pro 和 Max 方案上,將 Claude 在執行期間呼叫的 API 金鑰儲存為 [API 認證](/docs/zh-TW/cloud-environments#add-api-credentials)。該部分也列出了永遠不會獲得認證的請求
85 * **Setup script**:安裝例行程序需要的依賴項和工具。結果是 [cached](/zh-TW/claude-code-on-the-web#environment-caching),因此腳本不會在每個會話上重新運行85 * **設定指令碼**:安裝例行工作需要的相依性和工具。結果會被[快取](/docs/zh-TW/cloud-environments#environment-caching),因此指令碼不會在每個工作階段上重新執行
86 86
87 提供了一個 **Default** 環境,具有 **Trusted** 網絡訪問,允許 [default set](/zh-TW/claude-code-on-the-web#default-allowed-domains) 的包註冊表、雲提供商 API、容器註冊表和常見開發域,但阻止其他所有內容。如果您的例行程序需要到達您自己的服務或該列表之外的域,請在運行前編輯環境的 [network access](/zh-TW/claude-code-on-the-web#network-access)。要使用單獨的環境,請先 [create one](/zh-TW/claude-code-on-the-web#configure-your-environment)。87 提供了 **Default** 環境,具有 **Trusted** 網路存取,僅允許[預設允許清單](/docs/zh-TW/cloud-environments#default-allowed-domains)中的套件登錄、雲端提供者 API、容器登錄和常見開發網域透過工作階段的網路。您新增到例行工作的連接器透過 Anthropic 的伺服器存取其服務,因此不需要允許清單變更。如果您的例行工作需要直接存取您自己的服務或該清單外的網域,請在執行前編輯環境的[網路存取](/docs/zh-TW/cloud-environments#network-access)。若要使用單獨的環境,請[先建立一個](/docs/zh-TW/cloud-environments#configure-your-environment)。
88 </Step>88 </Step>
89 89
90 <Step title="選擇觸發器">90 <Step title="選擇觸發器">
91 在 **Select a trigger** 下,選擇例行程序如何啟動。您可以選擇一種觸發器類型或組合多種。91 在 **Select a trigger** 下,選擇例行工作的啟動方式。您可以選擇一個觸發器類型或組合多個。
92 92
93 <Tabs>93 <Tabs>
94 <Tab title="Schedule">94 <Tab title="Schedule">
95 選擇預設頻率進行定期運行,或在特定時間戳安排一次性運行。有關時區處理、交錯、自定義 cron 間隔和一次性運行,請參閱 [Add a schedule trigger](#add-a-schedule-trigger)。95 為重複執行選擇預設頻率,或在特定時間戳記排程單次一次性執行。請參閱[新增排程觸發器](#add-a-schedule-trigger)以了解時區處理、交錯、自訂 cron 間隔和一次性執行。
96 </Tab>96 </Tab>
97 97
98 <Tab title="GitHub event">98 <Tab title="GitHub event">
99 選擇存儲庫、要反應的事件和可選篩選器。有關支持的事件和篩選字段的完整列表,請參閱 [Add a GitHub trigger](#add-a-github-trigger)。99 選擇儲存庫、要反應的事件和選擇性篩選器。請參閱[新增 GitHub 觸發器](#add-a-github-trigger)以取得支援事件和篩選欄位的完整清單。
100 </Tab>100 </Tab>
101 101
102 <Tab title="API">102 <Tab title="API">
103 在此選擇 **API**,然後保存例行程序。URL 和令牌在保存例行程序後生成,因為它們取決於例行程序 ID。請參閱 [Add an API trigger](#add-an-api-trigger) 以複製 URL 並生成令牌。103 在此選擇 **API**,然後儲存例行工作。URL 和權杖在儲存例行工作後產生,因為它們取決於例行工作 ID。請參閱[新增 API 觸發器](#add-an-api-trigger)以複製 URL 並產生權杖。
104 </Tab>104 </Tab>
105 </Tabs>105 </Tabs>
106 </Step>106 </Step>
107 107
108 <Step title="審查 connectors 和權限">108 <Step title="檢閱連接器">
109 表單底部的 **Connectors** 和 **Permissions** 選項卡控制例行程序可以到達的內容。109 在表單底部的 **Connectors** 下,預設包括您所有連接的 [MCP 連接器](/docs/zh-TW/mcp)。移除例行工作不需要的任何連接器:Claude 可以使用包含連接器的每個工具,包括寫入,而無需在執行期間要求權限。
110
111 在 Connectors 下,默認情況下包括您所有連接的 [MCP connectors](/zh-TW/mcp)。移除例行程序不需要的任何。Claude 可以使用包含的 connector 中的每個工具,包括寫入,無需在運行期間請求權限。
112
113 在 Permissions 下,為任何 Claude 應該能夠推送到現有分支而不是僅 `claude/` 前綴分支的存儲庫啟用 **Allow unrestricted branch pushes**。
114 </Step>110 </Step>
115 111
116 <Step title="創建例行程序">112 <Step title="建立例行工作">
117 點擊 **Create**。例行程序出現在列表中,並在下次其觸發器之一匹配時運行。要立即開始運行,請在例行程序的詳細信息頁面上點擊 **Run now**。113 按一下 **Create**。例行工作出現在清單中,並在下次其觸發器之一符合時執行。若要立即開始執行,請按一下例行工作詳細資料頁面上的 **Run now**。
118 114
119 每次運行都會在您的其他會話旁邊創建一個新會話,您可以在其中查看 Claude 做了什麼、審查更改並創建拉取請求。115 每次執行都會在您的其他工作階段旁邊建立新的工作階段,您可以在其中查看 Claude 執行的操作、檢閱變更並建立拉取請求。
120 </Step>116 </Step>
121</Steps>117</Steps>
122 118
123<h3 id="create-from-the-cli">119<h3 id="create-from-the-cli">
124 從 CLI 創建120 從 CLI 建立
125</h3>121</h3>
126 122
127在任何會話中運行 `/schedule` 以對話方式創建排程例行程序。您也可以直接傳遞描述,例如定期例行程序如 `/schedule daily PR review at 9am` 或一次性例行程序如 `/schedule clean up feature flag in one week`。Claude 會逐步介紹 Web 表單收集的相同信息,然後將例行程序保存到您的帳戶。123在任何工作階段中執行 `/schedule` 以對話方式建立排程例行工作。您也可以直接傳遞描述,用於重複例行工作,例如 `/schedule daily PR review at 9am` 或一次性例行工作,例如 `/schedule clean up feature flag in one week`。Claude 會逐步執行網頁表單收集的相同資訊,然後將例行工作儲存到您的帳戶。該命令也可在別名 `/routines` 下使用。
128 124
129成功開始看起來像一次對話:Claude 在保存前詢問有關計劃、存儲庫和提示的後續問題。如果 Claude 改為回覆您需要進行身份驗證或無法連接到您的遠程 claude.ai 帳戶,則未創建例行程序;請參閱 [Troubleshooting](#troubleshooting)。125成功的開始看起來像一次對話:Claude 在儲存前詢問有關排程、儲存庫和提示的後續問題。如果 Claude 改為回覆您需要驗證或無法連接到您的遠端 claude.ai 帳戶,則未建立例行工作;請參閱[疑難排解](#troubleshooting)。
130 126
131CLI 中的 `/schedule` 僅創建排程例行程序。要添加 API 或 GitHub 觸發器,請在 [claude.ai/code/routines](https://claude.ai/code/routines) 的 Web 上編輯例行程序。127CLI 中的 `/schedule` 建立排程例行工作。若要新增 API 觸發器,請在 [claude.ai/code/routines](https://claude.ai/code/routines) 的網頁上編輯例行工作。您可以從網頁或 CLI 新增 [GitHub 觸發器](#add-a-github-trigger)。CLI 路徑需要 Claude Code v2.1.225 或更新版本。
132 128
133CLI 還支持管理現有例行程序。運行 `/schedule list` 查看所有例行程序,`/schedule update` 更改一個,或 `/schedule run` 立即觸發它。129沒有排程觸發器的例行工作,例如僅由 API 呼叫或 GitHub 事件啟動的例行工作,沒有下次執行時間,Claude 儲存或更新它時 CLI 不會顯示任何時間。在 v2.1.211 之前,CLI 為這些例行工作報告了第 1 年的下次執行時間。
134 130
135<h2 id="configure-triggers">131<h2 id="configure-triggers">
136 配置觸發器132 設定觸發條件
137</h2>133</h2>
138 134
139當其觸發器之一匹配時,例行程序啟動。您可以將排程、API 和 GitHub 觸發器的任何組合附加到同一例行程序,並可以隨時從例行程序編輯表單的 **Select a trigger** 部分添加或移除它們。135當其中一個觸發條件符合時,例行工作就會啟動。您可以將任何組合的排程、API 和 GitHub 觸發條件附加到同一個例行工作,並可以隨時從例行工作編輯表單的 **Select a trigger** 部分新增或移除它們。
140 136
141<h3 id="add-a-schedule-trigger">137<h3 id="add-a-schedule-trigger">
142 添加排程觸發器138 新增排程觸發條件
143</h3>139</h3>
144 140
145排程觸發器按定期節奏運行例行程序,或在特定的未來時間運行一次。在 **Select a trigger** 部分中選擇預設頻率:每小時、每天、工作日或每週。時間以您的本地時區輸入並自動轉換,因此例行程序在該掛鐘時間運行,無論雲端基礎設施位於何處。141排程觸發條件會按照循環週期執行例行工作,或在特定的未來時間執行一次。在 **Select a trigger** 部分選擇預設頻率:每小時、每天、工作日或每週。時間以您的本地時區輸入並自動轉換,因此無論雲端基礎設施位於何處,例行工作都會在該掛鐘時間執行。
146 142
147運行可能在排程時間後幾分鐘開始,原因是交錯。每個例行程序的偏移是一致的。143執行可能會在排程時間之後幾分鐘開始,原因是錯開。每個例行工作的偏移量是一致的。
148 144
149對於自定義間隔,例如每兩小時或每月的第一天,在表單中選擇最接近的預設,然後在 CLI 中運行 `/schedule update` 以設置特定的 cron 表達式。最小間隔是一小時;運行頻率更高的表達式會被拒絕。145對於自訂間隔(例如每兩小時或每月的第一天),請在表單中選擇最接近的預設,然後在 CLI 中執行 `/schedule update` 以設定特定的 cron 表達式。最小間隔是一小時;執行頻率更高的表達式會被拒絕。
150 146
151<h4 id="schedule-a-one-off-run">147<h4 id="schedule-a-one-off-run">
152 排程一次性運行148 排程一次性執行
153</h4>149</h4>
154 150
155一次性排程在特定時間戳處觸發例行程序一次。使用它來提醒自己本週稍後、在推出完成後打開清理 PR,或在上游更改到達時啟動後續任務。例行程序觸發後,它會自動禁用,Web UI 將其標記為 **Ran**。要再次運行它,編輯例行程序並設置新的一次性時間。151一次性排程會在特定時間戳記時單次執行例行工作。使用它來提醒自己本週稍後、在推出完成後開啟清理 PR,或在上游變更到達時啟動後續工作。例行工作執行後,它會自動停用,網頁 UI 會將其標記為 **Ran**。若要再次執行,請編輯例行工作並設定新的一次性時間。
156 152
157<Note>153從 CLI 透過自然語言描述時間來建立一次性執行。Claude 會根據目前時間解析該短語,並在儲存前確認絕對時間戳記。
158 一次性排程從 CLI 逐步推出,可能在您的帳戶上還不可用。如果 `/schedule` 只提供定期排程,請改為在 [claude.ai/code/routines](https://claude.ai/code/routines) 從 Web 創建一次性運行。
159</Note>
160
161通過在 CLI 中用自然語言描述時間來創建一次性運行。Claude 根據當前時間解析該短語,並在保存前確認絕對時間戳。
162 154
163```text theme={null}155```text theme={null}
164/schedule tomorrow at 9am, summarize yesterday's merged PRs156/schedule tomorrow at 9am, summarize yesterday's merged PRs
168/schedule in 2 weeks, open a cleanup PR that removes the feature flag160/schedule in 2 weeks, open a cleanup PR that removes the feature flag
169```161```
170 162
171與定期排程相同的本地到 UTC 轉換適用於一次性時間戳。163與循環排程相同的本地到 UTC 轉換適用於一次性時間戳記。
172 164
173一次性運行不計入每日例行程序運行上限。它們像任何其他會話一樣消耗您計劃的常規訂閱使用量。有關詳細信息,請參閱 [Usage and limits](#usage-and-limits)。165一次性執行不計入每日例行工作執行上限。詳見 [Usage and limits](#usage-and-limits)。
174 166
175<h3 id="add-an-api-trigger">167<h3 id="add-an-api-trigger">
176 添加 API 觸發器168 新增 API 觸發條件
177</h3>169</h3>
178 170
179API 觸發器為例行程序提供專用的 HTTP 端點。使用例行程序的持有人令牌 POST 到端點會啟動新會話並返回會話 URL。使用此功能將 Claude Code 連接到警報系統、部署管道、內部工具或任何可以進行身份驗證 HTTP 請求的地方。171API 觸發條件為例行工作提供專用的 HTTP 端點。使用例行工作的持有人令牌 POST 到端點會啟動新的工作階段並傳回工作階段 URL。使用此功能將 Claude Code 整合到警報系統、部署管道、內部工具或任何可以進行已驗證 HTTP 請求的地方。
180 172
181API 觸發器從 Web 添加到現有例行程序。CLI 目前無法創建或撤銷令牌。173API 觸發條件從網頁新增到現有例行工作。CLI 目前無法建立或撤銷令牌。
182 174
183<Steps>175<Steps>
184 <Step title="打開例行程序進行編輯">176 <Step title="Open the routine for editing">
185 轉到 [claude.ai/code/routines](https://claude.ai/code/routines),點擊您想通過 API 觸發的例行程序,然後點擊鉛筆圖標打開 **Edit routine**。177 前往 [claude.ai/code/routines](https://claude.ai/code/routines),點擊您想透過 API 觸發的例行工作,然後點擊鉛筆圖示以開啟 **Edit routine**。
186 </Step>178 </Step>
187 179
188 <Step title="添加 API 觸發器">180 <Step title="Add an API trigger">
189 滾動到 **Instructions** 框下方的 **Select a trigger** 部分,點擊 **Add another trigger**,並選擇 **API**。181 捲動到 **Instructions** 方塊下方的 **Select a trigger** 部分,點擊 **Add another trigger**,然後選擇 **API**。
190 </Step>182 </Step>
191 183
192 <Step title="複製 URL 並生成令牌">184 <Step title="Copy the URL and generate a token">
193 模態框顯示此例行程序的 URL 以及示例 curl 命令。複製 URL,然後點擊 **Generate token** 並立即複製令牌。令牌只顯示一次,之後無法檢索,因此請將其存儲在安全的地方,例如您的警報工具的機密存儲。185 模式視窗會顯示此例行工作的 URL 以及範例 curl 命令。複製 URL,然後點擊 **Generate token** 並立即複製令牌。令牌只會顯示一次,之後無法擷取,因此請將其儲存在安全的地方,例如您的警報工具的祕密存放區。
194 </Step>186 </Step>
195 187
196 <Step title="調用端點">188 <Step title="Call the endpoint">
197 POST 到 URL 時在 `Authorization: Bearer` 標頭中發送令牌。下面的 [Trigger a routine](#trigger-a-routine) 部分顯示完整示例。189 當您 POST 到 URL 時,在 `Authorization: Bearer` 標頭中傳送令牌。下方的 [Trigger a routine](#trigger-a-routine) 部分顯示完整範例。
198 </Step>190 </Step>
199</Steps>191</Steps>
200 192
201每個例行程序都有自己的令牌,範圍限於僅觸發該例行程序。要輪換或撤銷它,返回同一模態框並點擊 **Regenerate** 或 **Revoke**。193每個例行工作都有自己的令牌,範圍限制為僅觸發該例行工作。若要輪換或撤銷它,請返回相同的模式視窗並點擊 **Regenerate** 或 **Revoke**。
202 194
203<h4 id="trigger-a-routine">195<h4 id="trigger-a-routine">
204 觸發例行程序196 觸發例行工作
205</h4>197</h4>
206 198
207向 `/fire` 端點發送 POST 請求,在 `Authorization` 標頭中包含持有人令牌。請求正文接受可選的 `text` 字段,用於運行特定的上下文,例如警報正文或失敗的日誌,與其保存的提示一起傳遞給例行程序。該值是自由格式文本,不被解析:如果您發送 JSON 或其他結構化有效負載,例行程序會將其作為文字字符串接收。199將 POST 請求傳送到 `/fire` 端點,並在 `Authorization` 標頭中包含持有人令牌。請求本文接受選用的 `text` 欄位,用於執行特定的內容,例如警報本文或失敗的日誌,與例行工作的已儲存提示一起傳遞給例行工作。該值是自由格式文字,不會被解析:如果您傳送 JSON 或其他結構化承載,例行工作會將其作為字面字串接收。
200
201`text` 值不會作為裸訊息到達例行工作。它會到達並包裝在 `<routine-fire-payload>` 區塊中,該區塊將其標記為不受信任的資料,並告訴 Claude 除非例行工作自己的提示說明,否則不要遵循其中的指示。與網頁 UI 中的 **Run now** 提供的文字相同的包裝也適用。
208 202
209下面的示例從 shell 觸發例行程序。所示的例行程序 ID 和令牌是佔位符:將它們替換為您在 [添加 API 觸發器](#add-an-api-trigger) 時複製的 URL 和令牌,否則請求會失敗並出現 `401` 身份驗證錯誤:203這表示例行工作的已儲存提示必須選擇對觸發文字採取行動:編寫提示以明確參考承載,例如「調查例行工作觸發承載區塊中描述的警報」,或例行工作將文字視為惰性內容。任何持有持有人令牌的人都可以傳送 `text`,因此包裝使得來自洩露令牌的觸發文字到達時被標記為不受信任的資料,而不是作為對您例行工作的直接指示。
204
205下面的範例從 shell 觸發例行工作。顯示的例行工作 ID 和令牌是預留位置:將其替換為您在 [adding the API trigger](#add-an-api-trigger) 時複製的 URL 和令牌,否則請求會失敗並出現 `401` 驗證錯誤:
210 206
211```bash theme={null}207```bash theme={null}
212curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \208curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \
217 -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'213 -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'
218```214```
219 215
220成功的請求返回一個 JSON 正文,包含新的會話 ID 和 URL:216成功的請求會傳回包含新工作階段 ID 和 URL 的 JSON 本文:
221 217
222```json theme={null}218```json theme={null}
223{219{
227}223}
228```224```
229 225
230在瀏覽器中打開會話 URL 以實時觀看運行、審查更改或手動繼續對話。226在瀏覽器中開啟工作階段 URL 以即時觀看執行、檢閱變更或手動繼續對話。
231 227
232<Warning>228<Warning>
233 `/fire` 端點在 `experimental-cc-routine-2026-04-01` beta 標頭下發佈。請求和響應形狀、速率限制和令牌語義可能在功能處於研究預覽階段時變更。破壞性更改在新的日期 beta 標頭版本後發佈,最近的兩個先前標頭版本繼續工作,以便調用者有時間遷移。229 `/fire` 端點在 `experimental-cc-routine-2026-04-01` 測試版標頭下發佈。在功能處於研究預覽期間,請求和回應形狀、速率限制和令牌語義可能會變更。破壞性變更會在新的日期測試版標頭版本後發佈,最近的兩個先前標頭版本會繼續運作,以便呼叫者有時間進行遷移。
234</Warning>230</Warning>
235 231
236<h4 id="api-reference">232<h4 id="api-reference">
237 API 參考233 API 參考
238</h4>234</h4>
239 235
240有關完整的 API 參考,包括所有錯誤響應、驗證規則和字段限制,請參閱 Claude Platform 文檔中的 [Trigger a routine via API](https://platform.claude.com/docs/zh-TW/api/claude-code/routines-fire)。236如需完整的 API 參考,包括所有錯誤回應、驗證規則和欄位限制,請參閱 Claude Platform 文件中的 [Trigger a routine via API](https://platform.claude.com/docs/en/api/claude-code/routines-fire)。
241 237
242`/fire` 端點僅對 claude.ai 用戶可用,不是 Claude Platform API 表面的一部分。238`/fire` 端點僅適用於 claude.ai 使用者,不是 Claude Platform API 表面的一部分。
243 239
244<h3 id="add-a-github-trigger">240<h3 id="add-a-github-trigger">
245 添加 GitHub 觸發器241 新增 GitHub 觸發條件
246</h3>242</h3>
247 243
248GitHub 觸發器在連接的存儲庫上發生匹配事件時自動啟動新會話。每個匹配事件啟動自己的會話。244GitHub 觸發條件會在連線存放庫上發生符合的事件時自動啟動新的工作階段。Claude Code 不會跨事件重複使用工作階段,因此兩個 PR 更新會產生兩個獨立的工作階段。
249 245
250<Note>246<Note>
251 在研究預覽期間,GitHub webhook 事件受每個例行程序和每個帳戶的每小時上限限制。超過限制的事件會被丟棄,直到窗口重置。在 [claude.ai/code/routines](https://claude.ai/code/routines) 查看您當前的限制。247 在研究預覽期間,GitHub webhook 事件受到每個例行工作和每個帳戶的每小時上限限制。超過限制的事件會被捨棄,直到時間視窗重設。在 [claude.ai/code/routines](https://claude.ai/code/routines) 查看您目前的限制。
252</Note>248</Note>
253 249
254GitHub 觸發器僅從 Web UI 配置。250Claude GitHub App 必須安裝在您想訂閱的存放庫上,無論您從哪個表面設定觸發條件。
255 251
256<Steps>252* 從網頁 UI 設定 GitHub 觸發條件,當應用程式遺失時會提示您安裝它。按照下面的步驟在網頁上設定一個。
257 <Step title="打開例行程序進行編輯">253* 從 CLI,先從 [GitHub App page](https://github.com/apps/claude) 安裝應用程式,然後要求 Claude 將 GitHub 觸發條件附加到現有例行工作,例如 `/schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp`。CLI 路徑需要 Claude Code v2.1.225 或更新版本。當 Claude 新增觸發條件時,它會回覆觸發條件觸發的例行工作的連結。
258 轉到 [claude.ai/code/routines](https://claude.ai/code/routines),點擊例行程序,然後點擊鉛筆圖標打開 **Edit routine**。
259 </Step>
260 254
261 <Step title="添加 GitHub 事件觸發器">255<Steps>
262 滾動到 **Select a trigger** 部分,點擊 **Add another trigger**,並選擇 **GitHub event**。256 <Step title="Open the routine for editing">
257 前往 [claude.ai/code/routines](https://claude.ai/code/routines),點擊例行工作,然後點擊鉛筆圖示以開啟 **Edit routine**。
263 </Step>258 </Step>
264 259
265 <Step title="安裝 Claude GitHub App">260 <Step title="Add a GitHub event trigger">
266 Claude GitHub App 必須安裝在您想訂閱的存儲庫上。如果尚未安裝,觸發器設置會提示您安裝它。261 捲動到 **Select a trigger** 部分,點擊 **Add another trigger**,然後選擇 **GitHub event**。
267 262
268 <Note>263 <Note>
269 在 CLI 中運行 `/web-setup` 授予存儲庫訪問權限以進行克隆,但它不安裝 Claude GitHub App,也不啟用 webhook 傳遞。GitHub 觸發器需要安裝 Claude GitHub App,觸發器設置會提示您執行此操作。264 在 CLI 中執行 `/web-setup` 會授予用於複製的存放庫存取權限,但不會安裝 Claude GitHub App,也不會啟用 webhook 傳遞。
270 </Note>265 </Note>
271 </Step>266 </Step>
272 267
273 <Step title="配置觸發器">268 <Step title="Configure the trigger">
274 選擇存儲庫,從 [supported events](#supported-events) 列表中選擇事件,並可選地添加篩選器。保存觸發器。269 選擇存放庫,從 [supported events](#supported-events) 清單中選擇事件,並選擇性地新增篩選條件。儲存觸發條件。
275 </Step>270 </Step>
276</Steps>271</Steps>
277 272
278<h4 id="supported-events">273<h4 id="supported-events">
279 支持的事件274 支援的事件
280</h4>275</h4>
281 276
282GitHub 觸發器可以訂閱以下事件類別之一。在每個類別中,您可以選擇特定操作,例如 `pull_request.opened`,或對類別中的所有操作做出反應。277GitHub 觸發條件可以訂閱以下任一事件類別。在每個類別中,您可以選擇特定的動作,例如 `pull_request.opened`,或對類別中的所有動作做出反應。
283 278
284| 事件 | 觸發時機 |279| Event | Triggers when |
285| :----------- | :------------------------- |280| :----------- | :---------------------------- |
286| Pull request | PR 被打開、關閉、分配、標記、同步或以其他方式更新 |281| Pull request | 當 PR 被開啟、關閉、指派、標記、同步或以其他方式更新時 |
287| Release | 發佈被創建、發佈、編輯或刪除 |282| Release | 當發行版本被建立、發佈、編輯或刪除時 |
288 283
289<h4 id="filter-pull-requests">284<h4 id="filter-pull-requests">
290 篩選拉取請求285 篩選提取請求
291</h4>286</h4>
292 287
293使用篩選器縮小哪些拉取請求啟動新會話。所有篩選條件必須匹配才能觸發例行程序。可用的篩選字段是:288使用篩選條件來縮小哪些提取請求啟動新的工作階段。所有篩選條件都必須符合才能觸發例行工作。可用的篩選欄位為:
294 289
295| 篩選器 | 匹配 |290| Filter | Matches |
296| :---------- | :---------------- |291| :---------- | :------------------ |
297| Author | PR 作者的 GitHub 用戶名 |292| Author | PR 作者的 GitHub 使用者名稱 |
298| Title | PR 標題文本 |293| Title | PR 標題文字 |
299| Body | PR 描述文本 |294| Body | PR 描述文字 |
300| Base branch | PR 目標的分支 |295| Base branch | PR 目標的分支 |
301| Head branch | PR 來自的分支 |296| Head branch | PR 來自的分支 |
302| Labels | 應用於 PR 的標籤 |297| Labels | 套用到 PR 的標籤 |
303| Is draft | PR 是否處於草稿狀態 |298| Is draft | PR 是否處於草稿狀態 |
304| Is merged | PR 是否已合併 |299| Is merged | PR 是否已合併 |
305 300
306每個篩選器將字段與運算符配對:等於、包含、開始於、是其中之一、不是其中之一或匹配正則表達式。301每個篩選條件將欄位與運算子配對:等於、包含、開頭為、是其中之一、不是其中之一或符合 regex。
307 302
308`matches regex` 運算符測試整個字段值,而不是其中的子字符串。要匹配任何包含 `hotfix` 的標題,請寫 `.*hotfix.*`。沒有周圍的 `.*`,篩選器僅匹配完全是 `hotfix` 的標題,前後沒有任何內容。對於不使用正則表達式語法的文字子字符串匹配,請改用 `contains` 運算符。303`matches regex` 運算子測試整個欄位值,而不是其中的子字串。若要符合任何包含 `hotfix` 的標題,請寫入 `.*hotfix.*`。沒有周圍的 `.*`,篩選條件只符合完全是 `hotfix` 且前後沒有任何內容的標題。對於不使用 regex 語法的字面子字串符合,請改用 `contains` 運算子。
309 304
310一些示例篩選器組合:305一些篩選條件組合範例:
311
312* **Auth module review**:base branch `main`,head branch 包含 `auth-provider`。將任何涉及身份驗證的 PR 發送給專注的審查者。
313* **Ready-for-review only**:is draft 是 `false`。跳過草稿,以便例行程序僅在 PR 準備好審查時運行。
314* **Label-gated backport**:labels 包括 `needs-backport`。僅當維護者標記 PR 時才觸發移植到另一分支的例行程序。
315
316<h4 id="how-sessions-map-to-events">
317 會話如何映射到事件
318</h4>
319 306
320每個匹配的 GitHub 事件啟動新會話。GitHub 觸發的例行程序不提供跨事件的會話重用,因此兩個 PR 更新會產生兩個獨立會話。307* **Auth module review**:基礎分支 `main`,頭部分支包含 `auth-provider`。將任何涉及驗證的 PR 傳送給專注的審查者。
308* **Ready-for-review only**:is draft 是 `false`。跳過草稿,以便例行工作僅在 PR 準備好進行審查時執行。
309* **Label-gated backport**:標籤包括 `needs-backport`。僅當維護者標記 PR 時才觸發移植到另一個分支的例行工作。
321 310
322<h2 id="manage-routines">311<h2 id="manage-routines">
323 管理例行程序312 管理例行程序
324</h2>313</h2>
325 314
326點擊列表中的例行程序以打開其詳細信息頁面。詳細信息頁面顯示例行程序的存儲庫、connectors、提示、排程、API 令牌、GitHub 觸發器和過去運行的列表。315點擊列表中的例行程序以打開其詳細資訊頁面。詳細資訊頁面顯示例行程序的存儲庫、connectors、提示、排程、API 令牌、GitHub 觸發器和過去運行的列表。
327 316
328<h3 id="view-and-interact-with-runs">317<h3 id="view-and-interact-with-runs">
329 查看和交互運行318 查看和交互運行
330</h3>319</h3>
331 320
332點擊任何運行以將其作為完整會話打開。從那裡您可以看到 Claude 做了什麼、審查更改、創建拉取請求或繼續對話。每個運行會話的工作方式與任何其他會話相同:使用會話標題旁邊的下拉菜單重命名、存檔或刪除它。321點擊任何運行以將其作為完整會話打開。從那裡您可以看到 Claude 做了什麼、審查更改、建立拉取請求或繼續對話。每個運行會話的工作方式與任何其他會話相同:使用會話標題旁邊的下拉菜單重新命名、存檔或刪除它。
333 322
334<Note>323<Note>
335 運行列表中的綠色狀態表示會話已啟動並退出,沒有基礎設施錯誤。這並不意味著您提示中的任務成功。打開運行以讀取記錄並確認 Claude 實際上做了什麼。被阻止的網絡請求、缺失的 connector 工具和任務級別的失敗都會在那裡顯示,而不是在狀態指示器中。324 運行列表中的綠色狀態表示會話已啟動並退出,沒有基礎設施錯誤。這並不意味著您提示中的任務成功。打開運行以讀取記錄並確認 Claude 實際上做了什麼。被阻止的網路請求、缺失的 connector 工具和任務級別的失敗都會在那裡顯示,而不是在狀態指示器中。
336</Note>325</Note>
337 326
338<h3 id="edit-and-control-routines">327<h3 id="edit-and-control-routines">
339 編輯和控制例行程序328 編輯和控制例行程序
340</h3>329</h3>
341 330
342從例行程序詳細信息頁面,您可以:331從例行程序詳細資訊頁面,您可以:
343 332
344* 點擊 **Run now** 立即開始運行,無需等待下一個排程時間。333* 點擊 **Run now** 立即開始運行,無需等待下一個排程時間。您可以選擇性地提供運行特定的文字,該文字以與 API 觸發器的 `text` 欄位相同的方式到達例行程序。
345* 使用 **Repeats** 部分中的切換暫停或恢復排程。暫停的例行程序保留其配置但不運行,直到您重新啟用它們。334* 使用 **Repeats** 部分中的切換暫停或恢復排程。暫停的例行程序保留其設定但不運行,直到您重新啟用它們。
346* 點擊鉛筆圖標打開 **Edit routine** 並更改名稱、提示、存儲庫、環境、connectors 或例行程序的任何觸發器。**Select a trigger** 部分是您添加或移除排程、API 令牌和 GitHub 事件觸發器的地方。335* 點擊鉛筆圖標打開 **Edit routine** 並更改名稱、提示、存儲庫、環境、connectors 或例行程序的任何觸發器。**Select a trigger** 部分是您新增或移除排程、API 令牌和 GitHub 事件觸發器的地方。
347* 點擊刪除圖標移除例行程序。由例行程序創建的過去會話保留在您的會話列表中。336* 點擊刪除圖標移除例行程序。由例行程序建立的過去會話保留在您的會話列表中。
337
338<h3 id="manage-routines-from-the-cli">
339 從 CLI 管理例行程序
340</h3>
341
342CLI 支援管理現有的例行程序。執行 `/schedule list` 以查看所有例行程序,執行 `/schedule update` 以變更一個,或執行 `/schedule run` 以立即觸發它。
343
344您也可以詢問例行程序的運行歷史記錄,例如 `/schedule why did my nightly review do nothing this morning?`。Claude 列出例行程序的最近運行及其狀態和 [在網路上打開每個運行](#view-and-interact-with-runs) 的連結,並讀取運行的日誌以解釋發生了什麼,包括工具錯誤、權限拒絕和最終結果。需要 Claude Code v2.1.227 或更新版本。
348 345
349<h3 id="repositories-and-branch-permissions">346<h3 id="repositories-and-branch-permissions">
350 存儲庫和分支權限347 存儲庫和分支權限
351</h3>348</h3>
352 349
353例行程序需要 GitHub 訪問權限來克隆存儲庫。當您使用 `/schedule` 從 CLI 創建例行程序時,Claude 檢查您的帳戶是否連接了 GitHub,如果沒有則提示您運行 `/web-setup`。有關授予訪問權限的兩種方式,請參閱 [GitHub authentication options](/zh-TW/claude-code-on-the-web#github-authentication-options)。350例行程序需要 GitHub 存取權限來複製存儲庫。當您使用 `/schedule` 從 CLI 建立例行程序時,Claude 檢查您的帳戶是否具有您執行它的存儲庫的 GitHub 存取權限,如果沒有,則新增一個設定注記,說明如何授予它。請參閱 [GitHub authentication options](/docs/zh-TW/claude-code-on-the-web#github-authentication-options) 以了解授予存取權限的兩種方式。
351
352您新增的每個存儲庫在每次運行時都會被複製。Claude 從存儲庫的預設分支開始,除非您的提示另有指定。
354 353
355您添加的每個存儲庫在每次運行時都會被克隆。Claude 從存儲庫的默認分支開始,除非您的提示另有指定。354Claude 將其工作推送到以 `claude/` 為前綴的分支,這些分支始終被接受。當您的提示指示 Claude 推送到另一個分支時,Claude Code 會先檢查推送,如果以下任何情況為真,則拒絕它:
356 355
357默認情況下,Claude 只能推送到以 `claude/` 為前綴的分支。這可以防止例行程序意外修改受保護或長期分支。要移除特定存儲庫的此限制,請在創建或編輯例行程序時為該存儲庫啟用 **Allow unrestricted branch pushes**。356* 該分支在 GitHub 上受保護
357* 其他人有一個來自該分支的開放拉取請求
358* 該分支包含由您以外的人編寫的提交
358 359
359<h3 id="connectors">360<h3 id="connectors">
360 Connectors361 Connectors
361</h3>362</h3>
362 363
363例行程序可以使用您連接的 MCP connectors 在每次運行期間讀取和寫入外部服務。例如,分類支持請求的例行程序可能從 Slack 頻道讀取並在 Linear 中創建問題。364例行程序可以使用您連接的 MCP connectors 在每次運行期間讀取和寫入外部服務。例如,分類支援請求的例行程序可能從 Slack 頻道讀取並在 Linear 中建立問題。
364 365
365Connectors 是您帳戶上的 [claude.ai integrations](/zh-TW/mcp#use-mcp-servers-from-claude-ai)。您在 CLI 中使用 `claude mcp add` 本地添加的 MCP 伺服器存儲在您的機器上而不是您的 claude.ai 帳戶上,因此它們不會出現在 connectors 列表中。要在例行程序中使用其中一個伺服器,請在 [claude.ai/customize/connectors](https://claude.ai/customize/connectors) 添加它作為 connector,或在已提交的 [`.mcp.json`](/zh-TW/mcp#project-scope) 中聲明它,以便它是克隆存儲庫的一部分。366Connectors 是您帳戶上的 [claude.ai integrations](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai)。您在 CLI 中使用 `claude mcp add` 本地新增的 MCP 伺服器儲存在您的機器上而不是您的 claude.ai 帳戶上,因此它們不會出現在 connectors 列表中。要在例行程序中使用其中一個伺服器,請在 [claude.ai/customize/connectors](https://claude.ai/customize/connectors) 新增它作為 connector,或在已提交的 [`.mcp.json`](/docs/zh-TW/mcp#project-scope) 中宣告它,以便它是複製存儲庫的一部分。
366 367
367當您創建例行程序時,默認情況下包括您所有當前連接的 connectors。移除任何不需要的以限制 Claude 在運行期間可以訪問的工具。您也可以直接從例行程序表單添加 connectors。368當您建立例行程序時,預設情況下包括您所有目前連接的 connectors。移除任何不需要的以限制 Claude 在運行期間可以存取的工具。您也可以直接從例行程序表單新增 connectors。
368 369
369要在例行程序表單外管理或添加 connectors,請訪問 claude.ai 上的 **Settings > Connectors** 或在 CLI 中使用 `/schedule update`。370要在例行程序表單外管理或新增 connectors,請造訪 [claude.ai/customize/connectors](https://claude.ai/customize/connectors) 或在 CLI 中使用 `/schedule update`。
370 371
371<h3 id="environments-and-network-access">372<h3 id="environments-and-network-access">
372 環境和網絡訪問373 環境和網路存取
373</h3>374</h3>
374 375
375每個例行程序在 [cloud environment](/zh-TW/claude-code-on-the-web#the-cloud-environment) 中運行,該環境控制網絡訪問、環境變量和設置腳本。例行程序在每次運行時繼承環境的網絡策略。376每個例行程序使用 [cloud environment](/docs/zh-TW/cloud-environments) 來控制網路存取、環境變數和設定指令碼。例行程序在每次運行時繼承環境的網路策略。
376 377
377**Default** 環境使用 **Trusted** 網絡訪問:[默認允許列表](/zh-TW/claude-code-on-the-web#default-allowed-domains)中的包註冊表、雲提供商 API、容器註冊表和常見開發域是可達的,但任意域不可達。對其他主機的出站請求失敗,返回 `403` 和 `x-deny-reason: host_not_allowed`。MCP connector 流量通過 Anthropic 的伺服器路由,因此您添加到例行程序的 connectors 無需將其主機添加到 **Allowed domains** 即可工作。移除您不需要的任何 connectors,詳見 [Connectors](#connectors)。378**Default** 環境使用 **Trusted** 網路存取,它只允許 [預設允許清單](/docs/zh-TW/cloud-environments#default-allowed-domains) 通過會話的網路。對該路徑上允許清單外的主機的請求失敗,返回 `403` 和 `x-deny-reason: host_not_allowed`。MCP connector 流量通過 Anthropic 的伺服器路由,而不是該路徑,因此您新增到例行程序的 connectors 無需將其主機新增到 **Allowed domains** 即可工作。移除您不需要的任何 connectors,詳見 [Connectors](#connectors)。
378 379
379要允許其他域:380要允許其他網域:
380 381
381<Steps>382<Steps>
382 <Step title="打開例行程序進行編輯">383 <Step title="打開例行程序進行編輯">
383 在例行程序的詳細信息頁面上,點擊鉛筆圖標打開 **Edit routine**。384 在例行程序的詳細資訊頁面上,點擊鉛筆圖標打開 **Edit routine**。
384 </Step>385 </Step>
385 386
386 <Step title="打開環境選擇器">387 <Step title="打開環境選擇器">
387 在 **Instructions** 框下方,選擇顯示您環境名稱的雲圖標,例如 **Default**。388 在 **Instructions** 框下方,選擇顯示您環境名稱的雲圖標,例如 **Default**。
388 </Step>389 </Step>
389 390
390 <Step title="打開環境設置">391 <Step title="打開環境設定">
391 將滑鼠懸停在列表中的環境上,然後點擊右側出現的設置圖標。392 將滑鼠懸停在列表中的環境上,然後點擊右側出現的設定圖標。
392 </Step>393 </Step>
393 394
394 <Step title="更改網絡訪問級別">395 <Step title="變更網路存取級別">
395 在 **Update cloud environment** 對話框中,將 **Network access** 更改為 **Custom** 並在 **Allowed domains** 中輸入您的域。檢查 **Also include default list of common package managers** 以在自定義域旁邊保留 [默認允許列表](/zh-TW/claude-code-on-the-web#default-allowed-domains)。選擇 **Full** 以獲得不受限制的訪問。396 在 **Update cloud environment** 對話框中,將 **Network access** 變更為 **Custom** 並在 **Allowed domains** 中輸入您的網域。勾選 **Also include default list of common package managers** 以在自訂網域旁邊保留 [預設允許清單](/docs/zh-TW/cloud-environments#default-allowed-domains)。選擇 **Full** 以獲得不受限制的存取。
396 </Step>397 </Step>
397 398
398 <Step title="保存">399 <Step title="儲存">
399 點擊 **Save changes**。新策略從下一次運行開始應用。400 點擊 **Save changes**。新策略從下一次運行開始應用。
400 </Step>401 </Step>
401</Steps>402</Steps>
402 403
403有關訪問級別和默認允許列表的詳細信息,請參閱 [Network access](/zh-TW/claude-code-on-the-web#network-access)。404請參閱 [Network access](/docs/zh-TW/cloud-environments#network-access) 以了解存取級別和預設允許清單的詳細資訊。
404 405
405<h2 id="usage-and-limits">406<h2 id="usage-and-limits">
406 使用和限制407 使用和限制
408 409
409例行程序以與互動式會話相同的方式消耗訂閱使用量。除了標準訂閱限制外,例行程序還有每個帳戶每天可以啟動多少次運行的每日上限。在 [claude.ai/code/routines](https://claude.ai/code/routines) 或 [claude.ai/settings/usage](https://claude.ai/settings/usage) 查看您目前的消耗和剩餘的每日例行程序運行。410例行程序以與互動式會話相同的方式消耗訂閱使用量。除了標準訂閱限制外,例行程序還有每個帳戶每天可以啟動多少次運行的每日上限。在 [claude.ai/code/routines](https://claude.ai/code/routines) 或 [claude.ai/settings/usage](https://claude.ai/settings/usage) 查看您目前的消耗和剩餘的每日例行程序運行。
410 411
411當例行程序達到每日上限或您的訂閱使用限制時,啟用了使用額度的組織可以繼續在計量超額上運行例行程序。沒有使用額度,額外運行會被拒絕,直到時間窗口重置。從 claude.ai 上的 **Settings > Billing** 啟用使用額度。412當例行程序達到每日上限或您的訂閱使用限制時,啟用了使用額度的組織可以繼續在計量超額上運行例行程序。沒有使用額度,額外運行會被拒絕,直到時間窗口重置。在 [claude.ai/settings/usage](https://claude.ai/settings/usage) 啟用使用額度。在 Team 和 Enterprise 方案上,管理員在 [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) 為組織啟用使用額度。
412 413
413一次性運行不計入每日例行程序運行上限。它們像任何其他會話一樣消耗您的常規訂閱使用量,但它們不受每個帳戶每日例行程序運行額度的限制。414一次性運行不計入每日例行程序運行上限。它們像任何其他會話一樣消耗您的常規訂閱使用量。
414 415
415<h2 id="troubleshooting">416<h2 id="troubleshooting">
416 故障排除417 故障排除
417</h2>418</h2>
418 419
419<h3 id="/schedule-returns-unknown-command">420<h3 id="schedule-returns-unknown-command">
420 `/schedule` 返回「Unknown command」421 `/schedule` 返回「Unknown command」
421</h3>422</h3>
422 423
423當不滿足其中一項要求時,CLI 會隱藏 `/schedule`:命令菜單在您輸入時會顯示 `No commands match "/schedule"`,提交時會返回 `Unknown command: /schedule`。原因通常是以下之一:424當不滿足其中一項要求時,CLI 會隱藏 `/schedule`:命令菜單在您輸入時會顯示 `No commands match "/schedule"`,提交時會返回 `Unknown command: /schedule`。除了使用 Console API 金鑰或啟用功能旗標擷取的 Anthropic 設定檔外,以下情況都會返回 `Unknown command: /schedule`。原因通常是以下之一:
424 425
425* 您使用 Console API 金鑰或雲端提供商(例如 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry)進行身份驗證。`/schedule` 需要 claude.ai 訂閱登入。如果在您的 shell 中設定了 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN`,或在 `settings.json` 中設定了 `apiKeyHelper`,請先移除它,因為這些設定優先於 claude.ai 登入426* 您使用 Console API 金鑰、[Anthropic 設定檔或聯盟認證](/docs/zh-TW/authentication#anthropic-profiles-and-federation-credentials),或雲端提供商(例如 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry)進行身份驗證。`/schedule` 需要 claude.ai 訂閱登入。使用 Console API 金鑰或設定檔時,提交 `/schedule` 會改為顯示 `/schedule is available with Claude for Enterprise — ask your admin about migrating from API-key access`。使用雲端提供商登入時,您仍會看到 `Unknown command: /schedule`。如果在您的 shell 中設定了 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN`,或在 `settings.json` 中設定了 `apiKeyHelper`,請先移除它,因為這些設定優先於 claude.ai 登入。設定檔或聯盟認證也會優先,因此請同時關閉該設定
426* `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 `DISABLE_GROWTHBOOK` 在您的 shell 環境或 [`settings.json` 檔案](/zh-TW/settings#available-settings)的 `env` 區塊中設定。這些會停用功能旗標擷取,而 `/schedule` 依賴於此功能
427* 您在 Claude Code 網頁工作階段中。改為從 [web UI](https://claude.ai/code/routines) 管理例行程序427* 您在 Claude Code 網頁工作階段中。改為從 [web UI](https://claude.ai/code/routines) 管理例行程序
428* 您的組織政策停用了 [Claude Code on the web](/docs/zh-TW/claude-code-on-the-web),例行程序在其上執行
429* Owner 為您的 Team 或 Enterprise 組織[關閉了例行程序](#routines-are-disabled-by-your-organizations-policy)。在 v2.1.227 之前,命令在此情況下仍會出現,而 claude.ai 會在 Claude 嘗試建立或執行例行程序時拒絕它
428 430
429無論 CLI 如何配置,您始終可以在 [claude.ai/code/routines](https://claude.ai/code/routines) 建立和管理例行程序。431除非您的組織政策停用了例行程序或 Claude Code on the web,否則無論 CLI 如何配置,您都可以在 [claude.ai/code/routines](https://claude.ai/code/routines) 建立和管理例行程序。
430 432
431<h3 id="/schedule-asks-you-to-authenticate">433<h3 id="/schedule-asks-you-to-authenticate">
432 `/schedule` 要求您進行身份驗證434 `/schedule` 要求您進行身份驗證
434 436
435如果 `/schedule` 執行但 Claude 回應您需要先使用 claude.ai 帳戶進行身份驗證,則 CLI 沒有儲存的 claude.ai 登入。API 帳戶不支援例行程序。執行 `/login`,使用您的 claude.ai 帳戶登入,然後再次執行 `/schedule`。437如果 `/schedule` 執行但 Claude 回應您需要先使用 claude.ai 帳戶進行身份驗證,則 CLI 沒有儲存的 claude.ai 登入。API 帳戶不支援例行程序。執行 `/login`,使用您的 claude.ai 帳戶登入,然後再次執行 `/schedule`。
436 438
437<h3 id="routines-are-disabled-by-your-organization’s-policy">439<h3 id="routines-are-disabled-by-your-organizations-policy">
438 "例行程序已被您的組織政策禁用"440 「例行程序已被您的組織政策禁用」
439</h3>441</h3>
440 442
441您的 Team 或 Enterprise 組織中的擁有者可能已在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 關閉了 **Routines** 切換。這是一個伺服器端組織設定,因此無法從您的本地配置中覆蓋。請聯繫擁有者為您的組織啟用例行程序。443您的 Team 或 Enterprise 組織中的 Owner 可能已在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 關閉了 **Routines** 切換。在 Claude Code v2.1.227 或更新版本上,相同的切換也會在 CLI 中隱藏 `/schedule`。這是一個伺服器端組織設定,因此無法從您的本地設定中覆蓋。請聯繫 Owner 為您的組織啟用例行程序。
442 444
443<h2 id="related-resources">445<h2 id="related-resources">
444 相關資源446 相關資源
445</h2>447</h2>
446 448
447* [`/loop` 和會話內排程](/zh-TW/scheduled-tasks):在打開的 CLI 會話中排程本地任務449* [`/loop` 和會話內排程](/docs/zh-TW/scheduled-tasks):在打開的 CLI 會話中排程本地任務
448* [Desktop scheduled tasks](/zh-TW/desktop-scheduled-tasks):在您的機器上運行的本地排程任務,可以訪問本地文件450* [Desktop scheduled tasks](/docs/zh-TW/desktop-scheduled-tasks):在您的機器上運行的本地排程任務,可以訪問本地檔案
449* [Cloud environment](/zh-TW/claude-code-on-the-web#the-cloud-environment):為雲會話配置運行時環境451* [Cloud environments](/docs/zh-TW/cloud-environments):為雲會話配置網路存取、環境變數和設定指令碼
450* [MCP connectors](/zh-TW/mcp):連接外部服務,如 Slack、Linear 和 Google Drive452* [MCP connectors](/docs/zh-TW/mcp):連接外部服務,如 Slack、Linear 和 Google Drive
451* [GitHub Actions](/zh-TW/github-actions):在存儲庫事件上在您的 CI 管道中運行 Claude453* [GitHub Actions](/docs/zh-TW/github-actions):在存儲庫事件上在您的 CI 管道中運行 Claude