Documentation 2026-07-01 21:01 UTC to 2026-07-02 23:59 UTC

89| :------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |89| :------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |

90| 受管原則設定 | 端點管理的原則（無論是 MDM plist、登錄原則或受管設定檔）從主機載入；[伺服器管理的設定](/zh-TW/server-managed-settings)在工作階段使用組織 OAuth 登入或直接配置的 API 金鑰進行驗證時擷取，在[符合條件的配置](/zh-TW/server-managed-settings#platform-availability)上 | 端點原則：從主機移除受管設定檔、plist 或登錄原則。伺服器管理的設定：由您的組織管理員控制；無法從 SDK 停用 |90| 受管原則設定 | 端點管理的原則（無論是 MDM plist、登錄原則或受管設定檔）從主機載入；[伺服器管理的設定](/zh-TW/server-managed-settings)在工作階段使用組織 OAuth 登入或直接配置的 API 金鑰進行驗證時擷取，在[符合條件的配置](/zh-TW/server-managed-settings#platform-availability)上 | 端點原則：從主機移除受管設定檔、plist 或登錄原則。伺服器管理的設定：由您的組織管理員控制；無法從 SDK 停用 |

91| `~/.claude.json` 全域設定 | 始終讀取 | 在 `env` 中使用 `CLAUDE_CONFIG_DIR` 重新定位 |91| `~/.claude.json` 全域設定 | 始終讀取 | 在 `env` 中使用 `CLAUDE_CONFIG_DIR` 重新定位 |

92| `~/.claude/projects/<project>/memory/` 的自動記憶體 | 預設載入到系統提示中 | 在設定中設定 `autoMemoryEnabled: false`，或在 `env` 中設定 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` |92| `~/.claude/projects/<project>/memory/` 的自動記憶體 | 預設載入到系統提示中。代理程式使用標準 `Write` 和 `Edit` 工具而非專用記憶體工具寫入新記憶體，因此必須啟用這些工具才能讓代理程式儲存記憶體 | 在設定中設定 `autoMemoryEnabled: false`，或在 `env` 中設定 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` |

93| [claude.ai MCP 連接器](/zh-TW/mcp#use-mcp-servers-from-claude-ai) | 當作用中驗證方法是 claude.ai 訂閱時載入。傳遞 `mcpServers: {}` 不會抑制它們 | 設定 `strictMcpConfig: true`、[`disableClaudeAiConnectors: true`](/zh-TW/mcp#disable-claude-ai-connectors) 在設定中，或在 `env` 中設定 `ENABLE_CLAUDEAI_MCP_SERVERS=false` |93| [claude.ai MCP 連接器](/zh-TW/mcp#use-mcp-servers-from-claude-ai) | 當作用中驗證方法是 claude.ai 訂閱時載入。傳遞 `mcpServers: {}` 不會抑制它們 | 設定 `strictMcpConfig: true`、[`disableClaudeAiConnectors: true`](/zh-TW/mcp#disable-claude-ai-connectors) 在設定中，或在 `env` 中設定 `ENABLE_CLAUDEAI_MCP_SERVERS=false` |

94 94 

95<Warning>95<Warning>

4 4 

5# 將工作階段輸出分享為成品5# 將工作階段輸出分享為成品

6 6 

7> 成品將 Claude Code 的工作轉變為可在私人 URL 上進行的即時互動頁面，您可以在組織內分享。7> 成品將 Claude Code 的工作轉變為可在 claude.ai 上的私人 URL 進行的即時互動頁面。

8 8 

9{/* plan-availability: feature=artifacts plans=team,enterprise providers=anthropic */}9{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}

10 10 

11<Note>11<Note>

12 成品目前處於測試版。它們需要 Team 或 Enterprise 方案，以及使用 [`/login`](/zh-TW/setup#authenticate) 登入的工作階段。請參閱[可用性](#availability)以了解完整的需求集合。12 成品適用於 Pro、Max、Team 和 Enterprise 方案，並需要使用 [`/login`](/zh-TW/setup#authenticate) 登入的工作階段。請參閱[可用性](#availability)以了解完整的需求集合。

13</Note>13</Note>

14 14 

15成品是一個即時互動網頁，Claude Code 從您的工作階段發佈到 claude.ai 上的私人 URL。您在瀏覽器中開啟它，當工作階段繼續進行時，它會就地更新。當您想讓隊友看到它時，可以從頁面標題中分享它。例如，使用成品來引導審查者查看帶有註解差異的拉取請求、從工作階段資料建立儀表板，或保持調查時間軸，隨著 Claude 工作而填入。15成品是一個即時互動網頁，Claude Code 從您的工作階段發佈到 claude.ai 上的私人 URL。您在瀏覽器中開啟它，當工作階段繼續進行時，它會就地更新。在 Team 和 Enterprise 方案上，當您想讓隊友看到它時，可以從頁面標題中分享它。例如，使用成品來引導審查者查看帶有註解差異的拉取請求、從工作階段資料建立儀表板，或保持調查時間軸，隨著 Claude 工作而填入。

16 16 

17<Frame>17<Frame>

18 <img src="https://mintcdn.com/claude-code/kaHIYYMIYMYPxQg9/images/artifacts-viewer.png?fit=max&auto=format&n=kaHIYYMIYMYPxQg9&q=85&s=dbfd671cdb0d15f49f808b9e89778fe1" alt="在 claude.ai/code/artifact 的瀏覽器中開啟的成品。檢視器標題顯示成品標題 acme-funnel-fix、分享按鈕和作者頭像。分享選單已開啟，顯示'始終分享最新版本'切換、版本選擇器顯示'分享版本 2'、'Acme 的所有人'受眾選擇器和複製連結按鈕。在標題下方，成品頁面顯示兩個並排的行動裝置模型、漏斗圖表和一行指標卡片。" width="2511" height="1890" data-path="images/artifacts-viewer.png" />18 <img src="https://mintcdn.com/claude-code/kaHIYYMIYMYPxQg9/images/artifacts-viewer.png?fit=max&auto=format&n=kaHIYYMIYMYPxQg9&q=85&s=dbfd671cdb0d15f49f808b9e89778fe1" alt="在 claude.ai/code/artifact 的瀏覽器中開啟的成品。檢視器標題顯示成品標題 acme-funnel-fix、分享按鈕和作者頭像。分享選單已開啟，顯示'始終分享最新版本'切換、版本選擇器顯示'分享版本 2'、'Acme 的所有人'受眾選擇器和複製連結按鈕。在標題下方，成品頁面顯示兩個並排的行動裝置模型、漏斗圖表和一行指標卡片。" width="2511" height="1890" data-path="images/artifacts-viewer.png" />

84 分享成品84 分享成品

85</h2>85</h2>

86 86 

87新成品只對您可見。在瀏覽器中開啟它，並使用頁面標題中的**分享**控制項向您組織中的特定人員或所有人授予存取權限。標題將您命名為成品的作者，因此任何您與之分享的人都可以看到誰發佈了頁面。它還連結到您在 [claude.ai/code/artifacts](https://claude.ai/code/artifacts) 的庫，其中列出您建立的每個成品。87新成品只對您可見。在 Pro 和 Max 方案上，成品對您保持私密。在 Team 和 Enterprise 方案上，在瀏覽器中開啟成品，並使用頁面標題中的**分享**控制項向您組織中的特定人員或所有人授予存取權限。標題將您命名為成品的作者，因此任何您與之分享的人都可以看到誰發佈了頁面。它還連結到您在 [claude.ai/code/artifacts](https://claude.ai/code/artifacts) 的庫，其中列出您建立的每個成品。

88 88 

89分享停止在您的組織。檢視者必須以發佈成品的同一組織的成員身份登入 claude.ai，並且沒有選項可以使成品在組織外可見。要將基礎內容發送給組織外的人，請要求 Claude 提供 HTML 檔案並直接分享該檔案。89分享停止在您的組織。檢視者必須以發佈成品的同一組織的成員身份登入 claude.ai，並且沒有選項可以使成品在組織外可見。要將基礎內容發送給組織外的人，請要求 Claude 提供 HTML 檔案並直接分享該檔案。

90 90 

190 190 

191| 要求 | 可用時間 |191| 要求 | 可用時間 |

192| :---- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |192| :---- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

193| 方案 | Team 或 Enterprise。在 Team 方案上，成品預設開啟。在 Enterprise 方案上，Owner 在 claude.ai 管理設定中[啟用它們](#manage-artifacts-for-your-organization)。 |193| 方案 | Pro、Max、Team 或 Enterprise。在 Pro 和 Max 方案上，成品僅供您私人使用，不適用管理員管理。在 Team 方案上，成品預設開啟。在 Enterprise 方案上，Owner 在 claude.ai 管理設定中[啟用它們](#manage-artifacts-for-your-organization)。 |

194| 驗證 | 使用 `/login` 登入 claude.ai。使用 API 金鑰、[閘道令牌](/zh-TW/llm-gateway)或雲端提供者認證的工作階段無法發佈。 |194| 驗證 | 使用 `/login` 登入 claude.ai。使用 API 金鑰、[閘道令牌](/zh-TW/llm-gateway)或雲端提供者認證的工作階段無法發佈。 |

195| 模型提供者 | Anthropic API。在 [Amazon Bedrock](/zh-TW/amazon-bedrock)、[Google Cloud Vertex AI](/zh-TW/google-vertex-ai) 或 [Microsoft Foundry](/zh-TW/microsoft-foundry) 上不可用。 |195| 模型提供者 | Anthropic API。在 [Amazon Bedrock](/zh-TW/amazon-bedrock)、[Google Cloud Vertex AI](/zh-TW/google-vertex-ai) 或 [Microsoft Foundry](/zh-TW/microsoft-foundry) 上不可用。 |

196| 組織政策 | 客戶管理的加密金鑰 (CMEK)、HIPAA 和[零資料保留](/zh-TW/zero-data-retention)未為組織啟用。 |196| 組織政策 | 客戶管理的加密金鑰 (CMEK)、HIPAA 和[零資料保留](/zh-TW/zero-data-retention)未為組織啟用。 |

50 50 

51 <Step title="啟動並登入">51 <Step title="啟動並登入">

52 從您的應用程式啟動器啟動 **Claude**，或從終端機執行 `claude-desktop`，然後使用您的 Anthropic 帳戶登入。52 從您的應用程式啟動器啟動 **Claude**，或從終端機執行 `claude-desktop`，然後使用您的 Anthropic 帳戶登入。

53 

54 Linux 應用程式的登入方式與 macOS 和 Windows 上相同：使用 claude.ai 訂閱，或透過您組織的 SSO。Desktop 不直接接受 Claude Console API 金鑰；請使用 [CLI](/zh-TW/quickstart) 進行 API 金鑰驗證。對於將 Desktop 路由到 Google Cloud 的 Agent Platform 或 LLM 閘道的企業部署，請參閱 [企業配置指南](https://support.claude.com/en/articles/12622667-enterprise-configuration) 和 [網路配置](/zh-TW/network-config)。

53 </Step>55 </Step>

54</Steps>56</Steps>

55 57 

50* [Remote Control](/zh-TW/remote-control)50* [Remote Control](/zh-TW/remote-control)

51* [Chrome 擴充功能](/zh-TW/chrome)51* [Chrome 擴充功能](/zh-TW/chrome)

52* [Computer use](/zh-TW/computer-use)：Pro 和 Max 計畫52* [Computer use](/zh-TW/computer-use)：Pro 和 Max 計畫

53* [Artifacts](/zh-TW/artifacts)：Team 和 Enterprise 計畫53* [Artifacts](/zh-TW/artifacts)：Pro、Max、Team 和 Enterprise 計畫

54* [Voice dictation](/zh-TW/voice-dictation)54* [Voice dictation](/zh-TW/voice-dictation)

55 55 

56Desktop 是部分例外：Enterprise 部署可以透過[受管設定](https://support.claude.com/en/articles/12622667-enterprise-configuration)將 Desktop 路由到 Vertex AI 或閘道提供者，而[在 3P 研究預覽上協作](https://claude.com/docs/cowork/3p/overview)在 Bedrock、Vertex AI、Foundry 或自託管 LLM 閘道上執行 Code 標籤。如需這些功能的按計畫可用性，請參閱[按訂閱計畫的可用性](#availability-by-subscription-plan)。56Desktop 是部分例外：Enterprise 部署可以透過[受管設定](https://support.claude.com/en/articles/12622667-enterprise-configuration)將 Desktop 路由到 Vertex AI 或閘道提供者，而[在 3P 研究預覽上協作](https://claude.com/docs/cowork/3p/overview)在 Bedrock、Vertex AI、Foundry 或自託管 LLM 閘道上執行 Code 標籤。如需這些功能的按計畫可用性，請參閱[按訂閱計畫的可用性](#availability-by-subscription-plan)。

286| [Computer use](/zh-TW/computer-use) | ✓ | ✓ | ✗ | ✗ |286| [Computer use](/zh-TW/computer-use) | ✓ | ✓ | ✗ | ✗ |

287| Dispatch ([Desktop](/zh-TW/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |287| Dispatch ([Desktop](/zh-TW/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |

288| [Code Review](/zh-TW/code-review) | ✗ | ✗ | ✓ | ✓ |288| [Code Review](/zh-TW/code-review) | ✗ | ✗ | ✓ | ✓ |

289| [Artifacts](/zh-TW/artifacts) | ✗ | ✗ | ✓ | 管理員啟用 |289| [Artifacts](/zh-TW/artifacts) | ✓ | ✓ | ✓ | 管理員啟用 |

290| [分析儀表板、API 和貢獻指標](/zh-TW/analytics) | ✗ | ✗ | ✓ | ✓ |290| [分析儀表板、API 和貢獻指標](/zh-TW/analytics) | ✗ | ✗ | ✓ | ✓ |

291| [伺服器管理的設定](/zh-TW/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |291| [伺服器管理的設定](/zh-TW/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |

292| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |292| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |

37| `Ctrl+R` | 反向搜尋命令歷史 | 以互動方式搜尋先前的命令 |37| `Ctrl+R` | 反向搜尋命令歷史 | 以互動方式搜尋先前的命令 |

38| `Ctrl+V` 或 `Cmd+V`（iTerm2）或 `Alt+V`（Windows 和 WSL） | 從剪貼簿貼上影像 | 在游標處插入 `[Image #N]` 晶片，以便您可以在提示中按位置參考它。在 WSL 上，`Ctrl+V` 和 `Alt+V` 都已繫結；如果您的終端攔截 `Ctrl+V`，請使用 `Alt+V` |38| `Ctrl+V` 或 `Cmd+V`（iTerm2）或 `Alt+V`（Windows 和 WSL） | 從剪貼簿貼上影像 | 在游標處插入 `[Image #N]` 晶片，以便您可以在提示中按位置參考它。在 WSL 上，`Ctrl+V` 和 `Alt+V` 都已繫結；如果您的終端攔截 `Ctrl+V`，請使用 `Alt+V` |

39| `Ctrl+B` | 背景執行工作 | 將 bash 命令和代理放在背景執行。Tmux 使用者按兩次 |39| `Ctrl+B` | 背景執行工作 | 將 bash 命令和代理放在背景執行。Tmux 使用者按兩次 |

40| `Ctrl+T` | 切換工作清單 | 在終端狀態區域中顯示或隱藏[工作清單](#task-list) |40| `Ctrl+T` | 切換 Claude 的工作清單 | 在狀態區域中顯示或隱藏 [Claude 的待辦清單](#task-list)。這不是背景工作檢視；使用 [`/tasks`](/zh-TW/commands) 以查看執行中的 shell 和子代理 |

41| `Left/Right arrows` | 在對話框標籤之間循環 | 在權限對話框和選單中的標籤之間導航 |41| `Left/Right arrows` | 在對話框標籤之間循環 | 在權限對話框和選單中的標籤之間導航 |

42| `Up/Down arrows` 或 `Ctrl+P`/`Ctrl+N` | 移動游標或導航命令歷史 | 當輸入跨越多個視覺行時，無論是換行還是多行，首先在提示內移動游標。一旦游標已在第一個或最後一個視覺行，再次按下會導航命令歷史。{/* min-version: 2.1.169 */}自 v2.1.169 起，換行的單行輸入行為與多行相同 |42| `Up/Down arrows` 或 `Ctrl+P`/`Ctrl+N` | 移動游標或導航命令歷史 | 當輸入跨越多個視覺行時，無論是換行還是多行，首先在提示內移動游標。一旦游標已在第一個或最後一個視覺行，再次按下會導航命令歷史。{/* min-version: 2.1.169 */}自 v2.1.169 起，換行的單行輸入行為與多行相同 |

43| `Esc` | 中斷 Claude | 停止目前回應或工具呼叫中途，以便您可以重新導向。Claude 會保留迄今為止完成的工作 |43| `Esc` | 中斷 Claude | 停止目前回應或工具呼叫中途，以便您可以重新導向。Claude 會保留迄今為止完成的工作 |

387 工作清單387 工作清單

388</h2>388</h2>

389 389 

390在處理複雜的多步驟工作時，Claude 會建立工作清單以追蹤進度。工作出現在終端的狀態區域中，指示器顯示待處理、進行中或完成的內容。390工作清單是 Claude 的待辦事項檢查清單：Claude 建立的項目用於規劃多步驟工作，並有指示器顯示待處理、進行中或完成的內容。它與背景工作檢視分開。若要查看執行中的 shell 和子代理，請改用 [`/tasks`](/zh-TW/commands)。

391 391 

392* 按 `Ctrl+T` 以切換工作清單檢視。顯示一次最多 5 個工作392* 按 `Ctrl+T` 以切換工作清單檢視。顯示一次最多五個工作。當 Claude 尚未建立任何檢查清單項目時，切換沒有可見效果，因為沒有任何內容可顯示

393* 若要查看所有工作或清除它們，直接詢問 Claude：「show me all tasks」或「clear all tasks」393* 若要查看所有工作或清除它們，直接詢問 Claude：「show me all tasks」或「clear all tasks」

394* 工作在上下文壓縮中持續存在，幫助 Claude 在較大的專案上保持組織394* 工作在上下文壓縮中持續存在，幫助 Claude 在較大的專案上保持組織

395* 若要在會話之間共享工作清單，請設定 `CLAUDE_CODE_TASK_LIST_ID` 以使用 `~/.claude/tasks/` 中的命名目錄：`CLAUDE_CODE_TASK_LIST_ID=my-project claude`395* 若要在會話之間共享工作清單，請設定 `CLAUDE_CODE_TASK_LIST_ID` 以使用 `~/.claude/tasks/` 中的命名目錄：`CLAUDE_CODE_TASK_LIST_ID=my-project claude`

86在 `Global` 上下文中可用的動作：86在 `Global` 上下文中可用的動作：

87 87 

88| 動作 | 預設值 | 說明 |88| 動作 | 預設值 | 說明 |

89| :--------------------- | :----- | :------------- |89| :--------------------- | :----- | :-------------------------------------------------------- |

90| `app:interrupt` | Ctrl+C | 取消目前操作 |90| `app:interrupt` | Ctrl+C | 取消目前操作 |

91| `app:exit` | Ctrl+D | 結束 Claude Code |91| `app:exit` | Ctrl+D | 結束 Claude Code |

92| `app:redraw` | (未繫結) | 強制終端機重新繪製 |92| `app:redraw` | (未繫結) | 強制終端機重新繪製 |

93| `app:toggleTodos` | Ctrl+T | 切換工作清單可見性 |93| `app:toggleTodos` | Ctrl+T | 切換 Claude 工作清單的可見性。這不是 [`/tasks`](/zh-TW/commands) 背景工作檢視 |

94| `app:toggleTranscript` | Ctrl+O | 切換詳細文字記錄 |94| `app:toggleTranscript` | Ctrl+O | 切換詳細文字記錄 |

95 95 

96<h3 id="history-actions">96<h3 id="history-actions">

234 組織模型限制234 組織模型限制

235</h3>235</h3>

236 236 

237組織管理員透過在 Claude 主控台中停用個別模型來限制成員可以執行的模型。當您的成員透過 Anthropic API 進行驗證，且您想要一個組織範圍的開關而不部署設定檔時，請使用主控台切換而不是 `availableModels`。此限制在 Claude Code 驗證時與帳戶的權利一起傳遞，與設定中的任何 `availableModels` 清單分開，而伺服器在建立會話時獨立強制執行相同的限制。需要 Claude Code v2.1.187 或更新版本。237Claude Enterprise 計畫上的組織管理員透過在 claude.ai 管理員主控台中停用個別模型來限制成員可以執行的模型。此限制在 Claude Code 驗證時與帳戶的權利一起傳遞，與設定中的任何 `availableModels` 清單分開，而伺服器在建立會話時獨立強制執行相同的限制。需要 Claude Code v2.1.187 或更新版本。

238 

239當成員登入或使用自己的 API 金鑰時，限制適用。組織範圍的認證（例如組織服務金鑰）未與使用者相關聯，因此限制不適用於它們。

240 

241Claude Console 沒有模型限制控制。沒有 Claude Enterprise 計畫的組織（包括其成員透過 Anthropic API 進行驗證的組織）改為在[受管理設定](/zh-TW/settings#settings-files)中使用 [`availableModels`](#restrict-model-selection) 限制模型，新增 [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) 以涵蓋「預設」選項。這些設定由 Claude Code 本身強制執行，而不是由伺服器強制執行。

238 242 

239受限制的模型會從 `/model` 選擇器中隱藏。使用 `--model`、`ANTHROPIC_MODEL` 環境變數或 `model` 設定按名稱選擇它會顯示通知 `Model "<name>" is restricted by your organization's settings. Using <model> instead.`，會話會在允許的模型上啟動。為受限制的模型輸入 `/model <name>` 會被拒絕，並顯示 `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.`，會話會保持其目前模型。243受限制的模型會從 `/model` 選擇器中隱藏。使用 `--model`、`ANTHROPIC_MODEL` 環境變數或 `model` 設定按名稱選擇它會顯示通知 `Model "<name>" is restricted by your organization's settings. Using <model> instead.`，會話會在允許的模型上啟動。為受限制的模型輸入 `/model <name>` 會被拒絕，並顯示 `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.`，會話會保持其目前模型。

240 244 

62 62 

63<Steps>63<Steps>

64 <Step title="建立 plugin 目錄">64 <Step title="建立 plugin 目錄">

65 每個 plugin 都位於其自己的目錄中，包含您的 skills、agents 或 hooks，可選地與 `.claude-plugin/plugin.json` 清單並存。現在建立一個：65 每個 plugin 都位於其自己的目錄中，包含您的 skills、agents 或 hooks，可選地與 `.claude-plugin/plugin.json` 清單並存。位置對於本快速入門並不重要，因為您將在測試步驟中使用 `--plugin-dir` 指向 Claude Code 該目錄。在任何方便的地方建立它，例如暫存資料夾或專案目錄：

66 66 

67 ```bash theme={null}67 ```bash theme={null}

68 mkdir my-first-plugin68 mkdir my-first-plugin

69 ```69 ```

70 

71 其餘步驟從父目錄執行，並參考相對於它的路徑，例如 `my-first-plugin/...`。

70 </Step>72 </Step>

71 73 

72 <Step title="建立 plugin 清單">74 <Step title="建立 plugin 清單">

436 438 

437<Steps>439<Steps>

438 <Step title="建立 plugin 結構">440 <Step title="建立 plugin 結構">

439 建立新的 plugin 目錄：441 在您的專案根目錄中建立新的 plugin 目錄，與現有的 `.claude/` 資料夾並排放置，以便下一步中的相對 `cp` 路徑能夠解析：

440 442 

441 ```bash theme={null}443 ```bash theme={null}

442 mkdir -p my-plugin/.claude-plugin444 mkdir -p my-plugin/.claude-plugin

13| 工具 | 描述 | 需要權限 |13| 工具 | 描述 | 需要權限 |

14| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--- |14| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--- |

15| `Agent` | 生成一個具有自己 context window 的 [subagent](/zh-TW/sub-agents)，以處理任務。請參閱 [Agent 工具行為](#agent-tool-behavior) | 否 |15| `Agent` | 生成一個具有自己 context window 的 [subagent](/zh-TW/sub-agents)，以處理任務。請參閱 [Agent 工具行為](#agent-tool-behavior) | 否 |

16| `Artifact` | 將 HTML 或 Markdown 檔案發佈為 [artifact](/zh-TW/artifacts)：一個私人的互動式頁面，您可以在 claude.ai 上與組織內部分享。{/* plan-availability: feature=artifacts plans=team,enterprise providers=anthropic */}需要 Team 或 Enterprise 計畫和 `/login` 驗證；請參閱 [可用性](/zh-TW/artifacts#availability) | 是 |16| `Artifact` | 將 HTML 或 Markdown 檔案發佈為 [artifact](/zh-TW/artifacts)：一個私人的互動式頁面，在 claude.ai 上。在 Team 和 Enterprise 計畫上，您可以在組織內部分享。{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}需要 Pro、Max、Team 或 Enterprise 計畫和 `/login` 驗證；請參閱 [可用性](/zh-TW/artifacts#availability) | 是 |

17| `AskUserQuestion` | 提出多選題以收集需求或澄清歧義 | 否 |17| `AskUserQuestion` | 提出多選題以收集需求或澄清歧義 | 否 |

18| `Bash` | 在您的環境中執行 shell 命令。請參閱 [Bash 工具行為](#bash-tool-behavior) | 是 |18| `Bash` | 在您的環境中執行 shell 命令。請參閱 [Bash 工具行為](#bash-tool-behavior) | 是 |

19| `CronCreate` | 在目前工作階段內排程定期或一次性提示。任務的範圍限於工作階段，並在 `--resume` 或 `--continue` 時恢復（如果未過期）。請參閱 [排程任務](/zh-TW/scheduled-tasks) | 否 |19| `CronCreate` | 在目前工作階段內排程定期或一次性提示。任務的範圍限於工作階段，並在 `--resume` 或 `--continue` 時恢復（如果未過期）。請參閱 [排程任務](/zh-TW/scheduled-tasks) | 否 |

132ultracode: audit every API endpoint under src/routes/ for missing auth checks132ultracode: audit every API endpoint under src/routes/ for missing auth checks

133```133```

134 134 

135Claude Code 在您的輸入中突出顯示該關鍵字，Claude 為任務編寫工作流程指令碼，而不是逐輪完成它。如果執行執行您想要的操作，您可以之後[將其儲存為命令](#save-the-workflow-for-reuse)。135Claude Code 在您的輸入中突出顯示該關鍵字，Claude 為任務編寫工作流程指令碼，而不是逐輪完成它。如果您沒有打算啟動工作流程，請在 macOS 上按 `Option+W` 或在 Windows 和 Linux 上按 `Alt+W` 以忽略此提示的突出顯示，或在游標位於突出顯示單詞的正後方時按退格鍵。要停止該單詞完全觸發，請在 `/config` 中關閉 Ultracode keyword trigger。

136 136 

137如果您沒有打算啟動工作流程，請在 macOS 上按 `Option+W` 或在 Windows 和 Linux 上按 `Alt+W` 以忽略此提示的突出顯示，或在游標位於突出顯示單詞的正後方時按退格鍵。要停止該單詞完全觸發，請在 `/config` 中關閉 Ultracode keyword trigger。137如果執行執行您想要的操作，您可以之後[將其儲存為命令](#save-the-workflow-for-reuse)。

138 138 

139如果您已經以另一種方式建立了協調器，例如子代理提示的資料夾或一個分散工作的技能，您可以指向 Claude 並要求工作流程執行相同的操作。139如果您已經以另一種方式建立了協調器，例如子代理提示的資料夾或一個分散工作的技能，您可以指向 Claude 並要求工作流程執行相同的操作。

140 140 

212 212 

213Claude 將清單作為結構化資料傳遞，因此指令碼可以直接在 `args` 上呼叫陣列和物件方法，無需先解析它。如果省略 `args`，全域變數在指令碼內為 `undefined`。213Claude 將清單作為結構化資料傳遞，因此指令碼可以直接在 `args` 上呼叫陣列和物件方法，無需先解析它。如果省略 `args`，全域變數在指令碼內為 `undefined`。

214 214 

215<h2 id="example-workflow-prompts">

216 工作流程提示範例

217</h2>

218 

219工作流程最適合當任務大於一個代理可以在上下文中保存的情況，或當相同的步驟需要在許多項目上執行時。下面的提示顯示常見的形狀。每一個都要求 Claude 為該任務編寫並執行工作流程；您不自己編寫指令碼。

220 

221<h3 id="audit-many-files-for-the-same-issue">

222 審計許多檔案以查找相同問題

223</h3>

224 

225展開每個檔案一個代理，然後收集並驗證發現。

226 

227```text theme={null}

228> use a workflow to audit every route handler under src/routes/ for missing authentication checks, and adversarially verify each finding before reporting it

229```

230 

231<h3 id="keep-fixing-until-a-check-passes">

232 持續修復直到檢查通過

233</h3>

234 

235執行檢查器、修復失敗的內容，並重複直到通過或停止進展。

236 

237```text theme={null}

238> use a workflow to run npx tsc --noEmit and keep fixing the reported errors until the type check passes or two rounds in a row make no progress

239```

240 

241<h3 id="migrate-many-files-in-parallel">

242 並行遷移許多檔案

243</h3>

244 

245發現要遷移的檔案，在隔離的副本中轉換每個檔案，以便編輯不衝突，並驗證每個結果。

246 

247```text theme={null}

248> use a workflow to migrate every component under src/components/ from styled-components to Tailwind, working on each file in its own isolated copy

249```

250 

251<h3 id="review-every-changed-file-and-write-one-summary">

252 審查每個更改的檔案並寫一份摘要

253</h3>

254 

255為每個檔案執行審查者，然後將所有發現交給一個代理，該代理對它們進行排名和去重。

256 

257```text theme={null}

258> use a workflow to review every file changed in this PR for correctness issues, then merge the per-file findings into one ranked summary

259```

260 

261<h3 id="research-a-topic-across-many-sources">

262 跨許多來源研究主題

263</h3>

264 

265在變更日誌、問題和文件中展開讀者，然後合成。捆綁的 `/deep-research` 工作流程執行此操作；您也可以描述更狹隘的版本。

266 

267```text theme={null}

268> use a workflow to research how our three competitors handle rate limiting: read their public docs and recent changelog entries in parallel, then compare the approaches

269```

270 

271<h3 id="find-issues-until-the-list-stops-growing">

272 查找問題直到清單停止增長

273</h3>

274 

275持續搜尋並在新輪次發現沒有新內容時停止。

276 

277```text theme={null}

278> use a workflow to find flaky tests in this repo: run the suite repeatedly, record which tests fail intermittently, and stop once two rounds in a row find nothing new

279```

280 

281<h3 id="what-the-saved-script-looks-like">

282 已儲存的指令碼看起來像什麼

283</h3>

284 

285當您[儲存工作流程](#save-the-workflow-for-reuse)時，`.claude/workflows/` 中的檔案保存一個 `meta` 塊，後面跟著協調子代理的指令碼主體。您通常不需要編輯它，但這是一個小的形狀，以便您可以識別 Claude 生成的內容：

286 

287```javascript theme={null}

288export const meta = {

289 name: 'audit-routes',

290 description: 'Audit every route handler for missing auth checks',

291}

292 

293const found = await agent('List every .ts file under src/routes/.', {

294 schema: { type: 'object', required: ['files'], properties: { files: { type: 'array', items: { type: 'string' } } } },

295})

296 

297const audits = await pipeline(found.files, file =>

298 agent(`Audit ${file} for missing authentication checks.`, { label: file }),

299)

300 

301return audits.filter(Boolean)

302```

303 

304主體是具有頂級 `await` 的純 JavaScript。`agent()` 生成一個子代理，`pipeline()` 為清單中的每個項目執行一個。如果您想手動編輯指令碼，請要求 Claude 引導您完成更改，或查看 [Agent SDK 參考](/zh-TW/agent-sdk/typescript)中的 Workflow 工具條目以獲取完整的選項集。

305 

215<h2 id="how-a-workflow-runs">306<h2 id="how-a-workflow-runs">

216 工作流程如何執行307 工作流程如何執行

217</h2>308</h2>