Documentation 2026-10-15 23:58 UTC to 2026-10-16 22:59 UTC

9Hooks 是回調函數，在代理事件發生時執行您的程式碼，例如工具被呼叫、會話啟動或執行停止。使用 hooks，您可以：9Hooks 是回調函數，在代理事件發生時執行您的程式碼，例如工具被呼叫、會話啟動或執行停止。使用 hooks，您可以：

10 10 

11* **阻止危險操作**在執行前，例如破壞性的 shell 命令或未授權的檔案存取11* **阻止危險操作**在執行前，例如破壞性的 shell 命令或未授權的檔案存取

12* **記錄和審計**每個工具呼叫以進行合規性、除錯或分析12* **記錄和稽核**工具呼叫以進行合規性、除錯或分析

13* **轉換輸入和輸出**以清理資料、注入認證或重定向檔案路徑13* **轉換輸入和輸出**以清理資料、注入認證或重定向檔案路徑

14* **要求人工批准**敏感操作，例如資料庫寫入或 API 呼叫14* **要求人工批准**敏感操作，例如資料庫寫入或 API 呼叫

15* **追蹤會話生命週期**以管理狀態、清理資源或傳送通知15* **追蹤會話生命週期**以管理狀態、清理資源或傳送通知

40 </Step>40 </Step>

41</Steps>41</Steps>

42 42 

43以下範例將這些步驟組合在一起。它註冊一個 `PreToolUse` hook（步驟 1），帶有 `"Write|Edit"` matcher（步驟 3），因此回呼只針對檔案寫入工具觸發。觸發時，回呼接收工具的輸入（步驟 4），檢查檔案路徑是否指向 `.env` 檔案，並返回 `permissionDecision: "deny"` 以阻止操作（步驟 5）：43此範例註冊一個 `PreToolUse` hook（步驟 1），帶有 `"Write|Edit"` matcher（步驟 3），因此回呼會針對 Write 和 Edit 工具觸發。觸發時，回呼接收工具的輸入（步驟 4），檢查檔案路徑是否指向 `.env` 檔案，並返回 `permissionDecision: "deny"` 以阻止操作（步驟 5）：

44 44 

45<CodeGroup>45<CodeGroup>

46 ```python Python theme={null}46 ```python Python theme={null}

61 file_name = file_path.split("/")[-1]61 file_name = file_path.split("/")[-1]

62 62 

63 # 如果指向 .env 檔案，阻止操作63 # 如果指向 .env 檔案，阻止操作

64 if file_name == ".env":64 if file_name.lower() == ".env":

65 return {65 return {

66 "hookSpecificOutput": {66 "hookSpecificOutput": {

67 "hookEventName": input_data["hook_event_name"],67 "hookEventName": input_data["hook_event_name"],

108 const fileName = filePath?.split("/").pop();108 const fileName = filePath?.split("/").pop();

109 109 

110 // 如果指向 .env 檔案，阻止操作110 // 如果指向 .env 檔案，阻止操作

111 if (fileName === ".env") {111 if (fileName?.toLowerCase() === ".env") {

112 return {112 return {

113 hookSpecificOutput: {113 hookSpecificOutput: {

114 hookEventName: preInput.hook_event_name,114 hookEventName: preInput.hook_event_name,

140 ```140 ```

141</CodeGroup>141</CodeGroup>

142 142 

143當您執行任一指令碼時，Claude 會嘗試建立 `.env` 檔案，而 hook 會拒絕該工具呼叫。143此 hook 會拒絕 `file_path` 以 `/.env` 結尾的 Write 或 Edit 呼叫，不分大小寫。在 Windows 上，`file_path` 使用反斜線，例如 `C:\project\.env`，因此此 hook 會允許對 `C:\project\.env` 的 Write 或 Edit 呼叫。

144 

145<Warning>

146 `Write|Edit` matcher 將此 hook 限制於 Write 和 Edit 工具。如果 Claude 使用 Bash 命令寫入 `.env`，此 hook 不會執行。若要在[沙箱執行](/docs/zh-TW/sandboxing)的情況下阻止 Bash 寫入檔案，請參閱 [Python](/docs/zh-TW/agent-sdk/python#sandbox-configuration) 或 [TypeScript](/docs/zh-TW/agent-sdk/typescript#sandbox-configuration) 的沙箱設定。

147</Warning>

144 148 

145<h2 id="available-hooks">149<h2 id="available-hooks">

146 可用的 hooks150 可用的 hooks

151| Hook 事件 | Python SDK | TypeScript SDK | 觸發條件 | 使用案例範例 |155| Hook 事件 | Python SDK | TypeScript SDK | 觸發條件 | 使用案例範例 |

152| - | - | - | - | - |156| - | - | - | - | - |

153| `PreToolUse` | 是 | 是 | 工具呼叫請求（可以阻止或修改） | 阻止危險的 shell 命令 |157| `PreToolUse` | 是 | 是 | 工具呼叫請求（可以阻止或修改） | 阻止危險的 shell 命令 |

154| `PostToolUse` | 是 | 是 | 工具執行結果 | 將所有檔案變更記錄到審計追蹤 |158| `PostToolUse` | 是 | 是 | 工具執行結果 | 將檔案變更記錄到審計追蹤 |

155| `PostToolUseFailure` | 是 | 是 | 工具執行失敗 | 處理或記錄工具錯誤 |159| `PostToolUseFailure` | 是 | 是 | 工具執行失敗 | 處理或記錄工具錯誤 |

156| `PostToolBatch` | 否 | 是 | 一整批工具呼叫解決，每批一次，在下一個模型呼叫之前 | 為整個批次注入約定 |160| `PostToolBatch` | 否 | 是 | 一整批工具呼叫解決，每批一次，在下一個模型呼叫之前 | 為整個批次注入約定 |

157| [`UserPromptSubmit`](/docs/zh-TW/hooks#userpromptsubmit) | 是 | 是 | 提交提示詞時，包括 Claude Code 自行開始的回合 | 將額外上下文注入提示詞 |161| [`UserPromptSubmit`](/docs/zh-TW/hooks#userpromptsubmit) | 是 | 是 | 提交提示詞時，包括 Claude Code 自行開始的回合 | 將額外上下文注入提示詞 |

235| `hooks` | `HookCallback[]` | - | 必需。當模式比對成功時執行的回調函數陣列 |239| `hooks` | `HookCallback[]` | - | 必需。當模式比對成功時執行的回調函數陣列 |

236| `timeout` | `number` | `undefined` | 逾時時間（秒）。省略時，Claude Code 會套用[事件的預設逾時](#hook-timeout)。您的 SDK 回調遵循 `command` hook 預設值 |240| `timeout` | `number` | `undefined` | 逾時時間（秒）。省略時，Claude Code 會套用[事件的預設逾時](#hook-timeout)。您的 SDK 回調遵循 `command` hook 預設值 |

237 241 

238盡可能使用 `matcher` 模式來針對特定工具。帶有 `'Bash'` 的 matcher 只針對 Bash 命令執行，而省略模式會針對事件的每次出現執行您的回調。故意省略它以記錄您的工作階段進行的每個工具呼叫。242盡可能使用 `matcher` 模式來針對特定工具。帶有 `'Bash'` 的 matcher 只針對 Bash 命令執行，而省略模式會針對事件的每次出現執行您的回調。

239 243 

240<h3 id="callback-functions">244<h3 id="callback-functions">

241 回調函數245 回調函數

268返回 `{}` 以允許操作而不進行變更。SDK 回調 hook 使用與 [Claude Code shell 命令 hook](/docs/zh-TW/hooks#json-output) 相同的 JSON 輸出格式，其記錄每個欄位和事件特定選項。對於 SDK 類型定義，請參閱 [TypeScript](/docs/zh-TW/agent-sdk/typescript#synchookjsonoutput) 和 [Python](/docs/zh-TW/agent-sdk/python#synchookjsonoutput) SDK 參考。272返回 `{}` 以允許操作而不進行變更。SDK 回調 hook 使用與 [Claude Code shell 命令 hook](/docs/zh-TW/hooks#json-output) 相同的 JSON 輸出格式，其記錄每個欄位和事件特定選項。對於 SDK 類型定義，請參閱 [TypeScript](/docs/zh-TW/agent-sdk/typescript#synchookjsonoutput) 和 [Python](/docs/zh-TW/agent-sdk/python#synchookjsonoutput) SDK 參考。

269 273 

270<Note>274<Note>

271 當多個 hook 或權限規則適用時，`deny` 優先於 `defer`，`defer` 優先於 `ask`，`ask` 優先於 `allow`。如果任何 hook 返回 `deny`，操作將被阻止，無論其他 hook 如何。275 當多個 `PreToolUse` hook 返回不同的[決策](/docs/zh-TW/hooks#pretooluse-decision-control)時，`deny` 優先於 `defer`，`defer` 優先於 `ask`，`ask` 優先於 `allow`。

272</Note>276</Note>

273 277 

274<h4 id="asynchronous-output">278<h4 id="asynchronous-output">

313 修改工具輸入317 修改工具輸入

314</h3>318</h3>

315 319 

316此範例攔截 Write 工具呼叫並重寫 `file_path` 參數以預先加上 `/sandbox`，將所有檔案寫入重定向到沙箱目錄。回調返回帶有修改路徑的 `updatedInput` 和 `permissionDecision: 'allow'` 以自動批准重寫的操作：320此範例攔截 Write 工具呼叫並重寫 `file_path` 引數以預先加上 `/sandbox`。回調返回帶有修改路徑的 `updatedInput` 和 `permissionDecision: 'allow'` 以自動批准重寫的操作：

317 321 

318<CodeGroup>322<CodeGroup>

319 ```python Python theme={null}323 ```python Python theme={null}

370 新增上下文並阻止工具374 新增上下文並阻止工具

371</h3>375</h3>

372 376 

373此範例阻止寫入 `/etc` 目錄並向模型和使用者解釋原因：377此範例拒絕 `file_path` 以 `/etc` 開頭的工具呼叫，並向模型和使用者解釋原因：

374 378 

375* `permissionDecision: 'deny'` 停止工具呼叫。379* `permissionDecision: 'deny'` 停止工具呼叫。

376* `permissionDecisionReason` 告訴模型原因，以便它避免重試。380* `permissionDecisionReason` 告訴模型原因。

377* `systemMessage` 向使用者顯示發生了什麼。381* `systemMessage` 向使用者顯示發生了什麼。

378 382 

379<CodeGroup>383<CodeGroup>

468 註冊多個 hooks472 註冊多個 hooks

469</h3>473</h3>

470 474 

471當事件觸發時，所有匹配的 hooks 並行執行。對於權限決定，最嚴格的結果獲勝：單個 `deny` 會阻止工具呼叫，無論其他 hooks 返回什麼。由於完成順序是不確定的，請編寫每個 hook 以獨立行動，而不是依賴另一個 hook 已執行。475當事件觸發時，符合的 hook 會並行執行。對於權限決定，以最嚴格的結果為準。任一 hook 的 `deny` 都會阻止工具呼叫。由於完成順序是不確定的，請編寫每個 hook 以獨立運作，而不是依賴另一個 hook 已先執行。

472 476 

473下面的範例為每個工具呼叫註冊三個獨立檢查。範例中的 hook 名稱，例如 Python 中的 `audit_logger` 或 TypeScript 中的 `auditLogger`，代表您定義的回調：477下面的範例註冊三個獨立檢查，每個都[省略 matcher](/docs/zh-TW/hooks#matcher-patterns)。範例中的 hook 名稱，例如 Python 中的 `audit_logger` 或 TypeScript 中的 `auditLogger`，代表您定義的回調：

474 478 

475<CodeGroup>479<CodeGroup>

476 ```python Python theme={null}480 ```python Python theme={null}

504 508 

505使用多工具匹配器在相關工具間共享一個回調。此範例註冊三個具有不同範圍的匹配器，每個 hook 它命名代表您定義的回調：509使用多工具匹配器在相關工具間共享一個回調。此範例註冊三個具有不同範圍的匹配器，每個 hook 它命名代表您定義的回調：

506 510 

507* 管道分隔的精確列表（`Write|Edit|NotebookEdit`）僅針對檔案修改工具觸發 `file_security_hook`。511* 管道分隔的精確列表（`Write|Edit|NotebookEdit`）針對 Write、Edit 和 NotebookEdit 工具觸發 `file_security_hook`。

508* 正規表達式（`^mcp__`）針對任何名稱以 `mcp__` 開頭的 MCP 工具觸發 `mcp_audit_hook`。512* 正規表達式（`^mcp__`）針對任何名稱以 `mcp__` 開頭的 MCP 工具觸發 `mcp_audit_hook`。

509* 省略的匹配器針對每個工具呼叫（無論名稱如何）觸發 `global_logger`。513* 省略的 matcher 觸發 `global_logger`，不依工具名稱篩選。

510 514 

511<CodeGroup>515<CodeGroup>

512 ```python Python theme={null}516 ```python Python theme={null}

832 836 

833當回調超過其逾時時間時，Claude Code 取消它並捨棄其輸出，工作階段繼續而不是掛起。接下來發生的情況取決於事件：837當回調超過其逾時時間時，Claude Code 取消它並捨棄其輸出，工作階段繼續而不是掛起。接下來發生的情況取決於事件：

834 838 

835* `PreToolUse`：Claude Code 不執行工具呼叫，Claude 收到工具結果，說明 hook 未在逾時前回應，回合繼續。如果另一個 `PreToolUse` hook 返回明確拒絕，Claude 改為收到該拒絕而不是逾時錯誤。在 v2.1.210 之前，Claude Code 將逾時報告給 Claude 作為使用者拒絕，這使無人值守工作階段停止並等待輸入。839* `PreToolUse`：Claude Code 阻止工具呼叫。取而代之的是，Claude 收到工具結果，說明 hook 未在逾時前回應，回合繼續。在 v2.1.210 之前，Claude Code 將逾時報告給 Claude 作為使用者拒絕，這使無人值守工作階段停止並等待輸入。

836* `PostToolUse` 和 `PostToolUseFailure`：Claude Code 保留工具結果，回合繼續。840* `PostToolUse` 和 `PostToolUseFailure`：Claude Code 保留工具結果，回合繼續。

837* `UserPromptSubmit` 和 [`UserPromptExpansion`](/docs/zh-TW/hooks#userpromptexpansion)：Claude Code 以指出 hook 名稱和逾時的訊息阻止提示詞，工作階段繼續。因為這些事件上的回調可以充當政策閘門，Claude Code 永遠不會讓逾時的提示詞未經篩選就通過。在 v2.1.208 之前，當這些事件上的回調逾時時，Claude Code 以 `error_during_execution` 結束查詢。841* `UserPromptSubmit` 和 [`UserPromptExpansion`](/docs/zh-TW/hooks#userpromptexpansion)：Claude Code 以指出 hook 名稱和逾時的訊息阻止提示詞，工作階段繼續。在 v2.1.208 之前，當這些事件上的回調逾時時，Claude Code 以 `error_during_execution` 結束查詢。

838* `Stop` 和 `SubagentStop`：逾時的回調計為不返回任何決定。Agent 或 subagent 停止，如同該回調已允許它，而您其他 hook 在該事件上的決定仍然適用。在 Claude Code v2.1.273 之前，逾時的 `Stop` 或 `SubagentStop` 回調計為失敗的 hook 執行，Claude Code 捨棄您其他 hook 在該事件上的決定。842* `Stop` 和 `SubagentStop`：逾時的回調計為不返回任何決定。Agent 或 subagent 停止，如同該回調已允許它，而您其他 hook 在該事件上的決定仍然適用。在 Claude Code v2.1.273 之前，逾時的 `Stop` 或 `SubagentStop` 回調計為失敗的 hook 執行，Claude Code 捨棄您其他 hook 在該事件上的決定。

839* `SessionStart`：逾時的回調計為不返回任何輸出，工作階段繼續，使用您其他 `SessionStart` hook 的輸出。843* `SessionStart`：逾時的回調計為不返回任何輸出，工作階段繼續，使用您其他 `SessionStart` hook 的輸出。

840* `PreModelSwitch`：Claude Code 阻止模型切換。未回答的 hook 尚未核准切換。844* `PreModelSwitch`：Claude Code 阻止模型切換。未回答的 hook 尚未核准切換。

3881<Note>3881<Note>

3882 沙箱取決於平台支援，在 Linux 上，需要 `bubblewrap` 和 `socat` 等工具。預設情況下，當 `enabled` 為 `True` 但沙箱無法啟動時，命令會在沙箱外執行，並在 stderr 上顯示警告。此預設與 TypeScript SDK 不同，其中 `failIfUnavailable` 預設為 `true`。3882 沙箱取決於平台支援，在 Linux 上，需要 `bubblewrap` 和 `socat` 等工具。預設情況下，當 `enabled` 為 `True` 但沙箱無法啟動時，命令會在沙箱外執行，並在 stderr 上顯示警告。此預設與 TypeScript SDK 不同，其中 `failIfUnavailable` 預設為 `true`。

3883 3883 

3884 在沙箱設定中設定 `"failIfUnavailable": True` 以改為停止。該鍵尚未在 `SandboxSettings` 上宣告，但 SDK 會將其轉發給 Claude Code，後者會遵守它。`query()` 然後報告 `ResultMessage`，其中 `subtype="error_during_execution"` 且原因在 `errors` 中。因為這是單次 `query()` 呼叫，SDK 會在產生該錯誤結果後引發，所以將迴圈包裝在 try 區塊中以繼續通過它。請參閱[處理結果](/docs/zh-TW/agent-sdk/agent-loop#handle-the-result)以了解錯誤合約。3884 在沙箱設定中設定 `"failIfUnavailable": True` 以改為停止。SDK 會將 `failIfUnavailable` 連同已宣告的 `SandboxSettings` 欄位一起轉發給 Claude Code。`query()` 接著會回報 `ResultMessage`，其中 `subtype="error_during_execution"` 且原因在 `errors` 中。因為這是單次 `query()` 呼叫，SDK 會在產生該錯誤結果後引發例外，所以請將迴圈包裝在 try 區塊中以便繼續執行。請參閱[處理結果](/docs/zh-TW/agent-sdk/agent-loop#handle-the-result)以了解錯誤合約。

3885</Note>3885</Note>

3886 3886 

3887若要防止沙箱化命令寫入某個檔案，請在沙箱設定的 [`denyWrite`](/docs/zh-TW/settings-reference#sandbox-filesystem-denywrite) 下列出其絕對路徑，例如 `"filesystem": {"denyWrite": ["/home/user/project/.env"]}`。SDK 會將 `filesystem` 連同已宣告的 `SandboxSettings` 欄位一起轉發給 Claude Code。沙箱啟動後，會封鎖對每個列出路徑的寫入。如果您列出 `.env` 或 `./.env`，沙箱化命令仍可以寫入工作階段工作目錄中的 `.env` 檔案。

3888 

3887<h4 id="example-usage">3889<h4 id="example-usage">

3888 範例使用3890 範例使用

3889</h4>3891</h4>

557[Claude Code Skills 指南](/docs/zh-TW/skills) 涵蓋了深入的編寫。其指導適用於 SDK 會話。從這些部分開始：557[Claude Code Skills 指南](/docs/zh-TW/skills) 涵蓋了深入的編寫。其指導適用於 SDK 會話。從這些部分開始：

558 558 

559* [Frontmatter 參考](/docs/zh-TW/skills#frontmatter-reference)：每個支持的欄位559* [Frontmatter 參考](/docs/zh-TW/skills#frontmatter-reference)：每個支持的欄位

560* [將參數傳遞給 Skills](/docs/zh-TW/skills#pass-arguments-to-skills)：`$ARGUMENTS`、`$0`、`$1` 和 Skill 堆疊。[完整替換表](/docs/zh-TW/skills#available-string-substitutions) 添加命名參數和 `${CLAUDE_*}` 變數560* [將引數傳遞給 skills](/docs/zh-TW/skills#pass-arguments-to-skills)：`$ARGUMENTS`、`$0` 和 `$1`。[完整替換表](/docs/zh-TW/skills#available-string-substitutions) 另外加入了具名引數與 `${CLAUDE_*}` 變數

561* [注入動態上下文](/docs/zh-TW/skills#inject-dynamic-context)：`` !`command` `` 行在 Claude 看到 Skill 內容之前運行561* [注入動態上下文](/docs/zh-TW/skills#inject-dynamic-context)：`` !`command` `` 行在 Claude 看到 Skill 內容之前運行

562* [選擇 Skills 加載的位置](/docs/zh-TW/skills#where-skills-live)：每個 Skill 位置、外掛命名空間以及兩個共享名稱時哪個 Skill 運行562* [選擇 Skills 加載的位置](/docs/zh-TW/skills#where-skills-live)：每個 Skill 位置、外掛命名空間以及兩個共享名稱時哪個 Skill 運行

563 563 

6369| 屬性 | 類型 | 預設值 | 說明 |6369| 屬性 | 類型 | 預設值 | 說明 |

6370| :- | :- | :- | :- |6370| :- | :- | :- | :- |

6371| `allowWrite` | `string[]` | `[]` | 允許寫入存取的檔案路徑模式 |6371| `allowWrite` | `string[]` | `[]` | 允許寫入存取的檔案路徑模式 |

6372| `denyWrite` | `string[]` | `[]` | 拒絕寫入存取的檔案路徑模式 |6372| `denyWrite` | `string[]` | `[]` | 拒絕寫入存取的檔案路徑模式。若要封鎖 sandboxed 命令寫入工作階段工作目錄中的檔案，請列出其絕對路徑。如果您列出 `.env` 或 `./.env`，sandboxed 命令仍可寫入工作階段工作目錄中的 `.env` 檔案 |

6373| `denyRead` | `string[]` | `[]` | 拒絕讀取存取的檔案路徑模式 |6373| `denyRead` | `string[]` | `[]` | 拒絕讀取存取的檔案路徑模式 |

6374 6374 

6375<h3 id="permissions-fallback-for-unsandboxed-commands">6375<h3 id="permissions-fallback-for-unsandboxed-commands">

231 231 

232主管發送關閉請求。隊友可以批准並優雅地退出，或拒絕並提供解釋。232主管發送關閉請求。隊友可以批准並優雅地退出，或拒絕並提供解釋。

233 233 

234團隊的共享目錄在工作階段結束時會自動清理，因此沒有單獨的清理步驟。請參閱[架構](#architecture)以了解哪些目錄被移除以及哪些目錄為已恢復的工作階段保留。234團隊的共享目錄在工作階段結束時會自動清理，因此沒有單獨的清理步驟。請參閱[架構](#architecture)以了解哪些目錄被移除以及哪些目錄保留在磁碟上。

235 235 

236<h3 id="enforce-quality-gates-with-hooks">236<h3 id="enforce-quality-gates-with-hooks">

237 使用 hooks 強制執行品質閘門237 使用 hooks 強制執行品質閘門

278 278 

279團隊和任務存儲在本地，名稱來自工作階段衍生的名稱。名稱是 `session-` 後跟工作階段 ID 的前八個字元：279團隊和任務存儲在本地，名稱來自工作階段衍生的名稱。名稱是 `session-` 後跟工作階段 ID 的前八個字元：

280 280 

281* **Team config**：`~/.claude/teams/{team-name}/config.json`281* **Team config**：`~/.claude/teams/{team-name}/config.json`。Claude Code 會在工作階段結束時移除團隊設定目錄。

282* **Task list**：`~/.claude/tasks/{team-name}/`282* **Task list**：`~/.claude/tasks/{team-name}/`。此目錄在工作階段結束後會保留在磁碟上。若要變更 [Claude Code 保留它的時間長度](/docs/zh-TW/claude-directory#cleaned-up-automatically)，請設定 [`cleanupPeriodDays`](/docs/zh-TW/settings-reference#cleanupperioddays)。

283 283 

284Claude Code 在工作階段啟動時自動生成這兩者，並在隊友加入、閒置或離開時更新它們。團隊配置目錄在工作階段結束時被移除。任務列表目錄在本地保留，永遠不會上傳，因此恢復的工作階段會保留其任務。保留期由您已經控制的相同 [`cleanupPeriodDays`](/docs/zh-TW/settings-reference#cleanupperioddays) 管理，用於工作階段記錄，遵循[保留掃描規則](/docs/zh-TW/claude-directory#cleaned-up-automatically)。284Claude Code 在工作階段啟動時自動生成這兩者，並在隊友加入、閒置或離開時更新它們。

285 285 

286團隊配置保存運行時狀態，例如工作階段 ID 和 tmux 窗格 ID，因此不要手動編輯或預先編寫它：您的變更會在下次狀態更新時被覆蓋。286團隊配置保存運行時狀態，例如工作階段 ID 和 tmux 窗格 ID，因此不要手動編輯或預先編寫它：您的變更會在下次狀態更新時被覆蓋。

287 287 

12We're changing auto mode to no longer charge for classifier requests in Claude Code. However, this session isn't eligible.12We're changing auto mode to no longer charge for classifier requests in Claude Code. However, this session isn't eligible.

13```13```

14 14 

15在提示處，Claude Code 會暫停它要以這種方式檢查的第一個動作，直到您回答。沒有任何問題：auto mode 會繼續運作，其分類器請求會像以前一樣被計費。最常見的原因是 Claude Code 和 API 之間有 LLM 閘道或代理，當 Claude Code 能夠識別一個時，通知會命名它。按下 **Enter** 繼續，或參閱 [使工作階段符合資格](#make-the-session-eligible) 以防止它在新工作階段中出現。15在提示處，Claude Code 會暫停它要以這種方式檢查的第一個動作，直到您回答。自動模式會繼續運作，其分類器請求會像以前一樣被計費。

16 

17最常見的原因是 Claude Code 和 API 之間有 LLM 閘道或代理伺服器，當 Claude Code 能夠識別出來時，通知會指出其名稱。按下 **Enter** 繼續，或參閱[使工作階段符合資格](#make-the-session-eligible)以防止它在新工作階段中出現。

16 18 

17<h2 id="respond-to-the-notice">19<h2 id="respond-to-the-notice">

18 回應通知20 回應通知

45 如果安裝失敗，請對照 Claude Code 報告的訊息：45 如果安裝失敗，請對照 Claude Code 報告的訊息：

46 46 

47 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。47 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。

48 * 外掛程式[在市集中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛程式名稱。48 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`：您本機的市集目錄副本可能已過時。使用 `/plugin marketplace update claude-plugins-official` 重新整理，然後重試安裝。如果重試後顯示相同的訊息，請參閱[在市集中找不到外掛程式](/docs/zh-TW/plugins/troubleshooting#plugin-not-found-in-marketplace)。

49 49 

50 當安裝要求安裝範圍時，選擇使用者範圍選項，以便外掛程式在所有專案中可用。檢查安裝摘要：如果報告 `Run /reload-plugins to apply.`，請參閱[在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins)以使外掛程式的設定命令可用。50 當安裝要求安裝範圍時，選擇使用者範圍選項，以便外掛程式在所有專案中可用。檢查安裝摘要：如果報告 `Run /reload-plugins to apply.`，請參閱[在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins)以使外掛程式的設定命令可用。

51 </Step>51 </Step>

123 如果安裝失敗，請對照 Claude Code 報告的訊息：123 如果安裝失敗，請對照 Claude Code 報告的訊息：

124 124 

125 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。125 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。

126 * 外掛程式[在市集中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛程式名稱。126 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`：您本機的市集目錄副本可能已過時。使用 `/plugin marketplace update claude-plugins-official` 重新整理，然後重試安裝。如果重試後顯示相同的訊息，請參閱[在市集中找不到外掛程式](/docs/zh-TW/plugins/troubleshooting#plugin-not-found-in-marketplace)。

127 127 

128 當安裝要求安裝範圍時，選擇使用者範圍選項，以便外掛程式在所有專案中可用。檢查安裝摘要：如果報告 `Run /reload-plugins to apply.`，請參閱[在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins)以使外掛程式的設定命令可用。128 當安裝要求安裝範圍時，選擇使用者範圍選項，以便外掛程式在所有專案中可用。檢查安裝摘要：如果報告 `Run /reload-plugins to apply.`，請參閱[在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins)以使外掛程式的設定命令可用。

129 </Step>129 </Step>

188 如果安裝失敗，請對照 Claude Code 報告的訊息：188 如果安裝失敗，請對照 Claude Code 報告的訊息：

189 189 

190 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。190 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。

191 * 外掛程式[在市集中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛程式名稱。191 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`：您本機的市集目錄副本可能已過時。使用 `/plugin marketplace update claude-plugins-official` 重新整理，然後重試安裝。如果重試後顯示相同的訊息，請參閱[在市集中找不到外掛程式](/docs/zh-TW/plugins/troubleshooting#plugin-not-found-in-marketplace)。

192 192 

193 當安裝要求安裝範圍時，選擇使用者範圍選項，以便外掛程式在所有專案中可用。193 當安裝要求安裝範圍時，選擇使用者範圍選項，以便外掛程式在所有專案中可用。

194 194 

247 如果安裝失敗，請對照 Claude Code 報告的訊息：247 如果安裝失敗，請對照 Claude Code 報告的訊息：

248 248 

249 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。249 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。

250 * 外掛程式[在市集中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛程式名稱。250 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`：您本機的市集目錄副本可能已過期。使用 `/plugin marketplace update claude-plugins-official` 重新整理，然後重試安裝。如果重試時顯示相同的訊息，請參閱[在市集中找不到外掛程式](/docs/zh-TW/plugins/troubleshooting#plugin-not-found-in-marketplace)。

251 251 

252 當安裝要求選擇安裝範圍時，選擇使用者範圍選項，以便外掛程式在您的所有專案中可用。252 當安裝要求選擇安裝範圍時，選擇使用者範圍選項，以便外掛程式在您的所有專案中可用。

253 253 

290 note: commandsNote,290 note: commandsNote,

291 when: <>User types <C>/command-name</C></>,291 when: <>User types <C>/command-name</C></>,

292 description: <>A file at <C>commands/deploy.md</C> creates <C>/deploy</C> the same way a skill at <C>skills/deploy/SKILL.md</C> does, and both can be auto-invoked by Claude. Skills use a directory with SKILL.md, letting you bundle reference docs, templates, or scripts alongside the prompt.</>,292 description: <>A file at <C>commands/deploy.md</C> creates <C>/deploy</C> the same way a skill at <C>skills/deploy/SKILL.md</C> does, and both can be auto-invoked by Claude. Skills use a directory with SKILL.md, letting you bundle reference docs, templates, or scripts alongside the prompt.</>,

293 tips: [<>Use <C>$ARGUMENTS</C> in the file to accept parameters: <C>/fix-issue 123</C></>, 'If a skill and command share a name, the skill takes precedence', 'New commands should usually be skills instead; commands remain supported'],293 tips: [<>Use <C>$ARGUMENTS</C> in the file to accept parameters: <C>/fix-issue 123</C></>, 'If a skill and command share a name, the skill takes precedence', 'New commands should usually be skills instead; command files still work'],

294 docsLink: '/en/skills',294 docsLink: '/en/skills',

295 children: [{295 children: [{

296 id: 'cmd-example',296 id: 'cmd-example',

48 48 

49該命令會開啟外掛程式的詳細資訊，您可以在其中選擇[安裝範圍](/docs/zh-TW/plugins/install#install-a-plugin)以開始安裝。49該命令會開啟外掛程式的詳細資訊，您可以在其中選擇[安裝範圍](/docs/zh-TW/plugins/install#install-a-plugin)以開始安裝。

50 50 

51如果安裝失敗，修復方法取決於 Claude Code 報告的訊息：51如果安裝失敗，請對照 Claude Code 報告的訊息：

52 52 

53* 如果它報告 `Marketplace "claude-plugins-official" not found`，使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。53* `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。

54* 如果它報告[在市集中找不到外掛程式](/docs/zh-TW/plugins/install#install-a-plugin)，檢查外掛程式名稱是否有拼寫錯誤。54* `Plugin "claude-security" not found in marketplace "claude-plugins-official"`：您本機的市集目錄副本可能已過時。請使用 `/plugin marketplace update claude-plugins-official` 重新整理，然後重試安裝。如果重試後仍顯示相同訊息，請參閱[在市集中找不到外掛程式](/docs/zh-TW/plugins/troubleshooting#plugin-not-found-in-marketplace)。

55 55 

56檢查安裝摘要。如果它報告 `Run /reload-plugins to apply.`，請參閱[在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins)以在您目前的工作階段中啟用外掛程式。56檢查安裝摘要。如果它報告 `Run /reload-plugins to apply.`，請參閱[在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins)以在您目前的工作階段中啟用外掛程式。

57 57 

118在 effort 等級與旗標之後，Claude Code 會將該行的其餘部分讀取為審查目標。`ultra` 引數會改變這種解讀方式：118在 effort 等級與旗標之後，Claude Code 會將該行的其餘部分讀取為審查目標。`ultra` 引數會改變這種解讀方式：

119 119 

120* **使用 `ultra` 時**：Claude Code 會將單一字詞讀取為基底分支或 PR 編號。未指明分支或 PR 的較長文字會成為[附加到審查的備註](/docs/zh-TW/ultrareview#pass-a-request-in-plain-words)。`/code-review ultra check my auth changes` 會審查您目前的分支，而 Claude 會將發現的問題與您的備註相關聯。120* **使用 `ultra` 時**：Claude Code 會將單一字詞讀取為基底分支或 PR 編號。未指明分支或 PR 的較長文字會成為[附加到審查的備註](/docs/zh-TW/ultrareview#pass-a-request-in-plain-words)。`/code-review ultra check my auth changes` 會審查您目前的分支，而 Claude 會將發現的問題與您的備註相關聯。

121* **未使用 `ultra` 時**：剩餘的所有內容都是審查目標，即使它以另一個命令名稱開頭也一樣。`/code-review /fix-issue 123` 會以 `/fix-issue 123` 作為目標文字進行審查，而不是將 `/fix-issue` 載入為第二個[堆疊的 skill](/docs/zh-TW/skills#pass-arguments-to-skills)。在 v2.1.218 之前，堆疊在 `/code-review` 之後的命令會展開為其自己的 skill。121* **未使用 `ultra` 時**：剩餘的所有內容都是審查目標，即使它以另一個命令名稱開頭也一樣。`/code-review /fix-issue 123` 會以 `/fix-issue 123` 作為目標文字進行審查，而不是將 `/fix-issue` 載入為第二個[堆疊的 skill](/docs/zh-TW/skills#stack-several-skills-in-one-message)。在 v2.1.218 之前，堆疊在 `/code-review` 之後的命令會展開為其自己的 skill。

122 122 

123<h2 id="run-in-the-foreground">123<h2 id="run-in-the-foreground">

124 在前景執行124 在前景執行

10 10 

11輸入 `/` 以查看可用的命令，或輸入 `/` 後跟字母以篩選。[命令菜單如何匹配您輸入的內容](#how-the-command-menu-matches-what-you-type)涵蓋了突出顯示、拼寫錯誤以及 Claude Code 隱藏的少數命令，直到您輸入其完整名稱。11輸入 `/` 以查看可用的命令，或輸入 `/` 後跟字母以篩選。[命令菜單如何匹配您輸入的內容](#how-the-command-menu-matches-what-you-type)涵蓋了突出顯示、拼寫錯誤以及 Claude Code 隱藏的少數命令，直到您輸入其完整名稱。

12 12 

13命令只在您的訊息開始時被識別。命令名稱後面的文字成為其引數。[Skills](/docs/zh-TW/skills#pass-arguments-to-skills) 是例外：一個 skill 呼叫後跟更多 skills，例如 `/skill-a /skill-b do XYZ`，會載入開始時命名的 skills，並將尾部文字作為引數傳遞給每個 skill。最多可以串連六個 skills。13命令只在您的訊息開始時被識別。命令名稱後面的文字成為其引數。在終端機提示字元中，您可以在一則訊息的開頭使用多個 [skills](/docs/zh-TW/skills#stack-several-skills-in-one-message)：輸入 `/skill-a /skill-b do XYZ` 會載入這兩個 skills，並將尾部文字作為引數傳遞給每個 skill。最多可以串連六個 skills。

14 14 

15如果您在 Claude 回應時發送命令，Claude Code 會將其排隊，並在目前回合完成後執行。Claude Code 會立即執行某些命令而不中斷回應，例如 `/status`、`/tasks` 和 `/usage`。在[全螢幕渲染](/docs/zh-TW/fullscreen)中，Claude Code 也會立即開啟對話命令，例如 `/theme` 和 `/help`。在 v2.1.234 之前，Claude Code 會將這些對話排隊直到回合完成。15如果您在 Claude 回應時發送命令，Claude Code 會將其排隊，並在目前回合完成後執行。Claude Code 會立即執行某些命令而不中斷回應，例如 `/status`、`/tasks` 和 `/usage`。在[全螢幕渲染](/docs/zh-TW/fullscreen)中，Claude Code 也會立即開啟對話命令，例如 `/theme` 和 `/help`。在 v2.1.234 之前，Claude Code 會將這些對話排隊直到回合完成。

16 16 

1137</Warning>1137</Warning>

1138 1138 

1139* **睡眠或網路中斷之後**：如果程序[仍在執行](#limits-while-desktop-is-disconnected)且 Desktop 能在無提示的情況下登入，您就能取回執行中的任務。如果無法，請[傳送訊息](#reconnect-after-sleep-or-a-network-loss)。1139* **睡眠或網路中斷之後**：如果程序[仍在執行](#limits-while-desktop-is-disconnected)且 Desktop 能在無提示的情況下登入，您就能取回執行中的任務。如果無法，請[傳送訊息](#reconnect-after-sleep-or-a-network-loss)。

1140* **結束之後，Desktop 在 macOS 或 Linux 上且使用 Claude 帳戶**：如果 Desktop 能[重新加入該程序](#reopen-a-session-after-you-quit-desktop)，您就能取回執行中的任務。如果無法，任務會停止。如果任務持續停止，請傳送訊息。1140* **結束後**：任務會繼續執行，但除非 Desktop 能重新加入其程序，否則在工作階段再次開啟時您會失去該任務。結束前，請查看 [Desktop 何時能重新加入](#reopen-a-session-after-you-quit-desktop)。如果您失去了任務，請傳送訊息以繼續。

1141* **結束之後，Desktop 在 Windows 上或使用[第三方供應商](/docs/zh-TW/third-party-integrations)**：您會失去執行中的任務，因為 Desktop 會在工作階段開啟時終止該程序。請傳送訊息以繼續。

1142 1141 

1143當您回來且任務尚未完成時，請檢查是否有 Desktop 無法重新連線的訊息、身分驗證錯誤或等待中的請求：1142當您回來且任務尚未完成時，請檢查是否有 Desktop 無法重新連線的訊息、身分驗證錯誤或等待中的請求：

1144 1143 

1154</h5>1153</h5>

1155 1154 

1156* **先更新**：在開始長時間任務之前更新 Desktop。在 macOS 和 Windows 上，Desktop 可能會自行重新啟動以安裝已下載的更新。當 Claude 正在處理 SSH 任務時，該重新啟動會等待。在 macOS 上使用 Claude 帳戶時，預設情況下，一旦更新已等待 72 小時，重新啟動仍可能會進行。1155* **先更新**：在開始長時間任務之前更新 Desktop。在 macOS 和 Windows 上，Desktop 可能會自行重新啟動以安裝已下載的更新。當 Claude 正在處理 SSH 任務時，該重新啟動會等待。在 macOS 上使用 Claude 帳戶時，預設情況下，一旦更新已等待 72 小時，重新啟動仍可能會進行。

1157* **不要結束 Desktop**：如果 Desktop 在 Windows 上執行或使用第三方供應商，請在長時間任務執行期間讓它保持開啟。結束之後，它會在工作階段開啟時[終止執行中的任務](#reopen-a-session-after-you-quit-desktop)。讓它保持開啟並不能保護[等待您處理](#handle-requests-that-arrive-while-you-are-away)的請求。1156* **不要在 Windows 上結束，或在使用第三方供應商且版本早於 v2.42304.0 時結束**：在這些情況下結束後，您會失去執行中的任務，因此請在任務期間讓 Desktop 保持開啟。在其他任何情況下，請在結束前查看[您能取回什麼](#reopen-a-session-after-you-quit-desktop)。

1158* **減少請求**：選擇能[讓任務較少等待您](#handle-requests-that-arrive-while-you-are-away)的權限模式、規則或 hook1157* **減少請求**：選擇能[讓任務較少等待您](#handle-requests-that-arrive-while-you-are-away)的權限模式、規則或 hook

1159* **檢查跳板主機**：如果您的跳板主機要求登入（例如推送到手機），請改用無需提示即可運作的登入方式。否則 Desktop 每次嘗試重新連線時都可能再傳送一次推送。1158* **檢查跳板主機**：如果您的跳板主機要求登入（例如推送到手機），請改用無需提示即可運作的登入方式。否則 Desktop 每次嘗試重新連線時都可能再傳送一次推送。

1160* **測試遠端機器**：啟動一個短任務，在任務仍在執行時結束 Desktop，並在任務應已完成很久之後再次開啟工作階段。如果任務尚未完成且工作階段未顯示身分驗證錯誤，請檢查遠端機器上[可能終止任務的因素](#limits-while-desktop-is-disconnected)。1159* **測試遠端機器**：啟動一個短任務，在任務仍在執行時結束 Desktop，並在任務應已完成很久之後再次開啟工作階段。如果任務尚未完成且工作階段未顯示身分驗證錯誤，請檢查遠端機器上[可能終止任務的因素](#limits-while-desktop-is-disconnected)。

1206 1205 

1207如果 Claude 在 Desktop 中斷連線時需要您的核准或向您提問，Claude 會在遠端機器上等待。此等待本身沒有時間限制。當 Desktop 重新加入該程序時，會向您顯示該請求。如果 Desktop 改為啟動新的程序，您就會失去該請求。1206如果 Claude 在 Desktop 中斷連線時需要您的核准或向您提問，Claude 會在遠端機器上等待。此等待本身沒有時間限制。當 Desktop 重新加入該程序時，會向您顯示該請求。如果 Desktop 改為啟動新的程序，您就會失去該請求。

1208 1207 

1209在任務等待您期間，Desktop 可能會自行重新啟動，例如為了安裝更新。如果 Desktop 在 Windows 上執行或使用第三方供應商，該次重新啟動後您就會失去該請求。1208如果等待您的請求在您回來時已消失，其中一個原因是 Desktop 自行重新啟動，例如為了安裝更新。只有在 Desktop 能重新加入程序時，您才能在重新啟動後保留請求，因此在讓任務持續執行前，請查看 [Desktop 何時能重新加入](#reopen-a-session-after-you-quit-desktop)。

1210 1209 

1211如果您失去請求，請傳送訊息以繼續。1210如果您失去請求，請傳送訊息以繼續。

1212 1211 

1238 - **跳板主機，推送持續傳來**：在 Desktop 無法判斷沒有人回應的情況下（例如 Windows 上的 Desktop），只要有可重新加入的程序，無論該程序是否仍在執行，它都會持續嘗試。您每次嘗試都可能再收到一次推送。若要結束嘗試，請結束 Desktop，這[可能會讓您失去執行中的任務](#reopen-a-session-after-you-quit-desktop)。1237 - **跳板主機，推送持續傳來**：在 Desktop 無法判斷沒有人回應的情況下（例如 Windows 上的 Desktop），只要有可重新加入的程序，無論該程序是否仍在執行，它都會持續嘗試。您每次嘗試都可能再收到一次推送。若要結束嘗試，請結束 Desktop，這[可能會讓您失去執行中的任務](#reopen-a-session-after-you-quit-desktop)。

1239 - **長時間中斷**：Desktop 會放慢到大約每五分鐘嘗試一次。若要更快重新連線，請在工作階段中重試或傳送訊息，Desktop 會在連線後傳遞該訊息。1238 - **長時間中斷**：Desktop 會放慢到大約每五分鐘嘗試一次。若要更快重新連線，請在工作階段中重試或傳送訊息，Desktop 會在連線後傳遞該訊息。

1240 - **輸出遺失**：Desktop 中斷連線時，輔助程式會將每個工作階段最近的 Claude Code 輸出保留在 16 MiB 的緩衝區中，並捨棄較舊的輸出。Desktop 重新連線後，工作階段可能會顯示 `Loading recent output from <host>…`。如果 Desktop 無法載入所有輸出，您會看到 `Some output produced while you were disconnected may be missing here.` 這一列。此列並不代表任務已停止。1239 - **輸出遺失**：Desktop 中斷連線時，輔助程式會將每個工作階段最近的 Claude Code 輸出保留在 16 MiB 的緩衝區中，並捨棄較舊的輸出。Desktop 重新連線後，工作階段可能會顯示 `Loading recent output from <host>…`。如果 Desktop 無法載入所有輸出，您會看到 `Some output produced while you were disconnected may be missing here.` 這一列。此列並不代表任務已停止。

1241 - **程序已消失**：如果 Desktop 重新連線時程序已消失，Desktop 可能會根據對話的已儲存歷程記錄啟動新的程序，並告訴 Claude 繼續任務。如果程序持續結束，或 Desktop 使用第三方供應商，Desktop 不會自行繼續任務。請傳送訊息以繼續。1240 - **程序已消失**：程序在 Desktop 中斷連線期間結束，例如遠端電腦重新啟動時。Desktop 接著可能會從對話已儲存的歷史記錄啟動新程序，並指示 Claude 繼續任務。如果任務仍處於停止狀態，請傳送訊息。若使用第三方供應商，請更新至 Claude Desktop v2.42304.0 或更新版本，因為較早的版本永遠不會自行繼續任務。

1242</Accordion>1241</Accordion>

1243 1242 

1244<a id="reopen-a-session-after-you-quit-desktop" />1243<a id="reopen-a-session-after-you-quit-desktop" />

1247 結束 Desktop 後重新開啟工作階段1246 結束 Desktop 後重新開啟工作階段

1248</h5>1247</h5>

1249 1248 

1250結束 Desktop 後，任務會在遠端機器上繼續執行，直到完成、需要您處理，或達到其中一項[限制](#limits-while-desktop-is-disconnected)。1249結束 Desktop 後，任務會在遠端電腦上繼續執行，但除非 Desktop 能重新加入其程序，否則工作階段再次開啟時任務會停止。Desktop 關閉期間，任務會執行直到完成、需要您處理，或達到某個[限制](#limits-while-desktop-is-disconnected)。

1251 1250 

1252* **macOS 或 Linux 上的 Desktop，使用 Claude 帳戶**：啟動 Desktop 並開啟工作階段。當 Desktop 能重新加入程序時，您就能取回執行中的任務。它不一定都能重新加入，例如在某些 Desktop 更新之後，或在您的組織變更其受管設定之後。1251* **Windows 上的 Desktop**：您無法取回執行中的任務，因為 Desktop 在結束後永遠不會重新加入。請只在您預期任務已完成時再啟動 Desktop，因為工作階段可能在 Desktop 啟動時開啟。

1253* **在 macOS 或 Linux 上，當 Desktop 無法重新加入時**：Desktop 會終止該程序，並根據對話的已儲存歷程記錄啟動新的程序。您執行中的任務會停止，且您會失去任何等待您處理的核准或問題。更新之後，Desktop 接著可能會告訴 Claude 繼續。如果任務持續停止，請傳送訊息。1252* **第三方供應商，來自較早版本的任務**：如果您在 v2.42304.0 之前的 Desktop 版本中啟動任務，即使在 macOS 或 Linux 上您也無法取回。請只在您預期任務已完成時再啟動 Desktop。

1254* **Windows 上的 Desktop，或在任何平台上使用第三方供應商**：只有在您預期任務已完成時才再次啟動 Desktop。您無法取回執行中的任務，因為 Desktop 在結束後永遠不會重新加入。它會在工作階段開啟時終止該程序，而這可能在 Desktop 啟動時就發生。請傳送訊息以繼續。1253* **其他任何任務，搭配 macOS 或 Linux 上的 Desktop**：啟動 Desktop 並開啟工作階段，如果 Desktop 重新加入，任務就會繼續。它不一定能重新加入，例如在某些 Desktop 更新之後，因此請[在長時間任務前更新](#prepare-a-long-task)。

1254 

1255當 Desktop 無法重新加入時，您也會失去任何正在等待您的核准或問題。如果任務沒有自行繼續，請傳送訊息，Claude 會從對話已儲存的歷史記錄繼續。

1255 1256 

1256如需第三方部署的相關資訊，請參閱 [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions)。1257如需第三方部署的相關資訊，請參閱 [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions)。

1257 1258 

34[Skills](/docs/zh-TW/skills) 是最靈活的擴展。Skill 是一個包含知識、工作流程或指令的 markdown 檔案。您可以使用像 `/deploy` 這樣的命令調用 skills，或者 Claude 可以在相關時自動載入它們。Skills 可以在您目前的對話中運行，或通過 subagents 在隔離的上下文中運行。34[Skills](/docs/zh-TW/skills) 是最靈活的擴展。Skill 是一個包含知識、工作流程或指令的 markdown 檔案。您可以使用像 `/deploy` 這樣的命令調用 skills，或者 Claude 可以在相關時自動載入它們。Skills 可以在您目前的對話中運行，或通過 subagents 在隔離的上下文中運行。

35 35 

36<h2 id="match-features-to-your-goal">36<h2 id="match-features-to-your-goal">

37 將功能與您的目標相匹配37 依目標選擇功能

38</h2>38</h2>

39 39 

40功能範圍從 Claude 在每個會話中看到的始終開啟的上下文，到您或 Claude 可以調用的按需功能，再到在特定事件上運行的背景自動化。下表顯示了可用的功能以及何時使用每一個。40各項功能涵蓋範圍廣泛，從 Claude 每個工作階段都會看到的常駐上下文，到您或 Claude 可以叫用的隨選功能，再到在特定事件發生時執行的背景自動化。下表列出可用的功能以及各自適用的時機。

41 41 

42| 功能 | 它的作用 | 何時使用 | 範例 |42| 功能 | 用途 | 使用時機 | 範例 |

43| - | - | - | - |43| - | - | - | - |

44| **CLAUDE.md** | 每次對話載入的持久上下文 | 專案約定、「始終執行 X」規則 | 「使用 pnpm，而不是 npm。在提交前運行測試。」 |44| **CLAUDE.md** | 每次對話都會載入的持久上下文 | 專案慣例、「一律執行 X」的規則 | 「使用 pnpm，不要用 npm。提交前先執行測試。」 |

45| **[輸出風格](/docs/zh-TW/output-styles)** | 為整個會話設定 Claude 的角色、語調和回應格式的指令 | 您想在每個回應中使用的語音、長度或格式，或 Claude 作為軟體工程師以外的角色工作 | 用於較短回應的內建簡潔風格；一個自訂風格，首先用圖表回答每個問題 |45| **[輸出風格](/docs/zh-TW/output-styles)** | 為整個工作階段設定 Claude 角色、語氣與回應格式的指令 | 希望每個回應都採用的語氣、長度或格式，或讓 Claude 以軟體工程師以外的身分工作 | 內建的 Concise 風格可讓回應更簡短；自訂風格可讓每個問題都先以圖表回答 |

46| **Skill** | Claude 可以使用的指令、知識和工作流程 | 可重複使用的內容、參考文件、可重複的任務 | `/deploy` 運行您的部署檢查清單；包含端點模式的 API 文件 skill |46| **Skill** | Claude 可使用的指令、知識與工作流程 | 可重複使用的內容、參考文件、可重複執行的任務 | `/deploy` 會執行您的部署檢查清單；包含端點模式的 API 文件 skill |

47| **Subagent** | 返回摘要結果的隔離執行上下文 | 上下文隔離、並行任務、專門的工作者 | 讀取許多檔案但僅返回關鍵發現的研究任務 |47| **Subagent** | 回傳摘要結果的隔離執行上下文 | 上下文隔離、平行任務、專門化的工作者 | 讀取大量檔案但只回傳關鍵發現的研究任務 |

48| **[Dynamic workflow](/docs/zh-TW/workflows)** | Claude 編寫的在背景中運行許多 subagents 的指令碼 | 超出少數 subagents 的工作，或您想交叉檢查的發現 | 審計整個程式碼庫，第二組代理驗證每個發現 |48| **[動態工作流程](/docs/zh-TW/workflows)** | 由 Claude 撰寫、在背景執行多個 subagent 的指令碼 | 超出少數幾個 subagent 能處理的工作，或希望交叉驗證的發現 | 稽核整個程式碼庫，並由第二組 agent 驗證每項發現 |

49| **[Cross-session messaging](/docs/zh-TW/cross-session-messaging)** | Claude 將訊息從您的一個會話傳遞到另一個會話 | 您自己運行的需要彼此發現的會話，中途任務 | 一個會話警告另一個會話，它所做的更改會破壞另一個會話正在構建的內容 |49| **[跨工作階段傳訊](/docs/zh-TW/cross-session-messaging)** | Claude 將訊息從您的一個工作階段傳遞到另一個工作階段 | 您自行執行、在任務進行中需要彼此發現的工作階段 | 一個工作階段警告另一個工作階段，它所做的變更會破壞對方正在建構的內容 |

50| **[Code intelligence](/docs/zh-TW/tools-reference#lsp-tool-behavior)** | 語言伺服器導航和診斷 | 類型化語言、大型程式碼庫，其中 grep 速度慢或不精確 | 跳轉到符號的定義，而不是讀取整個檔案 |50| **[程式碼智慧](/docs/zh-TW/tools-reference#lsp-tool-behavior)** | 語言伺服器導覽與診斷 | 型別語言、grep 速度慢或不精確的大型程式碼庫 | 直接跳到符號的定義，而不是讀取整個檔案 |

51| **MCP** | 連接到外部服務 | 外部資料或操作 | 查詢您的資料庫、發佈到 Slack、控制瀏覽器 |51| **MCP** | 連接外部服務 | 外部資料或動作 | 查詢您的資料庫、發布訊息到 Slack、控制瀏覽器 |

52| **Hook** | 由事件觸發的指令碼、HTTP 請求、MCP 工具呼叫、提示或 subagent | 必須在每個匹配事件上運行的自動化 | 在每次檔案編輯後運行 ESLint |52| **Hook** | 由事件觸發的指令碼、HTTP 請求、MCP 工具呼叫、提示詞或 subagent | 必須在每個相符事件上執行的自動化 | 每次編輯檔案後執行 ESLint |

53| **[Artifact](/docs/zh-TW/artifacts)** | 將會話輸出發佈為私人、互動式網頁 | 您想以視覺方式查看或共享的輸出，而不是作為終端文字 | 隨著 Claude 進行調查而更新的事件時間表 |53| **[Artifact](/docs/zh-TW/artifacts)** | 將工作階段輸出發布為私人的互動式網頁 | 希望以視覺方式檢視或分享、而非以終端機文字呈現的輸出 | 隨著 Claude 調查而更新的事件時間軸 |

54 54 

55**[Plugins](/docs/zh-TW/plugins/overview)** 是打包層。Plugin 將 skills、hooks、subagents 和 MCP servers 捆綁到單個可安裝單元中。Plugin skills 是命名空間的（如 `/my-plugin:review`），因此多個 plugins 可以共存。當您想在多個儲存庫中重複使用相同的設置或通過 **[marketplace](/docs/zh-TW/plugins/overview)** 分發給他人時，使用 plugins。55\*\*[外掛](/docs/zh-TW/plugins/overview)\*\*是封裝層。外掛會將 skill、hook、subagent 與 MCP 伺服器組合成單一可安裝的單元。外掛 skill 具有命名空間（例如 `/my-plugin:review`），因此多個外掛可以並存。當您想在多個儲存庫中重複使用相同的設定，或透過 **[市集](/docs/zh-TW/plugins/overview)** 散布給其他人時，請使用外掛。

56 56 

57<h3 id="build-your-setup-over-time">57<h3 id="build-your-setup-over-time">

58 隨著時間推移構建您的設置58 逐步建立您的設定

59</h3>59</h3>

60 60 

61您不需要預先配置所有內容。每個功能都有一個可識別的觸發器，大多數團隊大致按以下順序添加它們：61您不需要一開始就設定好所有內容。每項功能都有可辨識的觸發時機，大多數團隊大致依照以下順序加入：

62 62 

63| 觸發器 | 添加 |63| 觸發時機 | 加入 |

64| :- | :- |64| :- | :- |

65| Claude 兩次出錯的約定或命令 | 將其添加到 [CLAUDE.md](/docs/zh-TW/memory) |65| Claude 兩次弄錯某個慣例或命令 | 將其加入 [CLAUDE.md](/docs/zh-TW/memory) |

66| 您一直在要求 Claude 更簡潔、解釋更多或以相同格式回答 | 設定 [輸出風格](/docs/zh-TW/output-styles) |66| 您一再要求 Claude 更簡短、多加解釋，或以相同格式回答 | 設定[輸出風格](/docs/zh-TW/output-styles) |

67| 您一直在輸入相同的提示來啟動任務 | 將其保存為使用者可調用的 [skill](/docs/zh-TW/skills) |67| 您一再輸入相同的提示詞來開始某項任務 | 將其儲存為使用者可叫用的 [skill](/docs/zh-TW/skills) |

68| 您第三次將相同的劇本或多步驟程序粘貼到聊天中 | 將其捕獲為 [skill](/docs/zh-TW/skills) |68| 您第三次將相同的操作手冊或多步驟程序貼到聊天中 | 將其整理為 [skill](/docs/zh-TW/skills) |

69| 您一直在從 Claude 無法看到的瀏覽器選項卡複製資料 | 將該系統連接為 [MCP server](/docs/zh-TW/mcp) |69| 您一直從 Claude 看不到的瀏覽器分頁複製資料 | 將該系統連接為 [MCP 伺服器](/docs/zh-TW/mcp) |

70| Claude 讀取許多檔案以找到符號的定義或使用位置 | 為您的語言安裝 [code intelligence plugin](/docs/zh-TW/plugins/code-intelligence) |70| Claude 讀取大量檔案來找出符號的定義或使用位置 | 為您的語言安裝[程式碼智慧外掛](/docs/zh-TW/plugins/code-intelligence) |

71| 一個附帶任務用您不會再次參考的輸出淹沒您的對話 | 通過 [subagent](/docs/zh-TW/sub-agents) 路由它 |71| 某個附帶任務以您之後不會再參考的輸出塞滿對話 | 透過 [subagent](/docs/zh-TW/sub-agents) 處理 |

72| 您希望每次都發生某事而無需詢問 | 編寫 [hook](/docs/zh-TW/hooks-guide) |72| 您希望某件事每次都自動發生而不需要要求 | 撰寫 [hook](/docs/zh-TW/hooks-guide) |

73| 第二個儲存庫需要相同的設置 | 將其打包為 [plugin](/docs/zh-TW/plugins/overview) |73| 第二個儲存庫需要相同的設定 | 將其封裝為[外掛](/docs/zh-TW/plugins/overview) |

74 74 

75相同的觸發器告訴您何時更新您已經擁有的內容。重複的錯誤或反覆出現的審查評論是 CLAUDE.md 編輯，而不是聊天中的一次性更正。您一直手動調整的工作流程是需要另一次修訂的 skill。75同樣的觸發時機也能告訴您何時該更新現有的設定。反覆出現的錯誤或一再出現的審查意見，應該編輯 CLAUDE.md，而不是在聊天中進行一次性的修正。您一直手動調整的工作流程，代表這個 skill 需要再修訂一次。

76 76 

77<h3 id="compare-similar-features">77<h3 id="compare-similar-features">

78 比較相似的功能78 比較相似的功能

79</h3>79</h3>

80 80 

81某些功能可能看起來相似。如需更深入的選擇演練，請參閱部落格上的 [Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents](https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more)。以下是如何區分它們。81有些功能看起來可能很相似。如需更深入了解如何在它們之間做選擇，請參閱部落格上的 [Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents](https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more)。以下說明如何區分它們。

82 82 

83<Tabs>83<Tabs>

84 <Tab title="Skill vs Subagent">84 <Tab title="Skill 與 Subagent">

85 Skills 和 subagents 解決不同的問題：85 Skill 與 subagent 解決的是不同的問題：

86 86 

87 * **Skills** 是可重複使用的內容，您可以將其載入任何上下文87 * **Skill** 是可以載入到任何上下文中的可重複使用內容

88 * **Subagents** 是與您的主要對話分開運行的隔離工作者88 * **Subagent** 是與主要對話分開執行的隔離工作者

89 89 

90 | 方面 | Skill | Subagent |90 | 面向 | Skill | Subagent |

91 | - | - | - |91 | - | - | - |

92 | **它是什麼** | 可重複使用的指令、知識或工作流程 | 具有自己上下文的隔離工作者 |92 | **是什麼** | 可重複使用的指令、知識或工作流程 | 擁有自己上下文的隔離工作者 |

93 | **主要優勢** | 在上下文之間共享內容 | 上下文隔離。工作單獨進行，僅返回摘要 |93 | **主要優點** | 在不同上下文之間共用內容 | 上下文隔離。工作分開進行，只回傳摘要 |

94 | **[上下文視窗](/docs/zh-TW/context-window)影響** | 添加到您的主視窗 | 使用具有自己輸入和輸出令牌的單獨視窗 |94 | **[上下文視窗](/docs/zh-TW/context-window)影響** | 增加到您的主要視窗 | 使用獨立的視窗，擁有自己的輸入與輸出 token |

95 | **最適合** | 參考資料、可調用的工作流程 | 讀取許多檔案的任務、並行工作、專門的工作者 |95 | **最適合** | 參考資料、可叫用的工作流程 | 需要讀取大量檔案的任務、平行工作、專門化的工作者 |

96 96 

97 **Skills 可以是參考或操作。** 參考 skills 提供 Claude 在整個會話中使用的知識（如您的 API 風格指南）。操作 skills 告訴 Claude 執行特定操作（如運行您的部署工作流程的 `/deploy`）。97 **Skill 可以是參考型或動作型。** 參考型 skill 提供 Claude 在整個工作階段中使用的知識（例如您的 API 風格指南）。動作型 skill 則告訴 Claude 執行特定的事情（例如執行部署工作流程的 `/deploy`）。

98 98 

99 **當您需要上下文隔離或您的上下文視窗變滿時，使用 subagent**。Subagent 可能讀取數十個檔案或運行廣泛的搜尋，但您的主要對話僅接收摘要。由於 subagent 工作不消耗您的主要上下文，當您不需要中間工作保持可見時，這也很有用。自訂 subagents 可以有自己的指令，並可以預載 skills。99 **使用 subagent** 的時機是需要上下文隔離，或上下文視窗即將填滿時。Subagent 可能會讀取數十個檔案或執行大量搜尋，但主要對話只會收到摘要。由於 subagent 的工作不會消耗主要上下文，當您不需要讓中間過程保持可見時，這也很有用。自訂 subagent 可以擁有自己的指令，並可預先載入 skill。

100 100 

101 **它們可以結合。** Subagent 可以預載特定 skills（`skills:` 欄位）。Skill 可以使用 `context: fork` 在隔離的上下文中運行。有關詳細資訊，請參閱 [Skills](/docs/zh-TW/skills)。101 **兩者可以結合。** Subagent 可以預先載入特定的 skill（`skills:` 欄位）。Skill 可以使用 `context: fork` 在隔離的上下文中執行。詳情請參閱 [Skill](/docs/zh-TW/skills)。

102 </Tab>102 </Tab>

103 103 

104 <Tab title="CLAUDE.md vs Skill">104 <Tab title="CLAUDE.md 與 Skill">

105 兩者都存儲指令，但它們的載入方式和用途不同。105 兩者都儲存指令，但載入方式不同，用途也不同。

106 106 

107 | 方面 | CLAUDE.md | Skill |107 | 面向 | CLAUDE.md | Skill |

108 | - | - | - |108 | - | - | - |

109 | **載入** | 每個會話，自動 | 按需 |109 | **載入** | 每個工作階段自動載入 | 隨選載入 |

110 | **可以包含檔案** | 是，使用 `@path` 匯入 | 是，使用 `@path` 匯入 |110 | **可包含檔案** | 可以，使用 `@path` 匯入 | 可以，使用 `@path` 匯入 |

111 | **可以觸發工作流程** | 否 | 是，使用 `/<name>` |111 | **可觸發工作流程** | 否 | 可以，使用 `/<name>` |

112 | **最適合** | 「始終執行 X」規則 | 參考資料、可調用的工作流程 |112 | **最適合** | 「一律執行 X」的規則 | 參考資料、可叫用的工作流程 |

113 113 

114 **如果 Claude 應該始終知道它，請將其放在 CLAUDE.md 中**：編碼約定、構建命令、專案結構、「永遠不要執行 X」規則。114 **放在 CLAUDE.md**：如果 Claude 應該隨時知道這些內容，例如程式碼慣例、建置命令、專案結構、「絕不執行 X」的規則。

115 115 

116 **如果它是 Claude 有時需要的參考資料（API 文件、風格指南）或您使用 `/<name>` 觸發的工作流程（部署、審查、發佈），請將其放在 skill 中**。116 **放在 skill**：如果是 Claude 有時才需要的參考資料（API 文件、風格指南），或是您透過 `/<name>` 觸發的工作流程（部署、審查、發布）。

117 117 

118 **經驗法則：** 保持 CLAUDE.md 在 200 行以下。如果它在增長，將參考內容移動到 skills 或拆分為 [`.claude/rules/`](/docs/zh-TW/memory#organize-rules-with-claude/rules/) 檔案。118 **經驗法則：** 讓 CLAUDE.md 保持在 200 行以內。如果內容持續增加，請將參考內容移至 skill，或拆分為 [`.claude/rules/`](/docs/zh-TW/memory#organize-rules-with-claude/rules/) 檔案。

119 </Tab>119 </Tab>

120 120 

121 <Tab title="CLAUDE.md vs Output style">121 <Tab title="CLAUDE.md 與輸出風格">

122 兩者都給予 Claude 常設指令。CLAUDE.md 攜帶 Claude 應該知道的內容，輸出風格設定 Claude 如何回應。122 兩者都為 Claude 提供常駐指令。CLAUDE.md 承載 Claude 應該知道的內容，而輸出風格則設定 Claude 的回應方式。

123 123 

124 | 方面 | CLAUDE.md | 輸出風格 |124 | 面向 | CLAUDE.md | 輸出風格 |

125 | - | - | - |125 | - | - | - |

126 | **保持** | 關於您的專案的事實和規則 | 角色、語調和回應格式 |126 | **內容** | 關於專案的事實與規則 | 角色、語氣與回應格式 |

127 | **切換** | 始終載入 | 一次一個活躍；[隨時切換風格](/docs/zh-TW/output-styles#change-your-output-style) |127 | **切換** | 一律載入 | 一次只有一個生效；可隨時[切換風格](/docs/zh-TW/output-styles#change-your-output-style) |

128 | **最適合** | 構建命令、約定、「永遠不要執行 X」規則 | 較短的回應、代碼旁邊的解釋、非工程角色 |128 | **最適合** | 建置命令、慣例、「絕不執行 X」的規則 | 較簡短的回應、搭配程式碼的說明、非工程類角色 |

129 129 

130 **如果它對無論您在哪種風格中的專案都是真實的，請將其放在 CLAUDE.md 中**：編碼約定、構建命令、專案結構。130 **放在 CLAUDE.md**：如果無論使用哪種風格，這些內容對專案都成立，例如程式碼慣例、建置命令、專案結構。

131 131 

132 **如果它是關於回應本身並且您可能想再次關閉它，請使用輸出風格**：長度、格式、Claude 解釋多少，或不同的角色，例如寫作助手。Claude Code 包括 [內建風格](/docs/zh-TW/output-styles#built-in-output-styles)，您可以編寫自己的風格。132 **使用輸出風格**：如果內容與回應本身有關，且您之後可能想將其關閉，例如長度、格式、Claude 解釋的詳細程度，或是寫作助理等不同的角色。Claude Code 包含[內建風格](/docs/zh-TW/output-styles#built-in-output-styles)，您也可以撰寫自己的風格。

133 133 

134 **它們結合。** 無論您選擇哪種風格，CLAUDE.md 都保持載入。Claude 遵循兩者作為指令，所以都不是強制執行的。對於必須每次都發生的任何事情，使用 [hook](/docs/zh-TW/hooks-guide)。134 **兩者可以結合。** 無論您選擇哪種風格，CLAUDE.md 都會保持載入。Claude 會將兩者都視為指令來遵循，因此兩者都不具強制性。對於每次都必須發生的事情，請使用 [hook](/docs/zh-TW/hooks-guide)。

135 </Tab>135 </Tab>

136 136 

137 <Tab title="CLAUDE.md vs Rules vs Skills">137 <Tab title="CLAUDE.md、規則與 Skill">

138 所有三者都存儲指令，但它們的載入方式不同：138 三者都儲存指令，但載入方式不同：

139 139 

140 | 方面 | CLAUDE.md | `.claude/rules/` | Skill |140 | 面向 | CLAUDE.md | `.claude/rules/` | Skill |

141 | - | - | - | - |141 | - | - | - | - |

142 | **載入** | 每個會話 | 每個會話，或在打開匹配檔案時 | 按需，在調用或相關時 |142 | **載入** | 每個工作階段 | 每個工作階段，或開啟相符檔案時 | 隨選，在叫用或相關時載入 |

143 | **範圍** | 整個專案 | 可以限定到檔案路徑 | 特定於任務 |143 | **範圍** | 整個專案 | 可限定於特定檔案路徑 | 特定任務 |

144 | **最適合** | 核心約定和構建命令 | 特定於語言或目錄的指南 | 參考資料、可重複的工作流程 |144 | **最適合** | 核心慣例與建置命令 | 特定語言或特定目錄的準則 | 參考資料、可重複執行的工作流程 |

145 145 

146 **使用 CLAUDE.md** 用於每個會話需要的指令：構建命令、測試約定、專案架構。146 **使用 CLAUDE.md** 存放每個工作階段都需要的指令：建置命令、測試慣例、專案架構。

147 147 

148 **使用 rules** 保持 CLAUDE.md 專注。具有 [`paths` frontmatter](/docs/zh-TW/memory#path-specific-rules) 的 rules 僅在 Claude 使用匹配檔案時載入，節省上下文。148 **使用規則** 讓 CLAUDE.md 保持聚焦。具有 [`paths` frontmatter](/docs/zh-TW/memory#path-specific-rules) 的規則只會在 Claude 處理相符檔案時載入，藉此節省上下文。

149 149 

150 **使用 skills** 用於 Claude 有時只需要的內容，如 API 文件或您使用 `/<name>` 觸發的部署檢查清單。150 **使用 skill** 存放 Claude 有時才需要的內容，例如 API 文件或您透過 `/<name>` 觸發的部署檢查清單。

151 </Tab>151 </Tab>

152 152 

153 <Tab title="Subagent vs Dynamic workflow">153 <Tab title="Subagent 與動態工作流程">

154 兩者都在您的主要對話之外進行工作。使用 subagents，Claude 逐個回合決定接下來運行什麼。在工作流程中，指令碼決定：154 兩者都在主要對話之外執行工作。使用 subagent 時，由 Claude 逐回合決定接下來要執行什麼。在工作流程中，則由指令碼決定：

155 155 

156 * **Subagents** 是 Claude 生成的工作者，每個都向生成它的對話返回摘要156 * **Subagent** 是 Claude 產生的工作者，每個都會將摘要回傳給產生它的對話

157 * **[Dynamic workflows](/docs/zh-TW/workflows)** 是 Claude 編寫的在背景中運行許多 subagents 並返回一個結果的指令碼157 * **[動態工作流程](/docs/zh-TW/workflows)** 是由 Claude 撰寫的指令碼，會在背景執行多個 subagent 並回傳單一結果

158 158 

159 **當您需要快速、專注的工作者時，使用 subagent**：研究問題、驗證聲明、審查檔案。Subagent 執行工作並返回摘要，因此您的主要對話保持乾淨。Claude 在生成時命名的 Subagents 也可以[彼此訊息傳遞](/docs/zh-TW/sub-agents#what-loads-at-startup)。159 **使用 subagent** 的時機是需要快速、專注的工作者時：研究某個問題、驗證某項主張、審查某個檔案。Subagent 完成工作後回傳摘要，讓您的主要對話保持整潔。Claude 在產生時為其命名的 subagent 也可以[彼此傳訊](/docs/zh-TW/sub-agents#what-loads-at-startup)。

160 160 

161 **當工作[超出少數 subagents](/docs/zh-TW/workflows#when-to-use-a-workflow)時，使用 dynamic workflow**，或當您想在看到發現之前交叉檢查發現時，例如程式碼庫範圍的審計、大型遷移或從多個角度起草的計劃。要啟動一個，[在您的提示中要求工作流程](/docs/zh-TW/workflows#ask-for-a-workflow-in-your-prompt)。161 **使用動態工作流程** 的時機是某項工作[超出少數幾個 subagent 能處理的範圍](/docs/zh-TW/workflows#when-to-use-a-workflow)，或您希望在看到發現之前先交叉驗證時，例如整個程式碼庫的稽核、大型遷移，或從多個角度起草的計畫。若要啟動工作流程，請[在提示詞中要求使用工作流程](/docs/zh-TW/workflows#ask-for-a-workflow-in-your-prompt)。

162 162 

163 **要將發現從您的一個會話傳遞到另一個會話**，要求第一個會話的 Claude 發送它。Claude 使用 [cross-session messaging](/docs/zh-TW/cross-session-messaging) 傳遞它。[並行運行代理](/docs/zh-TW/agents)比較了運行多個 Claude 的其他方式，包括您交付並稍後檢查的會話。163 **若要將某個工作階段的發現傳遞給另一個工作階段**，請要求第一個工作階段的 Claude 傳送。Claude 會透過[跨工作階段傳訊](/docs/zh-TW/cross-session-messaging)傳遞。[平行執行 agent](/docs/zh-TW/agents) 比較了同時執行多個 Claude 的其他方式，包括您交付出去、之後再回來查看的工作階段。

164 </Tab>164 </Tab>

165 165 

166 <Tab title="MCP vs Skill">166 <Tab title="MCP 與 Skill">

167 MCP 將 Claude 連接到外部服務。Skills 擴展 Claude 的知識，包括如何有效地使用這些服務。167 MCP 將 Claude 連接到外部服務。Skill 則擴充 Claude 所知道的內容，包括如何有效使用這些服務。

168 168 

169 | 方面 | MCP | Skill |169 | 面向 | MCP | Skill |

170 | - | - | - |170 | - | - | - |

171 | **它是什麼** | 連接到外部服務的協議 | 知識、工作流程和參考資料 |171 | **是什麼** | 用於連接外部服務的協定 | 知識、工作流程與參考資料 |

172 | **提供** | 工具和資料存取 | 知識、工作流程、參考資料 |172 | **提供** | 工具與資料存取 | 知識、工作流程、參考資料 |

173 | **範例** | Slack 整合、資料庫查詢、瀏覽器控制 | 程式碼審查檢查清單、部署工作流程、API 風格指南 |173 | **範例** | Slack 整合、資料庫查詢、瀏覽器控制 | 程式碼審查檢查清單、部署工作流程、API 風格指南 |

174 174 

175 這些解決不同的問題，並且可以很好地協同工作：175 兩者解決不同的問題，且能良好地搭配運作：

176 176 

177 **MCP** 給予 Claude 與外部系統互動的能力。沒有 MCP，Claude 無法查詢您的資料庫或發佈到 Slack。177 **MCP** 為 Claude 提供針對外部系統專門打造的工具，連線與身分驗證則由伺服器處理。

178 178 

179 **Skills** 給予 Claude 關於如何有效使用這些工具的知識，以及您可以使用 `/<name>` 觸發的工作流程。Skill 可能包括您的團隊資料庫架構和查詢模式，或具有您的團隊訊息格式規則的 `/post-to-slack` 工作流程。179 **Skill** 為 Claude 提供如何有效使用這些工具的知識，以及您可以透過 `/<name>` 觸發的工作流程。Skill 可能包含您團隊的資料庫 schema 與查詢模式，或是包含團隊訊息格式規則的 `/post-to-slack` 工作流程。

180 </Tab>180 </Tab>

181 181 

182 <Tab title="Hook vs Skill">182 <Tab title="Hook 與 Skill">

183 Claude Code 在生命週期事件上運行 hook；它將 skill 載入上下文供 Claude 應用。183 Claude Code 會在生命週期事件發生時執行 hook；而 skill 則是載入到上下文中供 Claude 套用。

184 184 

185 | 方面 | Hook | Skill |185 | 面向 | Hook | Skill |

186 | - | - | - |186 | - | - | - |

187 | **運行** | 殼層命令、HTTP 請求、MCP 工具呼叫、LLM 提示或 subagent | Claude 讀取並遵循的指令 |187 | **執行內容** | shell 命令、HTTP 請求、MCP 工具呼叫、LLM 提示詞或 subagent | Claude 閱讀並遵循的指令 |

188 | **由以下觸發** | [生命週期事件](/docs/zh-TW/hooks#hook-events)，例如 `PostToolUse` 或 `SessionStart` | 您輸入 `/<name>`，或 Claude 將描述與您的任務相匹配 |188 | **觸發方式** | [生命週期事件](/docs/zh-TW/hooks#hook-events)，例如 `PostToolUse` 或 `SessionStart` | 您輸入 `/<name>`，或 Claude 判斷描述與您的任務相符 |

189 | **確定性** | 始終在其事件上觸發；觸發器是有保證的 | Claude 解釋指令；結果可能會有所不同 |189 | **確定性** | 在其事件發生時觸發，無需 Claude 決定 | Claude 解讀指令；結果可能有所不同 |

190 | **上下文成本** | 零，除非 hook 返回輸出 | 描述在每個會話載入；使用時完整內容載入 |190 | **上下文成本** | 除非 hook 回傳輸出，否則為零 | 描述在每個工作階段載入；使用時載入完整內容 |

191 | **最適合** | 每次都以相同方式發生且不需要 Claude 思考的操作 | 需要推理的工作流程、參考資料、多步驟任務 |191 | **最適合** | 編輯後執行 lint、封鎖不安全的命令、記錄、通知 | 需要推理的工作流程、參考資料、多步驟任務 |

192 192 

193 **當操作必須每次都以相同方式發生且不需要 Claude 思考時，使用 hook**。例如：保存時格式化、拒絕 `rm -rf /`、在會話結束時發佈 Slack 訊息。193 **使用 hook** 的時機是動作每次都必須以相同方式發生，且不需要 Claude 思考時。例如：儲存時格式化、拒絕 `rm -rf /`、在工作階段結束時發布 Slack 訊息。

194 194 

195 **當 Claude 應該決定如何應用步驟或內容是知識而不是指令碼時，使用 skill**。例如：`/release` 檢查清單、您的 API 風格指南、除錯劇本。195 **使用 skill** 的時機是應由 Claude 決定如何套用步驟，或內容是知識而非指令碼時。例如：`/release` 檢查清單、您的 API 風格指南、除錯操作手冊。

196 196 

197 **將護欄放在 hooks 中。** CLAUDE.md 或 skill 中的「永遠不要編輯 `.env`」之類的指令是請求，而不是保證。阻止編輯的 `PreToolUse` hook 是強制執行。如果規則必須每次都成立，將其作為 hook 而不是提示指令。197 **將防護措施放在 hook 中。** 在 CLAUDE.md 或 skill 中寫下「絕不編輯 `.env`」這類指令只是請求，而非保證。封鎖該編輯的 `PreToolUse` hook 才是強制執行。如果某條規則每次都必須成立，請將其設為 hook，而不是提示詞指令。

198 198 

199 **Hook 輸出進入上下文。** 運行您的 linter 的 `PostToolUse` hook 將結果作為 Claude 讀取的文本反饋；`/fix-lint` skill 告訴 Claude 如何解決它們。199 **Hook 輸出會進入上下文。** 執行 linter 的 `PostToolUse` hook 會將結果以文字形式回饋給 Claude 閱讀；`/fix-lint` skill 則告訴 Claude 如何解決這些問題。

200 </Tab>200 </Tab>

201</Tabs>201</Tabs>

202 202 

204 了解功能如何分層204 了解功能如何分層

205</h3>205</h3>

206 206 

207功能可以在多個級別定義：使用者範圍、每個專案、通過 plugins，或通過受管理的策略。您也可以在子目錄中嵌套 CLAUDE.md 檔案，或在 monorepo 的特定套件中放置 skills。當相同的功能存在於多個級別時，以下是它們的分層方式：207功能可以在多個層級定義：整個使用者、個別專案、透過外掛，或透過受管理的政策。您也可以在子目錄中巢狀放置 CLAUDE.md 檔案，或將 skill 放在 monorepo 的特定套件中。當同一功能存在於多個層級時，分層方式如下：

208 208 

209* **CLAUDE.md 檔案** 是累加的：所有級別同時對 Claude 的上下文貢獻內容。來自您的工作目錄及以上的檔案在啟動時載入；子目錄在您在其中工作時載入。當指令衝突時，Claude 使用判斷來協調它們。請參閱 [CLAUDE.md 檔案如何載入](/docs/zh-TW/memory#how-claude-md-files-load)。209* **CLAUDE.md 檔案**是累加的：所有層級會同時將內容提供給 Claude 的上下文。來自工作目錄及其上層目錄的檔案會在啟動時載入；子目錄的檔案則在您於其中工作時載入。當指令互相衝突時，Claude 會自行判斷如何調和。請參閱 [CLAUDE.md 檔案的載入方式](/docs/zh-TW/memory#how-claude-md-files-load)。

210* **Skills 和 subagents** 按名稱覆蓋：當相同名稱存在於多個級別時，一個定義根據優先級獲勝（skills 為受管理 > 使用者 > 專案；subagents 為受管理 > CLI 標誌 > 專案 > 使用者 > plugin）。Plugin skills 是[命名空間](/docs/zh-TW/plugins/components#skills)的，以避免衝突。請參閱 [skill 發現](/docs/zh-TW/skills#resolve-skills-that-share-a-name) 和 [subagent 範圍](/docs/zh-TW/sub-agents#choose-the-subagent-scope)。210* **Skill 與 subagent** 依名稱覆寫：當同一名稱存在於多個層級時，會依優先順序由其中一個定義勝出（skill 為 managed > user > project；subagent 為 managed > CLI 旗標 > project > user > plugin）。外掛 skill 具有[命名空間](/docs/zh-TW/plugins/components#skills)以避免衝突。請參閱 [skill 探索](/docs/zh-TW/skills#resolve-skills-that-share-a-name)與 [subagent 範圍](/docs/zh-TW/sub-agents#choose-the-subagent-scope)。

211* **MCP 伺服器** 按名稱覆蓋：本地 > 專案 > 使用者。請參閱 [MCP 範圍](/docs/zh-TW/mcp#scope-hierarchy-and-precedence)。211* **MCP 伺服器**依名稱覆寫：local > project > user。請參閱 [MCP 範圍](/docs/zh-TW/mcp#scope-hierarchy-and-precedence)。

212* **Hooks** 合併：所有註冊的 hooks 為其匹配事件觸發，無論來源如何。請參閱 [hooks](/docs/zh-TW/hooks)。212* **Hook** 會合併：所有已註冊的 hook 都會在其相符事件發生時觸發，無論來源為何。請參閱 [hook](/docs/zh-TW/hooks)。

213 213 

214<h3 id="combine-features">214<h3 id="combine-features">

215 結合功能215 結合功能

216</h3>216</h3>

217 217 

218每個擴展解決不同的問題：CLAUDE.md 處理始終開啟的上下文，skills 處理按需知識和工作流程，MCP 處理外部連接，subagents 處理隔離，hooks 處理自動化。真實的設置根據您的工作流程結合它們。218每種擴充功能解決不同的問題：CLAUDE.md 處理常駐上下文，skill 處理隨選的知識與工作流程，MCP 處理外部連線，subagent 處理隔離，hook 則處理自動化。實際的設定會依您的工作流程將它們結合使用。

219 219 

220例如，您可能使用 CLAUDE.md 用於專案約定、skill 用於您的部署工作流程、MCP 用於連接到您的資料庫，以及 hook 用於在每次編輯後運行 linting。每個功能處理它最擅長的事情。220例如，您可以使用 CLAUDE.md 存放專案慣例、使用 skill 處理部署工作流程、使用 MCP 連接資料庫，並使用 hook 在每次編輯後執行 lint。每項功能都處理自己最擅長的部分。

221 221 

222| 模式 | 它如何運作 | 範例 |222| 模式 | 運作方式 | 範例 |

223| - | - | - |223| - | - | - |

224| **Skill + MCP** | MCP 提供連接；skill 教導 Claude 如何很好地使用它 | MCP 連接到您的資料庫，skill 記錄您的架構和查詢模式 |224| **Skill + MCP** | MCP 提供連線；skill 教導 Claude 如何善加運用 | MCP 連接到您的資料庫，skill 記錄您的 schema 與查詢模式 |

225| **Skill + Subagent** | Skill 生成 subagents 進行並行工作 | `/audit` skill 啟動在隔離上下文中工作的安全性、效能和風格 subagents |225| **Skill + Subagent** | Skill 產生 subagent 進行平行工作 | `/audit` skill 啟動安全性、效能與風格 subagent，各自在隔離的上下文中工作 |

226| **CLAUDE.md + Skills** | CLAUDE.md 保持始終開啟的規則；skills 保持按需載入的參考資料 | CLAUDE.md 說「遵循我們的 API 約定」，skill 包含完整的 API 風格指南 |226| **CLAUDE.md + Skill** | CLAUDE.md 存放常駐規則；skill 存放隨選載入的參考資料 | CLAUDE.md 寫著「遵循我們的 API 慣例」，skill 則包含完整的 API 風格指南 |

227| **Hook + MCP** | Hook 通過 MCP 觸發外部操作 | 編輯後 hook 在 Claude 修改關鍵檔案時發送 Slack 通知 |227| **Hook + MCP** | Hook 透過 MCP 觸發外部動作 | 編輯後 hook 在 Claude 修改關鍵檔案時傳送 Slack 通知 |

228 228 

229<h2 id="understand-context-costs">229<h2 id="understand-context-costs">

230 了解上下文成本230 了解上下文成本

1832 1832 

1833使用 [PreToolUse 決策控制](#pretooluse-decision-control)來允許、拒絕、詢問或延遲工具呼叫。1833使用 [PreToolUse 決策控制](#pretooluse-decision-control)來允許、拒絕、詢問或延遲工具呼叫。

1834 1834 

1835`PreToolUse` 上的 [Agent SDK 回呼 hook](/docs/zh-TW/agent-sdk/hooks) 若超過逾時，會阻擋工具呼叫，而 Claude 會收到指出逾時的錯誤結果。其他 hook 回傳的明確拒絕仍會優先。1835`PreToolUse` 上超過逾時的 [Agent SDK 回呼 hook](/docs/zh-TW/agent-sdk/hooks) 會封鎖工具呼叫，而 Claude 會收到一個指出逾時的錯誤結果。

1836 1836 

1837<h4 id="pretooluse-input">1837<h4 id="pretooluse-input">

1838 PreToolUse 輸入1838 PreToolUse 輸入

4097 4097 

4098您的 `content` 會取代使用者的整個 `content` 物件，因此請包含您未變更的欄位。請一併傳回 `action`，因為 Claude Code 會忽略沒有 `action` 的 `hookSpecificOutput`。4098您的 `content` 會取代使用者的整個 `content` 物件，因此請包含您未變更的欄位。請一併傳回 `action`，因為 Claude Code 會忽略沒有 `action` 的 `hookSpecificOutput`。

4099 4099 

4100ElicitationResult hook 在使用者拒絕或取消時也會執行，而您的 `action` 會取代使用者的 `action`。在傳回 `accept` 之前，請檢查輸入的 `action` 是否為 `accept`，否則您的 hook 會將已拒絕的請求變成已接受的請求。此指令碼會在使用者接受時進行相同的變更、保留其他欄位，否則不印出任何內容：4100ElicitationResult hook 在使用者拒絕或取消時也會執行，且您的 `action` 會取代使用者的。請在傳回 `accept` 之前，先確認輸入的 `action` 是 `accept`，否則您的 hook 會將被拒絕的請求變成已接受的請求。此指令碼會在使用者接受時進行相同的變更、保留其他欄位，否則不列印任何內容：

4101 4101 

4102```bash theme={null}4102```bash theme={null}

4103#!/bin/bash4103#!/bin/bash

213如果安裝失敗，請符合 Claude Code 報告的訊息：213如果安裝失敗，請符合 Claude Code 報告的訊息：

214 214 

215* `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 添加市場，然後重試安裝。215* `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 添加市場，然後重試安裝。

216* 外掛[在市場中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛名稱。216* `Plugin "<name>" not found in marketplace "claude-plugins-official"`：您本機的市集目錄副本可能已過期。請使用 `/plugin marketplace update claude-plugins-official` 重新整理，然後重試安裝。如果重試後顯示相同的訊息，請參閱[在市集中找不到外掛](/docs/zh-TW/plugins/troubleshooting#plugin-not-found-in-marketplace)。

217 217 

218若要為儲存庫中的每個人啟用外掛而不是自己安裝，請將其添加到 [`enabledPlugins` 專案設定](/docs/zh-TW/settings-reference#plugin-settings)。218若要為儲存庫中的每個人啟用外掛而不是自己安裝，請將其添加到 [`enabledPlugins` 專案設定](/docs/zh-TW/settings-reference#plugin-settings)。

219 219 

49 49 

50 如果安裝失敗，請符合 Claude Code 報告的訊息：50 如果安裝失敗，請符合 Claude Code 報告的訊息：

51 51 

52 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增 marketplace，然後重試安裝。52 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。

53 * [plugin 在 marketplace 中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查 plugin 名稱。53 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`：您本機的市集目錄副本可能已過時。請使用 `/plugin marketplace update claude-plugins-official` 重新整理，然後重試安裝。如果重試後顯示相同的訊息，請參閱 [Plugin not found in marketplace](/docs/zh-TW/plugins/troubleshooting#plugin-not-found-in-marketplace)。

54 54 

55 如果安裝摘要報告 `Run /reload-plugins to apply.`，Claude Code 會為您執行該重新載入。如果重新載入警告您的下一則訊息會重新讀取對話，請執行 `/reload-plugins --force`。55 如果安裝摘要報告 `Run /reload-plugins to apply.`，Claude Code 會為您執行該重新載入。如果重新載入警告您的下一則訊息會重新讀取對話，請執行 `/reload-plugins --force`。

56 </Step>56 </Step>

772**屬性**：772**屬性**：

773 773 

774* 所有[標準屬性](#standard-attributes)774* 所有[標準屬性](#standard-attributes)

775* `type`：（`"input"`、`"output"`、`"cacheRead"`、`"cacheCreation"`）。`"input"` 類型不包含從提示詞快取讀取或寫入的 token，這些會計入 `"cacheRead"` 與 `"cacheCreation"`775* `type`：（`"input"`、`"output"`、`"cacheRead"`、`"cacheCreation"`）。`"input"` 類型不包含從提示快取讀取或寫入提示快取的 token，這些會計入 `"cacheRead"` 與 `"cacheCreation"`。`"cacheCreation"` 類型會將五分鐘與一小時[快取存留期](/docs/zh-TW/prompt-caching#cache-lifetime)的快取寫入合併計算。

776* `model`：模型識別碼（例如 "claude-sonnet-5"）776* `model`：模型識別碼（例如 "claude-sonnet-5"）

777* `query_source`：發出請求之子系統的類別。為 `"main"`、`"subagent"` 或 `"auxiliary"` 之一777* `query_source`：發出請求之子系統的類別。為 `"main"`、`"subagent"` 或 `"auxiliary"` 之一

778* `speed`：當請求使用快速模式時為 `"fast"`。否則不存在778* `speed`：當請求使用快速模式時為 `"fast"`。否則不存在

749這些檢查仍然適用：749這些檢查仍然適用：

750 750 

751* 內容範圍的 ask 規則（如 `Bash(git push *)`）仍然強制提示751* 內容範圍的 ask 規則（如 `Bash(git push *)`）仍然強制提示

752* 明確的 deny 規則仍然適用

753* 針對 [critical path](/docs/zh-TW/permission-modes#critical-paths) 的 `rm` 或 `rmdir` 命令仍然會通過常規權限流程

754* 其他沙箱化命令也可能通過常規權限流程，如 [Auto-allow mode](/docs/zh-TW/sandboxing#auto-allow-mode) 所述752* 其他沙箱化命令也可能通過常規權限流程，如 [Auto-allow mode](/docs/zh-TW/sandboxing#auto-allow-mode) 所述

755 753 

756不會在沙箱中執行的命令（例如排除的命令）會遵守 bare `Bash` ask 規則。請參閱 [sandbox modes](/docs/zh-TW/sandboxing#sandbox-modes) 以變更此行為。754不會在沙箱中執行的命令（例如排除的命令）會遵守 bare `Bash` ask 規則。請參閱 [sandbox modes](/docs/zh-TW/sandboxing#sandbox-modes) 以變更此行為。

78 78 

79Mods 不會取代您已有的控制：79Mods 不會取代您已有的控制：

80 80 

81* **設定 hooks 保持有效。** 設定檔和外掛程式 `hooks/hooks.json` 中的命令、HTTP、提示和代理 hooks 像以前一樣執行，與 mods 並行。它們沒有任何內容已棄用。81* **設定 hook 保持有效。** 設定檔和外掛程式 `hooks/hooks.json` 中的命令、HTTP、提示詞和 agent hook 像以前一樣執行，與 mod 並行。

82* **拒絕規則在防護載入的地方優先。** 使用者的 mod 無法批准 `deny` 規則拒絕的呼叫，除非您設定 [`allowModsToOverrideDenyRules`](#set-options-on-the-built-in-guard)。82* **拒絕規則在防護載入的地方優先。** 使用者的 mod 無法批准 `deny` 規則拒絕的呼叫，除非您設定 [`allowModsToOverrideDenyRules`](#set-options-on-the-built-in-guard)。

83* **受管 hooks 首先執行。** 受管設定中的 `PreToolUse` hook 在任何 mod 看到工具呼叫之前執行，其塊是最終的。如果 mod 隨後重寫呼叫，您的受管 hooks 在重寫的呼叫上再次執行，因此塊仍然適用。來自其他設定檔和外掛程式的 `PreToolUse` hooks 在最後一個 mod 之後執行，因此返回自己結果代替執行工具的 mod 會防止這些執行。請參閱 [mods 執行的順序](/docs/zh-TW/plugins/mods/events#the-order-mods-run-in)。83* **受管 hooks 首先執行。** 受管設定中的 `PreToolUse` hook 在任何 mod 看到工具呼叫之前執行，其塊是最終的。如果 mod 隨後重寫呼叫，您的受管 hooks 在重寫的呼叫上再次執行，因此塊仍然適用。來自其他設定檔和外掛程式的 `PreToolUse` hooks 在最後一個 mod 之後執行，因此返回自己結果代替執行工具的 mod 會防止這些執行。請參閱 [mods 執行的順序](/docs/zh-TW/plugins/mods/events#the-order-mods-run-in)。

84* **網路政策涵蓋 `$.http.fetch`。**84* **網路政策涵蓋 `$.http.fetch`。**

114 `Text`114 `Text`

115</h3>115</h3>

116 116 

117`Text` 會以您指定的樣式繪製字串。此範例為每種樣式各顯示一行：117`Text` 會以您指定的樣式繪製字串。此範例顯示純文字與八種樣式，每行一種：

118 118 

119```javascript theme={null}119```javascript theme={null}

120Box({120Box({

455 455 

456| 元素 | 它繪製的內容 | 位置 |456| 元素 | 它繪製的內容 | 位置 |

457| :- | :- | :- |457| :- | :- | :- |

458| `Box` | 彈性容器。採用佈局 prop，例如 `flexDirection`、`columnGap`、`padding`、[`borderStyle`](/docs/zh-TW/plugins/mods/reference#box-border-styles) 和 `width`。 | 到處 |458| `Box` | 彈性容器。採用佈局 prop，例如 `flexDirection`、[`borderStyle`](/docs/zh-TW/plugins/mods/reference#box-border-styles) 和 `width`。`columnGap` 和 `padding` 等間距 prop 採用數字，或從 `'xs'` 到 `'xl'` 的[級距名稱](/docs/zh-TW/plugins/mods/reference#box-spacing-steps)。 | 到處 |

459| `Text` | 樣式文字。採用 `color`、`bold`、`dimColor`、`italic` 和 `wrap`。`color` 是主題鍵或顏色，例如 `'red'`。`wrap` 是 `'wrap'`、`'truncate'`、`'truncate-start'`、`'truncate-middle'` 或 `'truncate-end'`。 | 到處 |459| `Text` | 樣式文字。採用 `color`、`bold`、`dimColor`、`italic`、`wrap`，以及 [`weight`](/docs/zh-TW/plugins/mods/reference#text-typography) 等其他 prop。`color` 是主題鍵或顏色，例如 `'red'`。`wrap` 是 `'wrap'`、`'truncate'`、`'truncate-start'`、`'truncate-middle'` 或 `'truncate-end'`。 | 到處 |

460| `Button` | 呼叫 `onPress` 的控制項 | 到處 |460| `Button` | 呼叫 `onPress` 的控制項 | 到處 |

461| `Link`, `Code`, `Markdown` | 具有 `href` 和可選 `label` 的連結、程式碼區塊和格式化為 Claude 回覆方式的文字。`Markdown` 在 `text` 屬性中而不是在 `children` 中採用其內容，並在您傳遞 `onLinkPress` 時需要 `key`。 | 到處 |461| `Link`, `Code`, `Markdown` | 具有 `href` 和可選 `label` 的連結、程式碼區塊和格式化為 Claude 回覆方式的文字。`Markdown` 在 `text` 屬性中而不是在 `children` 中採用其內容，並在您傳遞 `onLinkPress` 時需要 `key`。 | 到處 |

462| `Input`, `Select` | 文字欄位和下拉式選單 | 終端機、桌面、VS Code |462| `Input`, `Select` | 文字欄位和下拉式選單 | 終端機、桌面、VS Code |

293 293 

294| 元素 | 主要 prop | 終端機 | Desktop | VS Code |294| 元素 | 主要 prop | 終端機 | Desktop | VS Code |

295| :- | :- | :-: | :-: | :-: |295| :- | :- | :-: | :-: | :-: |

296| [`Box`](/docs/zh-TW/plugins/mods/interface#build-a-tree-from-elements) | `key`、flex 版面配置、`gap`、`padding`、`margin`、`width`、`height`、[`borderStyle`](#box-border-styles)、`backgroundColor`、`position`、`hover` | ✓ | ✓ | ✓ |296| [`Box`](/docs/zh-TW/plugins/mods/interface#build-a-tree-from-elements) | `key`、flex 版面配置、[`gap`、`padding`、`margin`](#box-spacing-steps)、`width`、`height`、[`borderStyle`](#box-border-styles)、`backgroundColor`、`position`、`hover` | ✓ | ✓ | ✓ |

297| [`Text`](/docs/zh-TW/plugins/mods/interface#build-a-tree-from-elements) | `color`、`backgroundColor`、`bold`、`italic`、`underline`、`dimColor`、`inverse`、`wrap` | ✓ | ✓ | ✓ |297| [`Text`](/docs/zh-TW/plugins/mods/interface#build-a-tree-from-elements) | `color`、`backgroundColor`、[`bold`](#text-bold)、`italic`、`underline`、`dimColor`、`inverse`、`wrap`、[`size`、`weight`、`mono`、`tabular`](#text-typography) | ✓ | ✓ | ✓ |

298| [`Button`](/docs/zh-TW/plugins/mods/interface#respond-to-presses-and-typing) | `key`、`label`、`onPress`、`hotkey`、`plain`、`dimColor`、`autoFocus`、`action` | ✓ | ✓ | ✓ |298| [`Button`](/docs/zh-TW/plugins/mods/interface#respond-to-presses-and-typing) | `key`、`label`、`onPress`、`hotkey`、`plain`、`dimColor`、`autoFocus`、`action` | ✓ | ✓ | ✓ |

299| [`Link`](/docs/zh-TW/plugins/mods/interface#link-in-the-desktop-app) | `href`、`label`。請參閱[限制](#limits)。 | ✓ | ✓ | ✓ |299| [`Link`](/docs/zh-TW/plugins/mods/interface#link-in-the-desktop-app) | `href`、`label`。請參閱[限制](#limits)。 | ✓ | ✓ | ✓ |

300| [`Code`](/docs/zh-TW/plugins/mods/gallery#show-code-and-changes) | `source`、`language`、`path`、`startLine`、`format`、`wrap` | ✓ | ✓ | ✓ |300| [`Code`](/docs/zh-TW/plugins/mods/gallery#show-code-and-changes) | `source`、`language`、`path`、`startLine`、`format`、`wrap` | ✓ | ✓ | ✓ |

311VS Code 擴充功能會忽略部分元素 prop，並以如同您省略這些 prop 的方式繪製元素：311VS Code 擴充功能會忽略部分元素 prop，並以如同您省略這些 prop 的方式繪製元素：

312 312 

313* **`Box`**：`position` 和 `hover`313* **`Box`**：`position` 和 `hover`

314* **`Text`**：`size`、`mono` 和 `tabular`

314* **`Button`**：`hotkey`、`plain`、`autoFocus` 和 `action`，因此使用者在該處要透過點擊按下按鈕，或在按鈕取得焦點後按 Enter315* **`Button`**：`hotkey`、`plain`、`autoFocus` 和 `action`，因此使用者在該處要透過點擊按下按鈕，或在按鈕取得焦點後按 Enter

315* **`Code`**：`language`、`path`、`startLine`、`format` 和 `wrap`，因此程式碼繪製時不會有色彩或行號，而 `format: 'diff'` 區塊會顯示差異的原始文字316* **`Code`**：`language`、`path`、`startLine`、`format` 和 `wrap`，因此程式碼繪製時不會有色彩或行號，而 `format: 'diff'` 區塊會顯示差異的原始文字

316* **`Input` 和 `Select`**：`autoFocus`317* **`Input` 和 `Select`**：`autoFocus`

336 337 

337若 `Box` 的 `borderStyle` 指定為其他任何名稱，例如 `'rounded'`，則繪製時不會有框線。338若 `Box` 的 `borderStyle` 指定為其他任何名稱，例如 `'rounded'`，則繪製時不會有框線。

338 339 

340<h3 id="box-spacing-steps">

341 `Box` 間距級距

342</h3>

343 

344`Box` 的間距 prop 包括 `gap`、`columnGap`、`rowGap`、`padding`、`margin`，以及 `padding` 和 `margin` 的單側與單軸形式，例如 `paddingX` 和 `marginTop`。每個 prop 都接受以終端機儲存格為單位的數字，例如 `gap: 1`，或是級距名稱，例如 `gap: 'md'`。在終端機和 VS Code 擴充功能中，每個級距對應的儲存格數如下：

345 

346| 級距 | 橫向儲存格數 | 縱向儲存格數 |

347| :- | :- | :- |

348| `'xs'` | 1 | 0 |

349| `'sm'` | 1 | 0 |

350| `'md'` | 2 | 1 |

351| `'lg'` | 3 | 1 |

352| `'xl'` | 4 | 2 |

353 

354若您將 `gap`、`padding` 或 `margin` 設為某個級距，該級距會同時套用於橫向與縱向。例如，在終端機和 VS Code 擴充功能中，`padding: 'md'` 表示左右兩側各兩個儲存格，上下各一列。

355 

356級距名稱需要 Claude Code v2.1.299 或更新版本。在較早的版本中，Claude Code 會[繪製其自有版本的網站](/docs/zh-TW/plugins/mods/interface#build-a-tree-from-elements)，取代使用級距名稱的樹狀結構。

357 

358<h3 id="text-typography">

359 `Text` 字體排版 prop

360</h3>

361 

362在 `Text` 上設定 `size`、`weight`、`mono` 或 `tabular`，即可要求繪製您樹狀結構的應用程式使用特定文字大小、字重、等寬字體或等寬數字。在依賴某個 prop 之前，請先確認終端機和 VS Code 擴充功能如何處理它。若應用程式忽略您設定的 prop，您的樹狀結構仍會在該處繪製，文字則如同您省略該 prop 一樣。

363 

364| Prop | 值 | 在終端機中 | 在 VS Code 擴充功能中 |

365| :- | :- | :- | :- |

366| `size` | `'caption'`、`'footnote'`、`'body'`、`'heading'` 或 `'title'` | 忽略：終端機只有一種文字大小 | 忽略 |

367| `weight` | `'regular'`、`'medium'`、`'semibold'` 或 `'bold'` | `semibold` 和 `bold` 會繪製為粗體文字 | `semibold` 和 `bold` 會繪製為粗體文字 |

368| `mono` | `true`，要求使用應用程式的等寬字體 | 忽略：終端機一律為等寬 | 忽略，因此文字保留擴充功能本身的字體 |

369| `tabular` | `true`，要求使用等寬數字，讓就地更新的數字或一欄數字保持對齊 | 忽略：終端機的數字本來就是一個儲存格寬 | 忽略 |

370 

371這四個 prop 需要 Claude Code v2.1.299 或更新版本。在較早的版本中，Claude Code 會[繪製其自有版本的網站](/docs/zh-TW/plugins/mods/interface#build-a-tree-from-elements)，取代設定了 `size`、`weight`、`mono` 或 `tabular` 的樹狀結構。

372 

373<h4 id="text-bold">

374 以 `weight` 取代 `bold`

375</h4>

376 

377`Text` 上的 `bold` 已棄用，改用 `weight`，但仍可正常運作。若要在未設定 `weight` 的 `Text` 上取代它，請將 `bold: true` 改為 `weight: 'semibold'`，即可在 Claude Code v2.1.299 或更新版本上獲得相同結果。

378 

379在早於 v2.1.299 的版本中，設定了 `weight` 的樹狀結構不會繪製，Claude Code 會改為[繪製其自有版本的網站](/docs/zh-TW/plugins/mods/interface#build-a-tree-from-elements)。若您在 `Text` 上同時設定 `bold` 和 `weight`，則 `bold` 不會有任何作用。

380 

339<h2 id="limits">381<h2 id="limits">

340 限制382 限制

341</h2>383</h2>

235 235 

236mod 已載入，其窗格、帶狀、toast 或控制項的行為不符合您的預期。236mod 已載入，其窗格、帶狀、toast 或控制項的行為不符合您的預期。

237 237 

238<h3 id="another-mods-band-shows-and-yours-doesnt">

239 顯示的是另一個 mod 的帶狀，而不是您的

240</h3>

241 

242提示詞上方只有一個帶狀，所有 mod 共用。在[您的 mod 之前](/docs/zh-TW/plugins/mods/events#the-order-mods-run-in)執行的 mod，若返回的樹中不包含 `next(e)` 的結果，就會取代您的帶狀。若要同時顯示兩個帶狀，請修改該 mod 的 hook，或請其作者修改：

243 

244* **保留其後的帶狀**：將 `await next(e)` 的結果放在其樹中某個 `Box` 的子元素之間，如[選擇繪製位置](/docs/zh-TW/plugins/mods/interface#pick-where-to-draw)中「提示詞上方的帶狀」分頁所示

245* **保持樹有效**：不要為該 `Box` 或其外圍的任何 `Box` 指定 `width`、`height`、`minWidth`、`minHeight`、`position`、`top`、`left`、`right`、`bottom`、`display` 或 `overflow` prop

246 

247若要找出該 mod，請[寫入偵錯日誌](#read-the-debug-log)，並在其中搜尋 `answered ui.render without next()`。像 `other-mod (user) answered ui.render without next()` 這樣的行會指出某個未呼叫 `next(e)` 就返回其樹的 mod。該行不會指出[轉譯位置](/docs/zh-TW/plugins/mods/reference#render-sites)，因此僅使用窗格的 mod 也可能出現。呼叫了 `next(e)` 但捨棄其結果的 mod 不會產生任何行，因此也請檢查在您之前的 hook。

248 

249變更之後，若任何 mod 返回未通過驗證的樹，帶狀中將不會顯示任何內容。若要讀取原因，請在 `--plugin-dir` 工作階段的逐字稿中尋找 `ui.render (AbovePrompt) refused:` 行，或在偵錯日誌中搜尋 `does not validate`。當帶狀中有多個 mod 時，這兩行都不會指出是哪個 mod，因此請檢查每個 mod 的樹。

250 

238<h3 id="a-pane-or-band-is-empty-or-shows-claude-code’s-usual-content">251<h3 id="a-pane-or-band-is-empty-or-shows-claude-code’s-usual-content">

239 窗格或帶狀為空或顯示 Claude Code 的常見內容252 窗格或帶狀為空或顯示 Claude Code 的常見內容

240</h3>253</h3>

199 199 

200即使在 auto-allow 模式下，下列規則仍然適用：200即使在 auto-allow 模式下，下列規則仍然適用：

201 201 

202* 明確的[拒絕規則](/docs/zh-TW/permissions)一律受到遵守202* 採用 `Bash` 拒絕規則所能比對之[形式](/docs/zh-TW/permissions#bash-rule-limits)的命令仍會被封鎖

203* 以[關鍵路徑](/docs/zh-TW/permission-modes#critical-paths)為目標的 `rm` 或 `rmdir` 命令仍會經過一般的權限流程203* 經辨識為以[關鍵路徑](/docs/zh-TW/permission-modes#which-paths-are-critical)為目標的 `rm` 或 `rmdir` 命令仍會經過一般的權限流程

204* 以內容為範圍的[詢問規則](/docs/zh-TW/permissions)（例如 `Bash(git push *)`）即使對沙箱化命令仍會強制提示204* 以內容為範圍的[詢問規則](/docs/zh-TW/permissions)（例如 `Bash(git push *)`）即使對沙箱化命令仍會強制提示

205* 單純的 `Bash` 詢問規則，或等效的 `Bash(*)` 形式，對於以沙箱方式執行的命令會被略過；對於在沙箱外執行的命令則仍然適用。在 [plan mode](/docs/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode) 中，該規則不會被略過：它也會對沙箱化命令（包括唯讀命令）提示205* 單純的 `Bash` 詢問規則，或等效的 `Bash(*)` 形式，對於以沙箱方式執行的命令會被略過；對於在沙箱外執行的命令則仍然適用。在 [plan mode](/docs/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode) 中，該規則不會被略過：它也會對沙箱化命令（包括唯讀命令）提示

206* [Monitor 工具](/docs/zh-TW/tools-reference#monitor-tool)的命令不會自動核准，但仍會在沙箱中執行。若要略過提示，請新增與該命令相符的[允許規則](/docs/zh-TW/permissions#bash)，例如 `Bash(npm run *)`206* [Monitor 工具](/docs/zh-TW/tools-reference#monitor-tool)的命令不會自動核准，但仍會在沙箱中執行。若要略過提示，請新增與該命令相符的[允許規則](/docs/zh-TW/permissions#bash)，例如 `Bash(npm run *)`

112 IDE 安全性112 IDE 安全性

113</h2>113</h2>

114 114 

115有關在 IDE 中執行 Claude Code 的更多資訊，請參閱 [VS Code security and privacy](/docs/zh-TW/vs-code#security-and-privacy)。115有關在 IDE 中執行 Claude Code 的更多資訊，請參閱[內建的 IDE MCP 伺服器](/docs/zh-TW/vs-code#the-built-in-ide-mcp-server)。

116 116 

117<h2 id="cloud-execution-security">117<h2 id="cloud-execution-security">

118 雲端執行安全性118 雲端執行安全性

42如果安裝失敗，請比對 Claude Code 報告的訊息：42如果安裝失敗，請比對 Claude Code 報告的訊息：

43 43 

44* `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市場，然後重試安裝。44* `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市場，然後重試安裝。

45* 外掛程式 [在市場中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛程式名稱。45* `Plugin "<name>" not found in marketplace "claude-plugins-official"`：您本機的市集目錄副本可能已過時。請使用 `/plugin marketplace update claude-plugins-official` 重新整理，然後重試安裝。如果重試後顯示相同的訊息，請參閱 [Plugin not found in marketplace](/docs/zh-TW/plugins/troubleshooting#plugin-not-found-in-marketplace)。

46 46 

47檢查安裝摘要。如果它報告 `Run /reload-plugins to apply.`，請參閱 [在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins) 以在您目前的工作階段中啟用外掛程式。47檢查安裝摘要。如果它報告 `Run /reload-plugins to apply.`，請參閱 [在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins) 以在您目前的工作階段中啟用外掛程式。

48 48 

718 718 

719如果您使用引數調用 skill，但 skill 內容中沒有佔位符接收一個，Claude Code 將 `ARGUMENTS: <your input>` 附加到 skill 內容的末尾，以便 Claude 仍然看到您鍵入的內容。佔位符是 `$ARGUMENTS`、索引形式（例如 `$1`）或命名引數。沒有其位置引數的索引佔位符保持為文字文本，不計為接收一個。命名佔位符計數，即使其位置沒有引數，因為它擴展為空字串。719如果您使用引數調用 skill，但 skill 內容中沒有佔位符接收一個，Claude Code 將 `ARGUMENTS: <your input>` 附加到 skill 內容的末尾，以便 Claude 仍然看到您鍵入的內容。佔位符是 `$ARGUMENTS`、索引形式（例如 `$1`）或命名引數。沒有其位置引數的索引佔位符保持為文字文本，不計為接收一個。命名佔位符計數，即使其位置沒有引數，因為它擴展為空字串。

720 720 

721您也可以在一條訊息的開始堆疊多個 skills。鍵入 `/write-tests /fix-issue 123` 加載兩個 skills 並將尾隨文本 `123` 作為 `$ARGUMENTS` 傳遞給每個。

722 

723Claude Code 擴展第一個 skill 加上最多五個堆疊在它之後的。擴展在第一個不是內聯使用者可調用 skill 的 token 處停止，因此作為[分叉 subagent](#run-skills-in-a-subagent)運行的 skill（例如[`/code-review`](/docs/zh-TW/code-review-local)）或其引數本身可能以斜線命令開始的 skill（例如 `/loop`）也在那裡結束運行。該 token 和它之後的所有內容成為每個擴展 skill 的引數文本。從 v2.1.218 開始，`/code-review` 作為分叉 subagent 運行；在較早的版本上，它內聯運行並堆疊。

724 

725要按位置訪問個別引數，使用 `$ARGUMENTS[N]` 或較短的 `$N`：721要按位置訪問個別引數，使用 `$ARGUMENTS[N]` 或較短的 `$N`：

726 722 

727```yaml theme={null}723```yaml theme={null}

746Preserve all existing behavior and tests.742Preserve all existing behavior and tests.

747```743```

748 744 

745<h4 id="stack-several-skills-in-one-message">

746 在一條訊息中堆疊多個 skills

747</h4>

748 

749當您在終端機中的 Claude Code 提示字元輸入時，可以在一條訊息的開頭堆疊多個 skills。透過 Agent SDK 或 `claude -p` 時，Claude Code 只會加載第一個 skill，並將該行的其餘部分作為其引數。在終端機提示字元中，鍵入 `/write-tests /fix-issue 123` 會加載兩個 skills，並將尾隨文本 `123` 作為 `$ARGUMENTS` 傳遞給每個。

750 

751Claude Code 擴展第一個 skill 加上最多五個堆疊在它之後的 skills。擴展在第一個不是內聯使用者可調用 skill 的 token 處停止。如果您堆疊作為[分叉 subagent](#run-skills-in-a-subagent)運行的 skill（例如 [`/code-review`](/docs/zh-TW/code-review-local)），或其引數可能以另一個命令開始的 skill（例如 `/loop`），擴展就在那裡結束。該 token 和它之後的所有內容成為每個擴展 skill 的引數文本。

752 

749<h2 id="advanced-patterns">753<h2 id="advanced-patterns">

750 進階模式754 進階模式

751</h2>755</h2>

1044如果安裝失敗，請匹配 Claude Code 報告的訊息：1048如果安裝失敗，請匹配 Claude Code 報告的訊息：

1045 1049 

1046* `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市場，然後重試安裝。1050* `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市場，然後重試安裝。

1047* 外掛[在市場中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛名稱。1051* `Plugin "<name>" not found in marketplace "claude-plugins-official"`：您本機的市集目錄副本可能已過時。使用 `/plugin marketplace update claude-plugins-official` 重新整理，然後重試安裝。如果重試後仍顯示相同訊息，請參閱[在市集中找不到外掛](/docs/zh-TW/plugins/troubleshooting#plugin-not-found-in-marketplace)。

1048 1052 

1049如果安裝摘要顯示 `Run /reload-plugins to apply.`，Claude Code 接著會為您執行該重新載入。如果重新載入警告您的下一則訊息會重新讀取對話，請執行 `/reload-plugins --force`，讓外掛的 skill 在目前工作階段中可用。然後要求 Claude 評估現有的 skill，例如 `evaluate my summarize-changes skill with skill-creator`。外掛會引導您撰寫測試案例並執行迴圈：1053如果安裝摘要顯示 `Run /reload-plugins to apply.`，Claude Code 接著會為您執行該重新載入。如果重新載入警告您的下一則訊息會重新讀取對話，請執行 `/reload-plugins --force`，讓外掛的 skill 在目前工作階段中可用。然後要求 Claude 評估現有的 skill，例如 `evaluate my summarize-changes skill with skill-creator`。外掛會引導您撰寫測試案例並執行迴圈：

1050 1054 

281 全螢幕模式281 全螢幕模式

282 </h4>282 </h4>

283 283 

284 Claude Code 在預設和全螢幕轉譯器中繪製 `userMessageBackground`、`bashMessageBackgroundColor` 和 `memoryBackgroundColor`。它僅在[全螢幕轉譯模式](/docs/zh-TW/fullscreen)中使用 `userMessageBackgroundHover` 和 `selectionBg`。284 Claude Code 僅在[全螢幕轉譯模式](/docs/zh-TW/fullscreen)中使用 `userMessageBackgroundHover`、`selectionBg` 和 `composerSidebarBackground`。它在預設和全螢幕轉譯器中都會繪製 `userMessageBackground`、`bashMessageBackgroundColor` 和 `memoryBackgroundColor`。

285 285 

286 | 權杖 | 控制項 |286 | 權杖 | 控制項 |

287 | :- | :- |287 | :- | :- |

290 | `bashMessageBackgroundColor` | 文字記錄中 `!` shell 指令項目後面的背景 |290 | `bashMessageBackgroundColor` | 文字記錄中 `!` shell 指令項目後面的背景 |

291 | `memoryBackgroundColor` | 文字記錄中 `#` 記憶項目後面的背景 |291 | `memoryBackgroundColor` | 文字記錄中 `#` 記憶項目後面的背景 |

292 | `selectionBg` | 使用滑鼠選取的文字背景 |292 | `selectionBg` | 使用滑鼠選取的文字背景 |

293 | `composerSidebarBackground` | 對話旁面板的背景，例如[差異面板](/docs/zh-TW/fullscreen#watch-your-changes-in-the-diff-panel)或 [mod 的窗格](/docs/zh-TW/plugins/mods/interface) |

293 294 

294 <h4 id="usage-meter-and-speaker-labels">295 <h4 id="usage-meter-and-speaker-labels">

295 使用量計量和說話者標籤296 使用量計量和說話者標籤

4 4 

5# 在 VS Code 中使用 Claude Code5# 在 VS Code 中使用 Claude Code

6 6 

7> 安裝並配置 VS Code 的 Claude Code 擴充功能。透過內聯差異、@-提及、計畫審查和快捷鍵獲得 AI 編碼協助。7> 安裝並設定 VS Code 的 Claude Code 擴充功能。透過內聯差異、@-提及、計畫審查和鍵盤快捷鍵獲得 AI 編碼協助。

8 8 

9<img src="https://mintcdn.com/claude-code/-YhHHmtSxwr7W8gy/images/vs-code-extension-interface.jpg?fit=max&auto=format&n=-YhHHmtSxwr7W8gy&q=85&s=300652d5678c63905e6b0ea9e50835f8" alt="VS Code 編輯器，右側開啟 Claude Code 擴充功能面板，顯示與 Claude 的對話" width="2500" height="1155" data-path="images/vs-code-extension-interface.jpg" />9<img src="https://mintcdn.com/claude-code/-YhHHmtSxwr7W8gy/images/vs-code-extension-interface.jpg?fit=max&auto=format&n=-YhHHmtSxwr7W8gy&q=85&s=300652d5678c63905e6b0ea9e50835f8" alt="VS Code 編輯器，右側開啟 Claude Code 擴充功能面板，顯示與 Claude 的對話" width="2500" height="1155" data-path="images/vs-code-extension-interface.jpg" />

10 10 

11VS Code 擴充功能為 Claude Code 提供了原生圖形介面，直接整合到您的 IDE 中。這是在 VS Code 中使用 Claude Code 的推薦方式。11VS Code 擴充功能為 Claude Code 提供了原生圖形介面，直接整合到您的 IDE 中。這是在 VS Code 中使用 Claude Code 的推薦方式。

12 12 

13使用此擴充功能，您可以在接受 Claude 的計畫之前進行審查和編輯，在進行編輯時自動接受，從您的選擇中 @-提及具有特定行範圍的檔案，存取對話歷史記錄，以及在單獨的標籤或視窗中開啟多個對話。13使用此擴充功能，您可以：

14 

15* 在接受 Claude 的計畫之前進行審查和編輯

16* 在進行編輯時自動接受

17* 從您的選擇中 @-提及具有特定行範圍的檔案

18* 存取對話歷史記錄

19* 在單獨的標籤或視窗中開啟多個對話

14 20 

15<h2 id="prerequisites">21<h2 id="prerequisites">

16 先決條件22 先決條件

29 安裝擴充功能35 安裝擴充功能

30</h2>36</h2>

31 37 

32點擊您的 IDE 的連結以直接安裝：38點擊您所使用 IDE 的連結即可直接安裝：

33 39 

34* [為 VS Code 安裝](vscode:extension/anthropic.claude-code)40* [為 VS Code 安裝](vscode:extension/anthropic.claude-code)

35* [為 Cursor 安裝](cursor:extension/anthropic.claude-code)41* [為 Cursor 安裝](cursor:extension/anthropic.claude-code)

36 42 

37或在 VS Code 中，按 `Cmd+Shift+X`（Mac）或 `Ctrl+Shift+X`（Windows/Linux）開啟擴充功能檢視，搜尋「Claude Code」，然後點擊**安裝**。43或者在 VS Code 中，按下 `Cmd+Shift+X`（Mac）或 `Ctrl+Shift+X`（Windows/Linux）開啟「擴充功能」檢視，搜尋「Claude Code」，然後點擊 **Install**。

38 44 

39擴充功能的版本號碼即為其所內建的 Claude Code 版本。例如，需要 Claude Code v2.1.286 或更新版本的功能，就需要 2.1.286 或更新版本的擴充功能，版本號碼會顯示在擴充功能檢視中。45擴充功能的版本號碼即為其所內建的 Claude Code 版本。例如，需要 Claude Code v2.1.286 或更新版本的功能，就需要 2.1.286 或更新版本的擴充功能，版本號碼可在「擴充功能」檢視中查看。

40 46 

41擴充功能也會安裝在其他 VS Code 分支中，例如 Devin Desktop 或 Kiro。在編輯器的擴充功能檢視中搜尋「Claude Code」，或從 [Open VSX registry](https://open-vsx.org/extension/Anthropic/claude-code) 安裝。如果您的編輯器無法安裝擴充功能，請[安裝 CLI](/docs/zh-TW/quickstart) 並在其整合終端中執行 `claude`。CLI 可在任何終端中運作。47Claude Code 也可以在其他編輯器和容器中執行：

42 48 

43若要在開發容器中執行 Claude Code，請參閱[開發容器](/docs/zh-TW/devcontainer)。49* **其他 VS Code 分支版本**：此擴充功能也可安裝在 Devin Desktop 或 Kiro 等分支版本中。請在編輯器的「擴充功能」檢視中搜尋「Claude Code」，或從 [Open VSX registry](https://open-vsx.org/extension/Anthropic/claude-code) 安裝。

50* **無法安裝擴充功能的編輯器**：請改為[安裝 CLI](/docs/zh-TW/quickstart)，並在編輯器的整合式終端機中執行 `claude`。CLI 可在任何終端機中運作。

51* **開發容器**：若要在開發容器中執行 Claude Code，請參閱[開發容器](/docs/zh-TW/devcontainer)。

44 52 

45<Note>如果安裝後擴充功能未出現，請重新啟動 VS Code 或從命令面板執行「Developer: Reload Window」。</Note>53<Note>如果安裝後擴充功能沒有出現，請重新啟動 VS Code，或從命令選擇區執行「Developer: Reload Window」。</Note>

46 54 

47<h2 id="get-started">55<h2 id="get-started">

48 開始使用56 開始使用

49</h2>57</h2>

50 58 

51安裝後，您可以透過 VS Code 介面開始使用 Claude Code：59安裝完成後，您可以透過 VS Code 介面開始使用 Claude Code：

52 60 

53<Steps>61<Steps>

54 <Step title="開啟 Claude Code 面板">62 <Step title="開啟 Claude Code 面板">

55 在整個 VS Code 中，Spark 圖示表示 Claude Code：<img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Spark icon" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />63 在整個 VS Code 中，Spark 圖示代表 Claude Code：<img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Spark 圖示" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

56 64 

57 開啟 Claude 最快的方式是點擊**編輯器工具列**（編輯器右上角）中的 Spark 圖示。只有當您開啟檔案時，該圖示才會出現。65 開啟 Claude 最快的方式是點選 **Editor Toolbar**（編輯器右上角）中的 Spark 圖示。此圖示僅在開啟檔案時才會顯示。

58 66 

59 <img src="https://mintcdn.com/claude-code/mfM-EyoZGnQv8JTc/images/vs-code-editor-icon.png?fit=max&auto=format&n=mfM-EyoZGnQv8JTc&q=85&s=eb4540325d94664c51776dbbfec4cf02" alt="VS Code 編輯器顯示編輯器工具列中的 Spark 圖示" width="2796" height="734" data-path="images/vs-code-editor-icon.png" />67 <img src="https://mintcdn.com/claude-code/mfM-EyoZGnQv8JTc/images/vs-code-editor-icon.png?fit=max&auto=format&n=mfM-EyoZGnQv8JTc&q=85&s=eb4540325d94664c51776dbbfec4cf02" alt="VS Code 編輯器在 Editor Toolbar 中顯示 Spark 圖示" width="2796" height="734" data-path="images/vs-code-editor-icon.png" />

60 68 

61 開啟 Claude Code 的其他方式：69 開啟 Claude Code 的其他方式：

62 70 

63 * **活動列**：點擊左側邊欄中的 Spark 圖示以開啟工作階段清單。點擊任何工作階段以將其開啟至您的[偏好位置](#extension-settings)，或開始新的工作階段。此圖示在活動列中始終可見。71 * **Activity Bar**：點選左側邊欄中的 Spark 圖示以開啟工作階段清單。點選任一工作階段即可在您[偏好的位置](#extension-settings)開啟，或開始新的工作階段。此圖示在 Activity Bar 中始終可見。

64 * **命令面板**：`Cmd+Shift+P`（Mac）或 `Ctrl+Shift+P`（Windows/Linux），輸入「Claude Code」，然後選擇一個選項，例如「在新標籤中開啟」72 * **Command Palette**：按下 `Cmd+Shift+P`（Mac）或 `Ctrl+Shift+P`（Windows/Linux），輸入「Claude Code」，然後選擇「Open in New Tab」等選項

65 * **狀態列**：點擊視窗右下角的 **✻ Claude Code**。即使沒有開啟檔案，這也能運作。73 * **Status Bar**：點選視窗右下角的 **✻ Claude Code**。即使未開啟任何檔案，此方式也能使用。

66 74 

67 您可以拖曳 Claude 面板以在 VS Code 中的任何位置重新定位。詳細資訊請參閱[自訂您的工作流程](#customize-your-workflow)。75 您可以拖曳 Claude 面板，將其重新放置於 VS Code 中的任何位置。詳細資訊請參閱[自訂您的工作流程](#customize-your-workflow)。

68 </Step>76 </Step>

69 77 

70 <Step title="登入">78 <Step title="登入">

71 第一次開啟面板時，會出現登入畫面。點擊**登入**並在瀏覽器中完成授權。79 第一次開啟面板時，會出現登入畫面。點選 **Sign in** 並在瀏覽器中完成授權。

72 80 

73 如果您稍後看到**未登入 · 請執行 /login**，擴充功能會自動重新開啟登入畫面。如果沒有出現，請從命令面板使用**開發人員：重新載入視窗**重新載入視窗。81 如果之後看到 **Not logged in · Please run /login**，擴充功能會自動重新開啟登入畫面。如果登入畫面沒有出現，請從 Command Palette 使用 **Developer: Reload Window** 重新載入視窗。

74 82 

75 如果您在 shell 中設定了 `ANTHROPIC_API_KEY` 但仍然看到登入提示，VS Code 可能未繼承您的 shell 環境。從終端機使用 `code .` 啟動 VS Code，以便它繼承您的環境變數，或改為使用您的 Claude 帳戶登入。83 如果您已在 shell 中設定 `ANTHROPIC_API_KEY`，但仍看到登入提示，可能是 VS Code 沒有繼承您的 shell 環境。請從終端機使用 `code .` 啟動 VS Code，使其繼承您的環境變數，或改用您的 Claude 帳戶登入。

76 84 

77 登入後，會出現**學習 Claude Code** 檢查清單。透過點擊**顯示給我**來完成每個項目，或使用 X 關閉它。若要稍後重新開啟它，請在 VS Code 設定中的「擴充功能」→「Claude Code」下取消勾選**隱藏上線教學**。85 登入後，會出現 **Learn Claude Code** 檢查清單。點選 **Show me** 逐一完成各個項目，或點選 X 將其關閉。若之後要重新開啟，請在 VS Code 設定的 **Extensions > Claude Code** 下取消勾選 **Hide Onboarding**。

78 </Step>86 </Step>

79 87 

80 <Step title="傳送提示">88 <Step title="傳送提示詞">

81 要求 Claude 協助您的程式碼或檔案，無論是解釋某些內容的運作方式、除錯問題或進行變更。89 請 Claude 協助處理您的程式碼或檔案，無論是說明某項功能的運作方式、除錯問題，還是進行變更。

82 90 

83 <Tip>Claude 會自動看到您選取的文字。按 `Option+K`（Mac）/ `Alt+K`（Windows/Linux）也可以在您的提示中插入 @-mention 參考（例如 `@file.ts#5-10`）。</Tip>91 <Tip>Claude 會自動看到您選取的文字。按下 `Option+K`（Mac）/ `Alt+K`（Windows/Linux）還可以在提示詞中插入 @-mention 參照（例如 `@file.ts#5-10`）。</Tip>

84 92 

85 以下是詢問檔案中特定行的範例：93 以下是針對檔案中特定行提問的範例：

86 94 

87 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-send-prompt.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=ede3ed8d8d5f940e01c5de636d009cfd" alt="VS Code 編輯器在 Python 檔案中選取第 2-3 行，Claude Code 面板顯示關於這些行的問題，並帶有 @-mention 參考" width="3288" height="1876" data-path="images/vs-code-send-prompt.png" />95 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-send-prompt.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=ede3ed8d8d5f940e01c5de636d009cfd" alt="VS Code 編輯器在 Python 檔案中選取了第 2-3 行，Claude Code 面板顯示一個針對這些行、帶有 @-mention 參照的問題" width="3288" height="1876" data-path="images/vs-code-send-prompt.png" />

88 </Step>96 </Step>

89 97 

90 <Step title="檢閱變更">98 <Step title="檢閱變更">

91 您看到的內容取決於提示框底部顯示的[權限模式](/docs/zh-TW/permission-modes#which-mode-a-session-starts-in)：99 <span id="security-considerations" />

100 

101 <span id="security-and-privacy" />

102 

103 請查看提示詞輸入框底部顯示的[權限模式](/docs/zh-TW/permission-modes#which-mode-a-session-starts-in)：

92 104 

93 * 在自動或自動編輯模式中，Claude 會編輯工作區中的大多數檔案而不詢問。105 * 在 Auto 或 Edit automatically 模式下，Claude 會直接編輯您工作區中的[大多數檔案](/docs/zh-TW/permission-modes#protected-paths)，而不會詢問。

94 * 在手動模式中，當 Claude 想要編輯檔案時，它會顯示原始檔案和建議變更的並排比較，然後要求權限。您可以接受、拒絕或告訴 Claude 改為執行什麼操作。如果您在接受前直接在差異檢視中編輯建議的內容，Claude 會被告知您已修改它，因此不會假設檔案與其原始提案相符。106 * 在 Manual 模式下，當 Claude 想要編輯檔案時，會並排顯示原始內容與建議的變更，然後請求權限。您可以接受、拒絕，或告訴 Claude 改做什麼。如果您在接受之前直接於差異檢視中編輯建議的內容，Claude 會得知您已修改過，因此不會假設檔案與其原始建議一致。

95 107 

96 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code 顯示 Claude 建議變更的差異，以及詢問是否進行編輯的權限提示" width="3292" height="1876" data-path="images/vs-code-edits.png" />108 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code 顯示 Claude 建議變更的差異，以及詢問是否進行編輯的權限提示" width="3292" height="1876" data-path="images/vs-code-edits.png" />

97 109 

98 若要逐次檢閱建議的編輯，請使用差異中每個變更下方的**接受此變更**和**拒絕此變更**按鈕。拒絕變更會在建議的內容中還原它；接受會將其標記為已檢閱。接受或拒絕整個檔案仍會完成檢閱。超過 100 個變更的差異會在沒有逐個變更按鈕的情況下開啟，因此請將其作為整個檔案進行檢閱。逐個變更檢閱需要 Claude Code v2.1.275 或更新版本。110 若要一次檢閱一項建議的編輯變更，請使用差異中每項變更下方的 **Accept this change** 和 **Reject this change** 按鈕。拒絕某項變更會在建議的內容中還原該變更；接受則會將其標記為已檢閱。逐項變更檢閱需要 Claude Code v2.1.275 或更新版本。

99 111 

100 相同的操作可從編輯器的內容功能表和命令面板中取得，分別為**Claude Code: Accept Change at Cursor** 和**Claude Code: Reject Change at Cursor**。112 接受或拒絕整個檔案仍會完成檢閱。包含超過 100 項變更的差異開啟時不會顯示逐項變更按鈕，因此請以整個檔案為單位進行檢閱。

113 

114 相同的操作也可以在游標位置透過編輯器的右鍵選單，以及在 Command Palette 中以 **Claude Code: Accept Change at Cursor** 和 **Claude Code: Reject Change at Cursor** 執行。

101 </Step>115 </Step>

102</Steps>116</Steps>

103 117 

104如需更多關於您可以使用 Claude Code 執行的操作的想法，請參閱[常見工作流程](/docs/zh-TW/common-workflows)。118如需更多關於 Claude Code 用途的構想，請參閱[常見工作流程](/docs/zh-TW/common-workflows)。

105 119 

106<Tip>120<Tip>

107 從命令面板執行「Claude Code: Open Walkthrough」以取得基礎知識的引導式導覽。121 從 Command Palette 執行「Claude Code: Open Walkthrough」，即可獲得基本功能的導覽。

108</Tip>122</Tip>

109 123 

110<h2 id="use-the-prompt-box">124<h2 id="use-the-prompt-box">

111 使用提示框125 使用提示詞輸入框

112</h2>126</h2>

113 127 

114提示框支援多項功能：128提示詞輸入框支援多項功能：

129 

130* **權限模式**：點擊提示詞輸入框底部的模式指示器即可切換權限模式。在 Claude Code v2.1.283 或更新版本中，Auto 是內建的起始權限模式；在較早版本中，僅 Pro、Max 和 Team 方案如此。請參閱[擴充功能如何選擇起始權限模式](/docs/zh-TW/permission-modes#switch-permission-modes)，了解哪些因素會改變此設定，以及指示器提供的每種權限模式。

131 * **Auto**：由分類器審查大多數動作，而不是詢問您。請參閱[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)，了解它會審查和封鎖哪些內容。

132 * **Manual**：Claude 在編輯檔案和執行大多數 shell 命令前會請求權限。

133 * **Plan**：Claude 會描述它將執行的動作，並在進行變更前等待核准。VS Code 會自動將計畫開啟為完整的 Markdown 文件，您可以在其中加入行內註解，在 Claude 開始之前提供意見回饋。

115 134 

116* **權限模式**：點擊提示框底部的模式指示器以切換權限模式。使用 Claude Code v2.1.283 或更新版本時，Auto 是內建的起始權限模式，在較早版本中僅在 Pro、Max 和 Team 方案上提供。請參閱[擴充功能如何選擇起始權限模式](/docs/zh-TW/permission-modes#switch-permission-modes)以了解會改變該模式的因素，以及指示器提供的每個權限模式。135 您也可以在提示詞輸入框中輸入 `/plan`。需要 Claude Code v2.1.280 或更新版本。

117 * **Auto**：分類器會檢查大多數操作，而不是詢問您。請參閱 [auto 模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)以了解它檢查和阻止的內容。

118 * **Manual**：Claude 在進行檔案編輯和大多數 shell 命令之前會要求權限。

119 * **Plan**：Claude 描述它將執行的操作，並在進行變更之前等待批准。VS Code 會自動將計畫開啟為完整的 Markdown 文件，您可以在其中新增內嵌註解以在 Claude 開始之前提供回饋。

120 136 

121 您也可以在提示框中輸入 `/plan`。需要 Claude Code v2.1.280 或更新版本。137 * `/plan`：切換到 plan mode。如果您已處於 plan mode，則改為顯示目前的計畫。

138 * 帶有任務的 `/plan`，例如 `/plan fix the auth bug`：切換到 plan mode 並開始規劃該任務。

139 * `/plan open`：當您已處於 plan mode 時，在編輯器中開啟計畫檔案。

140 * **Edit automatically**：Claude 會直接進行編輯而不詢問。

141* **模型**：從命令選單中選取 **Switch model…**，即可在工作階段中途變更模型。您也可以點擊提示詞輸入框底部的模型名稱來開啟相同的選擇器。在 Claude Code v2.1.284 或更新版本中，在提示詞輸入框中單獨輸入 `/model` 也會開啟選擇器。

122 142 

123 * `/plan`：切換到計畫模式。如果您已經在計畫模式中，則顯示目前的計畫。143 當目前的模型支援 [effort 等級](/docs/zh-TW/model-config#adjust-effort-level)時，選擇器也會顯示 **Effort** 列，且模型名稱按鈕會顯示所選的等級。當您選擇 `max` 以外的等級時，Claude Code 會將其儲存為目前模型的預設值，存放於使用者設定中的 [`modelSettings`](/docs/zh-TW/settings-reference#modelsettings) 之下；`max` 僅套用於目前的工作階段。模型名稱按鈕和 **Effort** 列需要 Claude Code v2.1.257 或更新版本。

124 * `/plan` 搭配任務，例如 `/plan fix the auth bug`：切換到計畫模式並開始規劃該任務。

125 * `/plan open`：當您已經在計畫模式中時，在編輯器中開啟計畫檔案。

126 * **Edit automatically**：Claude 進行編輯而不詢問。

127* **Model**：從命令選單中選擇 **Switch model…** 以在工作階段中途變更模型。您也可以點擊提示框底部的模型名稱以開啟相同的選擇器。使用 Claude Code v2.1.284 或更新版本時，在提示框中單獨輸入 `/model` 也會開啟選擇器。

128 144 

129 當目前的模型支援[努力等級](/docs/zh-TW/model-config#adjust-effort-level)時，選擇器也會顯示 **Effort** 列和模型名稱按鈕顯示選定的等級。當您選擇 `max` 以外的等級時，Claude Code 會將其儲存為該模型的預設值，位於您的使用者設定中的 [`modelSettings`](/docs/zh-TW/settings-reference#modelsettings)；`max` 僅適用於目前工作階段。模型名稱按鈕和 **Effort** 列需要 Claude Code v2.1.257 或更新版本。145 當[動態工作流程](/docs/zh-TW/workflows)已啟用且目前的模型支援時，**Effort** 列下方會出現 **Ultracode** 開關。開啟後，Claude 會在此工作階段中，以所選的 effort 等級為每個實質任務規劃一個[工作流程](/docs/zh-TW/workflows#let-claude-decide-with-ultracode)。開啟期間，模型名稱按鈕會在等級後方顯示 `· Ultracode`。此開關需要 Claude Code v2.1.284 或更新版本。

146* **命令選單**：點擊 `/` 或輸入 `/` 以開啟命令選單。選項包括附加檔案、切換模型，以及切換延伸思考。

130 147 

131 當[動態工作流程](/docs/zh-TW/workflows)已啟用且目前的模型支援時，**Ultracode** 開關會出現在 **Effort** 列下方。開啟它以讓 Claude 為此工作階段中的每個實質性任務規劃[工作流程](/docs/zh-TW/workflows#let-claude-decide-with-ultracode)，採用選定的努力等級。開啟時，模型名稱按鈕會在等級後顯示 `· Ultracode`。開關需要 Claude Code v2.1.284 或更新版本。148 Customize 區段包含 MCP 伺服器、命令、輸出風格、hook、記憶、指令、權限和外掛等項目。帶有終端機圖示的項目會在整合式終端機中開啟。

132* **Command menu**：點擊 `/` 或輸入 `/` 以開啟命令選單。選項包括附加檔案、切換模型和切換擴充思考。

133 149 

134 Customize 部分包括 MCP servers、commands、output styles、hooks、memory、instructions、permissions 和 plugins 等項目。帶有終端機圖示的項目會在整合終端機中開啟。150 * 若要瀏覽 `/usage` 或 [`/remote-control`](/docs/zh-TW/remote-control) 等命令，請在 Customize 區段中選取 **Slash commands**。對話方塊會列出這些命令並提供篩選框。選取其中一個即可執行。在提示詞輸入框中輸入 `/` 仍會以內嵌方式建議命令。需要 Claude Code v2.1.257 或更新版本。

135 151 

136 * 若要瀏覽 `/usage` 或 [`/remote-control`](/docs/zh-TW/remote-control) 等命令，請在 Customize 部分中選擇 **Slash commands**。對話方塊會列出它們並提供篩選框。選擇一個以執行它。在提示框中輸入 `/` 仍會內嵌建議命令。需要 Claude Code v2.1.257 或更新版本。152 輸入 `/skills` 也會開啟此對話方塊。每個 [skill](/docs/zh-TW/skills) 列都會顯示其[可見性](/docs/zh-TW/skills#override-skill-visibility-from-settings)，例如 **On** 或 **Name only**。點擊可見性即可變更，但標記為 **locked** 的列（例如外掛 skill）除外。`/skills` 捷徑和可見性控制項需要 Claude Code v2.1.280 或更新版本。

153 * 在 Customize 區段中選取 **Output styles**，即可選擇[輸出風格](/docs/zh-TW/output-styles)，包括您的自訂風格。需要 Claude Code v2.1.257 或更新版本。

137 154 

138 輸入 `/skills` 也會開啟此對話方塊。每個[技能](/docs/zh-TW/skills)列會顯示其[可見性](/docs/zh-TW/skills#override-skill-visibility-from-settings)，例如 **On** 或 **Name only**。點擊可見性以變更它，除了標記為 **locked** 的列（例如外掛技能）。`/skills` 快捷方式和可見性控制項需要 Claude Code v2.1.280 或更新版本。155 若要改為建立自訂風格，請從 **Output styles** 選單中選取 **Build a custom style**。Claude Code 會在專案層級或使用者層級為您撰寫[風格檔案](/docs/zh-TW/output-styles#create-a-custom-output-style)。需要 Claude Code v2.1.261 或更新版本。

139 * 在 Customize 部分中選擇 **Output styles** 以選擇[輸出樣式](/docs/zh-TW/output-styles)，包括您的自訂樣式。需要 Claude Code v2.1.257 或更新版本。156 * 在 Customize 區段中選取 **Hooks**，即可檢視工作階段中載入的 [hook](/docs/zh-TW/hooks)，並依事件分組。您可以新增、編輯或移除儲存在使用者、專案和本機設定檔中的 hook。來自其他來源的 hook（例如受管設定或外掛）為唯讀。需要 Claude Code v2.1.269 或更新版本。

157 * 在 Customize 區段中選取 **Permissions**，即可檢視工作階段的[權限規則](/docs/zh-TW/permissions)，並分為 Allow、Ask 和 Deny 三組。您可以將規則新增至使用者、專案或本機設定，也可以移除儲存在其中的規則。來自其他來源的規則（例如受管設定或僅適用於此工作階段的核准）為唯讀。需要 Claude Code v2.1.269 或更新版本。

158 * 在 Customize 區段中選取 **Memory**，即可開啟或關閉[自動記憶](/docs/zh-TW/memory#auto-memory)。開啟期間，您也可以瀏覽 Claude 已儲存的記憶，並在檔案管理員中顯示存放這些記憶的資料夾。需要 Claude Code v2.1.274 或更新版本。

140 159 

141 若要改為建立自訂樣式，請從 **Output styles** 選單中選擇 **Build a custom style**。Claude Code 會在專案或使用者等級為您寫入[樣式檔案](/docs/zh-TW/output-styles#create-a-custom-output-style)。需要 Claude Code v2.1.261 或更新版本。160 點擊已儲存的記憶即可在對話方塊中閱讀，您可以在其中編輯文字、刪除記憶，或在編輯器中開啟其檔案。在對話方塊中檢視、編輯和刪除記憶需要 Claude Code v2.1.275 或更新版本。

142 * 在 Customize 部分中選擇 **Hooks** 以檢視在工作階段中載入的 [hooks](/docs/zh-TW/hooks)，按事件分組。您可以新增、編輯或移除儲存在您的使用者、專案和本機設定檔中的 hooks。來自其他來源（例如受管設定或外掛）的 Hooks 是唯讀的。需要 Claude Code v2.1.269 或更新版本。161 * 在 Customize 區段中選取 **Instructions**，即可編輯 Claude 讀取的 [CLAUDE.md 檔案](/docs/zh-TW/memory#claude-md-files)。選取檔案即可在編輯器中開啟。如果檔案尚不存在，Claude Code 會先建立它。需要 Claude Code v2.1.274 或更新版本。

143 * 在 Customize 部分中選擇 **Permissions** 以檢視工作階段的[權限規則](/docs/zh-TW/permissions)，分組為 Allow、Ask 和 Deny。您可以將規則新增到您的使用者、專案或本機設定，並移除儲存在那裡的規則。來自其他來源（例如受管設定或僅針對此工作階段進行的批准）的規則是唯讀的。需要 Claude Code v2.1.269 或更新版本。162 * 在 Customize 區段中選取 **Status**，或輸入 `/status`，即可查看工作階段的 Claude Code 版本、帳戶、模型和 MCP 伺服器詳細資訊。需要 Claude Code v2.1.280 或更新版本。

144 * 在 Customize 部分中選擇 **Memory** 以開啟或關閉[自動記憶](/docs/zh-TW/memory#auto-memory)。開啟時，您也可以瀏覽 Claude 已儲存的記憶，並在檔案管理員中顯示儲存它們的資料夾。需要 Claude Code v2.1.274 或更新版本。163 * 在 Customize 區段中選取 **Sandbox**，或輸入 `/sandbox`，即可查看 Claude 的 Bash 命令是否在[沙箱](/docs/zh-TW/sandboxing)中執行。您可以在其中切換沙箱模式並新增[排除的命令](/docs/zh-TW/settings-reference#sandbox-excludedcommands)。需要 Claude Code v2.1.280 或更新版本。

164 * 在 Customize 區段中選取 **Claude in Chrome**，或輸入 `/chrome`，即可檢查和管理 [Claude in Chrome](/docs/zh-TW/chrome) 連線。兩者都需要使用 claude.ai 帳戶登入。需要 Claude Code v2.1.280 或更新版本。

165 * 在 Context 區段中選取 **Export conversation**，或輸入 `/export`，即可將對話複製為純文字或儲存至檔案。加上檔案名稱（例如 `/export notes.txt`）即可略過對話方塊，並選擇檔案的儲存位置。需要 Claude Code v2.1.280 或更新版本。

166 * Settings 區段包含 **Enable Remote Control for all sessions**，它會設定 [`remoteControlAtStartup`](/docs/zh-TW/settings-reference#remotecontrolatstartup)，以控制[新的互動式工作階段是否自動連線至 Remote Control](/docs/zh-TW/remote-control#enable-remote-control-for-all-sessions)。需要 Claude Code v2.1.203 或更新版本。

145 167 

146 點擊已儲存的記憶以在對話方塊中讀取它，您可以在其中編輯文字、刪除記憶或在編輯器中開啟其檔案。在對話方塊中檢視、編輯和刪除記憶需要 Claude Code v2.1.275 或更新版本。168 當您在 VS Code 視窗中開啟或關閉此切換時，變更不僅限於之後啟動的工作階段，也會套用至該 VS Code 視窗中已開啟的工作階段。如果您將其關閉，已開啟的工作階段會中斷連線。在 Claude Code v2.1.261 或更新版本中，變更也會套用至您其他 VS Code 視窗中開啟的工作階段。

147 * 在 Customize 部分中選擇 **Instructions** 以編輯 Claude 讀取的 [CLAUDE.md 檔案](/docs/zh-TW/memory#claude-md-files)。選擇一個檔案以在編輯器中開啟它。如果檔案尚不存在，Claude Code 會先建立它。需要 Claude Code v2.1.274 或更新版本。169 * Settings 區段也包含 **Focus view**，它會將工具呼叫、工具結果和思考內容隱藏在可展開的列中，只留下您的提示詞和 Claude 的回應。您可以在該處切換，或使用 `Ctrl+Option+F`（Mac）/ `Ctrl+Alt+F`（Windows/Linux），或從命令選擇區使用 **Claude Code: Toggle Focus view**。此變更會套用至每個開啟的工作階段，並在工作階段之間保留。需要 Claude Code v2.1.221 或更新版本。

148 * 在 Customize 部分中選擇 **Status**，或輸入 `/status`，以檢查工作階段的 Claude Code 版本、帳戶、模型和 MCP 伺服器詳細資訊。需要 Claude Code v2.1.280 或更新版本。

149 * 在 Customize 部分中選擇 **Sandbox**，或輸入 `/sandbox`，以查看 Claude 的 Bash 命令是否執行[沙箱化](/docs/zh-TW/sandboxing)。您可以在那裡切換沙箱模式並新增[排除的命令](/docs/zh-TW/settings-reference#sandbox-excludedcommands)。需要 Claude Code v2.1.280 或更新版本。

150 * 在 Customize 部分中選擇 **Claude in Chrome**，或輸入 `/chrome`，以檢查和管理 [Claude in Chrome](/docs/zh-TW/chrome) 連線。兩者都需要使用 claude.ai 帳戶登入。需要 Claude Code v2.1.280 或更新版本。

151 * 在 Context 部分中選擇 **Export conversation**，或輸入 `/export`，以將對話複製為純文字或儲存到檔案。新增檔案名稱，例如 `/export notes.txt`，以跳過對話方塊並選擇儲存檔案的位置。需要 Claude Code v2.1.280 或更新版本。

152 * Settings 部分包括 **Enable Remote Control for all sessions**，它設定 [`remoteControlAtStartup`](/docs/zh-TW/settings-reference#remotecontrolatstartup) 以控制[新的互動工作階段是否自動連線到 Remote Control](/docs/zh-TW/remote-control#enable-remote-control-for-all-sessions)。需要 Claude Code v2.1.203 或更新版本。

153 170 

154 當您在 VS Code 視窗中開啟或關閉切換時，變更會套用到該 VS Code 視窗中已開啟的工作階段，而不僅僅是您之後啟動的工作階段。如果您關閉它，開啟的工作階段會斷開連線。使用 Claude Code v2.1.261 或更新版本時，變更也會到達您其他 VS Code 視窗中開啟的工作階段。171 Claude 最新的待辦事項清單會保持可見，Claude 待回覆問題所詢問的文字也會保持可見；這需要 Claude Code v2.1.225 或更新版本。當 Claude 執行 [subagent](/docs/zh-TW/sub-agents) 時，顯示其最新活動的即時進度列會出現在啟動它們的工具呼叫群組下方。這需要 Claude Code v2.1.269 或更新版本。

155 * Settings 部分也包括 **Focus view**，它隱藏工具呼叫、工具結果和思考在可展開的列後面，只留下您的提示和 Claude 的回應。在那裡切換它，使用 `Ctrl+Option+F`（Mac）/ `Ctrl+Alt+F`（Windows/Linux），或從命令選板使用 **Claude Code: Toggle Focus view**。變更會套用到每個開啟的工作階段並在工作階段之間保持。需要 Claude Code v2.1.221 或更新版本。172 * 若要登出您的 Anthropic 帳戶，請在 Settings 區段中選取 **Sign out**，或輸入 `/logout`。在[第三方供應商](#use-third-party-providers)上，選單不會提供任何一種方式。需要 Claude Code v2.1.277 或更新版本。

173 * 若要回報錯誤，請點擊選單底部的 **Report a problem**，或輸入 `/bug` 或 `/feedback`，並可選擇性附上描述以預先填入回報內容。當您提交回報且已透過第一方連線登入 Anthropic 時，Claude Code 會將其傳送給 Anthropic。需要 Claude Code v2.1.229 或更新版本。

156 174 

157 Claude 的最新待辦事項清單保持可見，待處理問題中 Claude 詢問的文字也是如此；這需要 Claude Code v2.1.225 或更新版本。當 Claude 執行[子代理](/docs/zh-TW/sub-agents)時，帶有其最新活動的即時進度列會出現在啟動它們的工具呼叫群組下方。這需要 Claude Code v2.1.269 或更新版本。175 在第三方供應商上，或沒有 Anthropic 憑證時，不會傳送任何內容。對話方塊會在您撰寫之前說明這一點。提交後會將回報儲存為[位於 `~/.claude/feedback-bundles/` 下的本機封存檔](/docs/zh-TW/data-usage#telemetry-services)，並遮蔽已知的 API 金鑰和 token 模式。將回報儲存在您的電腦上需要 Claude Code v2.1.284 或更新版本。

158 * 若要登出您的 Anthropic 帳戶，請在 Settings 部分中選擇 **Sign out**，或輸入 `/logout`。在[第三方提供者](#use-third-party-providers)上，選單不提供任何一個。需要 Claude Code v2.1.277 或更新版本。

159 * 若要報告錯誤，請點擊選單底部的 **Report a problem**，或輸入 `/bug` 或 `/feedback` 搭配可選的描述以預填報告。當您提交報告且您在第一方連線上登入 Anthropic 時，Claude Code 會將其傳送給 Anthropic。需要 Claude Code v2.1.229 或更新版本。

160 176 

161 在第三方提供者上，或沒有 Anthropic 認證時，不會傳送任何內容。對話方塊會在您寫入前說明這一點。提交會將報告儲存為[本機存檔在 `~/.claude/feedback-bundles/`](/docs/zh-TW/data-usage#telemetry-services)，已知的 API 金鑰和權杖模式已編輯。將該檔案傳送給您的 Anthropic 帳戶代表或將其附加到支援請求。確認會命名檔案並包括 **Show folder** 按鈕。在您的電腦上儲存報告需要 Claude Code v2.1.284 或更新版本。177 回報儲存後，確認訊息會列出檔案名稱，並包含 **Show folder** 按鈕。請將該檔案傳送給您的 Anthropic 客戶代表，或附加至支援請求中。

162 178 

163 如果您的組織的原則關閉產品回饋，**Report a problem** 不會出現在選單中，`/bug` 和 `/feedback` 會顯示 `Feedback is turned off by your organization's policy or this environment's settings.` 通知，而不是開啟報告。使用 Claude Code v2.1.284 或更新版本時，如果您設定 `DISABLE_FEEDBACK_COMMAND` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 環境變數，回饋也會關閉，開啟報告會顯示該通知。179 如果您組織的政策關閉了產品意見回饋，**Report a problem** 不會出現在選單中，而 `/bug` 和 `/feedback` 會顯示 `Feedback is turned off by your organization's policy or this environment's settings.` 通知，而不是開啟回報。在 Claude Code v2.1.284 或更新版本中，如果您設定了 `DISABLE_FEEDBACK_COMMAND` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 環境變數，意見回饋也會被關閉，開啟回報時會改為顯示該通知。

164* **Side questions**：輸入 `/btw` 後跟一個問題以詢問有關您的工作階段的問題[而不新增到對話](/docs/zh-TW/interactive-mode#side-questions-with-%2Fbtw)。答案會在聊天旁邊的面板中開啟，您可以在其中提出後續問題。執行緒在視窗重新載入後保持。Claude Code 保留最新的 20 個交換，並根據 [`cleanupPeriodDays`](/docs/zh-TW/settings-reference#cleanupperioddays) 排程過期儲存的執行緒，只要 Claude Code 可以[安全地確定保留期](/docs/zh-TW/claude-directory#cleaned-up-automatically)。若要清除執行緒，請點擊面板中的垃圾桶圖示。需要 Claude Code v2.1.227 或更新版本。180* **旁支問題**：輸入 `/btw` 後接問題，即可詢問有關工作階段的問題，[而不會加入對話中](/docs/zh-TW/interactive-mode#side-questions-with-%2Fbtw)。答案會在聊天旁的面板中開啟，您可以在其中提出後續問題。需要 Claude Code v2.1.227 或更新版本。

165* **Copy a response**：將滑鼠懸停在回應上並點擊 **Copy response** 以將其複製到您的剪貼簿，或輸入 `/copy` 以複製最新的回應。`/copy 2` 複製倒數第二個。需要 Claude Code v2.1.277 或更新版本。

166* **Bookmarks**：將滑鼠懸停在回應上並點擊 **Bookmark response** 以儲存它，或在已儲存的回應上點擊 **Remove bookmark** 以移除它。

167 181 

168 若要檢閱已儲存的回應，請開啟 Bookmarks 面板：點擊 Claude Code 面板頂部的書籤圖示、在命令選單的 Context 部分中選擇 **Bookmarks**，或輸入 `/bookmarks`。需要 Claude Code v2.1.286 或更新版本。182 此討論串在視窗重新載入後仍會保留。Claude Code 會保留最新的 20 次交流，並依照 [`cleanupPeriodDays`](/docs/zh-TW/settings-reference#cleanupperioddays) 排程讓已儲存的討論串過期，前提是 Claude Code 能夠[安全地判斷保留期限](/docs/zh-TW/claude-directory#cleaned-up-automatically)。若要清除討論串，請點擊面板中的垃圾桶圖示。

169* **Files Claude sends you**：當工作階段連線到 [Remote Control](/docs/zh-TW/remote-control#start-a-remote-control-session) 且 Claude 使用 [`SendUserFile` 工具](/docs/zh-TW/tools-reference)傳送檔案給您時，對話會顯示一列，例如 **Sent report.md, chart.png**。點擊檔案名稱以在編輯器中開啟它。183* **複製回應**：將滑鼠懸停在回應上並點擊 **Copy response** 即可將其複製到剪貼簿，或輸入 `/copy` 以複製最新的回應。`/copy 2` 會複製倒數第二個回應。需要 Claude Code v2.1.277 或更新版本。

170* **Context indicator**：提示框顯示您使用了多少 Claude 的內容視窗。Claude 會在需要時自動壓縮，或您可以手動執行 `/compact`。184* **書籤**：將滑鼠懸停在回應上並點擊 **Bookmark response** 即可儲存，或在已儲存的回應上點擊 **Remove bookmark** 以移除。

171* **Prompt cache clock**：內容指示器旁邊的時鐘圖示估計對話的[提示快取](/docs/zh-TW/prompt-caching)在過期前還剩多少時間。它從快取的五分鐘或一小時[生命週期](/docs/zh-TW/prompt-caching#cache-lifetime)倒數，每個使用快取的回應都會重新啟動倒數。除了壓縮外，[使快取失效的操作](/docs/zh-TW/prompt-caching#actions-that-invalidate-the-cache)不會重設時鐘，因此在您切換模型後它仍可以顯示剩餘的分鐘數。

172 * 在倒數結束前，圖示會顯示剩餘的分鐘數，例如 **12m**。

173 * 當倒數結束時，分鐘數消失，圖示變為紅色，或您主題的錯誤顏色，直到下一個回應。快取可能已過期，因此在快取重建時，預期您的下一條訊息會有更慢、更昂貴的回應。如果五分鐘的生命週期在您的訊息之間持續用完，請參閱[自己選擇 TTL](/docs/zh-TW/prompt-caching#choose-the-ttl-yourself)。

174 * 在對話[壓縮](/docs/zh-TW/prompt-caching#compacting-the-conversation)後，圖示也會變為紅色，沒有分鐘數直到下一個回應，因為快取還不涵蓋壓縮的對話。

175* **Agent map**：當對話包括[子代理](/docs/zh-TW/sub-agents)時，代理計數（例如 **2 agents**）會出現在提示框的底部。其點顯示任何子代理是否正在工作或等待您的權限。

176 185 

177 點擊代理計數以開啟代理地圖，它將對話的子代理繪製為主代理下的樹，每個都有其狀態、經過的時間和權杖計數。點擊子代理以查看其提示和工具呼叫、開啟其唯讀文字記錄或在其執行時停止它。需要 Claude Code v2.1.269 或更新版本。186 若要檢閱已儲存的回應，請開啟 Bookmarks 面板。您可以點擊 Claude Code 面板頂部的書籤圖示、在命令選單的 Context 區段中選取 **Bookmarks**，或輸入 `/bookmarks`。需要 Claude Code v2.1.286 或更新版本。

187* **Claude 傳送給您的檔案**：當工作階段連線至 [Remote Control](/docs/zh-TW/remote-control#start-a-remote-control-session)，且 Claude 使用 [`SendUserFile` 工具](/docs/zh-TW/tools-reference)傳送檔案給您時，對話中會顯示一列，例如 **Sent report.md, chart.png**。點擊檔案名稱即可在編輯器中開啟。

188* **上下文指示器**：提示詞輸入框會顯示您已使用了多少 Claude 的上下文視窗。Claude 會在需要時自動壓縮，您也可以手動執行 `/compact`。

189* **提示快取時鐘**：上下文指示器旁的時鐘圖示會估算對話的[提示快取](/docs/zh-TW/prompt-caching)在過期前還剩多少時間。它會從快取的五分鐘或一小時[存留期](/docs/zh-TW/prompt-caching#cache-lifetime)開始倒數，而每個使用快取的回應都會重新開始倒數。除了壓縮之外，[使快取失效的動作](/docs/zh-TW/prompt-caching#actions-that-invalidate-the-cache)不會重設時鐘，因此在您切換模型後，它仍可能顯示剩餘的分鐘數。

190 * 在倒數結束之前，圖示會顯示剩餘的分鐘數，例如 **12m**。

191 * 倒數結束時，分鐘數會消失，圖示會變成紅色（或您佈景主題的錯誤色彩），直到下一個回應為止。快取很可能已過期，因此在快取重建期間，您下一則訊息的回應可能會較慢且成本較高。如果五分鐘的存留期在您的訊息之間不斷用盡，請參閱[自行選擇 TTL](/docs/zh-TW/prompt-caching#choose-the-ttl-yourself)。

192 * 在對話剛[壓縮](/docs/zh-TW/prompt-caching#compacting-the-conversation)後，圖示也會變成紅色且不顯示分鐘數，直到下一個回應為止，因為快取尚未涵蓋壓縮後的對話。

193* **Agent 地圖**：當對話包含 [subagent](/docs/zh-TW/sub-agents) 時，提示詞輸入框底部會出現 agent 計數，例如 **2 agents**。其圓點會顯示是否有任何 subagent 正在工作或正在等待您的權限。

178 194 

179 地圖也列出工作階段的其他[背景任務](/docs/zh-TW/tools-reference#background-commands)，例如背景 shell 命令和[監視器](/docs/zh-TW/tools-reference#monitor-tool)，在代理下方。點擊一列以開啟任務的卡片並在那裡停止它。195 點擊 agent 計數即可開啟 agent 地圖，它會將對話的 subagent 繪製成位於主 agent 下方的樹狀結構，每個都附有其狀態、經過時間和 token 數。點擊 subagent 即可查看其提示詞和工具呼叫、開啟其唯讀逐字稿，或在其執行時將其停止。需要 Claude Code v2.1.269 或更新版本。