SpyBara
Go Premium

Documentation 2026-06-22 23:59 UTC to 2026-06-23 22:00 UTC

44 files changed +2,106 −106. View all changes and history on the product overview
2026
Tue 30 23:02 Mon 29 23:02 Sat 27 01:01 Fri 26 23:00 Thu 25 23:58 Wed 24 22:02 Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51
Details

86`settingSources` 涵蓋使用者、專案和本機設定。無論其值如何,都會讀取一些輸入:86`settingSources` 涵蓋使用者、專案和本機設定。無論其值如何,都會讀取一些輸入:

87 87 

88| 輸入 | 行為 | 停用方式 |88| 輸入 | 行為 | 停用方式 |

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

90| 受管原則設定 | 主機上存在時始終載入 | 移除受管設定檔 |90| 受管原則設定 | 主機上存在時始終載入 | 移除受管設定檔 |

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

92| `~/.claude/projects/<project>/memory/` 的自動記憶體 | 預設載入到系統提示中 | 在設定中設定 `autoMemoryEnabled: false`,或在 `env` 中設定 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` |92| `~/.claude/projects/<project>/memory/` 的自動記憶體 | 預設載入到系統提示中 | 在設定中設定 `autoMemoryEnabled: false`,或在 `env` 中設定 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` |

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

94 94 

95<Warning>95<Warning>

96 不要依賴預設 `query()` 選項進行多租戶隔離。因為上述輸入無論 `settingSources` 如何都會被讀取,SDK 程序可能會拾取主機層級設定和每個目錄的記憶體。對於多租戶部署,在其自己的檔案系統中執行每個租戶,並設定 `settingSources: []` 加上在 `env` 中設定 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`。請參閱 [安全部署](/zh-TW/agent-sdk/secure-deployment)。96 不要依賴預設 `query()` 選項進行多租戶隔離。因為上述輸入無論 `settingSources` 如何都會被讀取,SDK 程序可能會拾取主機層級設定和每個目錄的記憶體。對於多租戶部署,在其自己的檔案系統中執行每個租戶,並設定 `settingSources: []` 加上在 `env` 中設定 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`。請參閱 [安全部署](/zh-TW/agent-sdk/secure-deployment)。

Details

958```958```

959 959 

960* `API_TIMEOUT_MS`:Anthropic 客戶端上的每個請求逾時,以毫秒為單位。預設 `600000`。適用於主迴圈和所有子代理。960* `API_TIMEOUT_MS`:Anthropic 客戶端上的每個請求逾時,以毫秒為單位。預設 `600000`。適用於主迴圈和所有子代理。

961* `CLAUDE_CODE_MAX_RETRIES`:最大 API 重試次數。預設 `10`。每次重試都有自己的 `API_TIMEOUT_MS` 視窗,因此最壞情況下的牆時間大約是 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` 加上退避。961* `CLAUDE_CODE_MAX_RETRIES`:最大 API 重試次數。預設 `10`,上限為 `15`。每次重試都有自己的 `API_TIMEOUT_MS` 視窗,因此最壞情況下的牆時間大約是 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` 加上退避。對於需要等待更長中斷的無人值守執行,設定 `CLAUDE_CODE_RETRY_WATCHDOG=1` 以無限期重試容量錯誤。

962* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`:使用 `run_in_background` 啟動的子代理的停滯監視程式。預設 `600000`。在每個串流事件上重置;停滯時中止子代理,將任務標記為失敗,並將錯誤呈現給父代理,包含任何部分結果。不適用於同步子代理。962* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`:使用 `run_in_background` 啟動的子代理的停滯監視程式。預設 `600000`。在每個串流事件上重置;停滯時中止子代理,將任務標記為失敗,並將錯誤呈現給父代理,包含任何部分結果。不適用於同步子代理。

963* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` 搭配 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`:當標頭已到達但回應本體停止串流時中止請求。當 `CLAUDE_ENABLE_STREAM_WATCHDOG` 未設定時,預設在直接 Anthropic API 上由伺服器控制,在其他提供者上關閉。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` 預設為 `300000` 並限制在該最小值。中止的請求會經過正常重試路徑。963* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` 搭配 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`:當標頭已到達但回應本體停止串流時中止請求。當 `CLAUDE_ENABLE_STREAM_WATCHDOG` 未設定時,預設在直接 Anthropic API 上由伺服器控制,在其他提供者上關閉。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` 預設為 `300000` 並限制在該最小值。中止的請求會經過正常重試路徑。

964 964 

Details

196在 Python SDK 中,這些欄位名稱使用 camelCase 以匹配線路格式。有關詳細信息,請參閱 [`AgentDefinition` 參考](/zh-TW/agent-sdk/python#agentdefinition)。196在 Python SDK 中,這些欄位名稱使用 camelCase 以匹配線路格式。有關詳細信息,請參閱 [`AgentDefinition` 參考](/zh-TW/agent-sdk/python#agentdefinition)。

197 197 

198<Note>198<Note>

199 {/* min-version: 2.1.172 */}自 Claude Code v2.1.172 起,子代理可以生成自己的子代理。位於主代理下方五個級別的背景子代理無法生成進一步的子代理;前景子代理可以在任何深度生成。若要防止子代理生成其他子代理,請從其 `tools` 陣列中省略 `Agent` 或將其添加到 `disallowedTools`。有關完整的深度規則,請參閱[嵌套子代理](/zh-TW/sub-agents#spawn-nested-subagents)。199 {/* min-version: 2.1.172 */}自 Claude Code v2.1.172 起,子代理可以生成自己的子代理。位於主代理下方五個級別的子代理無法生成進一步的子代理,無論其是否在前景或背景中運行。若要防止子代理生成其他子代理,請從其 `tools` 陣列中省略 `Agent` 或將其添加到 `disallowedTools`。有關完整的深度規則,請參閱[嵌套子代理](/zh-TW/sub-agents#spawn-nested-subagents)。

200</Note>200</Note>

201 201 

202<h3 id="filesystem-based-definition-alternative">202<h3 id="filesystem-based-definition-alternative">

Details

551```551```

552 552 

553* `API_TIMEOUT_MS`:Anthropic 客戶端上的每個請求超時,以毫秒為單位。默認 `600000`。適用於主循環和所有子代理。553* `API_TIMEOUT_MS`:Anthropic 客戶端上的每個請求超時,以毫秒為單位。默認 `600000`。適用於主循環和所有子代理。

554* `CLAUDE_CODE_MAX_RETRIES`:最大 API 重試次數。默認 `10`。每次重試都有自己的 `API_TIMEOUT_MS` 窗口,因此最壞情況下的牆時間大約是 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` 加上退避。554* `CLAUDE_CODE_MAX_RETRIES`:最大 API 重試次數。默認 `10`,上限為 `15`。每次重試都有自己的 `API_TIMEOUT_MS` 窗口,因此最壞情況下的牆時間大約是 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` 加上退避。對於需要等待更長時間中斷的無人值守運行,設置 `CLAUDE_CODE_RETRY_WATCHDOG=1` 以無限期重試容量錯誤。

555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`:使用 `run_in_background` 啟動的子代理的停滯監視程序。默認 `600000`。在每個流事件上重置;在停滯時中止子代理,將任務標記為失敗,並將錯誤與任何部分結果一起呈現給父代理。不適用於同步子代理。555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`:使用 `run_in_background` 啟動的子代理的停滯監視程序。默認 `600000`。在每個流事件上重置;在停滯時中止子代理,將任務標記為失敗,並將錯誤與任何部分結果一起呈現給父代理。不適用於同步子代理。

556* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` 與 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`:當標頭已到達但響應正文停止流式傳輸時中止請求。當 `CLAUDE_ENABLE_STREAM_WATCHDOG` 未設置時,默認值在直接 Anthropic API 上由服務器控制,在其他提供商上關閉。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` 默認為 `300000` 並被限制為該最小值。中止的請求通過正常重試路徑進行。556* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` 與 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`:當標頭已到達但響應正文停止流式傳輸時中止請求。當 `CLAUDE_ENABLE_STREAM_WATCHDOG` 未設置時,默認值在直接 Anthropic API 上由服務器控制,在其他提供商上關閉。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` 默認為 `300000` 並被限制為該最小值。中止的請求通過正常重試路徑進行。

557 557 


1418```1418```

1419 1419 

1420| `kind` | 含義 |1420| `kind` | 含義 |

1421| ------------------- | -------------------------------------------------------------------------------------------------------------------------------- |1421| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

1422| `human` | 來自最終用戶的直接輸入。在用戶消息上,缺少的 `origin` 也表示人類輸入。 |1422| `human` | 來自最終用戶的直接輸入。在用戶消息上,缺少的 `origin` 也表示人類輸入。 |

1423| `channel` | 在[頻道](/zh-TW/channels)上到達的消息。`server` 是源 MCP 伺服器名稱。 |1423| `channel` | 在[頻道](/zh-TW/channels)上到達的消息。`server` 是源 MCP 伺服器名稱。 |

1424| `peer` | 保留用於來自另一個代理會話的消息。`from` 是發送者地址,`name` 是發送者的顯示名稱(如果可用)。`senderTaskId` 是發送消息的進程內背景子代理的任務 ID;對於跨會話對等體不存在Agent SDK 不發出此來源;將其視為未知來源。 |1424| `peer` | 來自另一個代理的消息對於通過 `SendMessage` 發送到 `main` 的進程內[隊友](/zh-TW/agent-teams),`from` 是隊友的名稱,`senderTaskId` 是其任務 ID。對於跨會話對等體(例如另一個本地 Claude Code 進程),`from` 是發送者地址,`senderTaskId` 不存在`name` 字段已保留。 |

1425| `task-notification` | 後台任務完成後注入的合成轉數。請參閱 [`SDKTaskNotificationMessage`](#sdktasknotificationmessage)。 |1425| `task-notification` | 後台任務完成後注入的合成轉數。請參閱 [`SDKTaskNotificationMessage`](#sdktasknotificationmessage)。 |

1426| `coordinator` | 來自[代理團隊](/zh-TW/agent-teams)中的團隊協調員的消息。 |1426| `coordinator` | 來自[代理團隊](/zh-TW/agent-teams)中的團隊協調員的消息。 |

1427| `auto-continuation` | 當會話在沒有新用戶輸入的情況下繼續時注入的合成轉數,例如觸發後續提示的命令結果。 |1427| `auto-continuation` | 當會話在沒有新用戶輸入的情況下繼續時注入的合成轉數,例如觸發後續提示的命令結果。 |


3654 status: "allowed" | "allowed_warning" | "rejected";3654 status: "allowed" | "allowed_warning" | "rejected";

3655 resetsAt?: number;3655 resetsAt?: number;

3656 utilization?: number;3656 utilization?: number;

3657 errorCode?: "credits_required";

3658 canUserPurchaseCredits?: boolean;

3659 hasChargeableSavedPaymentMethod?: boolean;

3657 };3660 };

3658 uuid: UUID;3661 uuid: UUID;

3659 session_id: string;3662 session_id: string;

3660};3663};

3661```3664```

3662 3665 

3666{/* min-version: 2.1.181 */}當 `errorCode` 為 `"credits_required"` 時,拒絕來自 claude.ai 訂閱,其包含的使用量已耗盡,會話無法繼續,直到用戶購買使用額度。`canUserPurchaseCredits` 指示經過身份驗證的用戶是否可以為帳戶購買額度,`hasChargeableSavedPaymentMethod` 指示是否有保存的付款方式。這三個字段在非信用額度必需拒絕的速率限制事件上不存在。需要 Claude Code v2.1.181 或更高版本。

3667 

3663<h3 id="sdklocalcommandoutputmessage">3668<h3 id="sdklocalcommandoutputmessage">

3664 `SDKLocalCommandOutputMessage`3669 `SDKLocalCommandOutputMessage`

3665</h3>3670</h3>

agent-teams.md +21 −10

Details

90 90 

91從那裡,Claude 會建立一個[共享任務列表](/zh-TW/interactive-mode#task-list),為每個觀點生成隊友,讓他們探索問題,並在完成時綜合發現。91從那裡,Claude 會建立一個[共享任務列表](/zh-TW/interactive-mode#task-list),為每個觀點生成隊友,讓他們探索問題,並在完成時綜合發現。

92 92 

93主管的終端列出所有隊友及其正在進行的工作。使用 Shift+Down 循環瀏覽隊友並直接向他們傳送訊息。在最後一個隊友之後,Shift+Down 會回到主管93主管的終端在提示輸入下方的 agent 面板中列出隊友從面板中:

94 

95* **向上和向下箭頭**:選擇隊友

96* **Enter**:開啟所選隊友的記錄並直接向其傳送訊息

97* **Escape**:中斷所選隊友的目前回合

98 

99{/* min-version: 2.1.181 */}自 v2.1.181 起,閒置隊友的列在 30 秒後會隱藏,並在其下一個回合時重新出現。隊友在隱藏時仍保持執行狀態且可定址。

94 100 

95如果您希望每個隊友都在自己的分割窗格中,請參閱[選擇顯示模式](#choose-a-display-mode)。101如果您希望每個隊友都在自己的分割窗格中,請參閱[選擇顯示模式](#choose-a-display-mode)。

96 102 


106 112 

107Agent teams 支援兩種顯示模式:113Agent teams 支援兩種顯示模式:

108 114 

109* **In-process**:所有隊友在您的主終端內運行。使用 Shift+Down 循環瀏覽隊友並輸入以直接向他們傳送訊息。在任何終端中工作,無需額外設定。115* **In-process**:所有隊友在您的主終端內運行。使用上下箭頭鍵在 agent 面板中選擇隊友,然後按 Enter 鍵查看它並輸入以直接向它傳送訊息。在任何終端中工作,無需額外設定。

110* **Split panes**:每個隊友都有自己的窗格。您可以同時看到所有人的輸出並點擊窗格直接互動。需要 tmux 或 iTerm2。116* **Split panes**:每個隊友都有自己的窗格。您可以同時看到所有人的輸出並點擊窗格直接互動。需要 tmux 或 iTerm2。

111 117 

112<Note>118<Note>

113 `tmux` 在某些作業系統上有已知限制,傳統上在 macOS 上效果最佳。在 iTerm2 中使用 `tmux -CC` 是進入 `tmux` 的建議入口點。119 `tmux` 在某些作業系統上有已知限制,傳統上在 macOS 上效果最佳。在 iTerm2 中使用 `tmux -CC` 是進入 `tmux` 的建議入口點。

114</Note>120</Note>

115 121 

116預設值是 `"auto"`,如果您已在 tmux 工作階段內運行或您的終端是 iTerm2,則使用分割窗格否則使用 in-process。`"tmux"` 設定啟用分割窗格模式,並根據您的終端自動偵測是否使用 tmux 或 iTerm2。若要覆蓋,請在 `~/.claude/settings.json` 中設定 [`teammateMode`](/zh-TW/settings#available-settings):122預設值是 `"in-process"`。在 v2.1.179 之前,預設值是 `"auto"`,因此升級的工作階段如果之前開啟了分割窗格,現在會保持在一個終端中,除非您明確設定模式。設定 `"auto"` 以在您已在 tmux 工作階段內運行或您的終端是 iTerm2 時啟用分割窗格否則回退到 in-process。`"tmux"` 設定啟用分割窗格模式,並根據您的終端自動偵測是否使用 tmux 或 iTerm2。

123 

124{/* min-version: 2.1.186 */}自 v2.1.186 起,設定 `"iterm2"` 以明確使用 iTerm2 原生分割窗格。此模式需要 [`it2` CLI](https://github.com/mkusaka/it2),如果 `it2` 遺失,會顯示帶有安裝命令的錯誤。當您的終端是 iTerm2 且 tmux 可作為備用方案時,在 `"auto"` 或 `"tmux"` 下會出現提供安裝 `it2` 或切換到 tmux 的設定提示。

125 

126若要覆蓋預設值,請在 `~/.claude/settings.json` 中設定 [`teammateMode`](/zh-TW/settings#available-settings):

117 127 

118```json theme={null}128```json theme={null}

119{129{

120 "teammateMode": "in-process"130 "teammateMode": "auto"

121}131}

122```132```

123 133 

124若要為單個工作階段強制 in-process 模式,請將其作為旗標傳遞:134若要為單個工作階段設定模式,請將其作為旗標傳遞:

125 135 

126```bash theme={null}136```bash theme={null}

127claude --teammate-mode in-process137claude --teammate-mode auto

128```138```

129 139 

130分割窗格模式需要 [tmux](https://github.com/tmux/tmux/wiki) 或 iTerm2 搭配 [`it2` CLI](https://github.com/mkusaka/it2)。若要手動安裝:140分割窗格模式需要 [tmux](https://github.com/tmux/tmux/wiki) 或 iTerm2 搭配 [`it2` CLI](https://github.com/mkusaka/it2)。若要手動安裝:


166 176 

167每個隊友都是一個完整、獨立的 Claude Code 工作階段。您可以直接向任何隊友傳送訊息,以提供額外指示、提出後續問題或重新定向其方法。177每個隊友都是一個完整、獨立的 Claude Code 工作階段。您可以直接向任何隊友傳送訊息,以提供額外指示、提出後續問題或重新定向其方法。

168 178 

169* **In-process 模式**:使用 Shift+Down 循環瀏覽隊友然後輸入以向他們傳送訊息。按 Enter 查看隊友的工作階段,然後按 Escape 中斷其目前回合。按 Ctrl+T 切換任務列表。179* **In-process 模式**:使用上下箭頭鍵在 agent 面板中選擇隊友然後按 Enter 鍵查看其工作階段並輸入以傳送訊息。在選定的隊友上按 `x` 以停止它。按 Ctrl+T 切換任務列表。

170* **Split-pane 模式**:點擊隊友的窗格以直接與其工作階段互動。每個隊友都有自己終端的完整檢視。180* **Split-pane 模式**:點擊隊友的窗格以直接與其工作階段互動。每個隊友都有自己終端的完整檢視。

171 181 

172<h3 id="assign-and-claim-tasks">182<h3 id="assign-and-claim-tasks">


422 432 

423如果在您要求 Claude 建立隊友後隊友未出現:433如果在您要求 Claude 建立隊友後隊友未出現:

424 434 

425* 在 in-process 模式中,隊友可能已在運行但不可見 Shift+Down 循環瀏覽活躍隊友435* 在 in-process 模式中,隊友會出現在提示輸入下方的代理面板中使用上下箭頭鍵選擇一個,然後按 Enter 鍵查看它

426* 檢查您給 Claude 的任務是否足夠複雜以保證隊友Claude 根據任務決定是否生成隊友436* 閒置後消失的隊友列已被隱藏,而非停止。閒置列在 30 秒後隱藏,並在隊友的下一輪時重新出現按名稱向隊友發送訊息以將其恢復

437* 檢查您給 Claude 的任務是否足夠複雜以保證建立團隊。Claude 根據任務決定是否生成隊友。

427* 如果您明確要求分割窗格,請確保 tmux 已安裝並在您的 PATH 中可用:438* 如果您明確要求分割窗格,請確保 tmux 已安裝並在您的 PATH 中可用:

428 ```bash theme={null}439 ```bash theme={null}

429 which tmux440 which tmux


440 隊友在錯誤時停止451 隊友在錯誤時停止

441</h3>452</h3>

442 453 

443隊友可能在遇到錯誤後停止,而不是恢復。使用 in-process 模式中的 Shift+Down 或分割模式中的點擊窗格檢查其輸出,然後:454隊友可能在遇到錯誤後停止,而不是恢復。通過在 in-process 模式中選擇代理面板中的隊友並按 Enter 或在分割模式中點擊窗格來檢查其輸出,然後:

444 455 

445* 直接給他們額外的指示456* 直接給他們額外的指示

446* 生成替換隊友以繼續工作457* 生成替換隊友以繼續工作

agent-view.md +32 −3

Details

281| `#<number>` 或拉取請求 URL | 如果工作階段已在該 PR 上工作,選擇它而不是分派 |281| `#<number>` 或拉取請求 URL | 如果工作階段已在該 PR 上工作,選擇它而不是分派 |

282| `Shift+Enter` | 分派並立即附加到新工作階段 |282| `Shift+Enter` | 分派並立即附加到新工作階段 |

283 283 

284一小組命令在 agent view 本身中執行,而不是分派:`/exit` 和 `/quit` 關閉 agent view,`/logout` 將您登出。所有其他命令和 skill 都作為新背景工作階段的第一個提示發送284一小組命令在 agent view 本身中執行,而不是分派:`/exit` 和 `/quit` 關閉 agent view,`/logout` 將您登出,以及 `/model` 設定 [dispatch model](#set-the-model)Skills、您自己的命令和提示擴展內建命令(例如 `/init`)會作為新背景工作階段的第一個提示發送。其他內建命令會顯示 `attach to a session to run it` 提示

285 285 

286將重複任務打包為 [skill](/zh-TW/skills) 可讓您從 agent view 多次啟動相同的工作流程,無需重新輸入提示。286將重複任務打包為 [skill](/zh-TW/skills) 可讓您從 agent view 多次啟動相同的工作流程,無需重新輸入提示。

287 287 


412 412 

413agent view 標題中顯示的模型名稱是分派預設值。您從輸入啟動的新工作階段使用此模型,這來自您使用者設定中的 [`model` setting](/zh-TW/settings#available-settings)。通過在 [`/model` picker](/zh-TW/model-config) 中選擇模型來設定它,或直接編輯設定。要為整個 agent view 工作階段覆蓋它,請在開啟 agent view 時傳遞 `--model`。請參閱 [Permission mode, model, and effort](#permission-mode-model-and-effort)。413agent view 標題中顯示的模型名稱是分派預設值。您從輸入啟動的新工作階段使用此模型,這來自您使用者設定中的 [`model` setting](/zh-TW/settings#available-settings)。通過在 [`/model` picker](/zh-TW/model-config) 中選擇模型來設定它,或直接編輯設定。要為整個 agent view 工作階段覆蓋它,請在開啟 agent view 時傳遞 `--model`。請參閱 [Permission mode, model, and effort](#permission-mode-model-and-effort)。

414 414 

415要從 agent view 內部更改分派預設值,請在分派輸入中輸入 `/model` 後跟模型名稱,然後按 `Enter`。標題會更新以顯示該模型,並帶有 `(session)` 標記,之後您分派的工作階段會使用它。輸入 `/model default` 以清除覆蓋並返回分派預設值。此覆蓋會持續到當前 `claude agents` 執行的其餘部分,不會寫入您的設定檔案,並需要 Claude Code v2.1.172 或更新版本。以下示例在 Opus 上分派一個工作階段,在 Sonnet 上分派下一個:

416 

417```text theme={null}

418/model opus

419refactor auth

420/model sonnet

421run the test suite

422```

423 

415每個背景工作階段可以在不同的模型上執行。要為一個工作階段覆蓋它:424每個背景工作階段可以在不同的模型上執行。要為一個工作階段覆蓋它:

416 425 

417* 從 shell,使用 `claude --bg` 傳遞 `--model`。426* 從 shell,使用 `claude --bg` 傳遞 `--model`。


422 Permission mode, model, and effort431 Permission mode, model, and effort

423</h3>432</h3>

424 433 

425背景工作階段從它執行的目錄讀取其 [settings](/zh-TW/settings),就像您在那裡啟動了 `claude` 一樣。434背景工作階段從它執行的目錄讀取其 [settings](/zh-TW/settings),就像您在那裡啟動了 `claude` 一樣。這包括專案設定中的 [`env` values](/zh-TW/settings#available-settings),因此在那裡設定的 `ANTHROPIC_MODEL` 或提供者變數適用於該目錄中的背景工作階段。

435 

436雲提供者選擇,例如 `CLAUDE_CODE_USE_BEDROCK` 或 `CLAUDE_CODE_USE_VERTEX`,以及 `ANTHROPIC_DEFAULT_*_MODEL` 別名遵循分派工作階段的 shell。閘道端點變數,例如 `ANTHROPIC_BASE_URL` 及其配對的 `ANTHROPIC_AUTH_TOKEN` 則不遵循。請參閱 [the supervisor process](#the-supervisor-process) 以了解背景工作階段如何源自提供者設定和認證。

426 437 

427[permission mode](/zh-TW/permissions) 取決於您如何啟動工作階段。使用 `/bg` 或 `←` 背景化現有工作階段會保持當前權限模式,因此您切換到 `acceptEdits` 或 `auto` 的工作階段在分離後仍保持該模式。從 agent view 輸入分派或從 shell 執行 `claude --bg` 使用該目錄設定中的 `defaultMode`,或分派的 [subagent 的 frontmatter](/zh-TW/sub-agents#supported-frontmatter-fields) 中的 `permissionMode`。438[permission mode](/zh-TW/permissions) 取決於您如何啟動工作階段。使用 `/bg` 或 `←` 背景化現有工作階段會保持當前權限模式,因此您切換到 `acceptEdits` 或 `auto` 的工作階段在分離後仍保持該模式。從 agent view 輸入分派或從 shell 執行 `claude --bg` 使用該目錄設定中的 `defaultMode`,或分派的 [subagent 的 frontmatter](/zh-TW/sub-agents#supported-frontmatter-fields) 中的 `permissionMode`。

428 439 


508 519 

509背景工作階段由每個使用者的監督程序託管,與您的終端和 agent view 分開。監督程序在您第一次背景化工作階段或開啟 agent view 時自動啟動,您不直接管理它。520背景工作階段由每個使用者的監督程序託管,與您的終端和 agent view 分開。監督程序在您第一次背景化工作階段或開啟 agent view 時自動啟動,您不直接管理它。

510 521 

511監督程序及其工作階段使用與互動工作階段相同的認證進行身份驗證並且除了模型 API 外不進行額外的網路連接522監督程序保持一個預熱的工作程序就緒以便來自 agent view 或 `claude --bg` 的分派無需冷啟動的延遲即可開始當您分派時,監督程序將預熱的工作程序分配給您的工作階段,將該工作階段的目錄、設定和認證應用於它,然後為下一次分派啟動替代程序。如果沒有可用的健康預熱工作程序,監督程序會改為啟動新程序。

523 

524監督程序及其工作階段使用與互動工作階段相同的認證進行身份驗證,並且除了模型 API 外不進行額外的網路連接。提供者選擇變數(例如 `CLAUDE_CODE_USE_BEDROCK` 和 `ANTHROPIC_DEFAULT_*_MODEL` 別名)從分派每個工作階段的 shell 中讀取,並應用於其工作程序。

525 

526{/* min-version: 2.1.174 */}背景工作階段不會繼承閘道端點變數(例如 `ANTHROPIC_BASE_URL`、等效的 Bedrock、Vertex 和 Foundry 基礎 URL 變數,或配對的 `ANTHROPIC_AUTH_TOKEN`)來自啟動監督程序的 shell 或分派 shell。工作階段改用您的儲存認證和專案目錄的[設定](/zh-TW/settings)中 `env` 區塊中的任何 `env` 值。要在專案中指向背景工作階段到[LLM 閘道](/zh-TW/llm-gateway),請在該專案的 `.claude/settings.json` `env` 區塊中設定 `ANTHROPIC_BASE_URL`,而不是在您的 shell 中匯出它。在 v2.1.174 之前,背景工作階段從監督程序的啟動 shell 繼承這些變數,因此它可以使用您在該 shell 中配置的閘道,而不是為專案目錄配置的閘道。

512 527 

513每個背景工作階段都是其自己的 Claude Code 程序,由監督程序管理而不是與您的終端相關聯。正在主動工作、等待您的輸入或已連接終端的工作階段保持其程序執行。執行中的背景 shell 命令、子代理、動態工作流程或監視器計為主動工作,因此長時間執行的程序(例如開發伺服器)會保持工作階段活躍。528每個背景工作階段都是其自己的 Claude Code 程序,由監督程序管理而不是與您的終端相關聯。正在主動工作、等待您的輸入或已連接終端的工作階段保持其程序執行。執行中的背景 shell 命令、子代理、動態工作流程或監視器計為主動工作,因此長時間執行的程序(例如開發伺服器)會保持工作階段活躍。

514 529 


597 612 

598在 Windows 上,如果監督程序未回應停止請求,該命令會列印其程序 ID。使用 `taskkill /PID <pid>` 結束該程序以完成復原。當您傳遞 `--keep-workers` 時,背景工作階段仍會被保留。613在 Windows 上,如果監督程序未回應停止請求,該命令會列印其程序 ID。使用 `taskkill /PID <pid>` 結束該程序以完成復原。當您傳遞 `--keep-workers` 時,背景工作階段仍會被保留。

599 614 

615<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">

616 背景分派失敗,出現 `Could not resolve authentication method`

617</h3>

618 

619{/* min-version: 2.1.174 */}如果背景分派失敗,出現 `Could not resolve authentication method`,而互動式工作階段正常驗證,接收分派的背景工作程序未取得認證。在 v2.1.174 及更新版本上,監督程序在指派[預先準備的背景工作程序](#the-supervisor-process)時提供新的認證快照,因此此錯誤表示監督程序本身沒有可用的已儲存認證。確認您已執行 `/login` 或設定 API 金鑰,然後停止監督程序:

620 

621```bash theme={null}

622claude daemon stop --any --keep-workers

623```

624 

625下一個 `claude agents` 或 `claude --bg` 啟動新的監督程序,該程序會讀取您的已儲存認證。如果您使用環境變數(例如 `ANTHROPIC_API_KEY`)而不是 `/login` 進行驗證,請從設定該變數的 shell 執行下一個命令。

626 

627請參閱[錯誤參考](/zh-TW/errors#could-not-resolve-authentication-method)以取得完整的原因和修復清單。在 v2.1.174 之前,閒置的預先準備背景工作程序在被指派給分派時可能會出現此錯誤,即使您的認證有效。升級以復原。

628 

600<h3 id="background-sessions-cannot-read-desktop-documents-or-downloads-on-macos">629<h3 id="background-sessions-cannot-read-desktop-documents-or-downloads-on-macos">

601 背景工作階段無法在 macOS 上讀取 Desktop、Documents 或 Downloads630 背景工作階段無法在 macOS 上讀取 Desktop、Documents 或 Downloads

602</h3>631</h3>

Details

219}219}

220```220```

221 221 

222{/* min-version: 2.1.181 */}自 Claude Code v2.1.181 起,`aws configure export-credentials --format process` 的平面輸出也被接受,具有相同的金鑰在頂層而不是巢狀在 `Credentials` 下。

223 

222`Expiration` 是選用的。{/* min-version: 2.1.176 */}自 Claude Code v2.1.176 起,當命令傳回有效的 ISO 8601 `Expiration` 時,Claude Code 會快取認證直到該時間前五分鐘。沒有它,或在較早版本上,認證會快取一小時。224`Expiration` 是選用的。{/* min-version: 2.1.176 */}自 Claude Code v2.1.176 起,當命令傳回有效的 ISO 8601 `Expiration` 時,Claude Code 會快取認證直到該時間前五分鐘。沒有它,或在較早版本上,認證會快取一小時。

223 225 

224<h3 id="3-configure-claude-code">226<h3 id="3-configure-claude-code">

artifacts.md +270 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

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

6 

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

8 

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

10 

11<Note>

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

13</Note>

14 

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

16 

17<Frame>

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

19</Frame>

20 

21本頁涵蓋如何:

22 

23* 決定[何時使用成品](#when-to-use-an-artifact)

24* [建立](#create-an-artifact)、[更新](#update-an-artifact)和[分享](#share-an-artifact)成品

25* 應用[提示模式](#what-you-can-build)以獲得更豐富的頁面

26* [應用您自己的設計系統](#improve-the-visual-design),使成品與您產品的品牌相符

27* 了解[頁面限制](#page-constraints)和[可用性要求](#availability)

28* [停用](#disable-artifacts)或[為您的組織管理成品](#manage-artifacts-for-your-organization)

29 

30<h2 id="when-to-use-an-artifact">

31 何時使用成品

32</h2>

33 

34當終端文字不是 Claude 產生的內容的正確媒介時,請使用成品:輸出更容易查看和互動,而不是逐行閱讀。Claude 從您的工作階段可以到達的任何內容建立頁面,包括您的程式碼庫和它通過您的[連接工具](/zh-TW/mcp)提取的資料,因此頁面可以顯示需要段落才能描述的內容。例如,要求 Claude:

35 

36* 引導審查者查看帶有註解差異的拉取請求

37* 從工作階段已經提取的資料呈現儀表板

38* 並排排列多個設計或實現選項

39* 保持調查時間軸,在長任務執行時填入

40* 向隊友發送連結,而不是將輸出貼到 Slack

41 

42請參閱[您可以建立的內容](#what-you-can-build)以了解與每個內容相符的提示。

43 

44<h3 id="what-an-artifact-is-not">

45 成品不是什麼

46</h3>

47 

48成品是工作的捕捉,不是應用程式。它是一個自包含的頁面,沒有後端,因此無法儲存表單輸入、在檢視時呼叫 API 或提供多個路由。對於具有後端的託管內部工具,請改為在您自己的基礎設施上部署它。請參閱[頁面限制](#page-constraints)以了解完整的限制集合。

49 

50<h2 id="create-an-artifact">

51 建立成品

52</h2>

53 

54當輸出適合頁面時,Claude 可能會自動發佈成品,或者您可以直接要求一個。要要求,請用純語言命名功能或描述您想要的視覺輸出。任何比作為文字閱讀更容易看到的內容都是很好的候選,例如註解差異、圖表或一組要比較的選項。下面的提示是兩個示例;請參閱[您可以建立的內容](#what-you-can-build)以了解更多模式。

55 

56```text wrap theme={null}

57Make an artifact that walks through this PR with the diff annotated inline.

58```

59 

60```text wrap theme={null}

61Build a dashboard artifact of last week's deploy failures by service and keep it updated as you investigate.

62```

63 

64Claude 將頁面寫入您的專案中的 HTML 或 Markdown 檔案,然後發佈它。在發佈新成品之前,Claude Code 會要求許可;它可能會說類似 `Claude wants to publish "Deploy failures by service" (deploy-failures.html) to a private page on claude.ai` 的內容。重新發佈您已經批准的成品不會再次提示。

65 

66選擇**是**以發佈。Claude 列印 URL,您的瀏覽器會開啟到新頁面。隨時按 `Ctrl+]` 從終端重新開啟最近的成品。

67 

68Claude 為成品選擇標題和瀏覽器標籤圖示的表情符號。兩者都出現在您在 claude.ai 上的[成品庫](#share-an-artifact)和共享連結中,因此如果您想要特定的標題或圖示,請要求 Claude 使用一個。

69 

70要停止瀏覽器在發佈新成品時自動開啟,請在您的環境中設定 `CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0`。

71 

72如果 Claude 回應它無法發佈,或寫入沒有連結的本地 HTML 檔案,則該工具未為您的工作階段啟用。檢查[可用性](#availability)要求。

73 

74<h2 id="update-an-artifact">

75 更新成品

76</h2>

77 

78要求 Claude 修訂頁面,或讓長時間執行的任務在進行時重新發佈。Claude 編輯基礎檔案並重新發佈到相同的 URL。

79 

80```text wrap theme={null}

81Add a per-region breakdown below the summary chart and republish.

82```

83 

84任何開啟頁面的人都會看到就地更新。每次發佈都會成為一個版本,從頁面標題中的**分享**控制項,您可以選擇檢視者看到哪個版本。

85 

86要從不同的工作階段更新成品,請給 Claude 成品的 URL 並要求它修訂。沒有 URL,新工作階段總是建立新成品,而不是更新現有的。

87 

88```text wrap theme={null}

89Update https://claude.ai/code/artifact/5fbea6f3-... with today's numbers.

90```

91 

92<h2 id="share-an-artifact">

93 分享成品

94</h2>

95 

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

97 

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

99 

100成品是可檢視的,不是共同編輯的。您分享的人看到您發佈的每個版本,但無法更改頁面;您仍然是唯一的寫入者。

101 

102<h2 id="what-you-can-build">

103 您可以建立的內容

104</h2>

105 

106成品是單個 HTML 頁面,因此您可以用 HTML、CSS 和內聯 JavaScript 表達的任何內容都在範圍內。下面的模式最常出現。

107 

108<h3 id="walk-through-a-change">

109 逐步查看變更

110</h3>

111 

112要求一個頁面,在相關行旁邊呈現差異或設計變更並帶有註解,以便審查者可以在程式碼旁邊閱讀您的推理,而不是從描述中重建它。

113 

114```text wrap theme={null}

115Make an artifact that walks through this PR. Render the diff with margin annotations and color-code findings by severity.

116```

117 

118<h3 id="compare-alternatives">

119 比較替代方案

120</h3>

121 

122要求在一個頁面上有多個變體,以便您可以相互評估它們。這適用於佈局、複製、API 形狀或實現計劃。

123 

124```text wrap theme={null}

125Make an artifact with four distinctly different layouts for the settings panel. Vary density and grouping, and lay them out as a grid with a one-line tradeoff under each.

126```

127 

128<h3 id="tune-with-interactive-controls">

129 使用互動控制項進行調整

130</h3>

131 

132要求滑塊、切換或輸入欄位綁定到您正在調整的任何內容,以便您可以直接探索值,而不是描述它們。

133 

134```text wrap theme={null}

135Build an artifact with sliders for the easing curve, duration, and delay so I can try values on this transition. Show the animation live as I move them.

136```

137 

138<h3 id="bring-the-result-back-to-your-session">

139 將結果帶回您的工作階段

140</h3>

141 

142成品可以充當輕量級編輯器,用於您隨後交給 Claude 的決定。要求匯出控制項,產生您可以貼到終端的文字,以便與頁面互動的結果流回工作階段,而不是停留在頁面上。

143 

144```text wrap theme={null}

145Make a triage board artifact with each open issue as a draggable card across Now, Next, Later, and Cut columns. Add a "Copy as prompt" button that gives me the final ordering to paste back here.

146```

147 

148<h3 id="track-work-in-progress">

149 追蹤進行中的工作

150</h3>

151 

152要求 Claude 在長任務執行時保持成品最新,以便任何有連結的人都可以跟進,而無需閱讀終端。

153 

154```text wrap theme={null}

155Turn this migration plan into a checklist artifact. Check items off as you complete them and add a note for anything you skip.

156```

157 

158<h2 id="improve-the-visual-design">

159 改進視覺設計

160</h2>

161 

162Claude 在建立成品時應用內建設計技能,因此頁面無需額外提示即可獲得刻意的調色板、排版和佈局。該技能還會在選擇自己的設計之前在您的專案中尋找現有的設計系統。要保持成品與您產品品牌的一致性,請在 Claude 可以找到的地方記錄您的設計令牌,例如專案的 [CLAUDE.md](/zh-TW/memory) 或您的儲存庫中的主題檔案:

163 

164```markdown theme={null}

165## Design system

166 

167- Colors: primary #1a4d8f, accent #f59e0b, surface #f8fafc

168- Typography: Inter for body, JetBrains Mono for code

169- Spacing: 8px scale, 6px border radius

170```

171 

172Claude 將您的設計系統視為比其自己選擇更高的優先級,並將您的提示視為比兩者都更高的優先級。上面的標題和格式是一個示例;任何清晰的顏色、字體和間距列表都有效。

173 

174<h2 id="page-constraints">

175 頁面限制

176</h2>

177 

178每個成品是一個自包含的頁面。Claude Code 將您發佈的檔案包裝在 HTML 文件殼中,並在嚴格的內容安全政策 (CSP) 下提供它,這形成了頁面可以做什麼。

179 

180| 限制 | 效果 |

181| :----- | :--------------------------------------------------------------------------------------------------------------------- |

182| 無外部請求 | CSP 阻止從任何其他主機載入的指令碼、樣式表、字體和影像,以及 `fetch`、XHR 和 WebSocket 呼叫。Claude 內聯 CSS 和 JavaScript,並將影像嵌入為資料 URI,以便頁面無需任何外部請求即可呈現。 |

183| 無後端 | 成品是靜態頁面。它無法儲存通過表單提交的資料、自行驗證檢視者或在檢視時呼叫 API。 |

184| 單頁 | 相對連結無法解析,因為沒有任何內容與頁面一起部署。對於多部分內容,Claude 使用頁面內錨點而不是單獨的檔案。 |

185| 來源檔案類型 | 發佈的檔案必須是 `.html`、`.htm` 或 `.md`。Markdown 檔案呈現為樣式化的 HTML。 |

186| 呈現大小 | 呈現的頁面必須為 16 MiB 或更小。大型嵌入影像是發佈因大小而失敗的常見原因。 |

187 

188生成成品使用輸出令牌,就像任何其他回應一樣,樣式化頁面比相同內容作為終端文字更耗令牌。內聯 CSS、用於互動控制項的 JavaScript,尤其是嵌入為資料 URI 的影像是主要貢獻者。要減少成品的令牌成本:

189 

190* 對於圖表,優先使用 SVG 或 HTML 和 CSS,而不是嵌入的光柵影像

191* 省略您不需要的互動性

192* 讓頁面總結大型資料集,而不是完整內聯它們

193 

194<h2 id="availability">

195 可用性

196</h2>

197 

198成品需要下面的每個條件。當不滿足其中一個時,Claude 寫入本地 HTML 檔案或說它無法發佈。

199 

200| 要求 | 可用時間 |

201| :---- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

202| 方案 | Team 或 Enterprise。在 Team 方案上,成品預設開啟。在 Enterprise 方案上,管理員在 claude.ai 管理設定中[啟用它們](#manage-artifacts-for-your-organization)。 |

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

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

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

206| 表面 | Claude Code CLI,或 Claude 桌面應用程式版本 1.13576.0 或更新版本。在 [Agent SDK](/zh-TW/agent-sdk/overview)、GitHub Action 和 MCP 伺服器上下文中預設關閉,以及當設定 [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/zh-TW/env-vars) 時。 |

207 

208<h2 id="disable-artifacts">

209 停用成品

210</h2>

211 

212要根據您組織的設定為您自己的工作階段關閉成品,請使用以下任何一個:

213 

214| 方法 | 設定 |

215| :------------------------- | :---------------------------------- |

216| [設定檔](/zh-TW/settings) | `"disableArtifact": true` |

217| [環境變數](/zh-TW/env-vars) | `CLAUDE_CODE_DISABLE_ARTIFACT=1` |

218| [許可規則](/zh-TW/permissions) | 將 `Artifact` 新增到 `permissions.deny` |

219 

220<h2 id="manage-artifacts-for-your-organization">

221 為您的組織管理成品

222</h2>

223 

224Team 和 Enterprise 方案上的管理員從 [claude.ai 管理設定](https://claude.ai/admin-settings/claude-code)控制成品。成品內容儲存在 Anthropic 營運的基礎設施上,僅對發佈組織的已驗證成員可見。

225 

226<h3 id="enable-or-disable-artifacts">

227 啟用或停用成品

228</h3>

229 

230要為整個組織啟用或停用成品,請前往**設定 > Claude Code > 功能**並使用**成品**切換。在具有角色型存取控制的 Enterprise 方案上,您還可以將成品範圍限制為特定角色:前往**設定 > 角色**、編輯角色,並在 **Claude Code** 群組下設定**成品**許可。

231 

232<h3 id="set-a-retention-policy">

233 設定保留政策

234</h3>

235 

236要設定在自動刪除之前保留成品的時間,請前往**設定 > 資料和隱私控制**。您可以為仍然是其作者私人的成品和已共享的成品設定單獨的保留期。

237 

238<h3 id="review-the-audit-log">

239 檢查稽核日誌

240</h3>

241 

242發佈、分享和刪除成品各自出現在您組織的稽核日誌中,位於 `claude_artifact_*` 事件類型下,與在 claude.ai 對話中建立的成品使用的相同系列。

243 

244<h3 id="allowlist-the-viewer-domain">

245 允許列表檢視器網域

246</h3>

247 

248claude.ai 上的檢視器從沙箱化的 `*.claudeusercontent.com` 來源載入每個成品。如果您的組織限制出站網路存取,請將該網域新增到您的允許列表中,以及 `claude.ai`。請參閱[網路存取要求](/zh-TW/network-config#network-access-requirements)以了解完整清單。

249 

250<h3 id="list-and-delete-artifacts-with-the-compliance-api">

251 使用 Compliance API 列出和刪除成品

252</h3>

253 

254[Compliance API](https://docs.claude.com/en/api/compliance) 提供端點來列出組織的成品、檢索特定版本的內容和刪除成品:

255 

256| 方法 | 端點 |

257| :------- | :------------------------------------------------------------------ |

258| `GET` | `/v1/compliance/code/artifacts` |

259| `GET` | `/v1/compliance/code/artifacts/{artifact_id}/versions/{version_id}` |

260| `DELETE` | `/v1/compliance/code/artifacts/{artifact_id}` |

261 

262有關請求和回應架構,請參閱 [Compliance API 參考](https://docs.claude.com/en/api/compliance/code/artifacts)。

263 

264<h2 id="related-resources">

265 相關資源

266</h2>

267 

268* 瀏覽與成品配對的[提示模式和工作流程](/zh-TW/prompt-library)

269* 將您重複使用的成品提示轉變為[技能](/zh-TW/skills),以便您可以將其作為命令呼叫

270* [連接 MCP 伺服器](/zh-TW/mcp),以便 Claude 可以將即時資料提取到成品中

chrome.md +1 −1

Details

198 未偵測到擴充功能198 未偵測到擴充功能

199</h3>199</h3>

200 200 

201如果 Claude Code 的設定問題行列出 `chrome`201如果 Claude Code 無法偵測到 Chrome 擴充功能

202 202 

2031. 驗證 Chrome 擴充功能已安裝並在 `chrome://extensions` 中啟用2031. 驗證 Chrome 擴充功能已安裝並在 `chrome://extensions` 中啟用

2042. 透過執行 `claude --version` 驗證 Claude Code 是否為最新版本2042. 透過執行 `claude --version` 驗證 Claude Code 是否為最新版本

Details

124 </Step>124 </Step>

125</Steps>125</Steps>

126 126 

127<h3 id="link-artifacts-back-to-the-session">127<h3 id="link-output-back-to-the-session">

128 將工件連結回工作階段128 將輸出連結回工作階段

129</h3>129</h3>

130 130 

131每個雲端工作階段在 claude.ai 上都有一個成績單 URL,工作階段可以從 `CLAUDE_CODE_REMOTE_SESSION_ID` 環境變數讀取自己的 ID。使用此在 PR 正文、提交訊息、Slack 貼文或生成的報告中放置可追蹤的連結,以便審查者可以開啟產生它們的執行。131每個雲端工作階段在 claude.ai 上都有一個成績單 URL,工作階段可以從 `CLAUDE_CODE_REMOTE_SESSION_ID` 環境變數讀取自己的 ID。使用此在 PR 正文、提交訊息、Slack 貼文或生成的報告中放置可追蹤的連結,以便審查者可以開啟產生它們的執行。

132 132 

133變數的值使用 `cse_` 前綴而成績單 URL 路徑採用相同的 ID但使用 `session_` 前綴。建立連結時替換前綴。以下命令列印 URL:133 v2.1.179 起,Claude 在網頁工作階段中建立的提交包括 `Claude-Session: <url>` git 預告片PR 正文包括工作階段 URL 在其自己的行上。{/* min-version: 2.1.182 */}從 v2.1.182 起設定 [`attribution.sessionUrl`](/zh-TW/settings#attribution-settings) `false` 以省略預告片和 PR 正文連結。

134 

135若要在提交或 PR 以外的其他內容中包括工作階段連結,例如 Claude 發佈的 Slack 訊息或它寫入的報告檔案,請讓 Claude 執行以下命令並使用其輸出。該命令將環境變數值中的 `cse_` 前綴轉換為成績單 URL 期望的 `session_` 前綴:

134 136 

135```bash theme={null}137```bash theme={null}

136echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"138echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"


902* [設定參考](/zh-TW/settings):所有配置選項904* [設定參考](/zh-TW/settings):所有配置選項

903* [安全性](/zh-TW/security):隔離保證和資料處理905* [安全性](/zh-TW/security):隔離保證和資料處理

904* [資料使用](/zh-TW/data-usage):Anthropic 從雲端工作階段保留的內容906* [資料使用](/zh-TW/data-usage):Anthropic 從雲端工作階段保留的內容

907* [Claude Tag](https://claude.com/docs/claude-tag/overview):在 Slack 中由組織管理的 @Claude,在相同的雲端環境中執行

Details

238}238}

239```239```

240 240 

241設定 `awsAuthRefresh` 後,`/login` 會在 **使用第三方平台** 下顯示 **Claude Platform on AWS · 重新整理認證** 選項。選取它會執行已設定的命令,並重新讀取您的 AWS 認證,而無需重新啟動 Claude Code。

242 

241**選項 B:工作區 API 金鑰**243**選項 B:工作區 API 金鑰**

242 244 

243工作區 API 金鑰是長期有效的祕密,在您不想管理聯合 AWS 認證時很有用。在 AWS Console 中的 **Claude Platform on AWS → API keys** 下產生一個,並將其設定為 `ANTHROPIC_AWS_API_KEY`:245工作區 API 金鑰是長期有效的祕密,在您不想管理聯合 AWS 認證時很有用。在 AWS Console 中的 **Claude Platform on AWS → API keys** 下產生一個,並將其設定為 `ANTHROPIC_AWS_API_KEY`:


251將工作區 API 金鑰視為任何其他生產認證。[使用者設定檔](/zh-TW/settings) `env` 區塊是在不全域匯出的情況下將金鑰限定於您的機器的便利方式。253將工作區 API 金鑰視為任何其他生產認證。[使用者設定檔](/zh-TW/settings) `env` 區塊是在不全域匯出的情況下將金鑰限定於您的機器的便利方式。

252 254 

253<Note>255<Note>

254 `/login` 和 `/logout` 命令不會變更 AWS 上的 Claude Platform 驗證。驗證透過您的 AWS 認證或工作區 API 金鑰執行,而不是透過 Claude.ai 訂閱。256 `/login` 和 `/logout` 命令不會變更 AWS 上的 Claude Platform 驗證。驗證透過您的 AWS 認證或工作區 API 金鑰執行,而不是透過 Claude.ai 訂閱。唯一的例外是當設定 `awsAuthRefresh` 時,`/login` 顯示的 **重新整理認證** 選項,它會如上所述重新讀取您的 AWS 認證。

255</Note>257</Note>

256 258 

257<h3 id="2-configure-claude-code">259<h3 id="2-configure-claude-code">

cli-reference.md +11 −8

Details

13您可以使用這些命令來啟動工作階段、管道內容、繼續對話和管理更新:13您可以使用這些命令來啟動工作階段、管道內容、繼續對話和管理更新:

14 14 

15| 命令 | 描述 | 範例 |15| 命令 | 描述 | 範例 |

16| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |16| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |

17| `claude` | 啟動互動式工作階段 | `claude` |17| `claude` | 啟動互動式工作階段 | `claude` |

18| `claude "query"` | 使用初始提示啟動互動式工作階段 | `claude "explain this project"` |18| `claude "query"` | 使用初始提示啟動互動式工作階段 | `claude "explain this project"` |

19| `claude -p "query"` | 透過 SDK 查詢,然後退出 | `claude -p "explain this function"` |19| `claude -p "query"` | 透過 SDK 查詢,然後退出 | `claude -p "explain this function"` |


26| `claude auth login` | 登入您的 Anthropic 帳戶。使用 `--email` 預先填入您的電子郵件地址,使用 `--sso` 強制進行 SSO 驗證,使用 `--console` 以 Anthropic Console 登入以進行 API 使用計費,而不是 Claude 訂閱 | `claude auth login --console` |26| `claude auth login` | 登入您的 Anthropic 帳戶。使用 `--email` 預先填入您的電子郵件地址,使用 `--sso` 強制進行 SSO 驗證,使用 `--console` 以 Anthropic Console 登入以進行 API 使用計費,而不是 Claude 訂閱 | `claude auth login --console` |

27| `claude auth logout` | 從您的 Anthropic 帳戶登出 | `claude auth logout` |27| `claude auth logout` | 從您的 Anthropic 帳戶登出 | `claude auth logout` |

28| `claude auth status` | 以 JSON 格式顯示驗證狀態。使用 `--text` 以人類可讀的格式輸出。如果已登入則以代碼 0 退出,如果未登入則以代碼 1 退出 | `claude auth status` |28| `claude auth status` | 以 JSON 格式顯示驗證狀態。使用 `--text` 以人類可讀的格式輸出。如果已登入則以代碼 0 退出,如果未登入則以代碼 1 退出 | `claude auth status` |

29| `claude agents` | 開啟 [agent view](/zh-TW/agent-view) 以監控和分派平行背景工作階段。使用 `--cwd <path>` 僅顯示在該目錄下啟動的工作階段,或使用 `--json` 將即時工作階段列印為 JSON 陣列以供指令碼使用。傳遞 `--permission-mode`、`--model`、`--effort` 或 `--agent` 以設定 [分派工作階段的預設值](/zh-TW/agent-view#permission-mode-model-and-effort)。接受 `--settings`、`--add-dir`、`--plugin-dir` 和 `--mcp-config`,如同頂層 `claude` 命令。開啟 agent view 需要互動式終端 | `claude agents --json` |29| `claude agents` | 開啟 [agent view](/zh-TW/agent-view) 以監控和分派平行背景工作階段。使用 `--cwd <path>` 僅顯示在該目錄下啟動的工作階段,或使用 `--json` 將即時工作階段列印為 JSON 陣列以供指令碼使用(`--json --all` 也包括已完成的背景工作階段)。傳遞 `--permission-mode`、`--model`、`--effort` 或 `--agent` 以設定 [分派工作階段的預設值](/zh-TW/agent-view#permission-mode-model-and-effort)。接受 `--settings`、`--add-dir`、`--plugin-dir` 和 `--mcp-config`,如同頂層 `claude` 命令。開啟 agent view 需要互動式終端 | `claude agents --json` |

30| `claude attach <id>` | 在此終端中附加到 [background session](/zh-TW/agent-view#manage-sessions-from-the-shell) | `claude attach 7c5dcf5d` |30| `claude attach <id>` | 在此終端中附加到 [背景工作階段](/zh-TW/agent-view#manage-sessions-from-the-shell) | `claude attach 7c5dcf5d` |

31| `claude auto-mode defaults` | 以 JSON 格式列印內建的 [auto mode](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 分類器規則。使用 `claude auto-mode config` 查看您的有效設定及套用的設定 | `claude auto-mode defaults > rules.json` |31| `claude auto-mode defaults` | 以 JSON 格式列印內建的 [auto mode](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 分類器規則。使用 `claude auto-mode config` 查看您的有效設定及套用的設定 | `claude auto-mode defaults > rules.json` |

32| `claude daemon status` | 列印背景工作階段 [supervisor](/zh-TW/agent-view#the-supervisor-process) 的狀態、版本、socket 目錄和工作者計數以進行診斷。如果 supervisor 未執行則以代碼 1 退出 | `claude daemon status` |32| `claude daemon status` | 列印背景工作階段 [supervisor](/zh-TW/agent-view#the-supervisor-process) 的狀態、版本、socket 目錄和工作者計數以進行診斷。如果 supervisor 未執行則以代碼 1 退出 | `claude daemon status` |

33| `claude daemon stop --any` | 停止背景工作階段 [supervisor](/zh-TW/agent-view#the-supervisor-process) 及其託管的工作階段。傳遞 `--keep-workers` 以保持背景工作階段執行中,以便下一個 supervisor 重新連接到它們。`--any` 確認停止隨選 supervisor,這是預設值。使用此命令以從 [無回應的 supervisor](/zh-TW/agent-view#agent-view-says-the-background-service-did-not-respond) 復原 | `claude daemon stop --any --keep-workers` |33| `claude daemon stop --any` | 停止背景工作階段 [supervisor](/zh-TW/agent-view#the-supervisor-process) 及其託管的工作階段。傳遞 `--keep-workers` 以保持背景工作階段執行中,以便下一個 supervisor 重新連接到它們。`--any` 確認停止隨選 supervisor,這是預設值。使用此命令以從 [無回應的 supervisor](/zh-TW/agent-view#agent-view-says-the-background-service-did-not-respond) 復原 | `claude daemon stop --any --keep-workers` |

34| `claude logs <id>` | 從 [background session](/zh-TW/agent-view#manage-sessions-from-the-shell) 列印最近的輸出 | `claude logs 7c5dcf5d` |34| `claude logs <id>` | 從 [背景工作階段](/zh-TW/agent-view#manage-sessions-from-the-shell) 列印最近的輸出 | `claude logs 7c5dcf5d` |

35| `claude mcp` | 設定 Model Context Protocol (MCP) 伺服器 | 請參閱 [Claude Code MCP 文件](/zh-TW/mcp)。 |35| `claude mcp` | 設定 Model Context Protocol (MCP) 伺服器 | 請參閱 [Claude Code MCP 文件](/zh-TW/mcp)。 |

36| `claude mcp login <name>` | {/* min-version: 2.1.186 */}執行已設定的 MCP 伺服器的 OAuth 流程而不開啟互動式 `/mcp` 面板。適用於 HTTP、SSE 和 claude.ai 連接器伺服器。在 SSH 上新增 `--no-browser` 以列印授權 URL 而不是開啟瀏覽器,然後將重新導向 URL 貼回提示。需要 Claude Code v2.1.186 或更新版本。請參閱 [從命令列驗證](/zh-TW/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |

37| `claude mcp logout <name>` | {/* min-version: 2.1.186 */}清除 MCP 伺服器的已儲存 OAuth 認證。需要 Claude Code v2.1.186 或更新版本 | `claude mcp logout sentry` |

36| `claude plugin` | 管理 Claude Code [plugins](/zh-TW/plugins)。別名:`claude plugins`。請參閱 [plugin 參考](/zh-TW/plugins-reference#cli-commands-reference) 以了解子命令 | `claude plugin install code-review@claude-plugins-official` |38| `claude plugin` | 管理 Claude Code [plugins](/zh-TW/plugins)。別名:`claude plugins`。請參閱 [plugin 參考](/zh-TW/plugins-reference#cli-commands-reference) 以了解子命令 | `claude plugin install code-review@claude-plugins-official` |

37| `claude project purge [path]` | 刪除專案的所有本機 Claude Code 狀態:文字記錄、工作清單、偵錯日誌、檔案編輯歷史記錄、提示歷史記錄行和專案在 `~/.claude.json` 中的項目。省略 `[path]` 以從互動式清單中選擇。旗標:`--dry-run` 以預覽,`-y`/`--yes` 以跳過確認,`-i`/`--interactive` 以確認每個項目,`--all` 用於每個專案。請參閱 [清除本機資料](/zh-TW/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |39| `claude project purge [path]` | 刪除專案的所有本機 Claude Code 狀態:文字記錄、工作清單、偵錯日誌、檔案編輯歷史記錄、提示歷史記錄行和專案在 `~/.claude.json` 中的項目。省略 `[path]` 以從互動式清單中選擇。旗標:`--dry-run` 以預覽,`-y`/`--yes` 以跳過確認,`-i`/`--interactive` 以確認每個項目,`--all` 用於每個專案。請參閱 [清除本機資料](/zh-TW/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |

38| `claude remote-control` | 啟動 [Remote Control](/zh-TW/remote-control) 伺服器以從 Claude.ai 或 Claude 應用程式控制 Claude Code。在伺服器模式下執行(無本機互動式工作階段)。請參閱 [伺服器模式旗標](/zh-TW/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |40| `claude remote-control` | 啟動 [Remote Control](/zh-TW/remote-control) 伺服器以從 Claude.ai 或 Claude 應用程式控制 Claude Code。在伺服器模式下執行(無本機互動式工作階段)。請參閱 [伺服器模式旗標](/zh-TW/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |

39| `claude respawn <id>` | 重新啟動 [background session](/zh-TW/agent-view#manage-sessions-from-the-shell)(執行中或已停止),保持其對話完整。使用 `--all` 重新啟動每個執行中的工作階段,例如以取得更新的 Claude Code 二進位檔 | `claude respawn 7c5dcf5d` |41| `claude respawn <id>` | 重新啟動 [背景工作階段](/zh-TW/agent-view#manage-sessions-from-the-shell)(執行中或已停止),保持其對話完整。使用 `--all` 重新啟動每個執行中的工作階段,例如以取得更新的 Claude Code 二進位檔 | `claude respawn 7c5dcf5d` |

40| `claude rm <id>` | 從清單中移除 [background session](/zh-TW/agent-view#manage-sessions-from-the-shell)。對話文字記錄保留在您的本機電腦上,可透過 `claude --resume` 取得 | `claude rm 7c5dcf5d` |42| `claude rm <id>` | 從清單中移除 [背景工作階段](/zh-TW/agent-view#manage-sessions-from-the-shell)。對話文字記錄保留在您的本機電腦上,可透過 `claude --resume` 取得 | `claude rm 7c5dcf5d` |

41| `claude setup-token` | 為 CI 和指令碼產生長期 OAuth 權杖。將權杖列印到終端而不儲存它。需要 Claude 訂閱。請參閱 [產生長期權杖](/zh-TW/authentication#generate-a-long-lived-token) | `claude setup-token` |43| `claude setup-token` | 為 CI 和指令碼產生長期 OAuth 權杖。將權杖列印到終端而不儲存它。需要 Claude 訂閱。請參閱 [產生長期權杖](/zh-TW/authentication#generate-a-long-lived-token) | `claude setup-token` |

42| `claude stop <id>` | 停止 [background session](/zh-TW/agent-view#manage-sessions-from-the-shell)。也接受 `claude kill` | `claude stop 7c5dcf5d` |44| `claude stop <id>` | 停止 [背景工作階段](/zh-TW/agent-view#manage-sessions-from-the-shell)。也接受 `claude kill` | `claude stop 7c5dcf5d` |

43| `claude ultrareview [target]` | 非互動式執行 [ultrareview](/zh-TW/ultrareview#run-ultrareview-non-interactively)。將發現列印到標準輸出,成功時以代碼 0 退出,失敗時以代碼 1 退出。使用 `--json` 取得原始承載,使用 `--timeout <minutes>` 覆蓋 30 分鐘的預設值 | `claude ultrareview 1234 --json` |45| `claude ultrareview [target]` | 非互動式執行 [ultrareview](/zh-TW/ultrareview#run-ultrareview-non-interactively)。將發現列印到標準輸出,成功時以代碼 0 退出,失敗時以代碼 1 退出。使用 `--json` 取得原始承載,使用 `--timeout <minutes>` 覆蓋 30 分鐘的預設值 | `claude ultrareview 1234 --json` |

44 46 

45如果您輸入錯誤的子命令,Claude Code 會建議最接近的匹配項並退出而不啟動工作階段。例如,`claude udpate` 會列印 `Did you mean claude update?`。47如果您輸入錯誤的子命令,Claude Code 會建議最接近的匹配項並退出而不啟動工作階段。例如,`claude udpate` 會列印 `Did you mean claude update?`。


60| `--allowedTools`、`--allowed-tools` | 無需提示權限即可執行的工具。請參閱 [permission rule syntax](/zh-TW/settings#permission-rule-syntax) 以了解模式匹配。若要限制可用的工具,請改用 `--tools` | `"Bash(git log *)" "Bash(git diff *)" "Read"` |62| `--allowedTools`、`--allowed-tools` | 無需提示權限即可執行的工具。請參閱 [permission rule syntax](/zh-TW/settings#permission-rule-syntax) 以了解模式匹配。若要限制可用的工具,請改用 `--tools` | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

61| `--append-system-prompt` | 將自訂文字附加到預設系統提示的末尾 | `claude --append-system-prompt "Always use TypeScript"` |63| `--append-system-prompt` | 將自訂文字附加到預設系統提示的末尾 | `claude --append-system-prompt "Always use TypeScript"` |

62| `--append-system-prompt-file` | 從檔案載入額外的系統提示文字並附加到預設提示 | `claude --append-system-prompt-file ./extra-rules.txt` |64| `--append-system-prompt-file` | 從檔案載入額外的系統提示文字並附加到預設提示 | `claude --append-system-prompt-file ./extra-rules.txt` |

65| `--ax-screen-reader` | {/* min-version: 2.1.181 */}呈現螢幕閱讀器友善的輸出:平面文字,無裝飾邊框或動畫。強制使用經典渲染器,因此 [`tui`](/zh-TW/settings#available-settings) 設定在工作階段中無效。優先於 [`CLAUDE_AX_SCREEN_READER`](/zh-TW/env-vars) 和 [`axScreenReader`](/zh-TW/settings#available-settings) 設定。需要 Claude Code v2.1.181 或更新版本 | `claude --ax-screen-reader` |

63| `--bare` | 最小模式:跳過 hooks、skills、plugins、MCP 伺服器、自動記憶體和 CLAUDE.md 的自動探索,以便指令碼呼叫啟動更快。Claude 可以存取 Bash、檔案讀取和檔案編輯工具。設定 [`CLAUDE_CODE_SIMPLE`](/zh-TW/env-vars)。請參閱 [bare mode](/zh-TW/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |66| `--bare` | 最小模式:跳過 hooks、skills、plugins、MCP 伺服器、自動記憶體和 CLAUDE.md 的自動探索,以便指令碼呼叫啟動更快。Claude 可以存取 Bash、檔案讀取和檔案編輯工具。設定 [`CLAUDE_CODE_SIMPLE`](/zh-TW/env-vars)。請參閱 [bare mode](/zh-TW/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

64| `--betas` | 要包含在 API 請求中的 Beta 標頭(僅限 API 金鑰使用者) | `claude --betas interleaved-thinking` |67| `--betas` | 要包含在 API 請求中的 Beta 標頭(僅限 API 金鑰使用者) | `claude --betas interleaved-thinking` |

65| `--bg` | 以 [background agent](/zh-TW/agent-view) 身份啟動工作階段並立即返回。列印工作階段 ID 和管理命令。與 `--exec` 結合以執行 shell 命令作為背景工作而不是 Claude 工作階段,或與 `--agent` 結合以執行特定 subagent | `claude --bg "investigate the flaky test"` |68| `--bg` | 以 [background agent](/zh-TW/agent-view) 身份啟動工作階段並立即返回。列印工作階段 ID 和管理命令。與 `--exec` 結合以執行 shell 命令作為背景工作而不是 Claude 工作階段,或與 `--agent` 結合以執行特定 subagent | `claude --bg "investigate the flaky test"` |


114| `--system-prompt` | 用自訂文字取代整個系統提示 | `claude --system-prompt "You are a Python expert"` |117| `--system-prompt` | 用自訂文字取代整個系統提示 | `claude --system-prompt "You are a Python expert"` |

115| `--system-prompt-file` | 從檔案載入系統提示,取代預設提示 | `claude --system-prompt-file ./custom-prompt.txt` |118| `--system-prompt-file` | 從檔案載入系統提示,取代預設提示 | `claude --system-prompt-file ./custom-prompt.txt` |

116| `--teleport` | 在本機終端中繼續 [web session](/zh-TW/claude-code-on-the-web) | `claude --teleport` |119| `--teleport` | 在本機終端中繼續 [web session](/zh-TW/claude-code-on-the-web) | `claude --teleport` |

117| `--teammate-mode` | 設定 [agent team](/zh-TW/agent-teams) 隊友的顯示方式:`auto`(預設)、`in-process` 或 `tmux`。覆蓋此工作階段的 [`teammateMode`](/zh-TW/settings#available-settings) 設定。請參閱 [選擇顯示模式](/zh-TW/agent-teams#choose-a-display-mode) | `claude --teammate-mode in-process` |120| `--teammate-mode` | 設定 [agent team](/zh-TW/agent-teams) 隊友的顯示方式:`in-process`(預設)、`auto`、`tmux`{/* min-version: 2.1.186 */}`iterm2`(在 v2.1.186 中新增)預設在 v2.1.179 中從 `auto` 變更。覆蓋此工作階段的 [`teammateMode`](/zh-TW/settings#available-settings) 設定。請參閱 [選擇顯示模式](/zh-TW/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |

118| `--tmux` | 為 worktree 建立 tmux 工作階段。需要 `--worktree`。在可用時使用 iTerm2 原生窗格;傳遞 `--tmux=classic` 以使用傳統 tmux | `claude -w feature-auth --tmux` |121| `--tmux` | 為 worktree 建立 tmux 工作階段。需要 `--worktree`。在可用時使用 iTerm2 原生窗格;傳遞 `--tmux=classic` 以使用傳統 tmux | `claude -w feature-auth --tmux` |

119| `--tools` | 限制 Claude 可以使用的內建工具。使用 `""` 停用全部、`"default"` 為全部,或工具名稱如 `"Bash,Edit,Read"`。MCP 工具不受影響;若要拒絕這些工具,請改用 `--disallowedTools "mcp__*"`,或傳遞 `--strict-mcp-config` 而不使用 `--mcp-config` 以便不載入 MCP 伺服器 | `claude --tools "Bash,Edit,Read"` |122| `--tools` | 限制 Claude 可以使用的內建工具。使用 `""` 停用全部、`"default"` 為全部,或工具名稱如 `"Bash,Edit,Read"`。MCP 工具不受影響;若要拒絕這些工具,請改用 `--disallowedTools "mcp__*"`,或傳遞 `--strict-mcp-config` 而不使用 `--mcp-config` 以便不載入 MCP 伺服器 | `claude --tools "Bash,Edit,Read"` |

120| `--verbose` | 啟用詳細記錄,顯示完整的逐轉輸出。覆蓋此工作階段的 [`viewMode`](/zh-TW/settings#available-settings) 設定 | `claude --verbose` |123| `--verbose` | 啟用詳細記錄,顯示完整的逐轉輸出。覆蓋此工作階段的 [`viewMode`](/zh-TW/settings#available-settings) 設定 | `claude --verbose` |

commands.md +3 −3

Details

24 24 

25**並行執行工作。** `/agents` 開啟管理員以管理 [subagents](/zh-TW/sub-agents) Claude 可以委派側邊任務,`/tasks` 列出目前工作階段背景中執行的內容。`/background` 分離整個工作階段以繼續作為 [background agent](/zh-TW/agent-view) 執行並釋放您的終端機。對於跨越程式碼庫的大型變更,`/batch` 將其分解為獨立單位,並在各自的 [worktree](/zh-TW/worktrees) 中執行每個單位。請參閱 [Run agents in parallel](/zh-TW/agents) 以了解這些方法如何相關。25**並行執行工作。** `/agents` 開啟管理員以管理 [subagents](/zh-TW/sub-agents) Claude 可以委派側邊任務,`/tasks` 列出目前工作階段背景中執行的內容。`/background` 分離整個工作階段以繼續作為 [background agent](/zh-TW/agent-view) 執行並釋放您的終端機。對於跨越程式碼庫的大型變更,`/batch` 將其分解為獨立單位,並在各自的 [worktree](/zh-TW/worktrees) 中執行每個單位。請參閱 [Run agents in parallel](/zh-TW/agents) 以了解這些方法如何相關。

26 26 

27**在您推送前。** `/diff` 顯示變更的內容,`/code-review` 檢查差異以找出正確性錯誤和清理,並可以使用 `--fix` 應用發現的結果,`/review` `/security-review` 進行更深入的唯讀檢查。`/code-review ultra` 在雲端執行多代理審查。27**在您推送前。** `/diff` 顯示變更的內容,`/code-review` 檢查差異以找出正確性錯誤和清理,並可以使用 `--fix` 應用發現的結果,`/review` GitHub pull request 上執行相同的唯讀審查,`/security-review` 進行更深入的唯讀檢查。`/code-review ultra` 在雲端執行多代理審查。

28 28 

29**在工作階段之間。** `/clear` 在保持專案記憶的同時開始新工作的新鮮開始。`/resume` 和 `/branch` 讓您返回或分叉較早的對話。`/teleport` 將網頁工作階段拉入此終端機,`/remote-control` 讓您從另一個裝置繼續此本地工作階段。29**在工作階段之間。** `/clear` 在保持專案記憶的同時開始新工作的新鮮開始。`/resume` 和 `/branch` 讓您返回或分叉較早的對話。`/teleport` 將網頁工作階段拉入此終端機,`/remote-control` 讓您從另一個裝置繼續此本地工作階段。

30 30 


64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/zh-TW/skills#bundled-skills).** 審閱目前的差異以查找正確性錯誤並進行重用、簡化和效率清理。傳遞 `--fix` 以將發現應用到您的工作樹,傳遞 `--comment` 以將其作為內聯 GitHub PR 評論發佈,或傳遞 `ultra` 以運行深度[雲端審閱](/zh-TW/ultrareview)。{/* min-version: 2.1.154 */}從 v2.1.154 開始,`/simplify` 運行單獨的僅清理審閱,應用修復而不尋找錯誤。請參閱[本地審閱差異](/zh-TW/code-review#review-a-diff-locally)以了解努力程度和目標設定 |64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/zh-TW/skills#bundled-skills).** 審閱目前的差異以查找正確性錯誤並進行重用、簡化和效率清理。傳遞 `--fix` 以將發現應用到您的工作樹,傳遞 `--comment` 以將其作為內聯 GitHub PR 評論發佈,或傳遞 `ultra` 以運行深度[雲端審閱](/zh-TW/ultrareview)。{/* min-version: 2.1.154 */}從 v2.1.154 開始,`/simplify` 運行單獨的僅清理審閱,應用修復而不尋找錯誤。請參閱[本地審閱差異](/zh-TW/code-review#review-a-diff-locally)以了解努力程度和目標設定 |

65| `/color [color\|default]` | 設定目前工作階段的提示列顏色。可用顏色:`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、`cyan`。使用 `default` 重設,或不帶引數執行以選擇隨機顏色。當[遠端控制](/zh-TW/remote-control)已連接時,顏色會同步到 claude.ai/code |65| `/color [color\|default]` | 設定目前工作階段的提示列顏色。可用顏色:`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、`cyan`。使用 `default` 重設,或不帶引數執行以選擇隨機顏色。當[遠端控制](/zh-TW/remote-control)已連接時,顏色會同步到 claude.ai/code |

66| `/compact [instructions]` | 通過總結到目前為止的對話來釋放上下文。可選擇性地傳遞焦點指示以進行摘要。請參閱[壓縮如何處理規則、skills 和記憶體檔案](/zh-TW/context-window#what-survives-compaction) |66| `/compact [instructions]` | 通過總結到目前為止的對話來釋放上下文。可選擇性地傳遞焦點指示以進行摘要。請參閱[壓縮如何處理規則、skills 和記憶體檔案](/zh-TW/context-window#what-survives-compaction) |

67| `/config` | 開啟[設定](/zh-TW/settings)介面以調整主題、模型、[輸出樣式](/zh-TW/output-styles)和其他偏好設定。別名:`/settings` |67| `/config [key=value ...]` | 開啟[設定](/zh-TW/settings)介面以調整主題、模型、[輸出樣式](/zh-TW/output-styles)和其他偏好設定。{/* min-version: 2.1.181 */}從 v2.1.181 開始,傳遞一個或多個 `key=value` 對以直接設定設定,無需開啟介面,例如 `/config thinking=false`。{/* min-version: 2.1.182 */}從 v2.1.182 開始,也接受命名的簡寫鍵,例如 `/config theme=dark` 或 `/config model=sonnet`。`key=value` 形式也適用於非互動模式(`-p`)和[遠端控制](/zh-TW/remote-control)。執行 `/config --help` 以列出每個可設定的鍵及其選項。別名:`/settings` |

68| `/context [all]` | 將目前的上下文使用情況視覺化為彩色網格。顯示上下文繁重工具、記憶體膨脹和容量警告的最佳化建議。在[全螢幕模式](/zh-TW/fullscreen)中,每個項目的分解會折疊以保持網格可見。傳遞 `all` 以展開它 |68| `/context [all]` | 將目前的上下文使用情況視覺化為彩色網格。顯示上下文繁重工具、記憶體膨脹和容量警告的最佳化建議。在[全螢幕模式](/zh-TW/fullscreen)中,每個項目的分解會折疊以保持網格可見。傳遞 `all` 以展開它 |

69| `/copy [N]` | 將最後一個助手回應複製到剪貼簿。傳遞數字 `N` 以複製第 N 個最新回應:`/copy 2` 複製倒數第二個。當存在程式碼區塊時,顯示互動式選擇器以選擇個別區塊或完整回應。在選擇器中按 `w` 以將選擇寫入檔案而不是剪貼簿,這在 SSH 上很有用 |69| `/copy [N]` | 將最後一個助手回應複製到剪貼簿。傳遞數字 `N` 以複製第 N 個最新回應:`/copy 2` 複製倒數第二個。當存在程式碼區塊時,顯示互動式選擇器以選擇個別區塊或完整回應。在選擇器中按 `w` 以將選擇寫入檔案而不是剪貼簿,這在 SSH 上很有用 |

70| `/cost` | `/usage` 的別名 |70| `/cost` | `/usage` 的別名 |


114| `/remote-env` | 為[雲端 agents](/zh-TW/claude-code-on-the-web#configure-your-environment) 選擇預設環境 |114| `/remote-env` | 為[雲端 agents](/zh-TW/claude-code-on-the-web#configure-your-environment) 選擇預設環境 |

115| `/rename [name]` | 重新命名目前的工作階段並在提示列上顯示名稱。不使用名稱時,從對話歷史記錄自動產生名稱 |115| `/rename [name]` | 重新命名目前的工作階段並在提示列上顯示名稱。不使用名稱時,從對話歷史記錄自動產生名稱 |

116| `/resume [session]` | 按 ID 或名稱繼續對話,或開啟工作階段選擇器。自 v2.1.144 起,[背景工作階段](/zh-TW/agent-view)會在選擇器中顯示,標記為 `bg`。別名:`/continue` |116| `/resume [session]` | 按 ID 或名稱繼續對話,或開啟工作階段選擇器。自 v2.1.144 起,[背景工作階段](/zh-TW/agent-view)會在選擇器中顯示,標記為 `bg`。別名:`/continue` |

117| `/review [PR]` | 在您目前的工作階段中本地審閱 pull request。如需更深入的雲端審閱,請參閱 [`/code-review ultra`](/zh-TW/ultrareview) |117| `/review [PR]` | 使用與 `/code-review` 相同的審閱引擎按編號審閱 GitHub pull request。不帶引數時列出開放的 PR 以供選擇。如需雲端審閱,請參閱 [`/code-review ultra`](/zh-TW/ultrareview) |

118| `/rewind` | 將對話和/或程式碼倒帶到上一個時刻,或從選定的訊息進行摘要。請參閱 [checkpointing](/zh-TW/checkpointing)。別名:`/checkpoint`、`/undo` |118| `/rewind` | 將對話和/或程式碼倒帶到上一個時刻,或從選定的訊息進行摘要。請參閱 [checkpointing](/zh-TW/checkpointing)。別名:`/checkpoint`、`/undo` |

119| `/run` | **[Skill](/zh-TW/skills#bundled-skills).** 啟動並驅動您的專案應用程式以查看在執行中的應用程式中工作的變更,而不僅僅是在測試中。請參閱[運行並驗證您的應用程式](/zh-TW/skills#run-and-verify-your-app)。{/* min-version: 2.1.145 */}需要 Claude Code v2.1.145 或更新版本 |119| `/run` | **[Skill](/zh-TW/skills#bundled-skills).** 啟動並驅動您的專案應用程式以查看在執行中的應用程式中工作的變更,而不僅僅是在測試中。請參閱[運行並驗證您的應用程式](/zh-TW/skills#run-and-verify-your-app)。{/* min-version: 2.1.145 */}需要 Claude Code v2.1.145 或更新版本 |

120| `/run-skill-generator` | **[Skill](/zh-TW/skills#bundled-skills).** 通過從乾淨環境編寫每個專案的 [skill](/zh-TW/skills#run-and-verify-your-app),教導 `/run` 和 `/verify` 如何構建、啟動和驅動您的專案應用程式。{/* min-version: 2.1.145 */}需要 Claude Code v2.1.145 或更新版本 |120| `/run-skill-generator` | **[Skill](/zh-TW/skills#bundled-skills).** 通過從乾淨環境編寫每個專案的 [skill](/zh-TW/skills#run-and-verify-your-app),教導 `/run` 和 `/verify` 如何構建、啟動和驅動您的專案應用程式。{/* min-version: 2.1.145 */}需要 Claude Code v2.1.145 或更新版本 |

env-vars.md +16 −7

Details

148| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | 設定為 `1` 以停用所有內建 [subagent](/zh-TW/sub-agents) 類型,例如 Explore 和 Plan。僅適用於非互動式模式(`-p` 旗標)。對於想要空白狀態的 SDK 使用者很有用 |148| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | 設定為 `1` 以停用所有內建 [subagent](/zh-TW/sub-agents) 類型,例如 Explore 和 Plan。僅適用於非互動式模式(`-p` 旗標)。對於想要空白狀態的 SDK 使用者很有用 |

149| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | 設定為 `1` 以跳過來自 SDK 建立的 MCP 伺服器的工具名稱上的 `mcp__<server>__` 前綴。工具使用其原始名稱。僅限 SDK 使用 |149| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | 設定為 `1` 以跳過來自 SDK 建立的 MCP 伺服器的工具名稱上的 `mcp__<server>__` 前綴。工具使用其原始名稱。僅限 SDK 使用 |

150| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | 背景 subagents 的停滯逾時(以毫秒為單位)。預設 `600000`(10 分鐘)。計時器在每個串流進度事件時重設;如果在視窗內沒有進度到達,subagent 會被中止,任務會標記為失敗,將任何部分結果呈現給父級 |150| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | 背景 subagents 的停滯逾時(以毫秒為單位)。預設 `600000`(10 分鐘)。計時器在每個串流進度事件時重設;如果在視窗內沒有進度到達,subagent 會被中止,任務會標記為失敗,將任何部分結果呈現給父級 |

151| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 設定自動壓縮觸發的上下文容量百分比 (1-100)。使用較低的值(如 `50`)以更早進行壓縮。此變數僅在 Claude Code 主動進行壓縮時導致更早壓縮:當設定 `CLAUDE_CODE_AUTO_COMPACT_WINDOW` 時、在 [cloud sessions](/zh-TW/claude-code-on-the-web) 中、在 [Remote Control](/zh-TW/remote-control) 工作階段中,以及在沒有 [extended context](/zh-TW/model-config#extended-context) 的 Sonnet 4.6 和 Opus 4.6 上,預設在 200K 邊界進行壓縮。在其他情況下,例如預設本機工作階段,當對話達到模型的上下文限制時,自動壓縮觸發。覆蓋只能降低閾值,因此高於預設值的值無效。適用於主要對話和 subagents |151| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 設定自動壓縮觸發的上下文容量百分比 (1-100)。使用較低的值(如 `50`)以更早進行壓縮。此變數僅在 Claude Code 主動進行壓縮時導致更早壓縮:當設定 `CLAUDE_CODE_AUTO_COMPACT_WINDOW` 時、在 [cloud sessions](/zh-TW/claude-code-on-the-web) 中、在沒有 [extended context](/zh-TW/model-config#extended-context) 的 Sonnet 4.6 和 Opus 4.6 上,預設在 200K 邊界進行壓縮。在其他情況下,例如本機工作階段,當對話達到模型的上下文限制時,自動壓縮觸發。覆蓋只能降低閾值,因此高於預設值的值無效。適用於主要對話和 subagents |

152| `CLAUDE_AUTO_BACKGROUND_TASKS` | 設定為 `1` 以強制啟用長時間執行的代理任務的自動背景執行。啟用時,subagents 在執行約兩分鐘後會移至背景 |152| `CLAUDE_AUTO_BACKGROUND_TASKS` | 設定為 `1` 以強制啟用長時間執行的代理任務的自動背景執行。啟用時,subagents 在執行約兩分鐘後會移至背景 |

153| `CLAUDE_AX_SCREEN_READER` | {/* min-version: 2.1.181 */}設定為 `1` 以呈現螢幕閱讀器友善的輸出:沒有裝飾邊框或動畫的平面文字。設定為 `0` 以強制關閉螢幕閱讀器模式,即使 [`axScreenReader`](/zh-TW/settings#available-settings) 為 `true`。[`--ax-screen-reader`](/zh-TW/cli-reference#cli-flags) 旗標優先。需要 Claude Code v2.1.181 或更新版本 |

153| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | 在主工作階段中每個 Bash 或 PowerShell 命令後返回原始工作目錄 |154| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | 在主工作階段中每個 Bash 或 PowerShell 命令後返回原始工作目錄 |

155| `CLAUDE_CLIENT_PRESENCE_FILE` | {/* min-version: 2.1.181 */}外部工具(例如螢幕鎖定監聽器)在您解鎖螢幕時建立並在您鎖定螢幕時刪除的檔案路徑。檔案存在時,Claude Code 會跳過 [Remote Control mobile push notifications](/zh-TW/remote-control#mobile-push-notifications),因此當您主動使用電腦時,您會停止收到推送。檔案不存在或無法讀取時,通知會正常發送。Claude Code 每次推送觸發事件檢查一次檔案,而不是輪詢它。需要 Claude Code v2.1.181 或更新版本 |

154| `CLAUDE_CODE_ACCESSIBILITY` | 設定為 `1` 以保持原生終端游標可見並停用反轉文字游標指示器。允許 macOS Zoom 等螢幕放大鏡追蹤游標位置 |156| `CLAUDE_CODE_ACCESSIBILITY` | 設定為 `1` 以保持原生終端游標可見並停用反轉文字游標指示器。允許 macOS Zoom 等螢幕放大鏡追蹤游標位置 |

155| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | 設定為 `1` 以從使用 `--add-dir` 指定的目錄載入記憶體檔案。載入 `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md` 和 `CLAUDE.local.md`。預設情況下,其他目錄不載入記憶體檔案 |157| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | 設定為 `1` 以從使用 `--add-dir` 指定的目錄載入記憶體檔案。載入 `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md` 和 `CLAUDE.local.md`。預設情況下,其他目錄不載入記憶體檔案 |

156| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | 設定為 `1` 以在 [fullscreen rendering](/zh-TW/fullscreen) 中的每一幀上重新繪製整個螢幕,而不是發送增量更新。如果全螢幕模式顯示過時或錯位的文字片段,請使用此選項。Claude Code 在 Windows 上的背景工作階段和 [agent view](/zh-TW/agent-view) 中自動啟用此功能 |158| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | 設定為 `1` 以在 [fullscreen rendering](/zh-TW/fullscreen) 中的每一幀上重新繪製整個螢幕,而不是發送增量更新。如果全螢幕模式顯示過時或錯位的文字片段,請使用此選項。Claude Code 在 Windows 上的背景工作階段和 [agent view](/zh-TW/agent-view) 中自動啟用此功能 |

157| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | 設定為 `1` 以在每個請求中發送 [effort](/zh-TW/model-config#adjust-effort-level) 參數,即使 Claude Code 不將模型 ID 識別為支援努力的模型。在透過 [LLM gateway](/zh-TW/llm-gateway) 或第三方提供者路由時使用,該提供者在自訂識別碼下提供模型。在 API 中拒絕努力參數的模型,包括 Claude 3 模型、Sonnet 4.0 和 4.5、Opus 4.0 和 4.1 以及 Haiku 4.5,仍被排除,以便請求不會失敗 |159| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | 設定為 `1` 以在每個請求中發送 [effort](/zh-TW/model-config#adjust-effort-level) 參數,即使 Claude Code 不將模型 ID 識別為支援努力的模型。在透過 [LLM gateway](/zh-TW/llm-gateway) 或第三方提供者路由時使用,該提供者在自訂識別碼下提供模型。在 API 中拒絕努力參數的模型,包括 Claude 3 模型、Sonnet 4.0 和 4.5、Opus 4.0 和 4.1 以及 Haiku 4.5,仍被排除,以便請求不會失敗 |

158| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 應刷新認證的間隔(以毫秒為單位)(使用 [`apiKeyHelper`](/zh-TW/settings#available-settings) 時) |160| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 應刷新認證的間隔(以毫秒為單位)(使用 [`apiKeyHelper`](/zh-TW/settings#available-settings) 時) |

161| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | 設定為 `0` 以停止 Claude Code 在發佈新 [artifact](/zh-TW/artifacts) 時自動開啟瀏覽器。重新發佈現有 artifact 無論此設定如何都不會開啟瀏覽器 |

159| `CLAUDE_CODE_ATTRIBUTION_HEADER` | 設定為 `0` 以省略系統提示開始處的歸屬區塊(用戶端版本和提示指紋)。停用它會改善透過 [LLM gateway](/zh-TW/llm-gateway) 路由時的提示快取命中率。Anthropic API 快取不受影響 |162| `CLAUDE_CODE_ATTRIBUTION_HEADER` | 設定為 `0` 以省略系統提示開始處的歸屬區塊(用戶端版本和提示指紋)。停用它會改善透過 [LLM gateway](/zh-TW/llm-gateway) 路由時的提示快取命中率。Anthropic API 快取不受影響 |

160| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 設定用於自動壓縮計算的上下文容量(以 token 為單位)。預設為模型的上下文視窗:標準模型為 200K 或 [extended context](/zh-TW/model-config#extended-context) 模型為 1M。在 1M 模型上使用較低的值(如 `500000`)以將視窗視為 500K 用於壓縮目的。該值上限為模型的實際上下文視窗。`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` 作為此值的百分比應用。設定此變數會將壓縮閾值與狀態行的 `used_percentage` 解耦,後者始終使用模型的完整上下文視窗 |163| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 設定用於自動壓縮計算的上下文容量(以 token 為單位)。預設為模型的上下文視窗:標準模型為 200K 或 [extended context](/zh-TW/model-config#extended-context) 模型為 1M。在 1M 模型上使用較低的值(如 `500000`)以將視窗視為 500K 用於壓縮目的。該值上限為模型的實際上下文視窗。`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` 作為此值的百分比應用。設定此變數會將壓縮閾值與狀態行的 `used_percentage` 解耦,後者始終使用模型的完整上下文視窗 |

161| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 覆蓋自動 [IDE connection](/zh-TW/vs-code)。預設情況下,在支援的 IDE 的整合終端內啟動時,Claude Code 會自動連線。設定為 `false` 以防止此情況。設定為 `true` 以在自動偵測失敗時強制連線嘗試,例如當 tmux 遮蔽父終端時。優先於 [`autoConnectIde`](/zh-TW/settings#global-config-settings) 全域配置設定 |164| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 覆蓋自動 [IDE connection](/zh-TW/vs-code)。預設情況下,在支援的 IDE 的整合終端內啟動時,Claude Code 會自動連線。設定為 `false` 以防止此情況。設定為 `true` 以在自動偵測失敗時強制連線嘗試,例如當 tmux 遮蔽父終端時。優先於 [`autoConnectIde`](/zh-TW/settings#global-config-settings) 全域配置設定 |


164| `CLAUDE_CODE_CLIENT_CERT` | 用於 mTLS 驗證的用戶端憑證檔案的路徑 |167| `CLAUDE_CODE_CLIENT_CERT` | 用於 mTLS 驗證的用戶端憑證檔案的路徑 |

165| `CLAUDE_CODE_CLIENT_KEY` | 用於 mTLS 驗證的用戶端私密金鑰檔案的路徑 |168| `CLAUDE_CODE_CLIENT_KEY` | 用於 mTLS 驗證的用戶端私密金鑰檔案的路徑 |

166| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 加密 CLAUDE\_CODE\_CLIENT\_KEY 的密碼(可選) |169| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 加密 CLAUDE\_CODE\_CLIENT\_KEY 的密碼(可選) |

170| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | {/* max-version: 2.1.185 */}在 v2.1.186 中移除,現在是無操作。先前設定串流 API 請求的連線、TLS 和回應標頭階段的逾時。使用 `API_TIMEOUT_MS` 進行每個請求的逾時 |

167| `CLAUDE_CODE_DEBUG_LOGS_DIR` | 覆蓋偵錯日誌檔案路徑。儘管名稱如此,這是檔案路徑,而不是目錄。需要透過 `--debug`、`/debug` 或 `DEBUG` 環境變數單獨啟用偵錯模式:僅設定此變數不會啟用日誌記錄。[`--debug-file`](/zh-TW/cli-reference#cli-flags) 旗標同時執行兩者。預設為 `~/.claude/debug/<session-id>.txt` |171| `CLAUDE_CODE_DEBUG_LOGS_DIR` | 覆蓋偵錯日誌檔案路徑。儘管名稱如此,這是檔案路徑,而不是目錄。需要透過 `--debug`、`/debug` 或 `DEBUG` 環境變數單獨啟用偵錯模式:僅設定此變數不會啟用日誌記錄。[`--debug-file`](/zh-TW/cli-reference#cli-flags) 旗標同時執行兩者。預設為 `~/.claude/debug/<session-id>.txt` |

168| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 寫入偵錯日誌檔案的最小日誌級別。值:`verbose`、`debug`(預設)、`info`、`warn`、`error`。設定為 `verbose` 以包含高容量診斷,例如完整狀態行命令輸出,或提高到 `error` 以減少雜訊 |172| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 寫入偵錯日誌檔案的最小日誌級別。值:`verbose`、`debug`(預設)、`info`、`warn`、`error`。設定為 `verbose` 以包含高容量診斷,例如完整狀態行命令輸出,或提高到 `error` 以減少雜訊 |

169| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | 設定為 `1` 以停用 [1M context window](/zh-TW/model-config#extended-context) 支援。設定時,1M 模型變體在模型選擇器中不可用。對於具有合規性要求的企業環境很有用 |173| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | 設定為 `1` 以停用 [1M context window](/zh-TW/model-config#extended-context) 支援。設定時,1M 模型變體在模型選擇器中不可用。對於具有合規性要求的企業環境很有用 |


171| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | {/* min-version: 2.1.98 */}設定為 `1` 以停用 [advisor tool](/zh-TW/advisor)。`/advisor` 命令和 `--advisor` 旗標變為不可用,任何配置的 `advisorModel` 都會被忽略。需要 Claude Code v2.1.98 或更新版本 |175| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | {/* min-version: 2.1.98 */}設定為 `1` 以停用 [advisor tool](/zh-TW/advisor)。`/advisor` 命令和 `--advisor` 旗標變為不可用,任何配置的 `advisorModel` 都會被忽略。需要 Claude Code v2.1.98 或更新版本 |

172| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | 設定為 `1` 以關閉 [background agents and agent view](/zh-TW/agent-view):`claude agents`、`--bg`、`/background` 和隨選主管。相當於 [`disableAgentView`](/zh-TW/settings#available-settings) 設定 |176| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | 設定為 `1` 以關閉 [background agents and agent view](/zh-TW/agent-view):`claude agents`、`--bg`、`/background` 和隨選主管。相當於 [`disableAgentView`](/zh-TW/settings#available-settings) 設定 |

173| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | 設定為 `1` 以停用 [fullscreen rendering](/zh-TW/fullscreen) 並使用經典主螢幕渲染器。對話保留在您終端的原生捲動回溯中,因此 `Cmd+f` 和 tmux 複製模式可以正常工作。優先於 `CLAUDE_CODE_NO_FLICKER` 和 [`tui`](/zh-TW/settings#available-settings) 設定。您也可以使用 `/tui default` 切換。不適用於從 [agent view](/zh-TW/agent-view) 開啟的背景工作階段,其始終使用全螢幕渲染 |177| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | 設定為 `1` 以停用 [fullscreen rendering](/zh-TW/fullscreen) 並使用經典主螢幕渲染器。對話保留在您終端的原生捲動回溯中,因此 `Cmd+f` 和 tmux 複製模式可以正常工作。優先於 `CLAUDE_CODE_NO_FLICKER` 和 [`tui`](/zh-TW/settings#available-settings) 設定。您也可以使用 `/tui default` 切換。不適用於從 [agent view](/zh-TW/agent-view) 開啟的背景工作階段,其始終使用全螢幕渲染 |

178| `CLAUDE_CODE_DISABLE_ARTIFACT` | 設定為 `1` 以停用 [Artifact](/zh-TW/artifacts) 工具,該工具將工作階段輸出發佈為 claude.ai 上的私人網頁。相當於 [`disableArtifact`](/zh-TW/settings#available-settings) 設定 |

174| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 設定為 `1` 以停用附件處理。使用 `@` 語法的檔案提及會作為純文字發送,而不是擴展為檔案內容 |179| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 設定為 `1` 以停用附件處理。使用 `@` 語法的檔案提及會作為純文字發送,而不是擴展為檔案內容 |

175| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | 設定為 `1` 以停用 [auto memory](/zh-TW/memory#auto-memory)。設定為 `0` 以在 `--bare` 模式或 [`autoMemoryEnabled: false`](/zh-TW/settings#available-settings) 會以其他方式停用時強制啟用自動記憶體。停用時,Claude 不會建立或載入自動記憶體檔案 |180| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | 設定為 `1` 以停用 [auto memory](/zh-TW/memory#auto-memory)。設定為 `0` 以在 `--bare` 模式或 [`autoMemoryEnabled: false`](/zh-TW/settings#available-settings) 會以其他方式停用時強制啟用自動記憶體。停用時,Claude 不會建立或載入自動記憶體檔案 |

176| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | 設定為 `1` 以停用所有背景任務功能,包括 Bash 和 subagent 工具上的 `run_in_background` 參數、自動背景執行和 Ctrl+B 快捷鍵 |181| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | 設定為 `1` 以停用所有背景任務功能,包括 Bash 和 subagent 工具上的 `run_in_background` 參數、自動背景執行和 Ctrl+B 快捷鍵 |


207| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | 設定為 `1` 以啟用 [agent teams](/zh-TW/agent-teams)。Agent teams 是實驗性的,預設停用 |212| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | 設定為 `1` 以啟用 [agent teams](/zh-TW/agent-teams)。Agent teams 是實驗性的,預設停用 |

208| `CLAUDE_CODE_EXTRA_BODY` | JSON 物件以合併到每個 API 請求主體的頂層。對於傳遞 Claude Code 不直接公開的提供者特定參數很有用 |213| `CLAUDE_CODE_EXTRA_BODY` | JSON 物件以合併到每個 API 請求主體的頂層。對於傳遞 Claude Code 不直接公開的提供者特定參數很有用 |

209| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | 覆蓋檔案讀取的預設 token 限制。當您需要完整讀取較大的檔案時很有用 |214| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | 覆蓋檔案讀取的預設 token 限制。當您需要完整讀取較大的檔案時很有用 |

210| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {/* min-version: 2.1.172 */}設定為 `1` 以強制文字記錄持久化、提示歷史記錄和 `claude agents` 註冊,即使此 `claude` 是從另一個 Claude Code 工作階段內啟動的。在繼承的 `CLAUDE_CODE_CHILD_SESSION` 值(例如來自 Claude Code 的 Bash 工具首次啟動的 tmux 伺服器)導致真正的頂層工作階段被誤分類為嵌套時使用。也在 v2.1.169 及更早版本上受尊重;對 v2.1.170 和 v2.1.171 無效,其中它覆蓋的嵌套工作階段偵測被移除 |215| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {/* min-version: 2.1.172 */}設定為 `1` 以強制文字記錄持久化、提示歷史記錄和 `claude agents` 註冊,即使此 `claude` 是從另一個 Claude Code 工作階段內啟動的。在繼承的 `CLAUDE_CODE_CHILD_SESSION` 值(例如來自 Claude Code 的 Bash 工具首次啟動的 tmux 伺服器)導致真正的頂層工作階段被誤分類為嵌套時使用。{/* min-version: 2.1.178 */}自 v2.1.178 起,Claude Code 會自動偵測 tmux 情況並忽略繼承的標記,因此 tmux 不再需要此變數。也在 v2.1.169 及更早版本上受尊重;對 v2.1.170 和 v2.1.171 無效,其中它覆蓋的嵌套工作階段偵測被移除 |

216| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | {/* min-version: 2.1.186 */}設定為 `1` 以在您的終端支援但未自動偵測時強制刪除線呈現 `~~text~~`,例如透過 SSH 而未轉發 `TERM_PROGRAM`。沒有此選項,未偵測的終端會顯示文字刪除線標記而不是呈現為刪除線。需要 Claude Code v2.1.186 或更新版本 |

211| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 設定為 `1` 以強制啟用 DEC 私有模式 2026 [synchronized output](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)(當您的終端支援但未自動偵測時)。對於實現 BSU/ESU 但不回覆功能探測的模擬器(例如 Emacs `eat`)很有用。在 tmux 下無效 |217| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 設定為 `1` 以強制啟用 DEC 私有模式 2026 [synchronized output](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)(當您的終端支援但未自動偵測時)。對於實現 BSU/ESU 但不回覆功能探測的模擬器(例如 Emacs `eat`)很有用。在 tmux 下無效 |

212| `CLAUDE_CODE_FORK_SUBAGENT` | 設定為 `1` 以啟用 [forked subagents](/zh-TW/sub-agents#fork-the-current-conversation) 作為模型的預設值,或 `0` 以停用它們,覆蓋任何伺服器端推出。啟用時,Claude 會生成一個分叉(一個繼承完整對話上下文而不是從頭開始的 subagent而不是使用通用 subagent,所有 subagent 生成都在背景中執行。明確的 [`/fork`](/zh-TW/commands) 命令無需此變數即可工作。在互動式模式和透過 SDK 或 `claude -p` 中工作 |218| `CLAUDE_CODE_FORK_SUBAGENT` | 設定為 `1` 以啟用 Claude 生成 [forked subagents](/zh-TW/sub-agents#fork-the-current-conversation),或 `0` 以停用它們,覆蓋任何伺服器端推出。啟用時,Claude 可以要求 `fork` subagent 類型以生成分叉一個繼承完整對話上下文而不是從頭開始的 subagent。沒有 subagent 類型的生成仍使用通用 subagent,所有 subagent 生成都在背景中執行。明確的 [`/fork`](/zh-TW/commands) 命令無需此變數即可工作。在互動式模式和透過 SDK 或 `claude -p` 中工作 |

213| `CLAUDE_CODE_GIT_BASH_PATH` | 僅限 Windows:Git Bash 可執行檔(`bash.exe`)的路徑。在 Git Bash 已安裝但不在您的 PATH 中時使用。請參閱 [Windows setup](/zh-TW/setup#set-up-on-windows) |219| `CLAUDE_CODE_GIT_BASH_PATH` | 僅限 Windows:Git Bash 可執行檔(`bash.exe`)的路徑。在 Git Bash 已安裝但不在您的 PATH 中時使用。請參閱 [Windows setup](/zh-TW/setup#set-up-on-windows) |

214| `CLAUDE_CODE_GLOB_HIDDEN` | 設定為 `false` 以在 Claude 呼叫 [Glob tool](/zh-TW/tools-reference#glob-tool-behavior) 時從結果中排除隱藏檔案。預設包含。不影響 `@` 檔案自動完成、`ls`、Grep 或 Read |220| `CLAUDE_CODE_GLOB_HIDDEN` | 設定為 `false` 以在 Claude 呼叫 [Glob tool](/zh-TW/tools-reference#glob-tool-behavior) 時從結果中排除隱藏檔案。預設包含。不影響 `@` 檔案自動完成、`ls`、Grep 或 Read |

215| `CLAUDE_CODE_GLOB_NO_IGNORE` | 設定為 `false` 以使 [Glob tool](/zh-TW/tools-reference#glob-tool-behavior) 尊重 `.gitignore` 模式。預設情況下,Glob 返回所有符合的檔案,包括 gitignored 的檔案。不影響 `@` 檔案自動完成,其具有自己的 [`respectGitignore` 設定](/zh-TW/settings#available-settings) |221| `CLAUDE_CODE_GLOB_NO_IGNORE` | 設定為 `false` 以使 [Glob tool](/zh-TW/tools-reference#glob-tool-behavior) 尊重 `.gitignore` 模式。預設情況下,Glob 返回所有符合的檔案,包括 gitignored 的檔案。不影響 `@` 檔案自動完成,其具有自己的 [`respectGitignore` 設定](/zh-TW/settings#available-settings) |


220| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 設定為 `1` 以跳過連線期間 IDE 鎖定檔案項目的驗證。當自動連線無法找到您的 IDE(儘管它正在執行)時使用 |226| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 設定為 `1` 以跳過連線期間 IDE 鎖定檔案項目的驗證。當自動連線無法找到您的 IDE(儘管它正在執行)時使用 |

221| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 覆蓋 Claude Code 假設用於作用中模型的上下文視窗大小。僅在同時設定 `DISABLE_COMPACT` 時生效。當透過 `ANTHROPIC_BASE_URL` 路由到模型時使用,其上下文視窗與其名稱的內建大小不符 |227| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 覆蓋 Claude Code 假設用於作用中模型的上下文視窗大小。僅在同時設定 `DISABLE_COMPACT` 時生效。當透過 `ANTHROPIC_BASE_URL` 路由到模型時使用,其上下文視窗與其名稱的內建大小不符 |

222| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 設定大多數請求的最大輸出 token 數。預設值和上限因模型而異;請參閱 [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)。增加此值會減少在 [auto-compaction](/zh-TW/costs#reduce-token-usage) 觸發之前可用的有效上下文視窗。 |228| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 設定大多數請求的最大輸出 token 數。預設值和上限因模型而異;請參閱 [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)。增加此值會減少在 [auto-compaction](/zh-TW/costs#reduce-token-usage) 觸發之前可用的有效上下文視窗。 |

223| `CLAUDE_CODE_MAX_RETRIES` | 覆蓋重試失敗 API 請求的次數(預設值:10) |229| `CLAUDE_CODE_MAX_RETRIES` | 覆蓋重試失敗 API 請求的次數(預設值:10)。{/* min-version: 2.1.186 */}自 v2.1.186 起上限為 15。對於需要等待較長中斷的無人值守工作階段,請改為設定 `CLAUDE_CODE_RETRY_WATCHDOG` |

224| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 可以並行執行的唯讀工具和 subagents 的最大數量(預設值:10)。較高的值會增加並行性,但消耗更多資源 |230| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 可以並行執行的唯讀工具和 subagents 的最大數量(預設值:10)。較高的值會增加並行性,但消耗更多資源 |

225| `CLAUDE_CODE_MAX_TURNS` | 當未傳遞明確限制時,限制代理回合的數量。相當於傳遞 [`--max-turns`](/zh-TW/cli-reference#cli-flags),當兩者都設定時優先。不是正整數的值在啟動時會被拒絕並出現錯誤,而不是被視為無限制 |231| `CLAUDE_CODE_MAX_TURNS` | 當未傳遞明確限制時,限制代理回合的數量。相當於傳遞 [`--max-turns`](/zh-TW/cli-reference#cli-flags),當兩者都設定時優先。不是正整數的值在啟動時會被拒絕並出現錯誤,而不是被視為無限制 |

226| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | 設定為 `1` 以使用僅安全基線環境加上伺服器配置的 `env` 而不是繼承您的 shell 環境來生成 stdio MCP 伺服器 |232| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | 設定為 `1` 以使用僅安全基線環境加上伺服器配置的 `env` 而不是繼承您的 shell 環境來生成 stdio MCP 伺服器 |


231| `CLAUDE_CODE_OAUTH_SCOPES` | 重新整理權杖發出時所使用的空格分隔 OAuth 範圍,例如 `"user:profile user:inference user:sessions:claude_code"`。設定 `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 時為必需 |237| `CLAUDE_CODE_OAUTH_SCOPES` | 重新整理權杖發出時所使用的空格分隔 OAuth 範圍,例如 `"user:profile user:inference user:sessions:claude_code"`。設定 `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 時為必需 |

232| `CLAUDE_CODE_OAUTH_TOKEN` | Claude.ai 驗證的 OAuth 存取權杖。`/login` 對於 SDK 和自動化環境的替代方案。優先於鑰匙圈儲存的認證。使用 [`claude setup-token`](/zh-TW/authentication#generate-a-long-lived-token) 產生一個 |238| `CLAUDE_CODE_OAUTH_TOKEN` | Claude.ai 驗證的 OAuth 存取權杖。`/login` 對於 SDK 和自動化環境的替代方案。優先於鑰匙圈儲存的認證。使用 [`claude setup-token`](/zh-TW/authentication#generate-a-long-lived-token) 產生一個 |

233| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}在 v2.1.160 中移除,現在是無操作。先前將 [fast mode](/zh-TW/fast-mode) 固定到 Claude Opus 4.6,而不是目前的預設值。若要在 Opus 4.6 停用之前在其上執行快速模式,請先使用 `/model` 選擇模型,然後 `/fast on` |239| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}在 v2.1.160 中移除,現在是無操作。先前將 [fast mode](/zh-TW/fast-mode) 固定到 Claude Opus 4.6,而不是目前的預設值。若要在 Opus 4.6 停用之前在其上執行快速模式,請先使用 `/model` 選擇模型,然後 `/fast on` |

240| `CLAUDE_CODE_OTEL_DIAG_STDERR` | {/* min-version: 2.1.179 */}設定為 `1` 以將 OpenTelemetry 匯出器診斷錯誤寫入 stderr。預設情況下,這些錯誤僅在 `--debug` 時出現,因此配置不當的匯出器(例如 Prometheus 連接埠衝突)會以其他方式無聲失敗。需要 Claude Code v2.1.179 或更新版本。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

234| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 刷新待處理 OpenTelemetry spans 的逾時(以毫秒為單位)(預設值:5000)。請參閱 [Monitoring](/zh-TW/monitoring-usage) |241| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 刷新待處理 OpenTelemetry spans 的逾時(以毫秒為單位)(預設值:5000)。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

235| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 刷新動態 OpenTelemetry 標頭的間隔(以毫秒為單位)(預設值:1740000 / 29 分鐘)。請參閱 [Dynamic headers](/zh-TW/monitoring-usage#dynamic-headers) |242| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 刷新動態 OpenTelemetry 標頭的間隔(以毫秒為單位)(預設值:1740000 / 29 分鐘)。請參閱 [Dynamic headers](/zh-TW/monitoring-usage#dynamic-headers) |

236| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry 匯出器在關閉時完成的逾時(以毫秒為單位)(預設值:2000)。如果指標在退出時被丟棄,請增加此值。請參閱 [Monitoring](/zh-TW/monitoring-usage) |243| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry 匯出器在關閉時完成的逾時(以毫秒為單位)(預設值:2000)。如果指標在退出時被丟棄,請增加此值。請參閱 [Monitoring](/zh-TW/monitoring-usage) |


242| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | 設定為 `1` 以透過 HTTPS 而不是 SSH 複製 GitHub `owner/repo` 外掛程式來源。在 CI 執行器、容器或任何沒有為 `github.com` 配置 SSH 金鑰的環境中很有用 |249| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | 設定為 `1` 以透過 HTTPS 而不是 SSH 複製 GitHub `owner/repo` 外掛程式來源。在 CI 執行器、容器或任何沒有為 `github.com` 配置 SSH 金鑰的環境中很有用 |

243| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 一個或多個唯讀外掛程式種子目錄的路徑,在 Unix 上以 `:` 分隔,在 Windows 上以 `;` 分隔。使用此選項可將預先填充的外掛程式目錄捆綁到容器映像中。Claude Code 在啟動時從這些目錄註冊市場,並使用預先快取的外掛程式而無需重新複製。請參閱 [Pre-populate plugins for containers](/zh-TW/plugin-marketplaces#pre-populate-plugins-for-containers) |250| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 一個或多個唯讀外掛程式種子目錄的路徑,在 Unix 上以 `:` 分隔,在 Windows 上以 `;` 分隔。使用此選項可將預先填充的外掛程式目錄捆綁到容器映像中。Claude Code 在啟動時從這些目錄註冊市場,並使用預先快取的外掛程式而無需重新複製。請參閱 [Pre-populate plugins for containers](/zh-TW/plugin-marketplaces#pre-populate-plugins-for-containers) |

244| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 設定為 `1` 以停止 Claude Code 在生成 PowerShell 以進行工具呼叫、hooks 和狀態行命令時傳遞 `-ExecutionPolicy Bypass`,並改為尊重機器的有效執行政策。預設情況下,Claude Code 在程序範圍內繞過執行政策,以便 `.ps1` 指令碼和模組匯入在預設受限的 Windows 安裝上工作。無論此設定如何,程序範圍繞過永遠不會覆蓋群組原則 `MachinePolicy` 或 `UserPolicy` |251| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 設定為 `1` 以停止 Claude Code 在生成 PowerShell 以進行工具呼叫、hooks 和狀態行命令時傳遞 `-ExecutionPolicy Bypass`,並改為尊重機器的有效執行政策。預設情況下,Claude Code 在程序範圍內繞過執行政策,以便 `.ps1` 指令碼和模組匯入在預設受限的 Windows 安裝上工作。無論此設定如何,程序範圍繞過永遠不會覆蓋群組原則 `MachinePolicy` 或 `UserPolicy` |

252| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}[非互動式模式](/zh-TW/headless#background-tasks-at-exit)使用 `-p` 旗標在最終回合後等待的最大時間(以毫秒為單位),用於背景 subagents 和工作流程,其結果是輸出的一部分。預設值:`600000`,或 10 分鐘。超過上限時,剩餘背景任務會被終止,程序會退出。設定為 `0` 以無限期等待。此上限與適用於純背景 shells 的 5 秒寬限期分開 |

245| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}設定為 `1` 以在 `ANTHROPIC_BASE_URL` 指向自訂代理時傳播 W3C 追蹤上下文。傳播涵蓋模型和 HTTP MCP 請求上的 `traceparent` 標頭以及 Bash、PowerShell 和 hook 子程序的 `TRACEPARENT` 環境變數。預設情況下,傳播僅在直接連線到 Anthropic API 時啟用。在 v2.1.152 中新增。請參閱 [Traces (beta)](/zh-TW/monitoring-usage#traces-beta) |253| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}設定為 `1` 以在 `ANTHROPIC_BASE_URL` 指向自訂代理時傳播 W3C 追蹤上下文。傳播涵蓋模型和 HTTP MCP 請求上的 `traceparent` 標頭以及 Bash、PowerShell 和 hook 子程序的 `TRACEPARENT` 環境變數。預設情況下,傳播僅在直接連線到 Anthropic API 時啟用。在 v2.1.152 中新增。請參閱 [Traces (beta)](/zh-TW/monitoring-usage#traces-beta) |

246| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | 由嵌入 Claude Code 並代表其管理模型提供者路由的主機平台設定。設定時,提供者選擇、端點和驗證變數(例如 `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL` 和 `ANTHROPIC_API_KEY`)在設定檔案中被忽略,以便使用者設定無法覆蓋主機的路由。Bedrock、Vertex 和 Foundry 的自動遙測選擇退出也會被跳過,因此遙測遵循標準 `DISABLE_TELEMETRY` 選擇退出。請參閱 [Default behaviors by API provider](/zh-TW/data-usage#default-behaviors-by-api-provider) |254| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | 由嵌入 Claude Code 並代表其管理模型提供者路由的主機平台設定。設定時,提供者選擇、端點和驗證變數(例如 `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL` 和 `ANTHROPIC_API_KEY`)在設定檔案中被忽略,以便使用者設定無法覆蓋主機的路由。Bedrock、Vertex 和 Foundry 的自動遙測選擇退出也會被跳過,因此遙測遵循標準 `DISABLE_TELEMETRY` 選擇退出。請參閱 [Default behaviors by API provider](/zh-TW/data-usage#default-behaviors-by-api-provider) |

247| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | 設定為 `1` 以允許代理執行 DNS 解析而不是呼叫者。對於代理應處理主機名稱解析的環境選擇加入 |255| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | 設定為 `1` 以允許代理執行 DNS 解析而不是呼叫者。對於代理應處理主機名稱解析的環境選擇加入 |

248| `CLAUDE_CODE_REMOTE` | 當 Claude Code 作為 [cloud session](/zh-TW/claude-code-on-the-web) 執行時自動設定為 `true`。從 hook 或設定指令碼讀取此項以偵測您是否在雲端環境中 |256| `CLAUDE_CODE_REMOTE` | 當 Claude Code 作為 [cloud session](/zh-TW/claude-code-on-the-web) 執行時自動設定為 `true`。從 hook 或設定指令碼讀取此項以偵測您是否在雲端環境中 |

249| `CLAUDE_CODE_REMOTE_SESSION_ID` | 在 [cloud sessions](/zh-TW/claude-code-on-the-web) 中自動設定為目前工作階段的 ID。讀取此項以構造回到工作階段文字記錄的連結。請參閱 [Link artifacts back to the session](/zh-TW/claude-code-on-the-web#link-artifacts-back-to-the-session) |257| `CLAUDE_CODE_REMOTE_SESSION_ID` | 在 [cloud sessions](/zh-TW/claude-code-on-the-web) 中自動設定為目前工作階段的 ID。讀取此項以構造回到工作階段文字記錄的連結。請參閱 [Link output back to the session](/zh-TW/claude-code-on-the-web#link-output-back-to-the-session) |

250| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 設定為 `1` 以在上一個工作階段在中途結束時自動繼續。在 SDK 模式中使用,以便模型繼續而無需 SDK 重新發送提示 |258| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 設定為 `1` 以在上一個工作階段在中途結束時自動繼續。在 SDK 模式中使用,以便模型繼續而無需 SDK 重新發送提示 |

251| `CLAUDE_CODE_RESUME_PROMPT` | 覆蓋在繼續在中途結束的工作階段時注入的延續訊息。預設為 `Continue from where you left off.`。長時間執行的代理的生成指令碼可以將此設定為更具指令性的啟動訊息。空字串使用預設值 |259| `CLAUDE_CODE_RESUME_PROMPT` | 覆蓋在繼續在中途結束的工作階段時注入的延續訊息。預設為 `Continue from where you left off.`。長時間執行的代理的生成指令碼可以將此設定為更具指令性的啟動訊息。空字串使用預設值 |

260| `CLAUDE_CODE_RETRY_WATCHDOG` | {/* min-version: 2.1.186 */}設定為 `1` 用於無人值守工作階段,例如評估工具、CI 工作或遠端工作者。無限期重試 `429` 和 `529` 容量錯誤,而不是在 `CLAUDE_CODE_MAX_RETRIES` 嘗試後失敗。監視程式在嘗試之間退避最多 5 分鐘,或直到限制在回應帶有速率限制重設時間時重設,因此達到使用限制的工作階段會等待剩餘視窗。需要 Claude Code v2.1.186 或更新版本 |

252| `CLAUDE_CODE_SAFE_MODE` | 設定為 `1` 以在安全模式下啟動:CLAUDE.md、skills、plugins、hooks、MCP 伺服器、自訂命令和代理、輸出樣式、工作流程、自訂主題、自訂快捷鍵、狀態行和檔案建議命令、LSP 伺服器和自動記憶體不載入,用於對損壞的配置進行故障排除。受管設定政策仍然適用,包括政策配置的 hooks、狀態行和檔案建議命令;受管外掛程式、受管 skills、受管 CLAUDE.md 和政策配置的 MCP 伺服器不適用。相當於傳遞 [`--safe-mode`](/zh-TW/cli-reference#cli-flags)。直接生成的子程序繼承該變數 |261| `CLAUDE_CODE_SAFE_MODE` | 設定為 `1` 以在安全模式下啟動:CLAUDE.md、skills、plugins、hooks、MCP 伺服器、自訂命令和代理、輸出樣式、工作流程、自訂主題、自訂快捷鍵、狀態行和檔案建議命令、LSP 伺服器和自動記憶體不載入,用於對損壞的配置進行故障排除。受管設定政策仍然適用,包括政策配置的 hooks、狀態行和檔案建議命令;受管外掛程式、受管 skills、受管 CLAUDE.md 和政策配置的 MCP 伺服器不適用。相當於傳遞 [`--safe-mode`](/zh-TW/cli-reference#cli-flags)。直接生成的子程序繼承該變數 |

253| `CLAUDE_CODE_SCRIPT_CAPS` | JSON 物件,當設定 `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` 時限制特定指令碼在每個工作階段中可被呼叫的次數。鍵是針對命令文字進行比對的子字串;值是整數呼叫限制。例如,`{"deploy.sh": 2}` 允許 `deploy.sh` 最多被呼叫兩次。比對是基於子字串的,因此 shell 擴展技巧(如 `./scripts/deploy.sh $(evil)`)仍然計入上限。透過 `xargs` 或 `find -exec` 的執行時扇出未被偵測;這是深度防禦控制 |262| `CLAUDE_CODE_SCRIPT_CAPS` | JSON 物件,當設定 `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` 時限制特定指令碼在每個工作階段中可被呼叫的次數。鍵是針對命令文字進行比對的子字串;值是整數呼叫限制。例如,`{"deploy.sh": 2}` 允許 `deploy.sh` 最多被呼叫兩次。比對是基於子字串的,因此 shell 擴展技巧(如 `./scripts/deploy.sh $(evil)`)仍然計入上限。透過 `xargs` 或 `find -exec` 的執行時扇出未被偵測;這是深度防禦控制 |

254| `CLAUDE_CODE_SCROLL_SPEED` | 在 [fullscreen rendering](/zh-TW/fullscreen#mouse-wheel-scrolling) 中設定滑鼠滾輪捲動乘數。接受 1 到 20 的值,以及低於 1 的分數值(例如 `0.5`)以減慢終端上原生捲動路徑中加速的觸控板和滾輪捲動。設定為 `3` 以符合 `vim`(如果您的終端在沒有放大的情況下每個刻度發送一個滾輪事件)。在 JetBrains IDE 終端中被忽略,Claude Code 使用其自己的捲動處理 |263| `CLAUDE_CODE_SCROLL_SPEED` | 在 [fullscreen rendering](/zh-TW/fullscreen#mouse-wheel-scrolling) 中設定滑鼠滾輪捲動乘數。接受 1 到 20 的值,以及低於 1 的分數值(例如 `0.5`)以減慢終端上原生捲動路徑中加速的觸控板和滾輪捲動。設定為 `3` 以符合 `vim`(如果您的終端在沒有放大的情況下每個刻度發送一個滾輪事件)。在 JetBrains IDE 終端中被忽略,Claude Code 使用其自己的捲動處理 |


316| `DISABLE_UPDATES` | 設定為 `1` 以阻止所有更新,包括手動 `claude update` 和 `claude install`。比 `DISABLE_AUTOUPDATER` 更嚴格。在透過您自己的管道分發 Claude Code 且使用者不應自行更新時使用 |325| `DISABLE_UPDATES` | 設定為 `1` 以阻止所有更新,包括手動 `claude update` 和 `claude install`。比 `DISABLE_AUTOUPDATER` 更嚴格。在透過您自己的管道分發 Claude Code 且使用者不應自行更新時使用 |

317| `DISABLE_UPGRADE_COMMAND` | 設定為 `1` 以隱藏 `/upgrade` 命令 |326| `DISABLE_UPGRADE_COMMAND` | 設定為 `1` 以隱藏 `/upgrade` 命令 |

318| `DO_NOT_TRACK` | 設定為 `1` 以選擇退出遙測。相當於設定 `DISABLE_TELEMETRY`。Claude Code 尊重此作為許多開發者 CLI 認可的跨工具慣例 |327| `DO_NOT_TRACK` | 設定為 `1` 以選擇退出遙測。相當於設定 `DISABLE_TELEMETRY`。Claude Code 尊重此作為許多開發者 CLI 認可的跨工具慣例 |

319| `ENABLE_CLAUDEAI_MCP_SERVERS` | 設定為 `false` 以停用 Claude Code 中的 [claude.ai MCP servers](/zh-TW/mcp#use-mcp-servers-from-claude-ai)。對於已登入的使用者預設啟用 |328| `ENABLE_CLAUDEAI_MCP_SERVERS` | 設定為 `false` 以停用 Claude Code 中的 [claude.ai MCP servers](/zh-TW/mcp#use-mcp-servers-from-claude-ai)。對於已登入的使用者預設啟用。若要按專案或按組織停用,請改為在設定中設定 [`disableClaudeAiConnectors`](/zh-TW/settings#available-settings) |

320| `ENABLE_PROMPT_CACHING_1H` | 設定為 `1` 以要求 1 小時的提示快取 TTL,而不是預設的 5 分鐘。適用於 API 金鑰、[Bedrock](/zh-TW/amazon-bedrock)、[Vertex](/zh-TW/google-vertex-ai)、[Foundry](/zh-TW/microsoft-foundry) 和 [Claude Platform on AWS](/zh-TW/claude-platform-on-aws) 使用者。訂閱使用者自動接收 1 小時 TTL。1 小時快取寫入以更高的速率計費 |329| `ENABLE_PROMPT_CACHING_1H` | 設定為 `1` 以要求 1 小時的提示快取 TTL,而不是預設的 5 分鐘。適用於 API 金鑰、[Bedrock](/zh-TW/amazon-bedrock)、[Vertex](/zh-TW/google-vertex-ai)、[Foundry](/zh-TW/microsoft-foundry) 和 [Claude Platform on AWS](/zh-TW/claude-platform-on-aws) 使用者。訂閱使用者自動接收 1 小時 TTL。1 小時快取寫入以更高的速率計費 |

321| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 已棄用。改用 `ENABLE_PROMPT_CACHING_1H` |330| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 已棄用。改用 `ENABLE_PROMPT_CACHING_1H` |

322| `ENABLE_TOOL_SEARCH` | 控制 [MCP tool search](/zh-TW/mcp#scale-with-mcp-tool-search)。未設定:預設所有 MCP 工具延遲,但在 Vertex AI 上或當 `ANTHROPIC_BASE_URL` 指向非第一方主機時提前載入。值:`true`(始終延遲並發送 beta 標頭,在 Vertex AI 或不支援 `tool_reference` 的代理上請求失敗)、`auto`(閾值模式:如果工具符合上下文的 10% 內則提前載入)、`auto:N`(自訂閾值,例如 `auto:5` 表示 5%)、`false`(提前載入全部) |331| `ENABLE_TOOL_SEARCH` | 控制 [MCP tool search](/zh-TW/mcp#scale-with-mcp-tool-search)。未設定:預設所有 MCP 工具延遲,但在 Vertex AI 上或當 `ANTHROPIC_BASE_URL` 指向非第一方主機時提前載入。值:`true`(始終延遲並發送 beta 標頭,在 Vertex AI 或不支援 `tool_reference` 的代理上請求失敗)、`auto`(閾值模式:如果工具符合上下文的 10% 內則提前載入)、`auto:N`(自訂閾值,例如 `auto:5` 表示 5%)、`false`(提前載入全部) |


340| `NO_PROXY` | 要直接發出請求的網域和 IP 清單,繞過代理 |349| `NO_PROXY` | 要直接發出請求的網域和 IP 清單,繞過代理 |

341| `OTEL_LOG_RAW_API_BODIES` | 設定為 `1` 以將完整的 Anthropic Messages API 請求和回應 JSON 作為 `api_request_body` / `api_response_body` 日誌事件發出(在 60 KB 處截斷),或 `file:<dir>` 以將未截斷的主體寫入磁碟並發出 `body_ref` 路徑。預設停用;主體包括整個對話歷史記錄。請參閱 [Monitoring](/zh-TW/monitoring-usage#api-request-body-event) |350| `OTEL_LOG_RAW_API_BODIES` | 設定為 `1` 以將完整的 Anthropic Messages API 請求和回應 JSON 作為 `api_request_body` / `api_response_body` 日誌事件發出(在 60 KB 處截斷),或 `file:<dir>` 以將未截斷的主體寫入磁碟並發出 `body_ref` 路徑。預設停用;主體包括整個對話歷史記錄。請參閱 [Monitoring](/zh-TW/monitoring-usage#api-request-body-event) |

342| `OTEL_LOG_TOOL_CONTENT` | 設定為 `1` 以在 OpenTelemetry span 事件中包含工具輸入和輸出內容。預設停用以保護敏感資料。請參閱 [Monitoring](/zh-TW/monitoring-usage) |351| `OTEL_LOG_TOOL_CONTENT` | 設定為 `1` 以在 OpenTelemetry span 事件中包含工具輸入和輸出內容。預設停用以保護敏感資料。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

343| `OTEL_LOG_TOOL_DETAILS` | 設定為 `1` 以在 OpenTelemetry 追蹤和日誌中包含工具輸入引數、MCP 伺服器名稱、工具失敗時的原始錯誤字串和其他工具詳細資訊。預設停用以保護個人識別資訊。請參閱 [Monitoring](/zh-TW/monitoring-usage) |352| `OTEL_LOG_TOOL_DETAILS` | 設定為 `1` 以在 OpenTelemetry 追蹤和日誌中包含工具輸入引數、MCP 伺服器名稱、工具失敗時的原始錯誤字串、`api_refusal` 事件上的拒絕 `category` 和其他工具詳細資訊。預設停用以保護個人識別資訊。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

344| `OTEL_LOG_USER_PROMPTS` | 設定為 `1` 以在 OpenTelemetry 追蹤和日誌中包含使用者提示文字。預設停用(提示被編輯)。請參閱 [Monitoring](/zh-TW/monitoring-usage) |353| `OTEL_LOG_USER_PROMPTS` | 設定為 `1` 以在 OpenTelemetry 追蹤和日誌中包含使用者提示文字。預設停用(提示被編輯)。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

345| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | 設定為 `false` 以從指標屬性中排除帳戶 UUID(預設值:包含)。請參閱 [Monitoring](/zh-TW/monitoring-usage) |354| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | 設定為 `false` 以從指標屬性中排除帳戶 UUID(預設值:包含)。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

346| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}設定為 `true` 以在指標屬性中包含工作階段進入點(預設值:排除)。在 v2.1.152 中新增。請參閱 [Monitoring](/zh-TW/monitoring-usage) |355| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}設定為 `true` 以在指標屬性中包含工作階段進入點(預設值:排除)。在 v2.1.152 中新增。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

errors.md +7 −3

Details

43| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |43| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |

44| `does not meet scope requirement user:profile` | [Authentication](#oauth-scope-requirement) |44| `does not meet scope requirement user:profile` | [Authentication](#oauth-scope-requirement) |

45| `Unable to connect to API` | [Network](#unable-to-connect-to-api) |45| `Unable to connect to API` | [Network](#unable-to-connect-to-api) |

46| `Waiting for API response · will retry in` | [Automatic retries](#automatic-retries),或如果持續發生,則為 [Network](#unable-to-connect-to-api) |

46| `SSL certificate verification failed` | [Network](#ssl-certificate-errors) |47| `SSL certificate verification failed` | [Network](#ssl-certificate-errors) |

47| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Network](#host-not-allowed-in-a-cloud-session) |48| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Network](#host-not-allowed-in-a-cloud-session) |

48| `Prompt is too long` | [Request errors](#prompt-is-too-long) |49| `Prompt is too long` | [Request errors](#prompt-is-too-long) |


66 67 

67Claude Code 在向您顯示錯誤之前會重試暫時性失敗。伺服器錯誤、過載回應、請求逾時、臨時 429 節流和中斷的連線都會以指數退避方式重試最多 10 次。重試時,微調器會顯示 `Retrying in Ns · attempt x/y` 倒數計時。68Claude Code 在向您顯示錯誤之前會重試暫時性失敗。伺服器錯誤、過載回應、請求逾時、臨時 429 節流和中斷的連線都會以指數退避方式重試最多 10 次。重試時,微調器會顯示 `Retrying in Ns · attempt x/y` 倒數計時。

68 69 

69當您看到本頁上的其中一個錯誤時這些重試已經用盡您可以使用兩個環境變數調整行為70{/* min-version: 2.1.185 */}如果在請求仍待處理時回應串流上 20 秒內沒有資料到達,微調器會在任何重試開始之前顯示 `Waiting for API response · will retry in … · check your network`請求尚未失敗倒數計時會執行到 Claude Code 中止停滯連線並重試的位置,因此一旦資料恢復或重試成功,橫幅就會自動清除。自 v2.1.185 起,閾值為 20 秒;較早的版本會在 10 秒後顯示橫幅,措辭不同。如果它在每次嘗試時都重新出現,請將其視為[網路問題](#unable-to-connect-to-api)。

71 

72當您看到本頁上的其中一個錯誤時,這些重試已經用盡。您可以使用這些環境變數調整行為:

70 73 

71| 變數 | 預設值 | 效果 |74| 變數 | 預設值 | 效果 |

72| :------------------------------------------- | :----- | :--------------------------------- |75| :---------------------------------------------- | :----- | :----------------------------------------------------------------------------------------- |

73| [`CLAUDE_CODE_MAX_RETRIES`](/zh-TW/env-vars) | 10 | 重試次數。降低它以在指令碼中更快地顯示失敗;提高它以等待更長的事件 |76| [`CLAUDE_CODE_MAX_RETRIES`](/zh-TW/env-vars) | 10 | 重試次數。{/* min-version: 2.1.186 */}自 v2.1.186 起上限為 15。降低它以在指令碼中更快地顯示失敗。 |

77| [`CLAUDE_CODE_RETRY_WATCHDOG`](/zh-TW/env-vars) | 未設定 | 在 CI 工作等無人值守的工作階段中設定為 `1`,以無限期重試 `429` 和 `529` 容量錯誤,而不是在 `CLAUDE_CODE_MAX_RETRIES` 次嘗試後失敗。 |

74| [`API_TIMEOUT_MS`](/zh-TW/env-vars) | 600000 | 每個請求的逾時(毫秒)。為慢速網路或代理提高它。 |78| [`API_TIMEOUT_MS`](/zh-TW/env-vars) | 600000 | 每個請求的逾時(毫秒)。為慢速網路或代理提高它。 |

75 79 

76<h2 id="server-errors">80<h2 id="server-errors">

Details

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

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

48| **Hook** | 由事件觸發的指令碼、HTTP 請求、提示或 subagent | 必須在每個匹配事件上運行的自動化 | 在每次檔案編輯後運行 ESLint |48| **Hook** | 由事件觸發的指令碼、HTTP 請求、提示或 subagent | 必須在每個匹配事件上運行的自動化 | 在每次檔案編輯後運行 ESLint |

49| **[Artifact](/zh-TW/artifacts)** | 將會話輸出發佈為私人、互動式網頁 | 您想以視覺方式查看或共享的輸出,而不是作為終端文字 | 隨著 Claude 進行調查而更新的事件時間表 |

49 50 

50**[Plugins](/zh-TW/plugins)** 是打包層。Plugin 將 skills、hooks、subagents 和 MCP servers 捆綁到單個可安裝單元中。Plugin skills 是命名空間的(如 `/my-plugin:review`),因此多個 plugins 可以共存。當您想在多個儲存庫中重複使用相同的設置或通過 **[marketplace](/zh-TW/plugin-marketplaces)** 分發給他人時,使用 plugins。51**[Plugins](/zh-TW/plugins)** 是打包層。Plugin 將 skills、hooks、subagents 和 MCP servers 捆綁到單個可安裝單元中。Plugin skills 是命名空間的(如 `/my-plugin:review`),因此多個 plugins 可以共存。當您想在多個儲存庫中重複使用相同的設置或通過 **[marketplace](/zh-TW/plugin-marketplaces)** 分發給他人時,使用 plugins。

51 52 

fullscreen.md +2 −2

Details

44| :--------------------- | :-------------------------------------- | :--------------------------------------------- |44| :--------------------- | :-------------------------------------- | :--------------------------------------------- |

45| `Cmd+f` 或 tmux 搜尋來尋找文字 | `Ctrl+o` 進入文字記錄模式,然後 `/` 搜尋或 `[` 寫入捲動回溯 | [搜尋和檢閱對話](#search-and-review-the-conversation) |45| `Cmd+f` 或 tmux 搜尋來尋找文字 | `Ctrl+o` 進入文字記錄模式,然後 `/` 搜尋或 `[` 寫入捲動回溯 | [搜尋和檢閱對話](#search-and-review-the-conversation) |

46| 終端的原生點擊並拖曳來選擇和複製 | 應用程式內選擇,在滑鼠釋放時自動複製 | [使用滑鼠](#use-the-mouse) |46| 終端的原生點擊並拖曳來選擇和複製 | 應用程式內選擇,在滑鼠釋放時自動複製 | [使用滑鼠](#use-the-mouse) |

47| `Cmd` 點擊來開啟 URL | 點擊 URL | [使用滑鼠](#use-the-mouse) |47| `Cmd` 點擊來開啟 URL | macOS 上的 `Cmd` 點擊,其他地方的 `Ctrl` 點擊 | [使用滑鼠](#use-the-mouse) |

48 48 

49如果滑鼠捕捉干擾您的工作流程,您可以[關閉它](#keep-native-text-selection),同時保持無閃爍渲染。49如果滑鼠捕捉干擾您的工作流程,您可以[關閉它](#keep-native-text-selection),同時保持無閃爍渲染。

50 50 


57* **在提示輸入中點擊**以在您輸入的文字中的任何位置定位游標。57* **在提示輸入中點擊**以在您輸入的文字中的任何位置定位游標。

58* **點擊 `/` 命令或 `@` 檔案清單中的建議**以接受它。懸停會突顯游標下的列。58* **點擊 `/` 命令或 `@` 檔案清單中的建議**以接受它。懸停會突顯游標下的列。

59* **點擊摺疊的工具結果**以展開它並查看完整輸出。再次點擊以摺疊。工具呼叫及其結果一起展開。只有有更多內容要顯示的訊息才可點擊。59* **點擊摺疊的工具結果**以展開它並查看完整輸出。再次點擊以摺疊。工具呼叫及其結果一起展開。只有有更多內容要顯示的訊息才可點擊。

60* **點擊 URL 或檔案路徑**以開啟它。工具輸出中的檔案路徑(例如在 Edit 或 Write 後列印的路徑)在您的預設應用程式中開啟。純 `http://` 和 `https://` URL 在您的瀏覽器中開啟。在大多數終端中這會取代原生 `Cmd` 點擊或 `Ctrl` 點擊滑鼠捕捉會攔截這些。在 VS Code 整合終端和類似的基於 xterm.js 的終端中,繼續使用 `Cmd` 點擊。Claude Code 在那裡遵從終端自己的連結處理程式以避免連結開啟兩次60* ** macOS 上按住 `Cmd`,或在 Linux 和 Windows 上按住 `Ctrl`,然後點擊 URL 或檔案路徑**以開啟它。工具輸出中的檔案路徑(例如在 Edit 或 Write 後列印的路徑)在您的預設應用程式中開啟。純 `http://` 和 `https://` URL 在您的瀏覽器中開啟。{/* min-version: 2.1.181 */}自 v2.1.181 起不按住 `Cmd` `Ctrl` 的純點擊不再開啟連結符合原生終端行為。在 VS Code 整合終端和類似的基於 xterm.js 的終端中,Claude Code 遵從終端自己的連結處理程式該處理程式使用相同的手勢

61* **點擊並拖曳**以在對話中的任何位置選擇文字。雙擊選擇一個單詞,符合 iTerm2 的單詞邊界,因此檔案路徑選擇為一個單位。三擊選擇該行。61* **點擊並拖曳**以在對話中的任何位置選擇文字。雙擊選擇一個單詞,符合 iTerm2 的單詞邊界,因此檔案路徑選擇為一個單位。三擊選擇該行。

62* **使用滑鼠滾輪捲動**以在對話中移動。62* **使用滑鼠滾輪捲動**以在對話中移動。

63 63 

glossary.md +8 −0

Details

44 44 

45了解更多:[How Claude Code works](/zh-TW/how-claude-code-works#the-agentic-loop)45了解更多:[How Claude Code works](/zh-TW/how-claude-code-works#the-agentic-loop)

46 46 

47<h3 id="artifact">

48 Artifact

49</h3>

50 

51Claude Code 從您的會話發佈到 claude.ai 上私人 URL 的即時互動網頁,因此您可以視覺化查看輸出或在組織內共享,而不是閱讀終端文字。當會話重新發佈時,頁面會就地更新。您從 Claude Code 建立的 Artifacts 會出現在與 claude.ai 對話中建立的 artifacts 相同的庫中,但其共享僅限於您的組織,無法公開。

52 

53了解更多:[Share session output as artifacts](/zh-TW/artifacts)

54 

47<h3 id="auto-memory">55<h3 id="auto-memory">

48 Auto memory56 Auto memory

49</h3>57</h3>

headless.md +3 −1

Details

68 68 

69如果 Claude 在 `claude -p` 執行期間啟動 [背景 Bash 工作](/zh-TW/tools-reference#bash-tool-behavior),例如開發伺服器或監視組建,該工作將在 Claude 傳回其最終結果且 stdin 已關閉後約五秒鐘終止。寬限期允許在結果之後立即完成的工作仍然傳遞其輸出。在 v2.1.163 之前,永不退出的背景程序會無限期地保持 `claude -p` 呼叫開啟。69如果 Claude 在 `claude -p` 執行期間啟動 [背景 Bash 工作](/zh-TW/tools-reference#bash-tool-behavior),例如開發伺服器或監視組建,該工作將在 Claude 傳回其最終結果且 stdin 已關閉後約五秒鐘終止。寬限期允許在結果之後立即完成的工作仍然傳遞其輸出。在 v2.1.163 之前,永不退出的背景程序會無限期地保持 `claude -p` 呼叫開啟。

70 70 

71背景 [subagents](/zh-TW/sub-agents) 和工作流程不受五秒寬限期的限制,因為它們的結果是最終輸出的一部分,所以 `claude -p` 會等待它們完成。從 v2.1.182 開始,該等待預設上限為十分鐘,因此卡住的背景 agent 無法無限期地保持程序開啟。使用 [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/zh-TW/env-vars) 調整上限,或將其設定為 `0` 以無限制地等待。

72 

71<h2 id="examples">73<h2 id="examples">

72 範例74 範例

73</h2>75</h2>


232`--allowedTools` 旗標使用 [權限規則語法](/zh-TW/settings#permission-rule-syntax)。尾部的 ` *` 啟用前綴匹配,因此 `Bash(git diff *)` 允許任何以 `git diff` 開頭的命令。空格在 `*` 之前很重要:沒有它,`Bash(git diff*)` 也會符合 `git diff-index`。234`--allowedTools` 旗標使用 [權限規則語法](/zh-TW/settings#permission-rule-syntax)。尾部的 ` *` 啟用前綴匹配,因此 `Bash(git diff *)` 允許任何以 `git diff` 開頭的命令。空格在 `*` 之前很重要:沒有它,`Bash(git diff*)` 也會符合 `git diff-index`。

233 235 

234<Note>236<Note>

235 使用者叫用的 [skills](/zh-TW/skills) 和自訂命令在 `-p` 模式中運作:在提示字串中包含 `/skill-name`,Claude Code 會在執行前展開它。開啟互動對話的內建命令,例如 `/config` 和 `/login`,在 `-p` 模式中不可用。237 使用者叫用的 [skills](/zh-TW/skills) 和自訂命令在 `-p` 模式中運作:在提示字串中包含 `/skill-name`,Claude Code 會在執行前展開它。開啟互動對話的內建命令,例如 `/login`,在 `-p` 模式中不可用。{/* min-version: 2.1.181 */}若要從 `-p` 叫用變更設定,請將 `key=value` 傳遞至 `/config`,例如 `/config thinking=false`。

236</Note>238</Note>

237 239 

238<h3 id="customize-the-system-prompt">240<h3 id="customize-the-system-prompt">

Details

326* 使用 `Escape`、`Backspace` 或在空提示上使用 `Ctrl+U` 退出326* 使用 `Escape`、`Backspace` 或在空提示上使用 `Ctrl+U` 退出

327* 將以 `!` 開頭的貼上文字貼到空提示中會自動進入 shell 模式,符合輸入的 `!` 行為327* 將以 `!` 開頭的貼上文字貼到空提示中會自動進入 shell 模式,符合輸入的 `!` 行為

328 328 

329自 v2.1.186 起,Claude 會在命令輸出進入文字記錄後自動回應,因此您可以執行 `! npm test` 並獲得失敗的說明,無需第二個提示。回應成本與傳送一般提示相同。若要恢復先前的行為,其中輸出被新增到上下文而不進行回應,請在 `settings.json` 中將 [`respondToBashCommands`](/zh-TW/settings#available-settings) 設定為 `false`。在 v2.1.186 之前,shell 模式始終將輸出新增到上下文而不進行回應。

330 

329這對於快速 shell 操作同時維護對話上下文很有用。331這對於快速 shell 操作同時維護對話上下文很有用。

330 332 

331<h2 id="prompt-suggestions">333<h2 id="prompt-suggestions">

keybindings.md +4 −3

Details

347 設定動作347 設定動作

348</h3>348</h3>

349 349 

350在 `Settings` 上下文中可用的動作:350在 `Settings` 上下文中可用的動作。`select:accept` 和 `confirm:no` 動作會從[選擇](#select-actions)和[確認](#confirmation-actions)上下文中重複使用,具有設定特定的行為變更會在您變更時立即套用到每個設定,因此 Escape 會關閉面板並儲存您的變更,而不是拒絕。

351 351 

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

353| :---------------- | :---- | :-------------------------- |353| :---------------- | :----------- | :--------------- |

354| `settings:search` | / | 進入搜尋模式 |354| `settings:search` | / | 進入搜尋模式 |

355| `settings:retry` | R | 重試載入使用量資料(發生錯誤時) |355| `settings:retry` | R | 重試載入使用量資料(發生錯誤時) |

356| `settings:close` | Enter | 儲存變更並關閉配置面板。Escape 會捨棄變更並關閉 |356| `select:accept` | Enter, Space | 變更選定的設定或開啟其子選單 |

357| `confirm:no` | Escape | 關閉面板。變更已儲存 |

357 358 

358<h3 id="doctor-actions">359<h3 id="doctor-actions">

359 Doctor 動作360 Doctor 動作

managed-mcp.md +8 −1

Details

161| `deniedMcpServers` | 不阻止任何伺服器 | 不阻止任何伺服器 | 阻止匹配的伺服器 |161| `deniedMcpServers` | 不阻止任何伺服器 | 不阻止任何伺服器 | 阻止匹配的伺服器 |

162 162 

163<Warning>163<Warning>

164 僅使用 `serverName` 條目的允許清單不是安全控制。名稱是使用者在執行 `claude mcp add` 或編輯配置檔案時指派的標籤,而不是基礎伺服器,因此使用者可以呼叫任何伺服器 `github`。要強制執行實際執行的伺服器,請新增 `serverCommand` 或 `serverUrl` 條目。164 `serverName` 條目(在任一清單中)不是安全控制。名稱是使用者在執行 `claude mcp add` 或編輯配置檔案時指派的標籤,而不是基礎伺服器,因此使用者可以呼叫任何伺服器 `github`。對於 claude.ai 連接器,名稱是 claude.ai 傳回的顯示名稱,可能會變更。要強制執行實際執行的伺服器,請新增 `serverCommand` 或 `serverUrl` 條目。

165</Warning>165</Warning>

166 166 

167`serverName` 驗證在兩個清單之間有所不同:

168 

169* {/* min-version: 2.1.182 */}在 `deniedMcpServers` 中,`serverName` 接受任何非空字串,因此您可以按顯示名稱阻止 [claude.ai 連接器](/zh-TW/mcp#use-mcp-servers-from-claude-ai)。例如,`{ "serverName": "claude.ai Slack" }` 阻止 Slack 連接器。當您需要拒絕對重新命名具有魯棒性時,或當連接器名稱衝突並獲得 ` (N)` 尾碼時,優先使用 `serverUrl` 條目。

170* 在 `allowedMcpServers` 中,`serverName` 限制為字母、數字、連字號和底線。使用 `serverUrl` 來允許列出 claude.ai 連接器。

171 

172要關閉所有 claude.ai 連接器,請參閱 [`disableClaudeAiConnectors`](/zh-TW/mcp#disable-claude-ai-connectors)。

173 

167<h3 id="how-a-server-is-evaluated">174<h3 id="how-a-server-is-evaluated">

168 伺服器如何被評估175 伺服器如何被評估

169</h3>176</h3>

mcp.md +40 −2

Details

554 * OAuth 驗證適用於 HTTP servers554 * OAuth 驗證適用於 HTTP servers

555</Tip>555</Tip>

556 556 

557<h3 id="authenticate-from-the-command-line">

558 從命令列進行驗證

559</h3>

560 

561從 v2.1.186 開始,`claude mcp login <name>` 直接從您的 shell 執行已配置 server 的 OAuth 流程,因此您不需要在 session 內開啟 `/mcp` 面板。

562 

563```bash theme={null}

564claude mcp login sentry

565```

566 

567若要稍後清除儲存的認證,請執行 `claude mcp logout <name>`。

568 

569當您透過 SSH 連接時,新增 `--no-browser` 以便命令列印授權 URL 而不是開啟瀏覽器。在您的本機機器上開啟 URL,然後將瀏覽器位址列中的完整重新導向 URL 貼回提示處。該命令需要互動式終端以進行貼上步驟,因此請使用 `ssh -t` 連接。

570 

571```bash theme={null}

572claude mcp login sentry --no-browser

573```

574 

557<h3 id="use-a-fixed-oauth-callback-port">575<h3 id="use-a-fixed-oauth-callback-port">

558 使用固定的 OAuth 回呼連接埠576 使用固定的 OAuth 回呼連接埠

559</h3>577</h3>


850 868 

851您在 Claude Code 中新增的 server 優先於指向相同 URL 的 claude.ai connector。發生這種情況時,`/mcp` 會將 connector 列為隱藏,並顯示如何移除重複項(如果您寧願使用 connector)。869您在 Claude Code 中新增的 server 優先於指向相同 URL 的 claude.ai connector。發生這種情況時,`/mcp` 會將 connector 列為隱藏,並顯示如何移除重複項(如果您寧願使用 connector)。

852 870 

853某些 Anthropic 託管的 connectors(例如 Microsoft 365、Gmail 和 Google Calendar)不支援來自 Claude Code 的本機 OAuth,因為上游身分識別提供者只接受 claude.ai 註冊的重新導向 URL。從 v2.1.162 開始,在 `/mcp` 中驗證其中一個主機會顯示一條訊息,指導您改為在 claude.ai 上的'設定''Connectors'中連接它。連接後,connector 會自動出現在 Claude Code 中。871某些 Anthropic 託管的 connectors(例如 Microsoft 365、Gmail 和 Google Calendar)不支援來自 Claude Code 的本機 OAuth,因為上游身分識別提供者只接受 claude.ai 註冊的重新導向 URL。從 v2.1.162 開始,在 `/mcp` 中驗證其中一個主機會顯示一條訊息,指導您改為在 claude.ai 上的設定 Connectors 中連接它。連接後,connector 會自動出現在 Claude Code 中。

872 

873<h3 id="disable-claude-ai-connectors">

874 停用 claude.ai connectors

875</h3>

876 

877若要在 Claude Code 中停用 claude.ai MCP servers,請將 [`disableClaudeAiConnectors`](/zh-TW/settings#available-settings) 設定為 `true`(在任何設定範圍中):

878 

879```json theme={null}

880{

881 "disableClaudeAiConnectors": true

882}

883```

884 

885此設定使用任何來源為真的語義:任何設定來源中的 `true` 優先。已簽入的專案 `.claude/settings.json` 可以選擇退出雲端 connectors,但專案層級的 `false` 無法重新啟用使用者或政策層級 `true` 已停用的 connectors。透過 `--mcp-config` 明確傳遞的 servers 不受影響。

854 886 

855若要在 Claude Code 中停用 claude.ai MCP servers,請將 `ENABLE_CLAUDEAI_MCP_SERVERS` 環境變數設定為 `false`:887您也可以將 `ENABLE_CLAUDEAI_MCP_SERVERS` 環境變數設定為 `false`,這對目前的 shell 工作階段有相同的效果

856 888 

857```bash theme={null}889```bash theme={null}

858ENABLE_CLAUDEAI_MCP_SERVERS=false claude890ENABLE_CLAUDEAI_MCP_SERVERS=false claude

859```891```

860 892 

893若要阻止個別 claude.ai connectors 而不是全部,請按名稱或 URL 模式將它們新增至 [`deniedMcpServers`](/zh-TW/managed-mcp)。例如,`serverName` 項目 `"claude.ai Slack"` 會阻止 Slack connector。若要僅針對目前專案切換 connector 的開啟或關閉,請使用 `/mcp` 面板。

894 

895<Note>

896 這些用戶端設定管理本機 Claude Code 工作階段。在 [Claude Code on the web](/zh-TW/claude-code-on-the-web) 工作階段中,claude.ai connectors 由遠端主機佈建,並作為明確的 `--mcp-config` 項目到達,因此 `disableClaudeAiConnectors` 不適用於此處。Connector URL 也會透過工作階段代理重寫,因此針對廠商 URL 的 `deniedMcpServers` `serverUrl` 模式將不會符合。從您的 claude.ai 組織設定管理雲端工作階段可以使用哪些 connectors。

897</Note>

898 

861<h2 id="use-claude-code-as-an-mcp-server">899<h2 id="use-claude-code-as-an-mcp-server">

862 使用 Claude Code 作為 MCP server900 使用 Claude Code 作為 MCP server

863</h2>901</h2>

Details

61 伺服器出現時帶有狀態指示器:61 伺服器出現時帶有狀態指示器:

62 62 

63 | 狀態 | 含義 |63 | 狀態 | 含義 |

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

65 | `✓ Connected` | 準備就緒。這是您應該為 `claude-code-docs` 看到的 |65 | `✓ Connected` | 準備就緒。這是您應該為 `claude-code-docs` 看到的 |

66 | `! Connected · tools fetch failed` | 伺服器已連接但無法列出其工具。執行 `claude mcp get <name>` 以取得錯誤詳細資訊 |

66 | `! Needs authentication` | 伺服器可到達但需要瀏覽器登入,或使用 `--header` 傳遞的令牌。請參閱[連接需要登入的伺服器](#connect-a-server-that-requires-sign-in) |67 | `! Needs authentication` | 伺服器可到達但需要瀏覽器登入,或使用 `--header` 傳遞的令牌。請參閱[連接需要登入的伺服器](#connect-a-server-that-requires-sign-in) |

67 | `✗ Failed to connect` | 伺服器未回應。請參閱[疑難排解](#troubleshooting) |68 | `✗ Failed to connect` | 伺服器未回應。請參閱[疑難排解](#troubleshooting) |

68 | `✗ Connection error` | 連接嘗試拋出錯誤。請參閱[疑難排解](#troubleshooting) |69 | `✗ Connection error` | 連接嘗試拋出錯誤。請參閱[疑難排解](#troubleshooting) |

model-config.md +2 −0

Details

94 94 

95當啟動時的活動模型來自專案或受管設定而非您自己的選擇時,啟動標題會顯示哪個設定檔設定了它。執行 `/model` 以覆蓋;專案或受管設定會在下次啟動時重新應用。95當啟動時的活動模型來自專案或受管設定而非您自己的選擇時,啟動標題會顯示哪個設定檔設定了它。執行 `/model` 以覆蓋;專案或受管設定會在下次啟動時重新應用。

96 96 

97當請求的模型有排定的淘汰日期或自動重新對應到較新版本時,Claude Code 會顯示一個警告,其中命名了請求的模型。互動式會話會將其顯示為啟動通知。從 v2.1.182 起,當使用預設文字輸出格式時,相同的警告會在[非互動模式](/zh-TW/headless)中寫入 stderr。檢查也涵蓋在[子代理 frontmatter](/zh-TW/sub-agents) 中設定的 `model`。對於 `--output-format json` 和 `stream-json`,stderr 警告會被抑制;改為從[結果訊息](/zh-TW/headless#get-structured-output)的 `modelUsage` 欄位讀取實際模型。

98 

97使用範例:99使用範例:

98 100 

99```bash theme={null}101```bash theme={null}

Details

701 API 拒絕事件701 API 拒絕事件

702</h4>702</h4>

703 703 

704當 API 請求傳回 `stop_reason: "refusal"` 時記錄。拒絕會在成功的回應串流上到達,而不是作為 HTTP 錯誤,因此 `api_error` 事件不會為它們觸發。此事件可讓您追蹤拒絕頻率704當 API 請求傳回 `stop_reason: "refusal"` 時記錄。拒絕會在成功的回應串流上到達,而不是作為 HTTP 錯誤,因此 `api_error` 事件不會為它們觸發。此事件可讓您追蹤拒絕頻率並按與 `api_request` 和 `api_error` 相同的屬性分組拒絕

705 705 

706**事件名稱**:`claude_code.api_refusal`706**事件名稱**:`claude_code.api_refusal`

707 707 


713* `event.sequence`:單調遞增計數器,用於排序工作階段內的事件713* `event.sequence`:單調遞增計數器,用於排序工作階段內的事件

714* `model`:來自請求的模型識別碼714* `model`:來自請求的模型識別碼

715* `request_id`:來自回應的 `request-id` 標頭的 Anthropic API 請求 ID,例如 `"req_011..."`。僅當 API 傳回時才存在。715* `request_id`:來自回應的 `request-id` 標頭的 Anthropic API 請求 ID,例如 `"req_011..."`。僅當 API 傳回時才存在。

716* `query_source`:發出請求的子系統,例如 `"repl_main_thread"`、`"compact"` 或子代理名稱。詳見[`api_request`](#api-request-event)以了解定義。

717* `speed`:當[快速模式](/zh-TW/fast-mode)啟用時為 `"fast"`,或 `"normal"`

718* `attempt`:重試嘗試編號。第一次嘗試是 `1`。

719* `effort`:應用於請求的[努力等級](/zh-TW/model-config#adjust-effort-level)。當模型不支援努力時不存在。

720* `server_fallback_hop`:當 API 的伺服器端模型後備已在不同模型上重試此拒絕時為 `true`,因此使用者沒有看到此特定拒絕。當請求以拒絕結束時為 `false`。單個轉換可以發出 `true` hop 事件和稍後的 `false` 最終事件,當後備模型也拒絕時。

721* `has_category`:當 API 回應帶有 `stop_details.category` 為 `"cyber"`、`"bio"`、`"frontier_llm"` 或 `"reasoning_extraction"` 時為 `true`。當回應沒有類別或值在該集合之外時為 `false`。當 `server_fallback_hop` 為 `true` 時不存在,因為 hop 區塊不帶 `stop_details`。

722* `has_explanation`:當 API 回應帶有 `stop_details.explanation` 時為 `true`,否則為 `false`。當 `server_fallback_hop` 為 `true` 時不存在。

723* `category`:來自 API 回應的 `stop_details.category` 值。`"cyber"`、`"bio"`、`"frontier_llm"` 或 `"reasoning_extraction"` 之一。僅當設定 `OTEL_LOG_TOOL_DETAILS=1` 且 `has_category` 為 `true` 時才存在。

724* `agent.name`、`skill.name`、`plugin.name`、`marketplace.name`、`mcp_server.name`、`mcp_tool.name`:請求的 Skill、plugin、代理和 MCP 歸屬。詳見[成本計數器](#cost-counter)以了解定義和編輯行為。

716 725 

717<h4 id="api-request-body-event">726<h4 id="api-request-body-event">

718 API 請求主體事件727 API 請求主體事件

Details

117Claude Code 需要存取以下 URL。請在您的代理設定和防火牆規則中將這些 URL 列入允許清單,特別是在容器化或受限網路環境中。117Claude Code 需要存取以下 URL。請在您的代理設定和防火牆規則中將這些 URL 列入允許清單,特別是在容器化或受限網路環境中。

118 118 

119| URL | 用途 |119| URL | 用途 |

120| ------------------------------ | ----------------------------------------------------------------- |120| ------------------------------ | ----------------------------------------------------------------------------------- |

121| `api.anthropic.com` | Claude API 請求 |121| `api.anthropic.com` | Claude API 請求 |

122| `claude.ai` | claude.ai 帳戶驗證 |122| `claude.ai` | claude.ai 帳戶驗證 |

123| `platform.claude.com` | Anthropic Console 帳戶驗證 |123| `platform.claude.com` | Anthropic Console 帳戶驗證 |

124| `downloads.claude.ai` | 外掛程式可執行檔下載;原生安裝程式和原生自動更新程式 |124| `downloads.claude.ai` | 外掛程式可執行檔下載;原生安裝程式和原生自動更新程式 |

125| `storage.googleapis.com` | {/* max-version: 2.1.115 */}2.1.116 版本之前的原生安裝程式和原生自動更新程式 |125| `storage.googleapis.com` | {/* max-version: 2.1.115 */}2.1.116 版本之前的原生安裝程式和原生自動更新程式 |

126| `bridge.claudeusercontent.com` | [Chrome 中的 Claude](/zh-TW/chrome) 擴充功能 WebSocket 橋接器 |126| `bridge.claudeusercontent.com` | [Chrome 中的 Claude](/zh-TW/chrome) 擴充功能 WebSocket 橋接器 |

127| `*.claudeusercontent.com` | 在 claude.ai 上檢視[成品](/zh-TW/artifacts)。檢視器會從此來源的沙箱子網域載入每個成品的內容。檢視器的瀏覽器需要此項,CLI 本身不需要 |

127| `raw.githubusercontent.com` | [`/release-notes`](/zh-TW/commands) 的變更日誌摘要和更新後顯示的版本資訊;外掛程式市集安裝計數 |128| `raw.githubusercontent.com` | [`/release-notes`](/zh-TW/commands) 的變更日誌摘要和更新後顯示的版本資訊;外掛程式市集安裝計數 |

128 129 

129如果您透過 npm 安裝 Claude Code 或管理自己的二進位分發,終端使用者可能不需要存取 `downloads.claude.ai` 或 `storage.googleapis.com`。130如果您透過 npm 安裝 Claude Code 或管理自己的二進位分發,終端使用者可能不需要存取 `downloads.claude.ai` 或 `storage.googleapis.com`。

Details

235* 修改共享基礎設施235* 修改共享基礎設施

236* 不可逆轉地銷毀會話開始前存在的檔案236* 不可逆轉地銷毀會話開始前存在的檔案

237* 強制推送或直接推送到 `main`237* 強制推送或直接推送到 `main`

238* {/* min-version: 2.1.182 */}`git reset --hard`、`git checkout -- .`、`git restore .`、`git clean -fd`、`git stash drop` 或 `git stash clear`,分類器推測這些會捨棄未提交的變更

239* `git commit --amend`,當 HEAD 的提交不是在此會話中建立的

240* `terraform destroy`、`pulumi destroy`、`cdk destroy` 或 `terragrunt destroy`,以及應用會銷毀資源的計劃

238 241 

239**預設允許**:242**預設允許**:

240 243 

permissions.md +2 −2

Details

400以下設定類型從 `--add-dir` 目錄載入:400以下設定類型從 `--add-dir` 目錄載入:

401 401 

402| 設定 | 從 `--add-dir` 載入 |402| 設定 | 從 `--add-dir` 載入 |

403| :----------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- |403| :------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- |

404| `.claude/skills/` 中的 [Skills](/zh-TW/skills) | 是,具有即時重新載入 |404| `.claude/skills/` 中的 [Skills](/zh-TW/skills) | 是,具有即時重新載入 |

405| `.claude/agents/` 中的 [Subagents](/zh-TW/sub-agents) | 是 |405| `.claude/agents/` 中的 [Subagents](/zh-TW/sub-agents) | 是 |

406| `.claude/settings.json` 中的外掛設定 | 僅 `enabledPlugins` 和 `extraKnownMarketplaces` |406| `.claude/settings.json` 和 `.claude/settings.local.json` 中的 [Settings](/zh-TW/settings) | 僅 `enabledPlugins` 和 `extraKnownMarketplaces` 金鑰 |

407| [CLAUDE.md](/zh-TW/memory) 檔案、`.claude/rules/` 和 `CLAUDE.local.md` | 僅當設定 `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` 時。`CLAUDE.local.md` 另外需要 `local` 設定來源,預設啟用 |407| [CLAUDE.md](/zh-TW/memory) 檔案、`.claude/rules/` 和 `CLAUDE.local.md` | 僅當設定 `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` 時。`CLAUDE.local.md` 另外需要 `local` 設定來源,預設啟用 |

408 408 

409命令和輸出樣式是從目前工作目錄及其父目錄、您在 `~/.claude/` 的使用者目錄和受管理設定發現的。Hooks 和其他 `settings.json` 金鑰從目前工作目錄的 `.claude/` 資料夾載入,沒有父目錄回退,同時也從您的使用者 `~/.claude/settings.json` 和受管理設定載入。若要在專案間共享該設定,請使用以下方法之一:409命令和輸出樣式是從目前工作目錄及其父目錄、您在 `~/.claude/` 的使用者目錄和受管理設定發現的。Hooks 和其他 `settings.json` 金鑰從目前工作目錄的 `.claude/` 資料夾載入,沒有父目錄回退,同時也從您的使用者 `~/.claude/settings.json` 和受管理設定載入。若要在專案間共享該設定,請使用以下方法之一:

Details

201 Plugin 項目201 Plugin 項目

202</h2>202</h2>

203 203 

204`plugins` 陣列中的每個 plugin 項目描述一個 plugin 及其位置。您可以包含 [plugin manifest 架構](/zh-TW/plugins-reference#plugin-manifest-schema)中的任何欄位(如 `description`、`version`、`author`、`commands`、`hooks` 等),加上這些 marketplace 特定欄位:`source`、`category`、`tags` 和 `strict`。204`plugins` 陣列中的每個 plugin 項目描述一個 plugin 及其位置。您可以包含 [plugin manifest 架構](/zh-TW/plugins-reference#plugin-manifest-schema)中的任何欄位(如 `description`、`version`、`author`、`commands`、`hooks` 等),加上這些 marketplace 特定欄位:`source`、`category`、`tags`、`strict` 和 `relevance`。

205 205 

206<h3 id="required-fields-1">206<h3 id="required-fields-1">

207 必需欄位207 必需欄位


231| `category` | string | Plugin 類別以供組織 |231| `category` | string | Plugin 類別以供組織 |

232| `tags` | array | 用於可搜尋性的標籤 |232| `tags` | array | 用於可搜尋性的標籤 |

233| `strict` | boolean | 控制 `plugin.json` 是否為元件定義的權威(預設值:true)。請參閱下面的 [Strict mode](#strict-mode)。 |233| `strict` | boolean | 控制 `plugin.json` 是否為元件定義的權威(預設值:true)。請參閱下面的 [Strict mode](#strict-mode)。 |

234| `relevance` | object | {/* min-version: 2.1.152 */}告知 Claude Code 何時向使用者建議此 plugin 的訊號。僅對管理員在受管設定中允許清單的 marketplace 生效。請參閱 [為您的組織推薦 plugin](/zh-TW/plugin-relevance)。需要 Claude Code v2.1.152 或更新版本。 |

234| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}安裝後 plugin 是否啟用(預設值:true)。設定為 `false` 以安裝已停用的 plugin,直到使用者選擇加入。優先於 plugin 的 `plugin.json` 中的相同欄位。請參閱 [預設啟用](/zh-TW/plugins-reference#default-enablement)。需要 Claude Code v2.1.154 或更新版本。 |235| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}安裝後 plugin 是否啟用(預設值:true)。設定為 `false` 以安裝已停用的 plugin,直到使用者選擇加入。優先於 plugin 的 `plugin.json` 中的相同欄位。請參閱 [預設啟用](/zh-TW/plugins-reference#default-enablement)。需要 Claude Code v2.1.154 或更新版本。 |

235 236 

236**元件配置欄位:**237**元件配置欄位:**


269 例如,託管在 `acme-corp/plugin-catalog`(marketplace 來源)的 marketplace 可以列出從 `acme-corp/code-formatter`(plugin 來源)取得的 plugin。marketplace 來源和 plugin 來源指向不同的儲存庫,並獨立固定。270 例如,託管在 `acme-corp/plugin-catalog`(marketplace 來源)的 marketplace 可以列出從 `acme-corp/code-formatter`(plugin 來源)取得的 plugin。marketplace 來源和 plugin 來源指向不同的儲存庫,並獨立固定。

270</Note>271</Note>

271 272 

272基於 git 的來源類型如下為 `github`、`url` 和 `git-subdir`。當任何一個上同時設定 `ref` 和 `sha` 時,`sha` 是有效的固定。Claude Code 直接取得並簽出固定的提交,因此即使上游的 `ref` 命名的分支或標籤已被刪除,只要提交仍可從儲存庫到達,安裝就會成功。273基於 git 的來源類型如下為 `github`、`url` 和 `git-subdir`。當任何一個上同時設定 `ref` 和 `sha` 時,`sha` 是有效的固定。Claude Code 直接取得並簽出固定的提交。在大多數 git 主機上包括 GitHub、GitLab 和 Bitbucket,這表示即使上游的 `ref` 命名的分支或標籤已被刪除,只要提交仍可從儲存庫到達,安裝就會成功。某些伺服器(例如 AWS CodeCommit)不支援透過 SHA 取得提交。在這些伺服器上,`ref` 仍必須存在,且固定的提交必須可從其到達。

273 274 

274<h3 id="relative-paths">275<h3 id="relative-paths">

275 相對路徑276 相對路徑


507* **`${CLAUDE_PLUGIN_ROOT}`**:在 hooks 和 MCP server 配置中使用此變數來參考 plugin 安裝目錄內的檔案。這是必要的,因為 plugin 在安裝時被複製到快取位置。對於應在 plugin 更新後保留的相依性或狀態,請改用 [`${CLAUDE_PLUGIN_DATA}`](/zh-TW/plugins-reference#persistent-data-directory)。508* **`${CLAUDE_PLUGIN_ROOT}`**:在 hooks 和 MCP server 配置中使用此變數來參考 plugin 安裝目錄內的檔案。這是必要的,因為 plugin 在安裝時被複製到快取位置。對於應在 plugin 更新後保留的相依性或狀態,請改用 [`${CLAUDE_PLUGIN_DATA}`](/zh-TW/plugins-reference#persistent-data-directory)。

508* **`strict: false`**:由於此設定為 false,plugin 不需要自己的 `plugin.json`。marketplace 項目定義所有內容。請參閱下面的 [Strict mode](#strict-mode)。509* **`strict: false`**:由於此設定為 false,plugin 不需要自己的 `plugin.json`。marketplace 項目定義所有內容。請參閱下面的 [Strict mode](#strict-mode)。

509 510 

510根據預設,plugin 的 skills 從其 `source` 下的 `skills/` 目錄載入,`skills` 下列出的任何路徑都會新增到該掃描中例外是 marketplace 根目錄來源,例如 `source: "./"` 的情況,其中多個 plugin 項目共享一個 `skills/` 資料夾。在該情況下,在 `skills` 下列出特定子目錄會使該清單成為該項目的完整集合,`skills/` 下的其他目錄不會載入。列出 `skills/` 目錄本身或 plugin 根目錄會保持完整掃描。如果列出的路徑都不存在,則改為執行預設掃描。511根據預設,plugin 的 skills 從其 `source` 下的 `skills/` 目錄載入。`skills` 欄位中列出的路徑會新增到該掃描中:

512 

513```json theme={null}

514"skills": ["./skills/", "./extra-skills/"]

515```

516 

517當多個 plugin 項目在 marketplace 根目錄(`source: "./"`) 共享一個 `skills/` 資料夾時,改為列出特定子目錄,以便每個項目只載入自己的 skills:

518 

519```json theme={null}

520"source": "./",

521"skills": ["./skills/code-review", "./skills/docs"]

522```

523 

524使用 marketplace 根目錄 `source` 時,列出的路徑是該項目的完整集合,共享 `skills/` 資料夾中的其他目錄不會載入。列出 `./skills/` 本身或 plugin 根目錄會保持完整掃描。如果列出的路徑都不存在,則改為執行預設掃描。

511 525 

512<h3 id="strict-mode">526<h3 id="strict-mode">

513 Strict mode527 Strict mode


1078* 檢查 plugin 目錄是否包含必需的檔案1092* 檢查 plugin 目錄是否包含必需的檔案

1079* 對於 GitHub 來源,確保儲存庫是公開的或您有存取權1093* 對於 GitHub 來源,確保儲存庫是公開的或您有存取權

1080* 透過手動複製/下載測試 plugin 來源1094* 透過手動複製/下載測試 plugin 來源

1081* 如果來源同時固定 `ref` 和 `sha`,已刪除的上游分支或標籤不會阻止安裝。如果安裝仍然失敗,請確認固定的提交仍然存在於儲存庫中1095* 如果來源同時固定 `ref` 和 `sha`,已刪除的上游分支或標籤不會阻止在大多數 git 主機(包括 GitHub、GitLab 和 Bitbucket)上的安裝在不支援按 SHA 擷取提交的伺服器上(例如 AWS CodeCommit),`ref` 仍必須存在,且固定的提交必須可從其到達。如果安裝仍然失敗,請確認固定的提交仍然存在於儲存庫中

1082 1096 

1083<h3 id="private-repository-authentication-fails">1097<h3 id="private-repository-authentication-fails">

1084 私人儲存庫驗證失敗1098 私人儲存庫驗證失敗

plugin-relevance.md +188 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# 為您的組織推薦外掛程式

6 

7> 在 marketplace.json 中的外掛程式項目中新增相關性區塊,以便在使用者的工作相符時,Claude Code 會建議這些外掛程式。

8 

9如果您為組織運營外掛程式 marketplace,您可以根據使用者正在進行的工作,讓 Claude Code 向使用者建議特定的外掛程式。在 `marketplace.json` 中的外掛程式項目中新增 `relevance` 區塊,然後在受管設定中將 marketplace 加入允許清單。當使用者的工作階段符合其中一個已宣告的信號時,Claude Code 會顯示該外掛程式的安裝建議。

10 

11Marketplace 宣告的建議是透過[受管設定](/zh-TW/settings#settings-files)按 marketplace 選擇加入的。在管理員將任何 marketplace 新增至允許清單之前,該 marketplace 的 `relevance` 宣告都不會產生建議,包括官方 Anthropic marketplace。Claude Code 還包括一個獨立於此允許清單的內建建議;當 [`spinnerTipsEnabled`](/zh-TW/settings#available-settings) 設定為 `false` 時,該提示和所有 marketplace 宣告的提示都會被停用。

12 

13{/* min-version: 2.1.152 */}此功能需要 Claude Code v2.1.152 或更新版本。較舊的用戶端會忽略 `relevance` 欄位。

14 

15此頁面適用於 marketplace 運營商和企業管理員。如果您想要安裝外掛程式,請參閱[探索和安裝外掛程式](/zh-TW/discover-plugins)。

16 

17<h2 id="how-it-works">

18 運作方式

19</h2>

20 

21`marketplace.json` 中的每個外掛程式項目都可以包含一個 `relevance` 物件。該物件命名一個主題和一個或多個信號。信號是 Claude Code 針對目前工作階段測試的模式,例如工作目錄或 Claude 已讀取的檔案。

22 

23信號比對在使用者的機器上本地進行。比對不會增加任何網路流量,也不會向 Anthropic 或 marketplace 運營商報告哪些信號相符或其值。

24 

25當信號相符且外掛程式尚未安裝時,Claude Code 會在三個位置顯示該外掛程式:

26 

27* **Spinner 提示**:當 Claude 正在回應時,spinner 下方會出現「使用 *主題*?安裝 *外掛程式* 外掛程式」訊息,並附帶 `/plugin install` 命令。

28* **工作階段開始建議**:{/* min-version: 2.1.153 */}如果 `cwd` 信號符合工作目錄,在第一個回合之前會出現一行 `plugin suggestion: <name>@<marketplace> · /plugin` 通知。此介面需要 Claude Code v2.1.153 或更新版本。

29* **`/plugin` Discover 標籤**:{/* min-version: 2.1.154 */}外掛程式會被釘選到 Discover 清單的頂部,並附帶註解,例如「建議用於此目錄」或「建議用於 stripe 命令」。此介面需要 Claude Code v2.1.154 或更新版本。

30 

31Spinner 提示和工作階段開始通知是 spinner 提示系統的一部分。當使用者或專案將 `spinnerTipsEnabled` 設定為 `false`,或當使用 `excludeDefault` 配置自訂 `spinnerTipsOverride` 時,兩者都會被停用。Discover 標籤釘選獨立於提示設定。

32 

33Claude Code 永遠不會自動安裝外掛程式。使用者始終需要確認。

34 

35<h2 id="add-relevance-to-a-plugin-entry">

36 為外掛程式項目新增相關性

37</h2>

38 

39在您的 `marketplace.json` 中的外掛程式項目中新增 `relevance` 物件。以下範例宣告當 Claude 讀取 `.tf` 檔案或執行 `terraform` 時,`terraform-helpers` 外掛程式是相關的:

40 

41```json theme={null}

42{

43 "name": "acme-corp-plugins",

44 "owner": { "name": "Acme Platform Team" },

45 "plugins": [

46 {

47 "name": "terraform-helpers",

48 "source": "./plugins/terraform-helpers",

49 "description": "Acme conventions and helpers for Terraform",

50 "relevance": {

51 "topic": "Terraform",

52 "signals": {

53 "cli": ["terraform"],

54 "filesRead": ["**/*.tf"]

55 }

56 }

57 }

58 ]

59}

60```

61 

62具有 `relevance` 區塊但沒有相符信號的外掛程式的行為與任何其他 marketplace 項目相同。它會在 Discover 清單中以其正常位置出現,永遠不會顯示為 spinner 提示。

63 

64<h2 id="field-reference">

65 欄位參考

66</h2>

67 

68<h3 id="relevance">

69 `relevance`

70</h3>

71 

72| 欄位 | 類型 | 說明 |

73| :-------- | :- | :---------------------------------------------------------------------------------------------------------------------------------- |

74| `topic` | 字串 | 選用。填充 spinner 提示中「使用 *主題*?」的片語。通常是產品名稱,例如 `Stripe`。當外掛程式名稱不能自然地作為主題讀取時,使用 `design` 等網域。預設為外掛程式名稱,每個連字號段落大寫。工作階段開始通知不使用此值。最多 64 個字元。 |

75| `signals` | 物件 | 決定外掛程式何時相關的匹配器。至少需要一個信號才能使外掛程式可被建議。請參閱下表。 |

76 

77<h3 id="relevance-signals">

78 `relevance.signals`

79</h3>

80 

81| 欄位 | 類型 | 說明 |

82| :------------- | :--- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

83| `cwd` | 字串陣列 | {/* min-version: 2.1.153 */}與工作階段工作目錄相符的 Glob 模式。作為絕對路徑相符,當在 git 儲存庫內時,作為相對於儲存庫根目錄的路徑相符。正斜線正規化且不區分大小寫。每個模式都符合目錄本身及其下的所有內容,因此 `infra`、`infra/` 和 `infra/**` 的行為相同。這是唯一可以在工作階段開始時(在第一個回合之前)相符的信號。最多 10 個模式,每個 256 個字元。 |

84| `cli` | 字串陣列 | Claude 在此工作階段執行的 shell 命令中的命令名稱,例如 `["stripe"]`。適用於每個平台:在 Windows 上透過 PowerShell 或 Git Bash 執行的命令以相同方式記錄。Claude Code 為每個 shell 工具呼叫記錄一個命令名稱:任何前導環境變數指派和 `sudo` 之後的第一個權杖。複合命令只貢獻其前導命令,因此 `cd infra && terraform plan` 記錄 `cd`,而不是 `terraform`。完全相符。最多 10 個項目,每個 64 個字元。 |

85| `hosts` | 字串陣列 | 此工作階段中 Bash 命令中 `http://` 或 `https://` URL 中看到的主機名稱,例如 `["api.stripe.com"]`。僅限裸露小寫主機名稱:無配置、連接埠或路徑。完全不區分大小寫相符。最多 20 個項目,每個 128 個字元。 |

86| `filesRead` | 字串陣列 | {/* min-version: 2.1.153 */}與 Claude 在此工作階段讀取的檔案路徑相符的 Glob 模式,例如 `["**/*.tf"]`。正斜線正規化且不區分大小寫。最多 10 個模式,每個 256 個字元。 |

87| `manifestDeps` | 物件陣列 | Claude 在此工作階段讀取的套件資訊清單中宣告的相依性。每個項目都是 `{ "file": "...", "pattern": "..." }`,其中 `file` 是與資訊清單檔案路徑相符的正規表達式(如工作階段狀態中所記錄,通常是絕對路徑),`pattern` 是與該檔案內容相符的正規表達式。在 `file` 的末尾錨定,例如 JSON 逸出形式中的 `[/\\\\]package\\.json$`,因為開始錨定的模式永遠不會符合絕對路徑。路徑不會針對此信號進行分隔符號正規化,因此 Windows 路徑使用反斜線。大於 512 KB 的資訊清單檔案會被跳過。兩個值都是最多 256 個字元的 JavaScript `RegExp` 來源字串。`file` 不區分大小寫相符。`pattern` 區分大小寫。最多 10 個項目。 |

88 

89`cli`、`hosts`、`filesRead` 和 `manifestDeps` 信號需要工作階段歷史記錄,因此它們只能在 spinner 提示和 Discover 標籤上相符。只有 `cwd` 可以在工作階段開始時相符。`filesRead` 和 `manifestDeps` 信號測試工作階段的記錄檔案狀態,其中也包括 Claude 已寫入或編輯的檔案以及自動載入的 `CLAUDE.md` 記憶體檔案。

90 

91以下範例使用 `manifestDeps` 在 Claude 讀取依賴 `stripe` 的 `package.json` 後建議 Stripe 外掛程式。`file` 模式使用 `[/\\\\]` 以便符合正斜線和反斜線路徑分隔符號,以及 `\\.` 以便點是字面意思。在 JSON 中,正規表達式中的每個反斜線都寫兩次。

92 

93```json theme={null}

94{

95 "name": "stripe-helpers",

96 "source": "./plugins/stripe-helpers",

97 "relevance": {

98 "topic": "Stripe",

99 "signals": {

100 "manifestDeps": [

101 {

102 "file": "[/\\\\]package\\.json$",

103 "pattern": "\"stripe\"\\s*:"

104 }

105 ]

106 }

107 }

108}

109```

110 

111<Note>

112 `relevance` 和 `relevance.signals` 下的未知欄位在載入時會被忽略,因此較舊的 Claude Code 用戶端會繼續載入您的 marketplace。執行 `claude plugin validate` 以將它們顯示為警告。

113</Note>

114 

115<h2 id="enable-suggestions-in-managed-settings">

116 在受管設定中啟用建議

117</h2>

118 

119在 `marketplace.json` 中宣告 `relevance` 本身是不夠的。管理員必須在[受管設定](/zh-TW/settings#settings-files)中將 marketplace 加入允許清單,才能向使用者顯示其建議。

120 

121將 marketplace 名稱新增至 `pluginSuggestionMarketplaces`。對於官方 Anthropic marketplace 以外的任何 marketplace,也在相同的受管設定中宣告 marketplace 來源,可以是該名稱在 `extraKnownMarketplaces` 中的項目,或在 `strictKnownMarketplaces` 中的項目。如果在機器上註冊的 marketplace 來自不同的來源,允許清單中的名稱會被忽略。這可防止無關的來源以允許清單中的名稱進行註冊,以便在整個組織中建議其外掛程式。

122 

123以下 `managed-settings.json` 從 GitHub 儲存庫註冊組織 marketplace 並啟用其建議:

124 

125```json theme={null}

126{

127 "extraKnownMarketplaces": {

128 "acme-corp-plugins": {

129 "source": {

130 "source": "github",

131 "repo": "acme-corp/claude-plugins"

132 }

133 }

134 },

135 "pluginSuggestionMarketplaces": ["acme-corp-plugins"]

136}

137```

138 

139官方 marketplace 不受來源宣告要求的限制,因為其名稱只能從官方 Anthropic 來源進行註冊。僅允許清單中的名稱就足夠了:

140 

141```json theme={null}

142{

143 "pluginSuggestionMarketplaces": ["claude-plugins-official"]

144}

145```

146 

147請參閱[設定參考](/zh-TW/settings)以取得 `pluginSuggestionMarketplaces` 和 [`extraKnownMarketplaces`](/zh-TW/settings#extraknownmarketplaces) 的完整配置詳細資訊。

148 

149<h2 id="what-the-user-sees">

150 使用者看到的內容

151</h2>

152 

153當工作階段期間信號相符時,spinner 提示會讀取:

154 

155```text theme={null}

156Working with Terraform? Install the terraform-helpers plugin:

157/plugin install terraform-helpers@acme-corp-plugins

158```

159 

160在工作階段開始時,相符的 `cwd` 信號會顯示一行通知:

161 

162```text theme={null}

163plugin suggestion: terraform-helpers@acme-corp-plugins · /plugin

164```

165 

166給定外掛程式的建議在 spinner 提示和工作階段開始通知的組合中最多每三個工作階段出現一次,安裝外掛程式後兩者都不會重複。工作階段開始通知在建議顯示兩次後還會停止出現。

167 

168{/* min-version: 2.1.154 */}在 `/plugin` Discover 標籤中,外掛程式會被釘選在其他結果上方,並附帶命名相符信號的註解,例如 `suggested for this directory` 或 `suggested for terraform commands`。Discover 標籤釘選給定的外掛程式一次;稍後的訪問會以正常順序列出它。Discover 標籤釘選需要 Claude Code v2.1.154 或更新版本。在 v2.1.152 上,只有 spinner 提示出現;工作階段開始通知在 v2.1.153 中新增。

169 

170<h2 id="validate-your-marketplace">

171 驗證您的 marketplace

172</h2>

173 

174針對您的 marketplace 目錄執行 `claude plugin validate` 以在發佈前檢查 `relevance` 區塊:

175 

176```

177claude plugin validate ./my-marketplace

178```

179 

180驗證器將 `relevance` 和 `relevance.signals` 下的未知鍵報告為警告,標記不是物件的 `relevance` 值,並拒絕包含配置、連接埠或路徑的 `signals.hosts` 項目。

181 

182<h2 id="see-also">

183 另請參閱

184</h2>

185 

186* [建立和發佈外掛程式 marketplace](/zh-TW/plugin-marketplaces):建立託管您的外掛程式的 marketplace

187* [從您的 CLI 推薦您的外掛程式](/zh-TW/plugin-hints):從您自己的 CLI 而不是從 Claude Code 的工作階段信號提示使用者

188* [設定](/zh-TW/settings):`pluginSuggestionMarketplaces` 和 `extraKnownMarketplaces` 的完整參考

prompt-library.md +1319 −0

Details

6 6 

7> 複製貼上提示詞供 Claude Code 使用,按任務和角色標記。7> 複製貼上提示詞供 Claude Code 使用,按任務和角色標記。

8 8 

9export const PromptLibrary = ({text = {}, labels = {}, tagLabels = {}, phaseLabels = {}, sourceLabels = {}, catLabels = {}}) => {

10 const RAW = useMemo(() => [{

11 id: 'get-oriented-in-a',

12 sdlc: 'discover',

13 cat: 'Onboard',

14 startN: 1,

15 roles: [],

16 prompt: 'give me an overview of this codebase: architecture, key directories, and how the pieces connect',

17 nextHref: '/en/memory',

18 src: 'workflows'

19 }, {

20 id: 'explain-unfamiliar-code',

21 sdlc: 'discover',

22 cat: 'Understand',

23 roles: [],

24 prompt: 'explain what {path} does and how data flows through it. write it up as {format}',

25 slots: {

26 path: 'src/scheduler/queue.ts',

27 format: 'an HTML page with a diagram, then open it in my browser'

28 },

29 nextHref: '/en/output-styles',

30 src: 'workflows'

31 }, {

32 id: 'find-where-something-happens',

33 sdlc: 'discover',

34 cat: 'Understand',

35 startN: 2,

36 roles: [],

37 prompt: 'where do we {behavior}?',

38 slots: {

39 behavior: 'validate uploaded file types'

40 },

41 src: 'workflows'

42 }, {

43 id: 'see-what-depends-on',

44 sdlc: 'discover',

45 cat: 'Understand',

46 roles: [],

47 prompt: 'what would break if I deleted {target}?',

48 slots: {

49 target: 'the retryWithBackoff helper'

50 },

51 src: 'workflows'

52 }, {

53 id: 'trace-how-code-evolved',

54 sdlc: 'discover',

55 cat: 'Understand',

56 roles: [],

57 prompt: 'look through the commit history of {path} and summarize how it evolved and why',

58 slots: {

59 path: 'internal/auth/session.go'

60 },

61 src: 'best-practices'

62 }, {

63 id: 'scope-a-change-before',

64 sdlc: 'discover',

65 cat: 'Understand',

66 roles: ['pm', 'design'],

67 prompt: 'which files would I need to touch to {change}?',

68 slots: {

69 change: 'add a dark mode toggle to settings'

70 },

71 src: 'teams'

72 }, {

73 id: 'ask-the-codebase-a',

74 sdlc: 'discover',

75 cat: 'Understand',

76 roles: ['pm'],

77 prompt: 'I am a {role}. walk me through what happens when a user {action}, from the UI down to the result',

78 slots: {

79 role: 'PM',

80 action: 'clicks Export to PDF'

81 },

82 nextHref: '/en/output-styles',

83 src: 'teams'

84 }, {

85 id: 'plan-a-multi-file',

86 sdlc: 'design',

87 cat: 'Plan',

88 roles: ['pm', 'design'],

89 prompt: 'plan how to refactor the {target} to {goal}. list the files you would change, but don\'t edit anything yet',

90 slots: {

91 target: 'payment module',

92 goal: 'support multiple currencies'

93 },

94 src: 'workflows'

95 }, {

96 id: 'draft-a-spec-by',

97 sdlc: 'design',

98 cat: 'Plan',

99 roles: ['pm'],

100 prompt: 'I want to build {feature}. interview me about implementation, UX, edge cases, and tradeoffs until we have covered everything, then write the spec to SPEC.md',

101 slots: {

102 feature: 'per-workspace rate limits'

103 },

104 nextHref: '/en/skills',

105 src: 'best-practices'

106 }, {

107 id: 'turn-a-meeting-into',

108 sdlc: 'design',

109 cat: 'Plan',

110 roles: ['pm'],

111 prompt: 'read {input} and write up the action items, then create a {tracker} ticket for each with acceptance criteria',

112 slots: {

113 input: '@meeting-notes.md',

114 tracker: 'Linear'

115 },

116 needs: 'tracker',

117 nextHref: '/en/skills',

118 src: 'teams'

119 }, {

120 id: 'map-edge-cases-before',

121 sdlc: 'design',

122 cat: 'Plan',

123 roles: ['design', 'pm'],

124 prompt: 'list the error states, empty states, and edge cases for {feature} that the design needs to cover',

125 slots: {

126 feature: 'the file upload flow'

127 },

128 src: 'teams'

129 }, {

130 id: 'turn-a-mockup-into',

131 sdlc: 'design',

132 cat: 'Prototype',

133 roles: ['design', 'pm', 'marketing'],

134 paste: 'mockup',

135 prompt: 'here is a mockup. build a working prototype I can click through, matching the layout and states shown',

136 src: 'teams'

137 }, {

138 id: 'implement-from-a-screenshot',

139 sdlc: 'design',

140 cat: 'Prototype',

141 roles: ['design'],

142 paste: 'design',

143 needs: 'browser',

144 prompt: 'implement this design, then take a screenshot of the result, compare it to the original, and fix any differences',

145 nextHref: '/en/goal',

146 src: 'best-practices'

147 }, {

148 id: 'follow-an-existing-pattern',

149 sdlc: 'build',

150 cat: 'Implement',

151 roles: [],

152 prompt: 'look at how {example} is implemented to understand the pattern, then build {new} the same way',

153 slots: {

154 example: 'the GitHub webhook handler',

155 new: 'a Stripe webhook handler'

156 },

157 nextHref: '/en/memory',

158 src: 'best-practices'

159 }, {

160 id: 'generate-docs-for-code',

161 sdlc: 'build',

162 cat: 'Implement',

163 roles: ['docs'],

164 prompt: 'find {scope} without {format} comments and add them, matching the style already used in the file',

165 slots: {

166 scope: 'the public functions in src/auth/',

167 format: 'JSDoc'

168 },

169 src: 'workflows'

170 }, {

171 id: 'add-a-small-well',

172 sdlc: 'build',

173 cat: 'Implement',

174 roles: [],

175 prompt: 'add a {endpoint} endpoint that returns {payload}',

176 slots: {

177 endpoint: '/health',

178 payload: 'the app version and uptime'

179 },

180 src: 'workflows'

181 }, {

182 id: 'build-a-small-internal',

183 sdlc: 'build',

184 cat: 'Implement',

185 roles: ['pm', 'design', 'marketing', 'docs'],

186 prompt: 'create a {tool} using HTML, CSS, and vanilla JavaScript, then open it in my browser',

187 slots: {

188 tool: 'drag-and-drop Kanban board with three columns'

189 },

190 src: 'teams'

191 }, {

192 id: 'work-an-issue-end',

193 sdlc: 'build',

194 cat: 'Implement',

195 roles: [],

196 prompt: 'read issue #{issue}, implement the fix, and run the tests',

197 slots: {

198 issue: '312'

199 },

200 needs: 'gh',

201 src: 'workflows'

202 }, {

203 id: 'find-and-update-copy',

204 sdlc: 'build',

205 cat: 'Implement',

206 roles: ['design', 'docs', 'marketing'],

207 prompt: 'find every place we say "{copy}" or a close variant, show me each one in context, then update them all to "{new}". leave tests and the changelog alone',

208 slots: {

209 copy: 'Sign up free',

210 new: 'Start free trial'

211 },

212 src: 'teams'

213 }, {

214 id: 'draft-from-past-examples',

215 sdlc: 'build',

216 cat: 'Implement',

217 roles: ['docs', 'marketing', 'pm'],

218 prompt: 'read the {examples} in {folder} to learn the structure and voice, then draft a new one for {topic}',

219 slots: {

220 examples: 'privacy impact assessments',

221 folder: 'legal/pia/',

222 topic: 'the new analytics integration'

223 },

224 nextHref: '/en/skills',

225 src: 'legal'

226 }, {

227 id: 'write-tests-run-them',

228 sdlc: 'build',

229 cat: 'Test',

230 startN: 4,

231 roles: [],

232 prompt: 'write tests for {path}, run them, and fix any failures',

233 slots: {

234 path: 'app/parsers/feed.py'

235 },

236 nextHref: '/en/memory',

237 src: 'workflows'

238 }, {

239 id: 'drive-implementation-from-tests',

240 sdlc: 'build',

241 cat: 'Test',

242 roles: [],

243 prompt: 'write tests for {feature} first, then implement it until they pass',

244 slots: {

245 feature: 'the password reset flow'

246 },

247 src: 'ebook'

248 }, {

249 id: 'fill-gaps-from-a',

250 sdlc: 'build',

251 cat: 'Test',

252 roles: [],

253 prompt: 'read {report} and add tests for the lowest-covered files until each is above {target}%',

254 slots: {

255 report: 'coverage/coverage-summary.json',

256 target: '80'

257 },

258 nextHref: '/en/goal',

259 src: 'workflows'

260 }, {

261 id: 'migrate-a-pattern-across',

262 sdlc: 'build',

263 cat: 'Refactor',

264 roles: [],

265 prompt: 'migrate everything from {from} to {to}: identify every place that needs to change, then make the changes',

266 slots: {

267 from: 'the old logging API',

268 to: 'the structured logger'

269 },

270 src: 'workflows'

271 }, {

272 id: 'port-code-between-languages',

273 sdlc: 'build',

274 cat: 'Refactor',

275 roles: [],

276 prompt: 'port {source} to {target}, keeping the same {keep}',

277 slots: {

278 source: 'this Python module',

279 target: 'Rust',

280 keep: 'public API and test behavior'

281 },

282 src: 'teams'

283 }, {

284 id: 'optimize-against-a-measurable',

285 sdlc: 'build',

286 cat: 'Refactor',

287 roles: ['data'],

288 prompt: 'optimize {target} to bring {metric} from {current} down to under {goal}',

289 slots: {

290 target: 'the search query',

291 metric: 'p95 latency',

292 current: '2s',

293 goal: '500ms'

294 },

295 nextHref: '/en/goal',

296 src: 'ebook'

297 }, {

298 id: 'fix-a-precise-visual',

299 sdlc: 'build',

300 cat: 'Refactor',

301 roles: ['design'],

302 prompt: 'the {element} extends {amount} beyond the {container} on {viewport}. fix it.',

303 slots: {

304 element: 'login button',

305 amount: '20px',

306 container: 'card border',

307 viewport: 'mobile'

308 },

309 nextHref: '/en/desktop#preview-your-app',

310 src: 'ebook'

311 }, {

312 id: 'review-your-changes-before',

313 sdlc: 'build',

314 cat: 'Review',

315 startN: 5,

316 roles: [],

317 prompt: 'review my uncommitted changes and flag anything that looks risky before I commit',

318 nextHref: '/en/commands',

319 src: 'workflows'

320 }, {

321 id: 'review-a-pull-request',

322 sdlc: 'build',

323 cat: 'Review',

324 roles: [],

325 prompt: 'review PR #{pr} and summarize what changed, then list any concerns',

326 slots: {

327 pr: '247'

328 },

329 needs: 'gh',

330 nextHref: '/en/code-review',

331 src: 'workflows'

332 }, {

333 id: 'review-infrastructure-changes-before',

334 sdlc: 'build',

335 cat: 'Review',

336 roles: ['security', 'ops'],

337 paste: 'plan',

338 prompt: 'here is my Terraform plan output. what is this going to do, and is anything here going to cause problems?',

339 src: 'teams'

340 }, {

341 id: 'run-a-security-review',

342 sdlc: 'build',

343 cat: 'Review',

344 roles: ['security'],

345 prompt: 'use a subagent to review {path} for security issues and report what it finds',

346 slots: {

347 path: 'src/api/'

348 },

349 nextHref: '/en/sub-agents',

350 src: 'best-practices'

351 }, {

352 id: 'review-content-before-sending',

353 sdlc: 'build',

354 cat: 'Review',

355 roles: ['marketing', 'docs'],

356 prompt: 'review {file} for {concerns} and list anything I should fix before it goes to {reviewer}',

357 slots: {

358 file: 'launch-post.md',

359 concerns: 'unsupported claims, missing attributions, and brand-guideline issues',

360 reviewer: 'legal'

361 },

362 nextHref: '/en/skills',

363 src: 'legal'

364 }, {

365 id: 'course-correct-a-wrong',

366 sdlc: 'build',

367 cat: 'Steer',

368 roles: [],

369 prompt: 'that is not right: {feedback}. try a different approach',

370 slots: {

371 feedback: 'the function signature needs to stay backward-compatible'

372 },

373 nextHref: '/en/checkpointing',

374 src: 'best-practices'

375 }, {

376 id: 'narrow-the-scope-of',

377 sdlc: 'build',

378 cat: 'Steer',

379 roles: [],

380 prompt: 'that is too much. keep only the changes to {scope} and undo your other edits',

381 slots: {

382 scope: 'the validation logic in src/forms/'

383 },

384 src: 'best-practices'

385 }, {

386 id: 'turn-a-correction-into',

387 sdlc: 'build',

388 cat: 'Steer',

389 roles: [],

390 prompt: 'you keep {mistake}. add a rule to CLAUDE.md so this stops happening',

391 slots: {

392 mistake: 'using default exports when this project uses named exports'

393 },

394 nextHref: '/en/memory',

395 src: 'best-practices'

396 }, {

397 id: 'resolve-merge-conflicts',

398 sdlc: 'ship',

399 cat: 'Git',

400 roles: [],

401 prompt: 'resolve the merge conflicts in this branch and explain what you kept from each side',

402 src: 'workflows'

403 }, {

404 id: 'commit-with-a-generated',

405 sdlc: 'ship',

406 cat: 'Git',

407 roles: [],

408 prompt: 'commit these changes with a message that summarizes what I did',

409 src: 'workflows'

410 }, {

411 id: 'open-a-pull-request',

412 sdlc: 'ship',

413 cat: 'Git',

414 roles: [],

415 prompt: 'find the {tracker} ticket about {topic} and open a PR that implements it',

416 slots: {

417 tracker: 'Linear',

418 topic: 'the login timeout'

419 },

420 needs: 'tracker',

421 src: 'workflows'

422 }, {

423 id: 'draft-release-notes-from',

424 sdlc: 'ship',

425 cat: 'Release',

426 roles: ['pm', 'docs', 'marketing'],

427 prompt: 'compare {from} to {to} and draft release notes grouped by feature, fix, and breaking change',

428 slots: {

429 from: 'v2.3.0',

430 to: 'v2.4.0'

431 },

432 nextHref: '/en/skills',

433 src: 'workflows'

434 }, {

435 id: 'write-a-ci-workflow',

436 sdlc: 'ship',

437 cat: 'Release',

438 roles: ['ops'],

439 prompt: 'write a GitHub Actions workflow that {steps} on every push to {branch}',

440 slots: {

441 steps: 'runs the tests and deploys to staging',

442 branch: 'main'

443 },

444 src: 'workflows'

445 }, {

446 id: 'find-and-fix-a',

447 sdlc: 'operate',

448 cat: 'Debug',

449 startN: 3,

450 roles: [],

451 prompt: 'the {test} test is failing, find out why and fix it',

452 slots: {

453 test: 'UserAuth'

454 },

455 src: 'workflows'

456 }, {

457 id: 'investigate-a-reported-error',

458 sdlc: 'operate',

459 cat: 'Debug',

460 roles: ['ops'],

461 prompt: 'users are seeing {symptom} on {where}. investigate and tell me what is going on',

462 slots: {

463 symptom: '500 errors',

464 where: '/api/settings'

465 },

466 nextHref: '/en/web-quickstart#pre-fill-sessions',

467 src: 'workflows'

468 }, {

469 id: 'fix-a-build-error',

470 sdlc: 'operate',

471 cat: 'Debug',

472 roles: ['ops'],

473 paste: 'error',

474 prompt: 'here is a build error. fix the root cause and verify the build succeeds',

475 src: 'best-practices'

476 }, {

477 id: 'investigate-a-production-incident',

478 sdlc: 'operate',

479 cat: 'Incident',

480 roles: ['ops', 'security'],

481 prompt: '{symptom}. check the logs, recent deploys, and config changes, then tell me the most likely cause',

482 slots: {

483 symptom: 'the checkout endpoint started returning 500s an hour ago'

484 },

485 nextHref: '/en/mcp',

486 src: 'workflows'

487 }, {

488 id: 'diagnose-from-a-console',

489 sdlc: 'operate',

490 cat: 'Incident',

491 roles: ['ops', 'data'],

492 paste: 'screenshot',

493 prompt: 'here is a screenshot of {console}. walk me through why {resource} is failing and give me the exact commands to fix it',

494 slots: {

495 console: 'the GCP Kubernetes dashboard',

496 resource: 'this pod'

497 },

498 src: 'teams'

499 }, {

500 id: 'query-logs-in-plain',

501 sdlc: 'operate',

502 cat: 'Incident',

503 roles: ['security', 'ops', 'data'],

504 prompt: 'show me all {events} for {scope} over {timeframe}. write the query, run it, and tell me what stands out',

505 slots: {

506 events: 'failed logins',

507 scope: 'the auth service',

508 timeframe: 'the past 24 hours'

509 },

510 needs: 'db',

511 src: 'cybersecurity'

512 }, {

513 id: 'analyze-a-data-file',

514 sdlc: 'operate',

515 cat: 'Data',

516 roles: ['data', 'pm', 'marketing'],

517 paste: 'csv',

518 prompt: 'read {file}, summarize the key patterns, and write the results to {output}',

519 slots: {

520 file: '@reports/q1-signups.csv',

521 output: 'an HTML page with charts, then open it in my browser'

522 },

523 nextHref: '/en/mcp',

524 src: 'teams'

525 }, {

526 id: 'generate-variations-from-performance',

527 sdlc: 'operate',

528 cat: 'Data',

529 roles: ['marketing', 'data'],

530 paste: 'csv',

531 prompt: 'read {file}, find the underperforming {items}, and generate {n} new variations that stay under {limit} characters',

532 slots: {

533 file: '@ads-performance.csv',

534 items: 'headlines',

535 n: '20',

536 limit: '90'

537 },

538 nextHref: '/en/mcp',

539 src: 'teams'

540 }, {

541 id: 'turn-a-recurring-task',

542 sdlc: 'operate',

543 cat: 'Automate',

544 roles: [],

545 prompt: 'create a /{name} skill for this project that {steps}',

546 slots: {

547 name: 'ship',

548 steps: 'runs the linter and tests, then drafts a commit message'

549 },

550 src: 'workflows'

551 }, {

552 id: 'add-a-hook-for',

553 sdlc: 'operate',

554 cat: 'Automate',

555 roles: [],

556 prompt: 'write a hook that {action} after every {event}',

557 slots: {

558 action: 'runs prettier',

559 event: 'edit to a .ts or .tsx file'

560 },

561 src: 'best-practices'

562 }, {

563 id: 'connect-a-tool-with',

564 sdlc: 'operate',

565 cat: 'Automate',

566 roles: [],

567 prompt: 'set up the {server} MCP server so you can read my {data} directly',

568 slots: {

569 server: 'Sentry',

570 data: 'error reports'

571 },

572 src: 'workflows'

573 }, {

574 id: 'capture-what-to-remember',

575 sdlc: 'operate',

576 cat: 'Automate',

577 roles: ['pm', 'docs'],

578 prompt: 'summarize what we did this session and suggest what to add to CLAUDE.md',

579 src: 'teams'

580 }], []);

581 const PROMPTS = useMemo(() => {

582 if (typeof window !== 'undefined') {

583 const rawIds = new Set(RAW.map(p => p.id));

584 RAW.forEach(p => {

585 if (!text[p.id]) console.warn('[prompt-library] no text[] entry for id:', p.id);

586 });

587 Object.keys(text).forEach(k => {

588 if (!rawIds.has(k)) console.warn('[prompt-library] orphaned text[] key:', k);

589 });

590 }

591 return RAW.map(p => ({

592 ...p,

593 title: p.id,

594 teaches: '',

595 ...text[p.id] || ({})

596 }));

597 }, [RAW, text]);

598 const L = labels;

599 const TL = k => tagLabels[k] || k;

600 const CAT_TAG = useMemo(() => ({

601 Onboard: 'understand',

602 Understand: 'understand',

603 Plan: 'plan',

604 Prototype: 'prototype',

605 Implement: 'build',

606 Test: 'test',

607 Refactor: 'refactor',

608 Review: 'review',

609 Steer: 'steer',

610 Git: 'git',

611 Release: 'release',

612 Debug: 'debug',

613 Incident: 'debug',

614 Data: 'data',

615 Automate: 'automate'

616 }), []);

617 const TAGS = useMemo(() => ['understand', 'plan', 'prototype', 'build', 'test', 'refactor', 'review', 'steer', 'debug', 'git', 'release', 'data', 'automate', 'pm', 'design', 'docs', 'marketing', 'security', 'ops'], []);

618 const tagsOf = p => [CAT_TAG[p.cat], ...p.roles || []];

619 const doc = useMemo(() => {

620 const p = typeof window !== 'undefined' ? window.location.pathname : '';

621 const base = p.startsWith('/docs/') ? '/docs' : '';

622 const m = p.slice(base.length).match(/^\/([a-z]{2}(?:-[A-Z]{2})?)\//);

623 const locale = m ? m[1] : 'en';

624 return href => {

625 if (!href || href[0] !== '/' || href[1] === '/') return href;

626 return base + (href.startsWith('/en/') ? '/' + locale + href.slice(3) : href);

627 };

628 }, []);

629 const linkify = s => {

630 const out = [];

631 let last = 0;

632 const re = /\[([^\]]+)\]\(([^)]+)\)/g;

633 for (let m; m = re.exec(s); ) {

634 if (m.index > last) out.push(s.slice(last, m.index));

635 out.push(<a key={m.index} href={doc(m[2])}>{m[1]}</a>);

636 last = re.lastIndex;

637 }

638 if (last < s.length) out.push(s.slice(last));

639 return out;

640 };

641 const codeify = s => s.split(/(`[^`]+`)/g).map((part, i) => part[0] === '`' ? <code key={i}>{part.slice(1, -1)}</code> : part);

642 const SOURCES = useMemo(() => ({

643 'workflows': '/en/common-workflows',

644 'teams': 'https://claude.com/blog/how-anthropic-teams-use-claude-code',

645 'legal': 'https://claude.com/blog/how-anthropic-uses-claude-legal',

646 'cybersecurity': 'https://claude.com/blog/how-anthropic-uses-claude-cybersecurity',

647 'best-practices': '/en/best-practices',

648 'ebook': 'https://resources.anthropic.com/hubfs/Scaling%20agentic%20coding%20across%20your%20organization.pdf'

649 }), []);

650 const [mounted, setMounted] = useState(false);

651 const [q, setQ] = useState('');

652 const [start, setStart] = useState(true);

653 const [sel, setSel] = useState(null);

654 const [openId, setOpenId] = useState(null);

655 const [copied, setCopied] = useState(null);

656 const [fills, setFills] = useState({});

657 const copyTimer = useRef(null);

658 useEffect(() => {

659 setMounted(true);

660 return () => clearTimeout(copyTimer.current);

661 }, []);

662 const setFill = (id, key, val) => setFills(f => ({

663 ...f,

664 [id + '.' + key]: val

665 }));

666 const fillOf = (p, key) => {

667 const v = fills[p.id + '.' + key];

668 return v !== undefined ? v : p.slots && p.slots[key] !== undefined ? p.slots[key] : '';

669 };

670 const assemble = p => p.prompt.replace(/\{(\w+)\}/g, (_, k) => fillOf(p, k) || p.slots && p.slots[k] || k);

671 const preview = p => p.prompt.replace(/\{(\w+)\}/g, (_, k) => p.slots && p.slots[k] || k);

672 const bodyText = p => preview(p) + ' ' + p.teaches.replace(/\[([^\]]+)\]\([^)]+\)/g, '$1') + ' ' + (p.next || '');

673 const widthFor = s => (s || '').length + 3 + 'ch';

674 const ql = q.trim().toLowerCase();

675 const toggleTag = k => {

676 setStart(false);

677 setSel(s => !ql && s === k ? null : k);

678 };

679 const clear = () => {

680 setStart(false);

681 setSel(null);

682 setQ('');

683 };

684 const results = useMemo(() => {

685 const list = PROMPTS.filter(p => {

686 if (ql) return p.title.toLowerCase().includes(ql) || bodyText(p).toLowerCase().includes(ql);

687 if (start) return !!p.startN;

688 if (sel) return tagsOf(p).includes(sel);

689 return true;

690 });

691 if (ql) return list;

692 if (start) return list.sort((a, b) => a.startN - b.startN);

693 if (sel) return list.sort((a, b) => (a.roles || []).length - (b.roles || []).length || (b.sdlc === 'operate') - (a.sdlc === 'operate'));

694 return list;

695 }, [PROMPTS, ql, start, sel]);

696 const matchSnippet = p => {

697 if (!ql || p.title.toLowerCase().includes(ql)) return null;

698 const txt = bodyText(p);

699 const at = txt.toLowerCase().indexOf(ql);

700 if (at < 0) return null;

701 const lo = Math.max(0, at - 30), hi = Math.min(txt.length, at + ql.length + 50);

702 return [lo > 0 ? '…' : '', txt.slice(lo, at), <mark key="m">{txt.slice(at, at + ql.length)}</mark>, txt.slice(at + ql.length, hi), hi < txt.length ? '…' : ''];

703 };

704 const grouped = useMemo(() => {

705 if (start && !q.trim()) return [];

706 const g = {};

707 for (const p of results) {

708 const key = p.sdlc + '|' + p.cat;

709 (g[key] = g[key] || ({

710 sdlc: p.sdlc,

711 cat: p.cat,

712 items: []

713 })).items.push(p);

714 }

715 return Object.values(g);

716 }, [results, start, q]);

717 const copy = async (str, id) => {

718 try {

719 await navigator.clipboard.writeText(str);

720 } catch {

721 const ta = document.createElement('textarea');

722 ta.value = str;

723 ta.setAttribute('readonly', '');

724 ta.style.position = 'fixed';

725 ta.style.opacity = '0';

726 document.body.appendChild(ta);

727 ta.select();

728 document.execCommand('copy');

729 document.body.removeChild(ta);

730 }

731 clearTimeout(copyTimer.current);

732 setCopied(id);

733 copyTimer.current = setTimeout(() => setCopied(null), 1600);

734 };

735 const promptBody = p => {

736 if (!p.slots) return <code>{p.prompt}</code>;

737 const parts = p.prompt.split(/(\{\w+\})/g);

738 return <code>

739 {parts.map((part, idx) => {

740 const m = part.match(/^\{(\w+)\}$/);

741 if (!m) return <span key={idx}>{part}</span>;

742 const k = m[1];

743 const val = fillOf(p, k);

744 return <input key={idx} type="text" className="pl-slot" value={val} placeholder={p.slots[k] || k} aria-label={k} style={{

745 width: widthFor(val || p.slots[k])

746 }} onChange={e => setFill(p.id, k, e.target.value)} onFocus={e => e.target.select()} onClick={e => e.stopPropagation()} />;

747 })}

748 </code>;

749 };

750 const card = p => {

751 const open = openId === p.id;

752 const srcHref = SOURCES[p.src];

753 const srcLabel = sourceLabels[p.src];

754 const snip = matchSnippet(p);

755 return <div key={p.id} className={'pl-card' + (open ? ' pl-open' : '')}>

756 <button type="button" className="pl-head" onClick={() => setOpenId(open ? null : p.id)} aria-expanded={open}>

757 <span className="pl-title">{p.title}</span>

758 {!!p.startN && <span className="pl-chip">{L.startHere} · {p.startN}</span>}

759 </button>

760 {snip ? <div className="pl-match">{snip}</div> : <code className="pl-prompt-preview">{preview(p)}</code>}

761 {open && <div className="pl-body">

762 <div className="pl-label">{p.slots ? L.fillAndCopy : L.copyThis}</div>

763 {p.needs && L.needs && L.needs[p.needs] && <div className="pl-hint pl-needs">

764 <span className="pl-needs-label">{L.needsLabel}</span> {linkify(L.needs[p.needs])}

765 </div>}

766 {p.paste && L.paste && L.paste[p.paste] && <div className="pl-hint pl-paste">{L.paste[p.paste]}</div>}

767 {p.slots && <div className="pl-hint">

768 {L.hintBefore} <span className="pl-hint-chip">{L.hintChip}</span> {L.hintAfter}

769 </div>}

770 <div className="pl-prompt-box">

771 <span className="pl-caret">{'❯'}</span>

772 {promptBody(p)}

773 <button type="button" className="pl-copy" onClick={() => copy(assemble(p), p.id)}>

774 {copied === p.id ? L.copied : L.copy}

775 </button>

776 </div>

777 <div className="pl-label">{L.whyWorks}</div>

778 <div className="pl-teaches">{linkify(p.teaches)}</div>

779 {p.nextHref && p.next && <div className="pl-next">

780 <span className="pl-next-label">{L.makeItStick}</span>

781 <a href={doc(p.nextHref)}>{codeify(p.next)} →</a>

782 </div>}

783 {srcLabel && <div className="pl-src">{L.from} {srcHref ? <a href={doc(srcHref)}>{srcLabel}</a> : srcLabel}</div>}

784 </div>}

785 </div>;

786 };

787 const STYLES = useMemo(() => `

788.pl {

789 --pl-accent: #D97757;

790 --pl-accent-bg: rgba(217,119,87,0.07);

791 --pl-bg: #fff;

792 --pl-surface: #FAFAF7;

793 --pl-border: #E8E6DC;

794 --pl-border-subtle: rgba(31,30,29,0.08);

795 --pl-text: #141413;

796 --pl-text-2: #5E5D59;

797 --pl-text-3: #73726C;

798 --pl-text-4: #9C9A92;

799 --pl-mono: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, monospace);

800 font-family: 'Anthropic Sans', -apple-system, BlinkMacSystemFont, sans-serif;

801 font-size: 16px; color: var(--pl-text); margin: 8px 0 32px;

802}

803.dark .pl {

804 --pl-bg: #1f1e1d;

805 --pl-surface: #262624;

806 --pl-border: #3d3d3a;

807 --pl-border-subtle: rgba(240,238,230,0.08);

808 --pl-text: #f0eee6;

809 --pl-text-2: #bfbdb4;

810 --pl-text-3: #91908a;

811 --pl-text-4: #73726c;

812}

813.pl *, .pl *::before, .pl *::after { box-sizing: border-box; }

814.pl button { font-family: inherit; cursor: pointer; }

815.pl a { color: var(--pl-accent); text-decoration: none; }

816.pl a:hover { text-decoration: underline; }

817 

818.pl-search {

819 display: flex; align-items: center; gap: 10px;

820 padding: 14px 18px; background: var(--pl-surface);

821 border: 1px solid var(--pl-border); border-radius: 12px;

822 margin-bottom: 14px;

823}

824.pl-search input {

825 flex: 1; border: none; outline: none; background: transparent;

826 font-size: 16px; color: var(--pl-text);

827}

828.pl-search input::placeholder { color: var(--pl-text-4); }

829 

830.pl-tags { display: flex; gap: 8px; flex-wrap: wrap; align-items: center; margin-bottom: 18px; }

831.pl-tag {

832 padding: 7px 14px; border: 1px solid var(--pl-border); background: var(--pl-bg);

833 font-size: 14px; color: var(--pl-text-2); border-radius: 999px;

834}

835.pl-tag:hover { background: var(--pl-surface); }

836.pl-tag.pl-on { background: var(--pl-text); border-color: var(--pl-text); color: var(--pl-bg); }

837.pl-tag.pl-start { color: var(--pl-accent); font-weight: 500; }

838.pl-tag.pl-start.pl-on { background: var(--pl-accent); border-color: var(--pl-accent); color: #fff; }

839.pl-tags.pl-dim .pl-tag { opacity: 0.5; }

840.pl-tags.pl-dim .pl-tag:hover { opacity: 1; }

841.pl-sep { width: 1px; height: 22px; background: var(--pl-border); margin: 0 4px; }

842.pl-clear { border: none; background: none; font-size: 13px; color: var(--pl-text-4); padding: 4px 6px; }

843.pl-clear:hover { color: var(--pl-text-2); }

844.pl-count { margin-left: auto; font-size: 14px; color: var(--pl-text-4); }

845 

846.pl-group-h {

847 font-size: 12px; letter-spacing: 0.08em; text-transform: uppercase;

848 color: var(--pl-text-4); margin: 24px 0 12px;

849}

850.pl-group-h .pl-phase { color: var(--pl-text-3); }

851.pl-card {

852 border: 1px solid var(--pl-border-subtle); border-radius: 10px;

853 margin-bottom: 12px; background: var(--pl-bg); overflow: hidden;

854 padding: 14px 18px;

855}

856.pl-card.pl-open { border-color: var(--pl-border); background: var(--pl-surface); }

857.pl-head {

858 width: 100%; display: flex; align-items: baseline; gap: 12px;

859 border: none; background: transparent; text-align: left; padding: 0;

860}

861.pl-head:focus-visible { outline: 2px solid var(--pl-accent); outline-offset: 2px; border-radius: 6px; }

862.pl-title {

863 flex: 1; font-size: 17px; font-weight: 500; color: var(--pl-text);

864 white-space: nowrap; overflow: hidden; text-overflow: ellipsis;

865}

866.pl-prompt-preview {

867 display: block; font-family: var(--pl-mono); font-size: 13.5px; color: var(--pl-text-3);

868 margin-top: 6px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis;

869}

870.pl-chip {

871 font-size: 11px; letter-spacing: 0.05em; text-transform: uppercase;

872 padding: 3px 9px; border-radius: 999px; flex-shrink: 0;

873 background: var(--pl-accent-bg); color: var(--pl-accent);

874}

875 

876.pl-body { margin-top: 14px; padding-top: 14px; border-top: 1px solid var(--pl-border-subtle); }

877.pl-label {

878 font-size: 11.5px; letter-spacing: 0.08em; text-transform: uppercase;

879 color: var(--pl-text-4); margin: 12px 0 8px;

880}

881.pl-prompt-box {

882 display: flex; align-items: center; gap: 10px;

883 padding: 14px 16px; background: #141413; color: #f0eee6;

884 border-radius: 8px; font-family: var(--pl-mono); font-size: 15px;

885}

886.pl-caret { color: var(--pl-accent); flex-shrink: 0; }

887.pl-prompt-box code { flex: 1; background: none; padding: 0; color: inherit; white-space: pre-wrap; line-height: 1.9; }

888.pl-slot {

889 font-family: var(--pl-mono); font-size: inherit;

890 background: rgba(217,119,87,0.15); color: #f0eee6;

891 border: none; border-bottom: 1.5px dashed var(--pl-accent);

892 border-radius: 4px 4px 0 0; padding: 2px 6px; margin: 0 1px;

893 outline: none; min-width: 6ch; max-width: 100%;

894 box-sizing: content-box; cursor: text;

895}

896.pl-slot:hover { background: rgba(217,119,87,0.22); }

897.pl-slot:focus { background: rgba(217,119,87,0.28); border-bottom-style: solid; }

898.pl-slot::placeholder { color: rgba(240,238,230,0.4); font-style: italic; }

899.pl-hint { font-size: 14px; color: var(--pl-text-3); margin: 0 0 10px; }

900.pl-paste { color: var(--pl-text-2); }

901.pl-needs { color: var(--pl-text-2); }

902.pl-needs-label {

903 display: inline-block; font-size: 10.5px; letter-spacing: 0.06em;

904 text-transform: uppercase; padding: 2px 7px; margin-right: 6px;

905 border-radius: 4px; background: var(--pl-accent-bg); color: var(--pl-accent);

906}

907.pl-hint-chip {

908 font-family: var(--pl-mono); font-size: 0.92em;

909 background: var(--pl-accent-bg); color: var(--pl-accent);

910 border-bottom: 1.5px dashed var(--pl-accent);

911 border-radius: 3px 3px 0 0; padding: 1px 5px;

912}

913.pl-copy {

914 font-size: 12.5px; padding: 6px 12px; border-radius: 6px;

915 background: var(--pl-accent); color: #fff; border: none; flex-shrink: 0;

916}

917.pl-teaches { display: block; font-size: 15.5px; color: var(--pl-text-2); margin: 4px 0 0; line-height: 1.6; }

918.pl-match {

919 display: block; font-size: 13.5px; color: var(--pl-text-3);

920 margin-top: 6px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis;

921}

922.pl-match mark { background: var(--pl-accent-bg); color: var(--pl-text); padding: 1px 2px; border-radius: 3px; }

923.pl-next {

924 display: flex; align-items: baseline; gap: 10px;

925 margin: 14px 0 0; padding: 10px 12px;

926 background: var(--pl-accent-bg); border-radius: 8px; font-size: 14.5px;

927}

928.pl-next-label {

929 font-size: 11px; letter-spacing: 0.06em; text-transform: uppercase;

930 color: var(--pl-accent); font-weight: 600; flex-shrink: 0;

931}

932.pl-src { display: block; font-size: 14px; color: var(--pl-text-4); margin: 14px 0 0; }

933 

934.pl-show-all {

935 display: block; width: 100%; padding: 14px; margin-top: 4px;

936 border: 1px dashed var(--pl-border); border-radius: 10px;

937 background: transparent; font-size: 15px; color: var(--pl-accent);

938 text-align: center;

939}

940.pl-show-all:hover { background: var(--pl-accent-bg); border-style: solid; }

941 

942.pl-empty {

943 padding: 32px; text-align: center; color: var(--pl-text-4);

944 border: 1px dashed var(--pl-border); border-radius: 10px;

945}

946`, []);

947 if (!mounted) return <div className="pl" style={{

948 minHeight: 480

949 }} />;

950 return <div className="pl">

951 <style>{STYLES}</style>

952 

953 <div className="pl-search">

954 <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" style={{

955 color: 'var(--pl-text-4)'

956 }}>

957 <circle cx="11" cy="11" r="7" /><line x1="21" y1="21" x2="16.65" y2="16.65" />

958 </svg>

959 <input type="text" placeholder={L.search} value={q} onChange={e => {

960 setQ(e.target.value);

961 if (e.target.value) setStart(false);

962 }} aria-label={L.search} />

963 </div>

964 

965 <div className={'pl-tags' + (ql ? ' pl-dim' : '')}>

966 <button type="button" className={'pl-tag pl-start' + (!ql && start ? ' pl-on' : '')} onClick={() => {

967 setQ('');

968 setStart(!start);

969 if (!start) setSel(null);

970 }}>

971 ★ {L.startHere}

972 </button>

973 <span className="pl-sep" />

974 {TAGS.map(k => <button key={k} type="button" aria-pressed={!ql && sel === k} className={'pl-tag' + (!ql && sel === k ? ' pl-on' : '')} onClick={() => {

975 setQ('');

976 toggleTag(k);

977 }}>

978 {TL(k)}

979 </button>)}

980 {(start || sel || q) && <button type="button" className="pl-clear" onClick={clear}>{L.clear}</button>}

981 <span className="pl-count">{results.length} {results.length === 1 ? L.prompt : L.prompts}</span>

982 </div>

983 

984 {results.length === 0 ? <div className="pl-empty">

985 {L.noMatch} {ql ? <code>{q}</code> : null} <button type="button" className="pl-clear" onClick={clear}>{L.clear}</button>

986 </div> : !ql && start ? <div>

987 <div className="pl-group-h">{L.startHereHeader}</div>

988 {results.map(card)}

989 <button type="button" className="pl-show-all" onClick={clear}>

990 {L.showAll && L.showAll.replace('{n}', PROMPTS.length)} →

991 </button>

992 </div> : grouped.map(g => <div key={g.sdlc + '|' + g.cat}>

993 <div className="pl-group-h"><span className="pl-phase">{phaseLabels[g.sdlc] || g.sdlc}</span> · {catLabels[g.cat] || g.cat}</div>

994 {g.items.map(card)}

995 </div>)}

996 </div>;

997};

998 

9這是一個提示詞庫,可複製貼上到 Claude Code 中。使用它來探索您未曾嘗試過的工作方式,或當您不確定從何開始時使用。999這是一個提示詞庫,可複製貼上到 Claude Code 中。使用它來探索您未曾嘗試過的工作方式,或當您不確定從何開始時使用。

10 1000 

11這些提示詞來自各種 Anthropic 指南,包括[常見工作流程](/zh-TW/common-workflows)、[最佳實踐](/zh-TW/best-practices)和[Anthropic 團隊如何使用 Claude Code](https://claude.com/blog/how-anthropic-teams-use-claude-code)。它們是起點而非腳本。在任何提示詞下打開**為什麼這有效**以查看其背後的模式,這樣您可以編寫自己的提示詞。1001這些提示詞來自各種 Anthropic 指南,包括[常見工作流程](/zh-TW/common-workflows)、[最佳實踐](/zh-TW/best-practices)和[Anthropic 團隊如何使用 Claude Code](https://claude.com/blog/how-anthropic-teams-use-claude-code)。它們是起點而非腳本。在任何提示詞下打開**為什麼這有效**以查看其背後的模式,這樣您可以編寫自己的提示詞。

12 1002 

1003export const labels = {

1004 startHere: "從這裡開始",

1005 startHereHeader: "五個首先嘗試的提示詞",

1006 showAll: "顯示全部 {n} 個提示詞",

1007 search: "搜尋提示詞…",

1008 clear: "清除",

1009 prompt: "提示詞",

1010 prompts: "提示詞",

1011 noMatch: "沒有提示詞符合",

1012 fillAndCopy: "填入並複製",

1013 copyThis: "複製此提示詞",

1014 hintBefore: "在",

1015 hintChip: "突出顯示的",

1016 hintAfter: "欄位中輸入以自訂,然後複製。",

1017 copy: "複製",

1018 copied: "已複製",

1019 whyWorks: "為什麼這有效",

1020 makeItStick: "使其堅持",

1021 from: "來自",

1022 paste: {

1023 mockup: "貼上、拖曳或 @-提及您的模型圖像,然後發送此內容:",

1024 design: "貼上、拖曳或 @-提及您的設計圖像,然後發送此內容:",

1025 screenshot: "貼上、拖曳或 @-提及您的螢幕截圖,然後發送此內容:",

1026 plan: "首先將您的計畫輸出貼上到提示詞中,然後發送此內容:",

1027 error: "首先將錯誤輸出貼上到提示詞中,然後發送此內容:",

1028 csv: "將您的檔案拖入提示詞中,或將下方路徑替換為您自己的 @-提及:"

1029 },

1030 needsLabel: "需要",

1031 needs: {

1032 tracker: "您的問題追蹤器已新增為 [claude.ai 連接器](/zh-TW/mcp#use-mcp-servers-from-claude-ai)或 [MCP 伺服器](/zh-TW/mcp)。",

1033 gh: "[gh CLI](https://cli.github.com) 已驗證,或 GitHub 已新增為 [claude.ai 連接器](/zh-TW/mcp#use-mcp-servers-from-claude-ai)。",

1034 browser: "Claude 可以呈現和截圖結果的方式。[桌面應用程式](/zh-TW/desktop#preview-your-app)內建此功能。在終端中,安裝 [Chrome 擴充功能](/zh-TW/chrome)或 Playwright [MCP](/zh-TW/mcp) 伺服器。",

1035 db: "您的資料倉庫或日誌存儲已新增為 [claude.ai 連接器](/zh-TW/mcp#use-mcp-servers-from-claude-ai)或 [MCP 伺服器](/zh-TW/mcp)。"

1036 }

1037};

1038 

1039export const tagLabels = {

1040 understand: "理解",

1041 plan: "計畫",

1042 prototype: "原型",

1043 build: "建置",

1044 test: "測試",

1045 refactor: "重構",

1046 review: "審查",

1047 steer: "引導",

1048 debug: "除錯",

1049 git: "Git",

1050 release: "發佈",

1051 data: "資料",

1052 automate: "自動化",

1053 pm: "產品",

1054 design: "設計",

1055 docs: "文件",

1056 marketing: "行銷",

1057 security: "安全",

1058 ops: "待命"

1059};

1060 

1061export const phaseLabels = {

1062 discover: "探索",

1063 design: "設計",

1064 build: "建置",

1065 ship: "發佈",

1066 operate: "運營"

1067};

1068 

1069export const sourceLabels = {

1070 workflows: "常見工作流程",

1071 teams: "Anthropic 團隊如何使用 Claude Code",

1072 legal: "Anthropic 如何在法律中使用 Claude",

1073 cybersecurity: "Anthropic 如何在網路安全中使用 Claude",

1074 "best-practices": "最佳實踐",

1075 ebook: "擴展代理編碼指南"

1076};

1077 

1078export const catLabels = {

1079 Onboard: "入職",

1080 Understand: "理解",

1081 Plan: "計畫",

1082 Prototype: "原型",

1083 Implement: "實施",

1084 Test: "測試",

1085 Refactor: "重構",

1086 Review: "審查",

1087 Steer: "引導",

1088 Git: "Git",

1089 Release: "發佈",

1090 Debug: "除錯",

1091 Incident: "事件",

1092 Data: "資料",

1093 Automate: "自動化"

1094};

1095 

1096export const text = {

1097 "get-oriented-in-a": {

1098 title: "在新儲存庫中定位",

1099 teaches: "描述您想了解的內容,而不是要讀取哪些檔案。Claude 自行探索專案並返回其如何組合在一起的摘要。",

1100 next: "執行 `/init` 以設定 `CLAUDE.md`,以便 Claude 在每個工作階段中記住這一點"

1101 },

1102 "explain-unfamiliar-code": {

1103 title: "解釋不熟悉的程式碼",

1104 teaches: "命名檔案並說出您想要答案的格式。將 HTML 頁面交換為圖表、項目符號或任何適合您學習方式的內容。",

1105 next: "設定輸出樣式,以便 Claude 始終以您偏好的格式進行解釋"

1106 },

1107 "find-where-something-happens": {

1108 title: "找到某事發生的位置",

1109 teaches: "按行為而不是按檔案名稱搜尋。即使您不知道檔案的名稱或它位於哪個目錄,搜尋也能運作。"

1110 },

1111 "see-what-depends-on": {

1112 title: "在刪除前檢查什麼會中斷",

1113 teaches: "在移除任何內容前先詢問。呼叫者清單和下游效應告訴您是在查看單行清理還是需要協調的變更。"

1114 },

1115 "trace-how-code-evolved": {

1116 title: "追蹤程式碼如何演變",

1117 teaches: "當問題是為什麼而不是什麼時,指向提交歷史。Claude 讀取您使用的任何版本控制的日誌和責備,並解釋目前實施背後的決策。"

1118 },

1119 "scope-a-change-before": {

1120 title: "在開始前確定變更的範圍",

1121 teaches: "在將其提交到路線圖前調整工作大小。檔案清單告訴您是在查看一個元件還是跨越式變更。"

1122 },

1123 "ask-the-codebase-a": {

1124 title: "向程式碼庫詢問產品問題",

1125 teaches: "說明您的角色,以便答案在正確的級別上。Claude 從原始程式碼解釋產品實際執行的內容,無需您讀取它。",

1126 next: "設定輸出樣式,以便 Claude 始終在此級別上提供答案"

1127 },

1128 "plan-a-multi-file": {

1129 title: "在觸及程式碼前計畫多檔案變更",

1130 teaches: "新增「暫不編輯」可將探索與變更分開,以便您在任何程式碼移動前看到方法。若要在每個提示詞上將計畫優先設為預設,請按 Shift+Tab 進入[計畫模式](/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode)。"

1131 },

1132 "draft-a-spec-by": {

1133 title: "透過訪談草擬規格",

1134 teaches: "要求被訪談而不是自己編寫規格。Claude 詢問您結構化問題,直到需求完整,然後將結果寫入檔案。",

1135 next: "將您的訪談問題儲存為 `/spec` 技能,以便每個規格都以相同方式開始"

1136 },

1137 "turn-a-meeting-into": {

1138 title: "將會議轉換為工單",

1139 teaches: "跳過轉錄步驟。Claude 從非結構化輸入中提取行動項目,並透過 [MCP](/zh-TW/mcp) 直接將其寫入您的追蹤器,以便您審查工單而不是轉錄。",

1140 next: "將此儲存為 `/tickets` 技能"

1141 },

1142 "map-edge-cases-before": {

1143 title: "在建置前對邊界情況進行對應",

1144 teaches: "詢問缺少什麼,而不是存在什麼。Claude 列出錯誤狀態、空狀態和邊界情況,這些是快樂路徑設計傾向於跳過的。"

1145 },

1146 "turn-a-mockup-into": {

1147 title: "將模型轉換為可運作的原型",

1148 teaches: "可點擊的原型回答靜態模型無法回答的問題。將可運作的程式碼交給工程部門,而不是在文件中解釋互動。"

1149 },

1150 "implement-from-a-screenshot": {

1151 title: "從螢幕截圖實施並自我檢查",

1152 teaches: "這為 Claude 提供了驗證迴圈:它呈現、與來源圖像進行比較,並在您指出每個差距前進行迭代。",

1153 next: "使用 `/goal` 讓 Claude 持續迭代,直到螢幕截圖相符"

1154 },

1155 "follow-an-existing-pattern": {

1156 title: "遵循現有模式",

1157 teaches: "指向您已經喜歡的程式碼。沒有參考,Claude 預設為一般最佳實踐。有了參考,它就會符合您的程式碼庫實際使用的慣例。",

1158 next: "要求 Claude 將其遵循的模式寫入 `CLAUDE.md`,以便未來工作階段無需參考即可符合它"

1159 },

1160 "add-a-small-well": {

1161 title: "新增小型、定義明確的功能",

1162 teaches: "說明輸入和輸出,而不是如何建置它。Claude 找到類似程式碼所在的位置,並將您的程式碼添加到其旁邊。"

1163 },

1164 "build-a-small-internal": {

1165 title: "從頭開始建置小型內部工具",

1166 teaches: "您不需要專案、框架或建置步驟。描述工具並要求 Claude 打開它,以便您立即看到它運作。"

1167 },

1168 "work-an-issue-end": {

1169 title: "端到端處理問題",

1170 teaches: "提供問題編號,而不是摘要。Claude 自行讀取完整工單,因此您會忘記提及的需求會通過,並在報告前驗證變更。"

1171 },

1172 "find-and-update-copy": {

1173 title: "在程式碼庫中尋找並更新副本",

1174 teaches: "詢問變體並說出要跳過的內容。Claude 找到字面搜尋會遺漏的措辭,並保持測試夾具和歷史記錄不變,以便您只審查使用者實際看到的副本。"

1175 },

1176 "draft-from-past-examples": {

1177 title: "從過去的範例草擬文件",

1178 teaches: "指向已完成工作的資料夾,而不是描述您的風格。Claude 從您已發佈的內容中學習結構和聲音,因此第一稿讀起來像您的其中之一。",

1179 next: "將聲音儲存為技能,以便每個草稿都從那裡開始"

1180 },

1181 "write-tests-run-them": {

1182 title: "編寫測試、執行測試、修復失敗",

1183 teaches: "一起要求編寫、執行和修復,以便 Claude 在不停止以獲取指示的情況下進行迭代。",

1184 next: "執行 `/init` 以便 Claude 自動學習您的測試命令"

1185 },

1186 "drive-implementation-from-tests": {

1187 title: "從測試驅動實施",

1188 teaches: "測試驅動開發:測試定義工作何時完成,Claude 在實施上進行迭代,直到它們通過。"

1189 },

1190 "fill-gaps-from-a": {

1191 title: "從涵蓋範圍報告填補空白",

1192 teaches: "指向涵蓋範圍報告,而不是猜測未測試的內容。Claude 讀取實際數字並為最需要的檔案編寫測試。",

1193 next: "將此設定為 `/goal`,以便 Claude 持續編寫測試,直到涵蓋範圍達到目標"

1194 },

1195 "port-code-between-languages": {

1196 title: "將程式碼移植到另一種語言",

1197 teaches: "說出要保留的內容,而不僅僅是目標語言。命名必須保持相同的 API 或行為,為 Claude 提供了一份合約來檢查移植。"

1198 },

1199 "generate-docs-for-code": {

1200 title: "為未記錄的程式碼產生文件",

1201 teaches: "命名範圍和格式。Claude 找到缺少的內容並符合檔案中已有的註解樣式,因此新文件讀起來像其餘部分。"

1202 },

1203 "migrate-a-pattern-across": {

1204 title: "在程式碼庫中遷移模式",

1205 teaches: "描述舊模式和新模式。要求 Claude 首先識別每個位置意味著呼叫網站在回應中列出,以便您可以檢查是否未遺漏任何內容。"

1206 },

1207 "optimize-against-a-measurable": {

1208 title: "針對可測量目標進行最佳化",

1209 teaches: "說明指標和目標為 Claude 提供了明確的完成定義。",

1210 next: "將此設定為 `/goal`,以便 Claude 持續測量和迭代,直到達到該數字"

1211 },

1212 "fix-a-precise-visual": {

1213 title: "修復精確的視覺錯誤",

1214 teaches: "精確的視覺回饋會得到精確的修復。說明確切的元素、測量和視埠。",

1215 next: "新增預覽工具,以便 Claude 自行截圖並驗證修復"

1216 },

1217 "review-your-changes-before": {

1218 title: "在提交前審查您的變更",

1219 teaches: "在問題仍然便宜時捕捉問題。Claude 完整讀取已變更的檔案,而不僅僅是差異行,因此它會發現快速自我審查會遺漏的問題。",

1220 next: "執行 `/code-review` 以在一個命令中進行相同檢查"

1221 },

1222 "review-a-pull-request": {

1223 title: "審查拉取請求",

1224 teaches: "Claude 在整個程式碼庫的背景下進行審查,而不僅僅是差異。它讀取已變更的程式碼及其呼叫的內容,因此它會捕捉僅差異審查會遺漏的問題。",

1225 next: "使用程式碼審查為每個 PR 開啟此功能"

1226 },

1227 "review-infrastructure-changes-before": {

1228 title: "在應用前審查基礎結構變更",

1229 teaches: "計畫輸出密集且難以掃描。貼上它會在您應用前獲得對實際要變更內容的純文字摘要。"

1230 },

1231 "run-a-security-review": {

1232 title: "使用子代理執行安全審查",

1233 teaches: "[子代理](/zh-TW/sub-agents)在其自己的背景視窗中執行審計並報告摘要,因此冗長的安全審查不會填滿您的主要工作階段。內建的通用子代理無需額外設定即可處理此問題。",

1234 next: "設定專用的安全審查子代理,您的整個團隊都可以使用"

1235 },

1236 "review-content-before-sending": {

1237 title: "在正式審查前捕捉問題",

1238 teaches: "在人類花時間之前進行第一次通過。命名您想檢查的關注點,以便審查集中,然後修復它找到的內容並發送更清潔的草稿。",

1239 next: "將您的審查檢查清單捕捉為您的整個團隊可以執行的技能"

1240 },

1241 "course-correct-a-wrong": {

1242 title: "糾正錯誤的方法",

1243 teaches: "命名 Claude 遺漏的約束,而不僅僅是它是錯誤的。具體的原因為 Claude 提供了一個具體的約束來在重試時滿足,而不是再次猜測。",

1244 next: "按 `Esc` 兩次以打開倒帶菜單並恢復程式碼和對話,以便重試乾淨開始"

1245 },

1246 "narrow-the-scope-of": {

1247 title: "縮小變更的範圍",

1248 teaches: "當方向正確但變更過於寬泛時,要求 Claude 保留其中一部分,而不是倒帶所有內容。說明的邊界可防止小修復變成重構。"

1249 },

1250 "turn-a-correction-into": {

1251 title: "將更正轉換為規則",

1252 teaches: "聊天中的更正不會與您的團隊共享。專案 [CLAUDE.md](/zh-TW/memory) 中的規則在您提交後共享,Claude 在每個工作階段開始時讀取它。",

1253 next: "打開 `/memory` 以審查 Claude 編寫的內容"

1254 },

1255 "resolve-merge-conflicts": {

1256 title: "解決合併衝突",

1257 teaches: "說出您想要的狀態,而不是要保留哪些標記。要求推理使合併可審查,而不是黑盒。"

1258 },

1259 "commit-with-a-generated": {

1260 title: "使用產生的訊息提交",

1261 teaches: "讓 Claude 從差異衍生訊息。它符合您儲存庫的現有提交樣式。"

1262 },

1263 "open-a-pull-request": {

1264 title: "從工單打開拉取請求",

1265 teaches: "跳過追蹤器、編輯器和 GitHub 之間的背景切換。一個提示詞讀取規格、進行變更並打開 PR。"

1266 },

1267 "draft-release-notes-from": {

1268 title: "從 git 歷史草擬發佈說明",

1269 teaches: "提供兩個參考點和您想要的結構。Claude 讀取它們之間的提交日誌並草擬您可以編輯的變更日誌。",

1270 next: "將此儲存為 `/changelog` 技能"

1271 },

1272 "write-a-ci-workflow": {

1273 title: "編寫 CI 工作流程",

1274 teaches: "描述何時應執行以及應執行的操作;YAML 為您產生,符合您專案的建置和測試命令。"

1275 },

1276 "find-and-fix-a": {

1277 title: "尋找並修復失敗的測試",

1278 teaches: "描述症狀;您不需要知道哪個檔案已損壞。Claude 執行測試以查看失敗,將其追蹤到來源,並修復它。"

1279 },

1280 "investigate-a-reported-error": {

1281 title: "調查報告的錯誤",

1282 teaches: "描述症狀和位置;Claude 讀取相關程式碼路徑並追蹤可能的原因。如果您有堆疊追蹤或日誌,請貼上它們。",

1283 next: "在您的執行手冊中放置深層連結,以打開預先填入此提示詞的 Claude"

1284 },

1285 "fix-a-build-error": {

1286 title: "在根本原因處修復建置錯誤",

1287 teaches: "要求根本原因和驗證可防止表面級修補程式抑制錯誤而不修復它。"

1288 },

1289 "investigate-a-production-incident": {

1290 title: "調查生產事件",

1291 teaches: "列出要關聯的證據來源,而不是要採取的步驟。Claude 一起讀取日誌、git 歷史和配置以縮小原因。",

1292 next: "透過 MCP 連接 Sentry 或您的日誌存儲"

1293 },

1294 "query-logs-in-plain": {

1295 title: "用純英文查詢日誌",

1296 teaches: "詢問問題而不是編寫 SQL。Claude 建置查詢、針對您連接的日誌執行它,並顯示查詢和結果,以便您可以檢查執行的內容。"

1297 },

1298 "diagnose-from-a-console": {

1299 title: "從控制台螢幕截圖診斷",

1300 teaches: "雲端控制台向您顯示問題,但不顯示修復它的命令。Claude 讀取螢幕截圖並將儀表板轉換為要執行的 kubectl、gcloud 或 aws 命令。"

1301 },

1302 "analyze-a-data-file": {

1303 title: "分析資料檔案",

1304 teaches: "一次性問題不需要一次性指令碼。指向專案資料夾中的檔案,Claude 直接讀取它、找到模式並在您要求的位置寫入輸出。",

1305 next: "透過 MCP 連接資料來源,而不是匯出檔案"

1306 },

1307 "generate-variations-from-performance": {

1308 title: "從效能資料產生變體",

1309 teaches: "在開始時說明約束,以便產生保持在限制內。Claude 讀取指標、選擇要替換的內容,並產生符合的替代方案。",

1310 next: "透過 MCP 連接廣告平台,而不是匯出檔案"

1311 },

1312 "turn-a-recurring-task": {

1313 title: "將重複任務轉換為技能",

1314 teaches: "命名步驟一次;將其重複用作命令。Claude 編寫您的團隊中任何人都可以執行的 [技能](/zh-TW/skills)。"

1315 },

1316 "add-a-hook-for": {

1317 title: "為重複行為新增 hook",

1318 teaches: "Hooks 使行為自動進行,而不是您必須記住要求的內容。描述觸發器和操作,Claude 編寫 [hook](/zh-TW/hooks) 配置。"

1319 },

1320 "connect-a-tool-with": {

1321 title: "使用 MCP 連接工具",

1322 teaches: "連接來源一次,而不是每個工作階段貼上資料。在 [MCP](/zh-TW/mcp) 設定後,當您詢問它時,Claude 直接從工具讀取。"

1323 },

1324 "capture-what-to-remember": {

1325 title: "捕捉下次要記住的內容",

1326 teaches: "在您忘記前詢問。Claude 知道它在此工作階段中必須弄清楚的內容,並提議 [CLAUDE.md](/zh-TW/memory) 項目,以便下一個工作階段以該背景開始。"

1327 }

1328};

1329 

1330<PromptLibrary text={text} labels={labels} tagLabels={tagLabels} phaseLabels={phaseLabels} sourceLabels={sourceLabels} catLabels={catLabels} />

1331 

13<h2 id="what-makes-these-prompts-work">1332<h2 id="what-makes-these-prompts-work">

14 這些提示詞有效的原因1333 這些提示詞有效的原因

15</h2>1334</h2>

Details

119 119 

120在互動式終端機會話中,當連接啟動時,`/rc active` 指示器會位於輸入框下方的頁尾中,如果終端機太窄無法容納則會隱藏。指示器文字是 claude.ai 上會話的連結。使用向下箭頭鍵選擇它並按 Enter 鍵,或再次執行 `/remote-control`,以開啟狀態面板,其中包含會話 URL 和 QR 碼,您可以使用它從[另一個裝置連接](#connect-from-another-device)。120在互動式終端機會話中,當連接啟動時,`/rc active` 指示器會位於輸入框下方的頁尾中,如果終端機太窄無法容納則會隱藏。指示器文字是 claude.ai 上會話的連結。使用向下箭頭鍵選擇它並按 Enter 鍵,或再次執行 `/remote-control`,以開啟狀態面板,其中包含會話 URL 和 QR 碼,您可以使用它從[另一個裝置連接](#connect-from-another-device)。

121 121 

122如果連接失敗,指示器會變紅並顯示 `/rc failed`。使用向下箭頭鍵選擇它並按 Enter 鍵以查看失敗原因和關閉選項或再次執行 `/remote-control` 以重試。122如果連接失敗,會出現一個通知顯示失敗原因,指示器會從頁尾消失。再次執行 `/remote-control` 以重試。

123 123 

124<h3 id="connect-from-another-device">124<h3 id="connect-from-another-device">

125 從另一個裝置連接125 從另一個裝置連接


206* 在 iOS 上,焦點模式和通知摘要可能會抑制或延遲推播。檢查設定 → 通知 → Claude。206* 在 iOS 上,焦點模式和通知摘要可能會抑制或延遲推播。檢查設定 → 通知 → Claude。

207* 在 Android 上,激進的電池優化可能會延遲傳遞。在系統設定中將 Claude 應用程式豁免於電池優化。207* 在 Android 上,激進的電池優化可能會延遲傳遞。在系統設定中將 Claude 應用程式豁免於電池優化。

208 208 

209Claude Code 在您在連接的終端機中輸入或專注時會跳過行動推播通知。{/* min-version: 2.1.181 */}自 v2.1.181 起,您可以將 [`CLAUDE_CLIENT_PRESENCE_FILE`](/zh-TW/env-vars) 設定為標記檔案路徑,以將其擴展到您在機器上的任何時間,即使在另一個視窗中:當檔案存在時,通知會被跳過。配置螢幕鎖定監聽器或類似工具,以在螢幕解鎖時建立檔案,並在螢幕鎖定時刪除檔案。

210 

209<h2 id="limitations">211<h2 id="limitations">

210 限制212 限制

211</h2>213</h2>


214* **本地程序必須保持執行**:Remote Control 作為本地程序執行。如果您關閉終端機、退出 VS Code 或以其他方式停止 `claude` 程序,會話結束。216* **本地程序必須保持執行**:Remote Control 作為本地程序執行。如果您關閉終端機、退出 VS Code 或以其他方式停止 `claude` 程序,會話結束。

215* **延長的網路中斷**:如果您的機器處於喚醒狀態但無法在大約 10 分鐘以上的時間內到達網路,會話會逾時並且程序退出。再次執行 `claude remote-control` 以啟動新會話。217* **延長的網路中斷**:如果您的機器處於喚醒狀態但無法在大約 10 分鐘以上的時間內到達網路,會話會逾時並且程序退出。再次執行 `claude remote-control` 以啟動新會話。

216* **Ultraplan 斷開 Remote Control**:啟動 [ultraplan](/zh-TW/ultraplan) 會話會斷開任何活動的 Remote Control 會話,因為兩個功能都佔據 claude.ai/code 介面,一次只能連接一個。218* **Ultraplan 斷開 Remote Control**:啟動 [ultraplan](/zh-TW/ultraplan) 會話會斷開任何活動的 Remote Control 會話,因為兩個功能都佔據 claude.ai/code 介面,一次只能連接一個。

217* **某些命令僅限本地**:在終端機中開啟互動式選擇器的命令,例如 `/plugin` 或 `/resume`,只能從本地 CLI 使用。產生文字輸出的命令,包括 `/compact`、`/clear`、`/context`、`/usage`、`/exit`、`/usage-credits`、`/recap` 和 `/reload-plugins`,可從行動和網頁使用。{/* min-version: 2.1.166 */}自 v2.1.166 起,`/mcp` 也可從行動和網頁使用:它會傳回伺服器狀態的文字摘要而不是開啟選擇器,並接受與本地 CLI 相同的 `reconnect`、`enable` 和 `disable` [子命令](/zh-TW/commands#all-commands),但有一個差異從行動和網頁,`/mcp reconnect` 不帶伺服器名稱會重新連接每個已失敗或需要驗證的伺服器,而本地 CLI 需要伺服器名稱才能執行 `reconnect`。219* **某些命令僅限本地**:在終端機中開啟互動式選擇器的命令,例如 `/plugin` 或 `/resume`,只能從本地 CLI 使用。以下命令可從行動和網頁使用

220 * 文字輸出命令:`/compact`、`/clear`、`/context`、`/usage`、`/exit`、`/usage-credits`、`/recap`、`/reload-plugins`

221 * {/* min-version: 2.1.166 */}自 v2.1.166 起,`/mcp`:傳回伺服器狀態的文字摘要而不是開啟選擇器,並接受 `reconnect`、`enable` 和 `disable` [子命令](/zh-TW/commands#all-commands)。與本地 CLI 不同,`/mcp reconnect` 不帶伺服器名稱會重新連接每個已失敗或需要驗證的伺服器。

222 * {/* min-version: 2.1.181 */}自 v2.1.181 起,`/config`:傳遞 `key=value` 以設定設定,或不帶引數執行以列出您可以設定的金鑰。

218 223 

219<h2 id="troubleshooting">224<h2 id="troubleshooting">

220 疑難排解225 疑難排解

sandboxing.md +2 −0

Details

373* **命令因主機不允許錯誤而失敗**:許多 CLI 工具需要到達特定主機。在提示時授予權限會將主機新增到您的允許清單,以便工具在將來在沙箱內執行。373* **命令因主機不允許錯誤而失敗**:許多 CLI 工具需要到達特定主機。在提示時授予權限會將主機新增到您的允許清單,以便工具在將來在沙箱內執行。

374* **`jest` 掛起或失敗**:`watchman` 與沙箱不相容。改為執行 `jest --no-watchman`。374* **`jest` 掛起或失敗**:`watchman` 與沙箱不相容。改為執行 `jest --no-watchman`。

375* **Go 型 CLI 在 macOS 上 TLS 驗證失敗**:`gh`、`gcloud` 和 `terraform` 等工具在 Seatbelt 下可能無法進行 TLS 驗證。在 `excludedCommands` 中列出這些工具以在沙箱外執行它們。如果您使用 `httpProxyPort` 與 MITM 代理和自訂 CA,請改為將 [`enableWeakerNetworkIsolation`](/zh-TW/settings#sandbox-settings) 設定為 `true`。375* **Go 型 CLI 在 macOS 上 TLS 驗證失敗**:`gh`、`gcloud` 和 `terraform` 等工具在 Seatbelt 下可能無法進行 TLS 驗證。在 `excludedCommands` 中列出這些工具以在沙箱外執行它們。如果您使用 `httpProxyPort` 與 MITM 代理和自訂 CA,請改為將 [`enableWeakerNetworkIsolation`](/zh-TW/settings#sandbox-settings) 設定為 `true`。

376* **`open`、`osascript` 或瀏覽器型驗證流程在 macOS 上因錯誤 `-600` 而失敗**:沙箱預設會阻止 Apple Events。在您的使用者、受管理或 CLI 設定中將 [`allowAppleEvents`](/zh-TW/settings#sandbox-settings) 設定為 `true` 以允許它們。專案設定會被忽略此金鑰。啟用它會移除程式碼執行隔離,因為沙箱化命令之後可以啟動其他應用程式而不進行沙箱化,無需使用者提示,並向執行中的應用程式傳送 AppleScript 命令,受限於 macOS 自動化同意提示 (TCC)。或者,將命令新增到 `excludedCommands` 以在沙箱外執行它。

376* **`docker` 命令失敗**:`docker` 與沙箱不相容。將 `docker *` 新增到 `excludedCommands` 以在沙箱外執行它。377* **`docker` 命令失敗**:`docker` 與沙箱不相容。將 `docker *` 新增到 `excludedCommands` 以在沙箱外執行它。

377* **Bubblewrap 在容器內啟動失敗**:在無特權容器中,bubblewrap 無法掛載新的 `/proc` 檔案系統。將 [`enableWeakerNestedSandbox`](/zh-TW/settings#sandbox-settings) 設定為 `true`,以便內部沙箱綁定掛載容器的現有 `/proc`。僅在外部容器已提供您需要的隔離邊界時使用此設定,因為它向沙箱化命令公開流程資訊,新的 `/proc` 掛載會隱藏。378* **Bubblewrap 在容器內啟動失敗**:在無特權容器中,bubblewrap 無法掛載新的 `/proc` 檔案系統。將 [`enableWeakerNestedSandbox`](/zh-TW/settings#sandbox-settings) 設定為 `true`,以便內部沙箱綁定掛載容器的現有 `/proc`。僅在外部容器已提供您需要的隔離邊界時使用此設定,因為它向沙箱化命令公開流程資訊,新的 `/proc` 掛載會隱藏。

378* **Linux 上的 Seccomp 過濾器**:seccomp 過濾器是阻止 Unix 域套接字所必需的。`/sandbox` 中的 Dependencies 標籤顯示它是否可用。如果缺少,請執行 `npm install -g @anthropic-ai/sandbox-runtime` 安裝幫助程式。379* **Linux 上的 Seccomp 過濾器**:seccomp 過濾器是阻止 Unix 域套接字所必需的。`/sandbox` 中的 Dependencies 標籤顯示它是否可用。如果缺少,請執行 `npm install -g @anthropic-ai/sandbox-runtime` 安裝幫助程式。


397* **通過 Unix 套接字的特權提升**:`allowUnixSockets` 配置可能會無意中授予對強大系統服務的存取,這可能導致沙箱繞過。例如,允許存取 `/var/run/docker.sock` 有效地通過 Docker 套接字授予對主機系統的存取。仔細考慮您通過沙箱允許的任何 Unix 套接字。398* **通過 Unix 套接字的特權提升**:`allowUnixSockets` 配置可能會無意中授予對強大系統服務的存取,這可能導致沙箱繞過。例如,允許存取 `/var/run/docker.sock` 有效地通過 Docker 套接字授予對主機系統的存取。仔細考慮您通過沙箱允許的任何 Unix 套接字。

398* **檔案系統權限提升**:過於寬泛的檔案系統寫入權限可能導致特權提升攻擊。允許寫入包含 `$PATH` 中可執行檔案的目錄、系統配置目錄或使用者 shell 配置檔案(例如 `.bashrc` 或 `.zshrc`)可能導致當其他使用者或系統流程存取這些檔案時在不同安全上下文中執行程式碼。399* **檔案系統權限提升**:過於寬泛的檔案系統寫入權限可能導致特權提升攻擊。允許寫入包含 `$PATH` 中可執行檔案的目錄、系統配置目錄或使用者 shell 配置檔案(例如 `.bashrc` 或 `.zshrc`)可能導致當其他使用者或系統流程存取這些檔案時在不同安全上下文中執行程式碼。

399* **Linux 沙箱強度**:Linux 實現提供強大的檔案系統和網路隔離,但包含一個 `enableWeakerNestedSandbox` 模式,使其能夠在 Docker 環境中工作而無需特權命名空間,或在 Linux 主機上禁用無特權使用者命名空間的情況下。此選項大大削弱了安全性,應僅在其他隔離被強制執行時使用。400* **Linux 沙箱強度**:Linux 實現提供強大的檔案系統和網路隔離,但包含一個 `enableWeakerNestedSandbox` 模式,使其能夠在 Docker 環境中工作而無需特權命名空間,或在 Linux 主機上禁用無特權使用者命名空間的情況下。此選項大大削弱了安全性,應僅在其他隔離被強制執行時使用。

401* **macOS 上的 Apple Events**:macOS 沙箱預設阻止 Apple Events。`allowAppleEvents` 設定解除此限制,使 `open` 和 `osascript` 等工具能夠運作,但它移除了程式碼執行隔離:沙箱化命令可以啟動其他應用程式而不進行沙箱化,無需使用者提示,並可以向執行中的應用程式傳送 AppleScript 命令,受限於每個應用程式的 macOS 自動化同意提示 (TCC)。它僅從使用者、受管或 CLI 設定中被接受。專案設定無法啟用它。

400* **設定檔案受保護**:沙箱自動拒絕對 Claude Code 的 `settings.json` 檔案在每個範圍和受管設定目錄的寫入存取,因此沙箱化命令無法修改其自己的策略。402* **設定檔案受保護**:沙箱自動拒絕對 Claude Code 的 `settings.json` 檔案在每個範圍和受管設定目錄的寫入存取,因此沙箱化命令無法修改其自己的策略。

401 403 

402<h3 id="platform-and-tool-compatibility">404<h3 id="platform-and-tool-compatibility">

settings.md +15 −8

Details

6 6 

7> 使用全域和專案層級設定以及環境變數來設定 Claude Code。7> 使用全域和專案層級設定以及環境變數來設定 Claude Code。

8 8 

9Claude Code 提供多種設定選項,可根據您的需求配置其行為。您可以在使用互動式 REPL 時執行 `/config` 命令來設定 Claude Code,這會開啟一個標籤式設定介面,您可以在其中查看狀態資訊並修改設定選項。9Claude Code 提供多種設定選項,可根據您的需求配置其行為。您可以執行 `/config` 命令來設定 Claude Code,這會開啟一個標籤式設定介面,您可以在其中查看狀態資訊並修改設定選項。{/* min-version: 2.1.181 */}從 v2.1.181 版本開始,您可以透過將 `key=value` 傳遞給 `/config` 來變更單一選項,而無需開啟介面,例如 `/config verbose=true`。

10 10 

11<h2 id="configuration-scopes">11<h2 id="configuration-scopes">

12 設定範圍12 設定範圍


210`settings.json` 支援多個選項:210`settings.json` 支援多個選項:

211 211 

212| 金鑰 | 說明 | 範例 |212| 金鑰 | 說明 | 範例 |

213| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------ |213| :-------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |

214| `advisorModel` | {/* min-version: 2.1.98 */}伺服器端[advisor tool](/zh-TW/advisor)的模型。接受模型別名,例如 `"opus"`、`"sonnet"` 或 `"fable"`({/* min-version: 2.1.170 */}v2.1.170+),或完整模型 ID。當您執行 `/advisor` 時自動寫入。取消設定以停用 advisor。需要 Claude Code v2.1.98 或更新版本 | `"opus"` |214| `advisorModel` | {/* min-version: 2.1.98 */}伺服器端[advisor tool](/zh-TW/advisor)的模型。接受模型別名,例如 `"opus"`、`"sonnet"` 或 `"fable"`({/* min-version: 2.1.170 */}v2.1.170+),或完整模型 ID。當您執行 `/advisor` 時自動寫入。取消設定以停用 advisor。需要 Claude Code v2.1.98 或更新版本 | `"opus"` |

215| `agent` | 將主執行緒作為命名 subagent 執行,並為從 `claude agents` 分派的工作階段設定預設 agent。應用該 subagent 的系統提示、工具限制和模型。請參閱[明確叫用 subagents](/zh-TW/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |215| `agent` | 將主執行緒作為命名 subagent 執行,並為從 `claude agents` 分派的工作階段設定預設 agent。應用該 subagent 的系統提示、工具限制和模型。請參閱[明確叫用 subagents](/zh-TW/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |

216| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}當[遠端控制](/zh-TW/remote-control)已連線時,允許 Claude 主動傳送推播通知到您的手機,例如當長時間工作完成時。預設:`false`。在 `/config` 中顯示為**Claude 決定時推播**。請參閱[行動推播通知](/zh-TW/remote-control#mobile-push-notifications)。需要 Claude Code v2.1.119 或更新版本 | `true` |216| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}當[遠端控制](/zh-TW/remote-control)已連線時,允許 Claude 主動傳送推播通知到您的手機,例如當長時間工作完成時。預設:`false`。在 `/config` 中顯示為**Claude 決定時推播**。請參閱[行動推播通知](/zh-TW/remote-control#mobile-push-notifications)。需要 Claude Code v2.1.119 或更新版本 | `true` |


234| `awaySummaryEnabled` | 在您離開終端機幾分鐘後返回時顯示單行工作階段摘要。設定為 `false` 或在 `/config` 中關閉工作階段摘要以停用。與 [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/zh-TW/env-vars) 相同 | `true` |234| `awaySummaryEnabled` | 在您離開終端機幾分鐘後返回時顯示單行工作階段摘要。設定為 `false` 或在 `/config` 中關閉工作階段摘要以停用。與 [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/zh-TW/env-vars) 相同 | `true` |

235| `awsAuthRefresh` | 修改 `.aws` 目錄的自訂指令碼(請參閱[進階認證設定](/zh-TW/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |235| `awsAuthRefresh` | 修改 `.aws` 目錄的自訂指令碼(請參閱[進階認證設定](/zh-TW/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |

236| `awsCredentialExport` | 輸出包含 AWS 認證的 JSON 的自訂指令碼(請參閱[進階認證設定](/zh-TW/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |236| `awsCredentialExport` | 輸出包含 AWS 認證的 JSON 的自訂指令碼(請參閱[進階認證設定](/zh-TW/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |

237| `axScreenReader` | {/* min-version: 2.1.181 */}渲染螢幕閱讀器友善的輸出:沒有裝飾邊框或動畫的平面文字。螢幕閱讀器模式始終使用經典渲染器,因此在其使用中時 `tui` 設定無效。[`CLAUDE_AX_SCREEN_READER`](/zh-TW/env-vars) 環境變數和 [`--ax-screen-reader`](/zh-TW/cli-reference#cli-flags) 旗標優先。需要 Claude Code v2.1.181 或更新版本 | `true` |

237| `blockedMarketplaces` | (Managed 設定僅限)marketplace 來源的黑名單。在 marketplace 新增和 plugin 安裝、更新、重新整理和自動更新時強制執行,因此在設定政策之前新增的 marketplace 無法用於擷取 plugins。在下載前檢查被阻止的來源,因此它們永遠不會接觸檔案系統。請參閱 [Managed marketplace 限制](/zh-TW/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |238| `blockedMarketplaces` | (Managed 設定僅限)marketplace 來源的黑名單。在 marketplace 新增和 plugin 安裝、更新、重新整理和自動更新時強制執行,因此在設定政策之前新增的 marketplace 無法用於擷取 plugins。在下載前檢查被阻止的來源,因此它們永遠不會接觸檔案系統。請參閱 [Managed marketplace 限制](/zh-TW/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

238| `channelsEnabled` | (Managed 設定僅限)允許組織使用[頻道](/zh-TW/channels)。在 claude.ai Team 和 Enterprise 方案上,當此設定未設定或為 `false` 時,頻道會被阻止。對於使用 API 金鑰驗證的 [Anthropic Console](/zh-TW/authentication#claude-console-authentication) 帳戶,除非您的組織部署 managed 設定(在這種情況下此金鑰必須設定為 `true`),否則預設允許頻道 | `true` |239| `channelsEnabled` | (Managed 設定僅限)允許組織使用[頻道](/zh-TW/channels)。在 claude.ai Team 和 Enterprise 方案上,當此設定未設定或為 `false` 時,頻道會被阻止。對於使用 API 金鑰驗證的 [Anthropic Console](/zh-TW/authentication#claude-console-authentication) 帳戶,除非您的組織部署 managed 設定(在這種情況下此金鑰必須設定為 `true`),否則預設允許頻道 | `true` |

239| `claudeMd` | (Managed 設定僅限)CLAUDE.md 樣式的指示,作為組織管理的記憶注入。僅在 managed 或政策設定中設定時受尊重,在使用者、專案和本機設定中被忽略。請參閱[組織範圍的 CLAUDE.md](/zh-TW/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |240| `claudeMd` | (Managed 設定僅限)CLAUDE.md 樣式的指示,作為組織管理的記憶注入。僅在 managed 或政策設定中設定時受尊重,在使用者、專案和本機設定中被忽略。請參閱[組織範圍的 CLAUDE.md](/zh-TW/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |


244| `deniedMcpServers` | 在 managed-settings.json 中設定時,明確阻止的 MCP servers 拒絕清單。適用於所有範圍,包括 managed servers。拒絕清單優先於白名單。請參閱 [Managed MCP 設定](/zh-TW/managed-mcp) | `[{ "serverName": "filesystem" }]` |245| `deniedMcpServers` | 在 managed-settings.json 中設定時,明確阻止的 MCP servers 拒絕清單。適用於所有範圍,包括 managed servers。拒絕清單優先於白名單。請參閱 [Managed MCP 設定](/zh-TW/managed-mcp) | `[{ "serverName": "filesystem" }]` |

245| `disableAgentView` | 設定為 `true` 以關閉[背景代理和代理檢視](/zh-TW/agent-view):`claude agents`、`--bg`、`/background` 和隨選主管。通常在 [managed 設定](/zh-TW/permissions#managed-settings) 中設定。等同於將 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 設定為 `1` | `true` |246| `disableAgentView` | 設定為 `true` 以關閉[背景代理和代理檢視](/zh-TW/agent-view):`claude agents`、`--bg`、`/background` 和隨選主管。通常在 [managed 設定](/zh-TW/permissions#managed-settings) 中設定。等同於將 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 設定為 `1` | `true` |

246| `disableAllHooks` | 停用所有 [hooks](/zh-TW/hooks) 和任何自訂[狀態行](/zh-TW/statusline) | `true` |247| `disableAllHooks` | 停用所有 [hooks](/zh-TW/hooks) 和任何自訂[狀態行](/zh-TW/statusline) | `true` |

248| `disableArtifact` | 設定為 `true` 以停用 [Artifact](/zh-TW/artifacts) 工具,該工具將工作階段輸出發佈為 claude.ai 上的私人網頁。等同於將 `CLAUDE_CODE_DISABLE_ARTIFACT` 設定為 `1` | `true` |

247| `disableAutoMode` | 設定為 `"disable"` 以防止[自動模式](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)被啟用。從 `Shift+Tab` 循環中移除 `auto` 並在啟動時拒絕 `--permission-mode auto`。在[managed 設定](/zh-TW/permissions#managed-settings)中最有用,使用者無法覆蓋它 | `"disable"` |249| `disableAutoMode` | 設定為 `"disable"` 以防止[自動模式](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)被啟用。從 `Shift+Tab` 循環中移除 `auto` 並在啟動時拒絕 `--permission-mode auto`。在[managed 設定](/zh-TW/permissions#managed-settings)中最有用,使用者無法覆蓋它 | `"disable"` |

248| `disableBundledSkills` | 設定為 `true` 以停用隨 Claude Code 一起提供的 [skills](/zh-TW/skills) 和工作流程:bundled skills 和工作流程會被完全移除,而內建斜線命令(如 `/init`)保持可輸入但對模型隱藏。來自 plugins、`.claude/skills/` 和 `.claude/commands/` 的 Skills 不受影響。等同於將 `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` 設定為 `1` | `true` |250| `disableBundledSkills` | 設定為 `true` 以停用隨 Claude Code 一起提供的 [skills](/zh-TW/skills) 和工作流程:bundled skills 和工作流程會被完全移除,而內建斜線命令(如 `/init`)保持可輸入但對模型隱藏。來自 plugins、`.claude/skills/` 和 `.claude/commands/` 的 Skills 不受影響。等同於將 `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` 設定為 `1` | `true` |

251| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}停用 [claude.ai MCP connectors](/zh-TW/mcp#use-mcp-servers-from-claude-ai),使其不會自動擷取或連線。在任何設定範圍中設定。任何來源中的 `true` 優先,因此簽入的專案 `.claude/settings.json` 可以選擇退出雲端 connectors,但專案層級的 `false` 無法覆蓋使用者或政策層級的 `true`。透過 `--mcp-config` 明確傳遞的 Servers 不受影響。若要拒絕個別 connectors 而不是所有 connectors,請改用 [`deniedMcpServers`](/zh-TW/managed-mcp)。需要 Claude Code v2.1.182 或更新版本 | `true` |

249| `disableDeepLinkRegistration` | 設定為 `"disable"` 以防止 Claude Code 在啟動時向作業系統註冊 `claude-cli://` 協議處理程式。[深層連結](/zh-TW/deep-links)讓外部工具透過預先填入的提示開啟 Claude Code 工作階段。在協議處理程式註冊受限或單獨管理的環境中很有用 | `"disable"` |252| `disableDeepLinkRegistration` | 設定為 `"disable"` 以防止 Claude Code 在啟動時向作業系統註冊 `claude-cli://` 協議處理程式。[深層連結](/zh-TW/deep-links)讓外部工具透過預先填入的提示開啟 Claude Code 工作階段。在協議處理程式註冊受限或單獨管理的環境中很有用 | `"disable"` |

250| `disabledMcpjsonServers` | 要拒絕的 `.mcp.json` 檔案中特定 MCP servers 的清單 | `["filesystem"]` |253| `disabledMcpjsonServers` | 要拒絕的 `.mcp.json` 檔案中特定 MCP servers 的清單 | `["filesystem"]` |

251| `disableRemoteControl` | {/* min-version: 2.1.128 */}停用[遠端控制](/zh-TW/remote-control):阻止 `claude remote-control`、`--remote-control` 旗標、自動啟動和工作階段內切換。通常放在[managed 設定](/zh-TW/permissions#managed-settings)中以進行每個裝置的 MDM 強制執行,但適用於任何範圍。需要 Claude Code v2.1.128 或更新版本 | `true` |254| `disableRemoteControl` | {/* min-version: 2.1.128 */}停用[遠端控制](/zh-TW/remote-control):阻止 `claude remote-control`、`--remote-control` 旗標、自動啟動和工作階段內切換。通常放在[managed 設定](/zh-TW/permissions#managed-settings)中以進行每個裝置的 MDM 強制執行,但適用於任何範圍。需要 Claude Code v2.1.128 或更新版本 | `true` |


288| `preferredNotifChannel` | 工作完成和權限提示通知的方法:`"auto"`、`"terminal_bell"`、`"iterm2"`、`"iterm2_with_bell"`、`"kitty"`、`"ghostty"` 或 `"notifications_disabled"`。預設:`"auto"`,在 iTerm2、Ghostty 和 Kitty 中傳送桌面通知,在其他終端機中不執行任何操作。設定 `"terminal_bell"` 以在任何終端機中響鈴字元。在 `/config` 中顯示為**通知**。請參閱[取得終端機鈴聲或通知](/zh-TW/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |291| `preferredNotifChannel` | 工作完成和權限提示通知的方法:`"auto"`、`"terminal_bell"`、`"iterm2"`、`"iterm2_with_bell"`、`"kitty"`、`"ghostty"` 或 `"notifications_disabled"`。預設:`"auto"`,在 iTerm2、Ghostty 和 Kitty 中傳送桌面通知,在其他終端機中不執行任何操作。設定 `"terminal_bell"` 以在任何終端機中響鈴字元。在 `/config` 中顯示為**通知**。請參閱[取得終端機鈴聲或通知](/zh-TW/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |

289| `prefersReducedMotion` | 減少或停用 UI 動畫(微調器、閃爍、閃光效果)以提高可訪問性 | `true` |292| `prefersReducedMotion` | 減少或停用 UI 動畫(微調器、閃爍、閃光效果)以提高可訪問性 | `true` |

290| `prUrlTemplate` | PR 徽章的 URL 範本,顯示在頁尾和工具結果摘要中。替換 `gh` 報告的 PR URL 中的 `{host}`、`{owner}`、`{repo}`、`{number}` 和 `{url}`。使用以指向內部程式碼審查工具而不是 `github.com`。不影響 Claude 散文中的 `#123` 自動連結 | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |293| `prUrlTemplate` | PR 徽章的 URL 範本,顯示在頁尾和工具結果摘要中。替換 `gh` 報告的 PR URL 中的 `{host}`、`{owner}`、`{repo}`、`{number}` 和 `{url}`。使用以指向內部程式碼審查工具而不是 `github.com`。不影響 Claude 散文中的 `#123` 自動連結 | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |

294| `remoteControlAtStartup` | {/* min-version: 2.1.119 */}當每個互動式工作階段啟動時自動連線[遠端控制](/zh-TW/remote-control),而不是等待 `/remote-control`。設定為 `true` 以始終自動連線,`false` 以永不自動連線,或保留未設定以遵循您組織的預設。在 `/config` 中顯示為**為所有工作階段啟用遠端控制**。請參閱[為所有工作階段啟用遠端控制](/zh-TW/remote-control#enable-remote-control-for-all-sessions) | `false` |

291| `requiredMaximumVersion` | Managed 設定僅限。允許啟動的最大 Claude Code 版本。如果執行中的版本較新,Claude Code 會在啟動時結束並指示使用者透過組織的核准方法安裝核准的版本;`claude install <version>` 也可能有效。背景自動更新和 `claude update` 會跳過高於上限的版本,因此在範圍內的安裝保持在範圍內。`claude update`、`claude install` 和 `claude doctor` 在上限以上保持工作,以便使用者可以恢復。早於此設定的版本會忽略它 | `"2.1.150"` |295| `requiredMaximumVersion` | Managed 設定僅限。允許啟動的最大 Claude Code 版本。如果執行中的版本較新,Claude Code 會在啟動時結束並指示使用者透過組織的核准方法安裝核准的版本;`claude install <version>` 也可能有效。背景自動更新和 `claude update` 會跳過高於上限的版本,因此在範圍內的安裝保持在範圍內。`claude update`、`claude install` 和 `claude doctor` 在上限以上保持工作,以便使用者可以恢復。早於此設定的版本會忽略它 | `"2.1.150"` |

292| `requiredMinimumVersion` | Managed 設定僅限。啟動所需的最小 Claude Code 版本。如果執行中的版本較舊,Claude Code 會在啟動時結束並指示使用者透過組織的核准方法更新。`claude update`、`claude install` 和 `claude doctor` 在底線以下保持工作,以便使用者可以恢復。與 `minimumVersion` 不同,後者防止降級但永遠不會阻止啟動。早於此設定的版本會忽略它 | `"2.1.150"` |296| `requiredMinimumVersion` | Managed 設定僅限。啟動所需的最小 Claude Code 版本。如果執行中的版本較舊,Claude Code 會在啟動時結束並指示使用者透過組織的核准方法更新。`claude update`、`claude install` 和 `claude doctor` 在底線以下保持工作,以便使用者可以恢復。與 `minimumVersion` 不同,後者防止降級但永遠不會阻止啟動。早於此設定的版本會忽略它 | `"2.1.150"` |

297| `respondToBashCommands` | {/* min-version: 2.1.186 */}輸入框 `!` shell 命令執行後 Claude 是否回應。設定為 `false` 以將命令輸出新增到內容而不回應。預設:`true`。請參閱[使用 `!` 前綴的 Shell 模式](/zh-TW/interactive-mode#shell-mode-with-prefix)。需要 Claude Code v2.1.186 或更新版本 | `false` |

293| `respectGitignore` | 控制 `@` 檔案選擇器是否尊重 `.gitignore` 模式。當為 `true`(預設)時,符合 `.gitignore` 模式的檔案會從建議中排除 | `false` |298| `respectGitignore` | 控制 `@` 檔案選擇器是否尊重 `.gitignore` 模式。當為 `true`(預設)時,符合 `.gitignore` 模式的檔案會從建議中排除 | `false` |

294| `showClearContextOnPlanAccept` | 在 Plan Mode 接受畫面上顯示「清除內容」選項。預設為 `false`。設定為 `true` 以還原選項 | `true` |299| `showClearContextOnPlanAccept` | 在 Plan Mode 接受畫面上顯示「清除內容」選項。預設為 `false`。設定為 `true` 以還原選項 | `true` |

295| `showThinkingSummaries` | 在互動式工作階段中顯示[擴展思考](/zh-TW/model-config#extended-thinking)摘要。未設定或 `false`(互動模式中的預設值)時,思考區塊由 API 編輯並顯示為摺疊的存根。編輯只會改變您看到的內容,而不是模型生成的內容:若要減少思考支出,請[降低預算或停用思考](/zh-TW/model-config#extended-thinking)。此設定在非互動模式(`-p`)、Agent SDK 或 IDE 擴充功能(例如 VS Code)中無效 | `true` |300| `showThinkingSummaries` | 在互動式工作階段中顯示[擴展思考](/zh-TW/model-config#extended-thinking)摘要。未設定或 `false`(互動模式中的預設值)時,思考區塊由 API 編輯並顯示為摺疊的存根。編輯只會改變您看到的內容,而不是模型生成的內容:若要減少思考支出,請[降低預算或停用思考](/zh-TW/model-config#extended-thinking)。此設定在非互動模式(`-p`)、Agent SDK 或 IDE 擴充功能(例如 VS Code)中無效 | `true` |


305| `strictKnownMarketplaces` | (Managed 設定僅限)plugin marketplaces 白名單。未定義 = 無限制,空陣列 = 鎖定。在 marketplace 新增和 plugin 安裝、更新、重新整理和自動更新時強制執行,因此在設定政策之前新增的 marketplace 無法用於擷取 plugins。請參閱 [Managed marketplace 限制](/zh-TW/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |310| `strictKnownMarketplaces` | (Managed 設定僅限)plugin marketplaces 白名單。未定義 = 無限制,空陣列 = 鎖定。在 marketplace 新增和 plugin 安裝、更新、重新整理和自動更新時強制執行,因此在設定政策之前新增的 marketplace 無法用於擷取 plugins。請參閱 [Managed marketplace 限制](/zh-TW/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |

306| `strictPluginOnlyCustomization` | (Managed 設定僅限)阻止 skills、agents、hooks 和 MCP servers 來自使用者和專案來源,因此它們只能來自 plugins 或 managed 設定。`true` 鎖定所有四個表面;陣列僅鎖定命名的表面。請參閱 [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |311| `strictPluginOnlyCustomization` | (Managed 設定僅限)阻止 skills、agents、hooks 和 MCP servers 來自使用者和專案來源,因此它們只能來自 plugins 或 managed 設定。`true` 鎖定所有四個表面;陣列僅鎖定命名的表面。請參閱 [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |

307| `syntaxHighlightingDisabled` | 停用 diffs、程式碼區塊和檔案預覽中的語法醒目提示 | `true` |312| `syntaxHighlightingDisabled` | 停用 diffs、程式碼區塊和檔案預覽中的語法醒目提示 | `true` |

308| `teammateMode` | [agent team](/zh-TW/agent-teams) 隊友的顯示方式:`auto`(在 tmux 或 iTerm2 中選擇分割窗格,否則為進程內)、`in-process` 或 `tmux`(使用 tmux 或 iTerm2 選擇分割窗格,從您的終端機偵測)。`--teammate-mode` 會覆蓋此設定以進行一個工作階段。請參閱[選擇顯示模式](/zh-TW/agent-teams#choose-a-display-mode) | `"in-process"` |313| `teammateMode` | [agent team](/zh-TW/agent-teams) 隊友的顯示方式:`in-process`(預設)、`auto`(在 tmux 或 iTerm2 中選擇分割窗格,否則為進程內)、`tmux`(使用 tmux 或 iTerm2 選擇分割窗格,從您的終端機偵測)或 {/* min-version: 2.1.186 */}}`iterm2`(iTerm2 原生分割窗格透過 `it2` CLI,在 v2.1.186 中新增)預設在 v2.1.179 中從 `auto` 變更。`--teammate-mode` 會覆蓋此設定以進行一個工作階段。請參閱[選擇顯示模式](/zh-TW/agent-teams#choose-a-display-mode) | `"auto"` |

309| `terminalProgressBarEnabled` | 在支援的終端機中顯示終端機進度條:ConEmu、Ghostty 1.2.0+ 和 iTerm2 3.6.6+。預設:`true`。在 `/config` 中顯示為**終端機進度條** | `false` |314| `terminalProgressBarEnabled` | 在支援的終端機中顯示終端機進度條:ConEmu、Ghostty 1.2.0+ 和 iTerm2 3.6.6+。預設:`true`。在 `/config` 中顯示為**終端機進度條** | `false` |

310| `theme` | {/* min-version: 2.1.119 */}介面的色彩主題:`"auto"`、`"dark"`、`"light"`、`"dark-daltonized"`、`"light-daltonized"`、`"dark-ansi"`、`"light-ansi"` 或自訂主題參考,例如 `"custom:<slug>"` 或 `"custom:<plugin-name>:<slug>"`。預設:`"dark"`。請參閱[建立自訂主題](/zh-TW/terminal-config#create-a-custom-theme)。在 `/config` 中顯示為**主題** | `"dark"` |315| `theme` | {/* min-version: 2.1.119 */}介面的色彩主題:`"auto"`、`"dark"`、`"light"`、`"dark-daltonized"`、`"light-daltonized"`、`"dark-ansi"`、`"light-ansi"` 或自訂主題參考,例如 `"custom:<slug>"` 或 `"custom:<plugin-name>:<slug>"`。預設:`"dark"`。請參閱[建立自訂主題](/zh-TW/terminal-config#create-a-custom-theme)。在 `/config` 中顯示為**主題** | `"dark"` |

311| `tui` | 終端機 UI 渲染器。使用 `"fullscreen"` 以取得無閃爍[替代螢幕渲染器](/zh-TW/fullscreen),具有虛擬化捲軸。使用 `"default"` 以取得經典主螢幕渲染器。透過 `/tui` 設定。您也可以設定 [`CLAUDE_CODE_NO_FLICKER`](/zh-TW/env-vars) 環境變數。背景工作階段從[代理檢視](/zh-TW/agent-view)開啟時,無論此設定如何,始終使用全螢幕渲染器 | `"fullscreen"` |316| `tui` | 終端機 UI 渲染器。使用 `"fullscreen"` 以取得無閃爍[替代螢幕渲染器](/zh-TW/fullscreen),具有虛擬化捲軸。使用 `"default"` 以取得經典主螢幕渲染器。透過 `/tui` 設定。您也可以設定 [`CLAUDE_CODE_NO_FLICKER`](/zh-TW/env-vars) 環境變數。背景工作階段從[代理檢視](/zh-TW/agent-view)開啟時,無論此設定如何,始終使用全螢幕渲染器 | `"fullscreen"` |


344 349 

345| 金鑰 | 說明 | 範例 |350| 金鑰 | 說明 | 範例 |

346| :---------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |351| :---------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |

347| `worktree.baseRef` | 新 worktrees 分支的來源 ref。`"fresh"`(預設)從 `origin/<default-branch>` 分支以取得與遠端相符的乾淨樹。`"head"` 從您目前的本機 `HEAD` 分支,因此未推送的提交和功能分支狀態存在於 worktree 中。適用於 `--worktree`、`EnterWorktree` 工具和 subagent 隔離 | `"head"` |352| `worktree.baseRef` | 新 worktrees 分支的來源 ref。`"fresh"`(預設)從 `origin/<default-branch>` 分支以取得與遠端相符的乾淨樹。`"head"` 從您目前的本機 `HEAD` 分支,所以未推送的提交和功能分支狀態存在於 worktree 中。適用於 `--worktree`、`EnterWorktree` 工具和 subagent 隔離 | `"head"` |

348| `worktree.symlinkDirectories` | 要從主儲存庫符號連結到每個 worktree 的目錄,以避免在磁碟上複製大型目錄。預設不符號連結任何目錄 | `["node_modules", ".cache"]` |353| `worktree.symlinkDirectories` | 要從主儲存庫符號連結到每個 worktree 的目錄,以避免在磁碟上複製大型目錄。預設不符號連結任何目錄 | `["node_modules", ".cache"]` |

349| `worktree.sparsePaths` | 要在每個 worktree 中透過 git sparse-checkout 簽出的目錄。僅將列出的目錄加上根層級檔案寫入磁碟,在大型 monorepos 中速度更快 | `["packages/my-app", "shared/utils"]` |354| `worktree.sparsePaths` | 要在每個 worktree 中透過 git sparse-checkout 簽出的目錄。僅將列出的目錄加上根層級檔案寫入磁碟,在大型 monorepos 中速度更快 | `["packages/my-app", "shared/utils"]` |

350| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}[背景工作階段](/zh-TW/agent-view#how-file-edits-are-isolated)的隔離模式。`"worktree"`(預設)在呼叫 `EnterWorktree` 之前阻止主簽出中的 `Edit`/`Write`。`"none"` 讓背景工作直接編輯工作副本。需要 Claude Code v2.1.143 或更新版本 | `"none"` |355| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}[背景工作階段](/zh-TW/agent-view#how-file-edits-are-isolated)的隔離模式。`"worktree"`(預設)在呼叫 `EnterWorktree` 之前阻止主簽出中的 `Edit`/`Write`。`"none"` 讓背景工作直接編輯工作副本。需要 Claude Code v2.1.143 或更新版本 | `"none"` |


389設定進階 sandboxing 行為。Sandboxing 將 bash 命令與您的檔案系統和網路隔離。請參閱 [Sandboxing](/zh-TW/sandboxing) 以了解詳細資訊。394設定進階 sandboxing 行為。Sandboxing 將 bash 命令與您的檔案系統和網路隔離。請參閱 [Sandboxing](/zh-TW/sandboxing) 以了解詳細資訊。

390 395 

391| 金鑰 | 說明 | 範例 |396| 金鑰 | 說明 | 範例 |

392| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------- |397| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------- |

393| `enabled` | 啟用 bash sandboxing(macOS、Linux 和 WSL2)。預設:false | `true` |398| `enabled` | 啟用 bash sandboxing(macOS、Linux 和 WSL2)。預設:false | `true` |

394| `failIfUnavailable` | 如果 `sandbox.enabled` 為 true 但 sandbox 無法啟動(遺失相依性、不支援的平台),則在啟動時以錯誤結束。當為 false(預設)時,會顯示警告,命令會以 unsandboxed 方式執行。適用於需要 sandboxing 作為硬閘門的 managed 設定部署 | `true` |399| `failIfUnavailable` | 如果 `sandbox.enabled` 為 true 但 sandbox 無法啟動(遺失相依性、不支援的平台),則在啟動時以錯誤結束。當為 false(預設)時,會顯示警告,命令會以 unsandboxed 方式執行。適用於需要 sandboxing 作為硬閘門的 managed 設定部署 | `true` |

395| `autoAllowBashIfSandboxed` | 在 sandboxed 時自動批准 bash 命令。預設:true | `true` |400| `autoAllowBashIfSandboxed` | 在 sandboxed 時自動批准 bash 命令。預設:true | `true` |


411| `network.socksProxyPort` | 如果您想帶上自己的代理,使用的 SOCKS5 代理連接埠。如果未指定,Claude 將執行自己的代理。 | `8081` |416| `network.socksProxyPort` | 如果您想帶上自己的代理,使用的 SOCKS5 代理連接埠。如果未指定,Claude 將執行自己的代理。 | `8081` |

412| `enableWeakerNestedSandbox` | 為無特權 Docker 環境啟用較弱的 sandbox(僅限 Linux 和 WSL2)。**降低安全性。** 預設:false | `true` |417| `enableWeakerNestedSandbox` | 為無特權 Docker 環境啟用較弱的 sandbox(僅限 Linux 和 WSL2)。**降低安全性。** 預設:false | `true` |

413| `enableWeakerNetworkIsolation` | (僅限 macOS)允許在 sandbox 中存取系統 TLS 信任服務(`com.apple.trustd.agent`)。使用 `httpProxyPort` 和自訂 CA 的 MITM 代理時,Go 型工具(如 `gh`、`gcloud` 和 `terraform`)需要驗證 TLS 憑證。**透過開啟潛在的資料外洩路徑降低安全性**。預設:false | `true` |418| `enableWeakerNetworkIsolation` | (僅限 macOS)允許在 sandbox 中存取系統 TLS 信任服務(`com.apple.trustd.agent`)。使用 `httpProxyPort` 和自訂 CA 的 MITM 代理時,Go 型工具(如 `gh`、`gcloud` 和 `terraform`)需要驗證 TLS 憑證。**透過開啟潛在的資料外洩路徑降低安全性**。預設:false | `true` |

419| `allowAppleEvents` | (僅限 macOS)允許 sandboxed 命令傳送 Apple Events。`open`、`osascript` 和在瀏覽器中開啟 URL 的工具需要,否則會失敗並出現錯誤 `-600`。**移除程式碼執行隔離。** Sandboxed 命令可以啟動其他應用程式 unsandboxed,無需使用者提示;它們也可以傳送 AppleScript 命令到執行中的應用程式(例如終端機),受限於每個應用程式的 macOS 自動化同意提示 (TCC)。僅從使用者、managed 或 CLI 設定受尊重,不從專案設定。預設:false | `true` |

414| `bwrapPath` | (Managed 設定僅限,Linux/WSL2)bubblewrap (`bwrap`) 二進位檔的絕對路徑。覆蓋透過 `PATH` 的自動偵測。僅從 [managed 設定](/zh-TW/settings#settings-files)受尊重,不從使用者或專案設定。在 managed 環境中 `bwrap` 安裝在非標準位置時很有用。 | `/opt/admin/bwrap` |420| `bwrapPath` | (Managed 設定僅限,Linux/WSL2)bubblewrap (`bwrap`) 二進位檔的絕對路徑。覆蓋透過 `PATH` 的自動偵測。僅從 [managed 設定](/zh-TW/settings#settings-files)受尊重,不從使用者或專案設定。在 managed 環境中 `bwrap` 安裝在非標準位置時很有用。 | `/opt/admin/bwrap` |

415| `socatPath` | (Managed 設定僅限,Linux/WSL2)用於 sandbox 網路代理的 `socat` 二進位檔的絕對路徑。覆蓋透過 `PATH` 的自動偵測。僅從 managed 設定受尊重。 | `/opt/admin/socat` |421| `socatPath` | (Managed 設定僅限,Linux/WSL2)用於 sandbox 網路代理的 `socat` 二進位檔的絕對路徑。覆蓋透過 `PATH` 的自動偵測。僅從 managed 設定受尊重。 | `/opt/admin/socat` |

416 422 


467* 拉取請求說明是純文字473* 拉取請求說明是純文字

468 474 

469| 金鑰 | 說明 |475| 金鑰 | 說明 |

470| :------- | :-------------------------------- |476| :----------- | :------------------------------------------------------------------------------------------------------------- |

471| `commit` | git 提交的歸屬,包括任何 trailers。空字串隱藏提交歸屬 |477| `commit` | git 提交的歸屬,包括任何 trailers。空字串隱藏提交歸屬 |

472| `pr` | 拉取請求說明的歸屬。空字串隱藏拉取請求歸屬 |478| `pr` | 拉取請求說明的歸屬。空字串隱藏拉取請求歸屬 |

479| `sessionUrl` | 當從網頁或遠端控制工作階段執行時,是否將 claude.ai 工作階段連結附加為提交上的 `Claude-Session` trailer 和拉取請求說明中的連結。預設為 `true`。設定為 `false` 以省略連結 |

473 480 

474**預設提交歸屬:**481**預設提交歸屬:**

475 482 


497```504```

498 505 

499<Note>506<Note>

500 `attribution` 設定優先於已棄用的 `includeCoAuthoredBy` 設定。若要隱藏所有歸屬,請將 `commit` 和 `pr` 設定為空字串。507 `attribution` 設定優先於已棄用的 `includeCoAuthoredBy` 設定。若要隱藏所有歸屬,請將 `commit` 和 `pr` 設定為空字串,並將 `sessionUrl` 設定為 `false`

501</Note>508</Note>

502 509 

503<h3 id="file-suggestion-settings">510<h3 id="file-suggestion-settings">


678 685 

679`Setting sources` 行確認正在讀取哪些來源。它不顯示哪一層提供了每個個別金鑰。同一對話框中的 **Config** 標籤是固定切換集(例如主題和詳細輸出)的編輯器,而不是您 `settings.json` 內容的檢視。686`Setting sources` 行確認正在讀取哪些來源。它不顯示哪一層提供了每個個別金鑰。同一對話框中的 **Config** 標籤是固定切換集(例如主題和詳細輸出)的編輯器,而不是您 `settings.json` 內容的檢視。

680 687 

681如果設定檔案包含錯誤(例如無效的 JSON 或驗證失敗的值),Claude Code 會在啟動時顯示設定問題通知,`/status` 會列出受影響的檔案。執行 `/doctor` 以查看每個錯誤的詳細資訊。688如果設定檔案包含錯誤(例如無效的 JSON 或驗證失敗的值),`/status` 會列出受影響的檔案。執行 `/doctor` 以查看每個錯誤的詳細資訊。

682 689 

683<h3 id="key-points-about-the-configuration-system">690<h3 id="key-points-about-the-configuration-system">

684 設定系統的關鍵要點691 設定系統的關鍵要點

skills.md +38 −1

Details

173 173 

174`--add-dir` 旗標和 `/add-dir` 命令[授予檔案存取權](/zh-TW/permissions#additional-directories-grant-file-access-not-configuration)而不是設定發現,但 skills 是例外:已新增目錄中的 `.claude/skills/` 會自動載入。此例外僅適用於 `--add-dir` 和 `/add-dir`。`settings.json` 中的 `permissions.additionalDirectories` 設定僅授予檔案存取權,不會載入 skills。請參閱[即時變更偵測](#live-change-detection)以了解編輯在工作階段期間如何被拾取。174`--add-dir` 旗標和 `/add-dir` 命令[授予檔案存取權](/zh-TW/permissions#additional-directories-grant-file-access-not-configuration)而不是設定發現,但 skills 是例外:已新增目錄中的 `.claude/skills/` 會自動載入。此例外僅適用於 `--add-dir` 和 `/add-dir`。`settings.json` 中的 `permissions.additionalDirectories` 設定僅授予檔案存取權,不會載入 skills。請參閱[即時變更偵測](#live-change-detection)以了解編輯在工作階段期間如何被拾取。

175 175 

176其他 `.claude/` 設定(例如 subagents、命令和輸出樣式)不會從其他目錄載入。請參閱[例外表](/zh-TW/permissions#additional-directories-grant-file-access-not-configuration)以取得完整的載入和未載入內容清單,以及跨專案共享設定的建議方式。176其他 `.claude/` 設定(例如命令和輸出樣式)不會從其他目錄載入。請參閱[例外表](/zh-TW/permissions#additional-directories-grant-file-access-not-configuration)以取得完整的載入和未載入內容清單,以及跨專案共享設定的建議方式。

177 177 

178<Note>178<Note>

179 來自 `--add-dir` 目錄的 CLAUDE.md 檔案預設不會載入。若要載入它們,請設定 `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`。請參閱[從其他目錄載入](/zh-TW/memory#load-from-additional-directories)。179 來自 `--add-dir` 目錄的 CLAUDE.md 檔案預設不會載入。若要載入它們,請設定 `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`。請參閱[從其他目錄載入](/zh-TW/memory#load-from-additional-directories)。


632 632 

633外掛 skills 不受 `skillOverrides` 影響。透過 `/plugin` 改為管理這些。633外掛 skills 不受 `skillOverrides` 影響。透過 `/plugin` 改為管理這些。

634 634 

635<h2 id="evaluate-and-iterate-on-a-skill">

636 評估和反覆改進 skill

637</h2>

638 

639看到 skill 觸發告訴您 Claude 找到了它,而不是它做了您想要的。若要知道 skill 是否有效,請分別測量兩件事:Claude 是否在應該的提示上叫用它,以及當它確實叫用時輸出是否符合您的預期。

640 

641兩者的檢查都是基準比較。收集一些現實的提示,在一個新工作階段中執行每個提示,skill 可用,然後再次執行[停用](#override-skill-visibility-from-settings)它,並比較結果。新工作階段很重要,因為編寫 skill 的剩餘上下文會掩蓋書面說明中的差距。

642 

643<h3 id="run-evals-with-skill-creator">

644 使用 skill-creator 執行 evals

645</h3>

646 

647[`skill-creator` 外掛](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/skill-creator)在 Claude Code 內自動化比較迴圈。從官方市場安裝它:

648 

649```text theme={null}

650/plugin install skill-creator@claude-plugins-official

651```

652 

653如果 Claude Code 報告在任何市場中找不到該外掛,您的市場要麼遺失,要麼已過期。執行 `/plugin marketplace update claude-plugins-official` 以重新整理它,或 `/plugin marketplace add anthropics/claude-plugins-official`(如果您之前未新增過)。然後重試安裝。

654 

655安裝後,執行 `/reload-plugins` 以在目前工作階段中提供外掛的 skills。然後要求 Claude 評估現有 skill,例如 `evaluate my summarize-changes skill with skill-creator`。外掛會引導您完成編寫測試案例並執行迴圈:

656 

657* **測試案例**:在 skill 目錄內的 `evals/evals.json` 中儲存提示、輸入檔案和預期行為

658* **隔離執行**:為每個測試案例生成一個 [subagent](/zh-TW/sub-agents),以便每次執行都從乾淨的上下文開始,並記錄令牌計數和持續時間

659* **評分**:根據輸出檢查每個判斷,並將通過或失敗與證據寫入 `grading.json`

660* **基準**:將通過率、時間和令牌聚合為有 skill 與無 skill 的 `benchmark.json`,以便您可以比較通過率改進與令牌和時間開銷

661* **版本比較**:在兩個版本的 skill 之間執行盲 A/B,以便您可以在提交之前確認編輯是改進

662* **描述調整**:生成應觸發和不應觸發的提示,測量命中率,並在 skill 在錯誤的請求上啟動時提議描述編輯

663* **檢查檢視器**:開啟一個 HTML 報告,您可以在其中檢查每個輸出並記錄下一個反覆運算讀取的定性反饋

664 

665對於 eval 檔案格式和完整反覆運算工作流程,請參閱 agentskills.io 上的[評估 skill 輸出品質](https://agentskills.io/skill-creation/evaluating-skills)。有關基準和比較模式的背景,請參閱 [skill-creator 公告](https://claude.com/blog/improving-skill-creator-test-measure-and-refine-agent-skills)。

666 

635<h2 id="share-skills">667<h2 id="share-skills">

636 分享 skills668 分享 skills

637</h2>669</h2>


8503. 嘗試重新表述您的請求以更密切地匹配描述8823. 嘗試重新表述您的請求以更密切地匹配描述

8514. 如果 skill 是使用者可叫用的,請使用 `/skill-name` 直接叫用它8834. 如果 skill 是使用者可叫用的,請使用 `/skill-name` 直接叫用它

852 884 

885如果 frontmatter YAML 格式不正確,Claude Code 會載入 skill 主體且中繼資料為空,因此 `/skill-name` 仍然有效,但 Claude 沒有 `description` 可用來比對。執行 `--debug` 以查看解析錯誤。

886 

853<h3 id="skill-triggers-too-often">887<h3 id="skill-triggers-too-often">

854 Skill 觸發過於頻繁888 Skill 觸發過於頻繁

855</h3>889</h3>


872</h2>906</h2>

873 907 

874* **[除錯您的設定](/zh-TW/debug-your-config)**:診斷為什麼 skill 沒有出現或觸發908* **[除錯您的設定](/zh-TW/debug-your-config)**:診斷為什麼 skill 沒有出現或觸發

909* **[評估 skill 輸出品質](https://agentskills.io/skill-creation/evaluating-skills)**:agentskills.io 上的 eval 檔案格式和反覆運算工作流程

910* **[Skill 編寫最佳實踐](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)**:適用於 Claude 產品的編寫指導

875* **[Subagents](/zh-TW/sub-agents)**:委派任務給專門的代理911* **[Subagents](/zh-TW/sub-agents)**:委派任務給專門的代理

876* **[Plugins](/zh-TW/plugins)**:使用其他擴展功能打包和分發 skills912* **[Plugins](/zh-TW/plugins)**:使用其他擴展功能打包和分發 skills

877* **[Hooks](/zh-TW/hooks)**:自動化工具事件周圍的工作流程913* **[Hooks](/zh-TW/hooks)**:自動化工具事件周圍的工作流程

878* **[Memory](/zh-TW/memory)**:管理 CLAUDE.md 檔案以取得持久上下文914* **[Memory](/zh-TW/memory)**:管理 CLAUDE.md 檔案以取得持久上下文

879* **[Commands](/zh-TW/commands)**:內建命令和捆綁 skills 的參考915* **[Commands](/zh-TW/commands)**:內建命令和捆綁 skills 的參考

880* **[Permissions](/zh-TW/permissions)**:控制工具和 skill 存取916* **[Permissions](/zh-TW/permissions)**:控制工具和 skill 存取

917* **[Claude Tag skills](https://claude.com/docs/claude-tag/admins/skills-repo)**:提交到儲存庫的專案 skills 在該儲存庫用於 Claude Tag 頻道時也會載入

slack.md +15 −1

Details

6 6 

7> 直接從您的 Slack 工作區委派編碼任務7> 直接從您的 Slack 工作區委派編碼任務

8 8 

9<Note>

10 Slack 中的 Claude Code 正被 [Claude Tag](https://claude.com/docs/claude-tag/overview) 取代,適用於 Team 和 Enterprise 工作區。Claude Tag 以 @Claude 身份作為您組織的共享身份運行,具有管理員配置的存取權限,在同一個 Slack 應用程式下,因此無需重新安裝,現有設定在轉換期間繼續運作。若要切換工作區,請參閱[從較早的 Slack 中的 Claude 遷移](https://claude.com/docs/claude-tag/admins/migrate-from-earlier)。

11</Note>

12 

9Slack 中的 Claude Code 將 Claude Code 的強大功能直接帶入您的 Slack 工作區。當您提及 `@Claude` 並附帶編碼任務時,Claude 會自動檢測意圖並在網路上建立 Claude Code 工作階段,讓您無需離開團隊對話即可委派開發工作。13Slack 中的 Claude Code 將 Claude Code 的強大功能直接帶入您的 Slack 工作區。當您提及 `@Claude` 並附帶編碼任務時,Claude 會自動檢測意圖並在網路上建立 Claude Code 工作階段,讓您無需離開團隊對話即可委派開發工作。

10 14 

11此整合建立在現有的 Claude for Slack 應用程式基礎上,但為編碼相關請求添加了智能路由到網路上的 Claude Code。15此整合建立在現有的 Claude for Slack 應用程式基礎上,但為編碼相關請求添加了智能路由到網路上的 Claude Code。每個工作階段在您自己的 Claude 帳戶下運行,使用您連接的儲存庫和您的方案限制。

12 16 

13<h2 id="use-cases">17<h2 id="use-cases">

14 使用案例18 使用案例


217 故障排除221 故障排除

218</h2>222</h2>

219 223 

224<h3 id="claude-code-is-not-enabled-for-your-account">

225 'Claude Code 未為您的帳戶啟用'

226</h3>

227 

228此錯誤表示您的 Claude 帳戶尚未有雲端環境,而不是管理員需要啟用任何內容。使用您連接到 Slack 的同一帳戶登入 [claude.ai/code](https://claude.ai/code) 一次。首次造訪會建立您的預設雲端環境,錯誤會在您下次提及時清除。每位使用者必須個別執行此操作。

229 

220<h3 id="sessions-not-starting">230<h3 id="sessions-not-starting">

221 工作階段未啟動231 工作階段未啟動

222</h3>232</h3>


277 Claude for Slack 一般文檔287 Claude for Slack 一般文檔

278 </Card>288 </Card>

279 289 

290 <Card title="Claude Tag" icon="users" href="https://claude.com/docs/claude-tag/overview">

291 組織管理的 Slack 中的 @Claude,具有管理員配置的存取權限

292 </Card>

293 

280 <Card title="Slack 應用程式市場" icon="store" href="https://slack.com/marketplace/A08SF47R6P4">294 <Card title="Slack 應用程式市場" icon="store" href="https://slack.com/marketplace/A08SF47R6P4">

281 從 Slack 市場安裝 Claude 應用程式295 從 Slack 市場安裝 Claude 應用程式

282 </Card>296 </Card>

statusline.md +1 −1

Details

15* 您跨多個工作階段工作,需要區分它們15* 您跨多個工作階段工作,需要區分它們

16* 您希望 git 分支和狀態始終可見16* 您希望 git 分支和狀態始終可見

17 17 

18Claude Code 也可以呈現[頁尾連結徽章](/zh-TW/settings#footer-link-badges):當設定的正規表達式符合對話中的文字時會在頁尾出現的可點擊晶片。這些與狀態列無關不會與您的指令碼互動;請改用 [`footerLinksRegexes`](/zh-TW/settings#footer-link-badges) 設定來設定它們18狀態列會在內建頁尾徽章上方的自己的列中呈現,不會取代它們。若要在對話中出現 ID 時在頁尾新增可點擊的連結徽章而不需要撰寫指令碼請改為設定 [`footerLinksRegexes`](/zh-TW/settings#footer-link-badges)。

19 19 

20以下是一個[多行狀態列](#display-multiple-lines)的範例,在第一行顯示 git 資訊,在第二行顯示顏色編碼的 context 列。20以下是一個[多行狀態列](#display-multiple-lines)的範例,在第一行顯示 git 資訊,在第二行顯示顏色編碼的 context 列。

21 21 

sub-agents.md +6 −11

Details

765Subagents 可以在前景(阻止)或背景(並行)中執行:765Subagents 可以在前景(阻止)或背景(並行)中執行:

766 766 

767* **前景 subagents** 阻止主要對話直到完成。權限提示會在出現時傳遞給您。767* **前景 subagents** 阻止主要對話直到完成。權限提示會在出現時傳遞給您。

768* **背景 subagents** 在您繼續工作時並行執行。它們使用工作階段中已授予的權限執行並自動拒絕任何否則會提示的工具呼叫。如果背景 subagent 需要提出澄清問題該工具呼叫失敗 subagent 繼續。768* **背景 subagents** 在您繼續工作時並行執行。{/* min-version: 2.1.186 */}自 v2.1.186 起當背景 subagent 到達需要權限的工具呼叫時提示會在您的主要工作階段中出現並命名要求的 subagent。批准以讓 subagent 繼續,或按 Esc 拒絕該單一工具呼叫而不停止 subagent在 v2.1.186 之前,背景 subagents 自動拒絕任何會提示的工具呼叫。

769 

770如果背景 subagent 因權限遺失而失敗,您可以啟動一個新的前景 subagent 執行相同任務以使用互動式提示重試。

771 769 

772Claude 根據任務決定是否在前景或背景中執行 subagents。您也可以:770Claude 根據任務決定是否在前景或背景中執行 subagents。您也可以:

773 771 


776 774 

777若要禁用所有背景任務功能,請將 `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 環境變數設定為 `1`。請參閱 [Environment variables](/zh-TW/env-vars)。775若要禁用所有背景任務功能,請將 `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 環境變數設定為 `1`。請參閱 [Environment variables](/zh-TW/env-vars)。

778 776 

779當 [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) 設定為 `1` 時,每個 subagent 產生都在背景中執行,無論 `background` 欄位如何。Forks 仍然在您的終端中出現權限提示;命名 subagents 自動拒絕任何會提示的內容,如上所述。777當 [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) 設定為 `1` 時,每個 subagent 產生都在背景中執行,無論 `background` 欄位如何。權限提示來自這些背景 subagents 會在您的主要工作階段中出現,如上所述。

780 778 

781<h3 id="common-patterns">779<h3 id="common-patterns">

782 常見模式780 常見模式


849 847 

850嵌套 subagent 的配置方式與頂級 subagent 相同,並從相同的 [scopes](#choose-the-subagent-scope) 解析。提示輸入下方的 subagent 面板顯示完整樹:每一行顯示後代的 `(+N)` 計數,打開一行會顯示該 subagent 的直接子代,以及返回到 `main` 的路徑。[`/agents`](#use-the-%2Fagents-command) 中的 Running 標籤將執行中的 subagents 列為平面列表。848嵌套 subagent 的配置方式與頂級 subagent 相同,並從相同的 [scopes](#choose-the-subagent-scope) 解析。提示輸入下方的 subagent 面板顯示完整樹:每一行顯示後代的 `(+N)` 計數,打開一行會顯示該 subagent 的直接子代,以及返回到 `main` 的路徑。[`/agents`](#use-the-%2Fagents-command) 中的 Running 標籤將執行中的 subagents 列為平面列表。

851 849 

852深度計算為主要對話下方的 subagent 級別數,無論每個級別是否在 [前景或背景](#run-subagents-in-foreground-or-background) 中執行850深度計算為主要對話下方的 subagent 級別數,無論每個級別是否在 [前景或背景](#run-subagents-in-foreground-or-background) 中執行。深度為五的 subagent 不接收 Agent 工具,無法進一步產生。限制是固定的且不可配置。

853 

854* **前景 subagents**:可以在任何深度產生。每個級別阻止其父級直到它返回,所以鏈是自限制的:主要對話等待整個鏈。

855* **背景 subagents**:深度五的背景 subagent 不接收 Agent 工具,無法進一步產生。限制是固定的且不可配置,存在是為了防止失控的並行樹。

856 851 

857若要防止特定 subagent 產生其他 subagents,請從其 [`tools`](#available-tools) 列表中省略 `Agent` 或將其新增到 `disallowedTools`。852若要防止特定 subagent 產生其他 subagents,請從其 [`tools`](#available-tools) 列表中省略 `Agent` 或將其新增到 `disallowedTools`。

858 853 


888 883 

889恢復的 subagents 保留其完整對話歷史記錄,包括所有先前的工具呼叫、結果和推理。Subagent 從停止的地方精確繼續,而不是從頭開始。884恢復的 subagents 保留其完整對話歷史記錄,包括所有先前的工具呼叫、結果和推理。Subagent 從停止的地方精確繼續,而不是從頭開始。

890 885 

891當 subagent 完成時,Claude 接收其代理 ID。內建的 Explore 和 Plan 代理是一次性的,不返回代理 ID,所以它們無法被恢復;當您需要繼續工作時,請使用 `general-purpose` 或自訂 subagent。Claude 使用 `SendMessage` 工具,將代理的 ID 作為 `to` 欄位來恢復它。`SendMessage` 工具僅在透過 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 啟用 [agent teams](/zh-TW/agent-teams) 時可用886當 subagent 完成時,Claude 接收其代理 ID。內建的 Explore 和 Plan 代理是一次性的,不返回代理 ID,所以它們無法被恢復;當您需要繼續工作時,請使用 `general-purpose` 或自訂 subagent。Claude 使用 `SendMessage` 工具,將代理的 ID 作為 `to` 欄位來恢復它。`SendMessage` 工具始終可用於透過代理 ID 或名稱恢復 subagents。結構化的團隊協議訊息,例如 `shutdown_request` `plan_approval_response`,需要啟用 [agent teams](/zh-TW/agent-teams)。

892 887 

893若要恢復 subagent,請要求 Claude 繼續先前的工作:888若要恢復 subagent,請要求 Claude 繼續先前的工作:

894 889 


976Fork 繼承主工作階段在產生時擁有的所有內容。命名 subagent 從自己的定義開始。971Fork 繼承主工作階段在產生時擁有的所有內容。命名 subagent 從自己的定義開始。

977 972 

978| | Fork | 命名 subagent |973| | Fork | 命名 subagent |

979| :----------- | :--------- | :---------------------------------------------------------------- |974| :----------- | :--------- | :----------------------------------------------------------------------------------------- |

980| Context | 完整對話歷史記錄 | 新鮮上下文,帶有您傳遞的提示 |975| Context | 完整對話歷史記錄 | 新鮮上下文,帶有您傳遞的提示 |

981| 系統提示和工具 | 與主工作階段相同 | 來自 subagent 的 [definition file](#write-subagent-files) |976| 系統提示和工具 | 與主工作階段相同 | 來自 subagent 的 [definition file](#write-subagent-files) |

982| Model | 與主工作階段相同 | 來自 subagent 的 `model` 欄位 |977| Model | 與主工作階段相同 | 來自 subagent 的 `model` 欄位 |

983| Permissions | 提示出現在您的終端中 | [Auto-denied](#run-subagents-in-foreground-or-background) 在背景中執行時 |978| Permissions | 提示出現在您的終端中 | [Prompts surface in your main session](#run-subagents-in-foreground-or-background) 在背景中執行時 |

984| Prompt cache | 與主工作階段共享 | 單獨的快取 |979| Prompt cache | 與主工作階段共享 | 單獨的快取 |

985 980 

986因為 fork 的系統提示和工具定義與父級相同,其第一個請求重複使用父級的 [prompt cache](/zh-TW/prompt-caching#subagents-and-the-cache)。這使得 forking 比為需要相同上下文的任務產生新 subagent 更便宜。981因為 fork 的系統提示和工具定義與父級相同,其第一個請求重複使用父級的 [prompt cache](/zh-TW/prompt-caching#subagents-and-the-cache)。這使得 forking 比為需要相同上下文的任務產生新 subagent 更便宜。

Details

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

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

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

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

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

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

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


35| `ReadMcpResourceTool` | 按 URI 讀取特定 MCP 資源 | 否 |36| `ReadMcpResourceTool` | 按 URI 讀取特定 MCP 資源 | 否 |

36| `RemoteTrigger` | 在 claude.ai 上建立、更新、執行和列出 [Routines](/zh-TW/routines)。支援 `/schedule` 命令。{/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines 位於 claude.ai 上,需要 Pro、Max、Team 或 Enterprise 計畫,因此此工具無法從 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 存取 | 否 |37| `RemoteTrigger` | 在 claude.ai 上建立、更新、執行和列出 [Routines](/zh-TW/routines)。支援 `/schedule` 命令。{/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines 位於 claude.ai 上,需要 Pro、Max、Team 或 Enterprise 計畫,因此此工具無法從 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 存取 | 否 |

37| `ScheduleWakeup` | 重新排程 [自主進行的 `/loop`](/zh-TW/scheduled-tasks#let-claude-choose-the-interval) 的下一次迭代。Claude 在每次迭代結束時呼叫此工具,以選擇下一次執行的時間,範圍在一分鐘到一小時之間;您不需要直接呼叫它。待處理的喚醒會出現在 [Stop hook input](/zh-TW/hooks#stop-input) 的 `session_crons` 中。{/* plan-availability: feature=loop-dynamic providers=anthropic */}在 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 上不可用,其中沒有間隔的 `/loop` 提示會改為按固定時間表執行 | 否 |38| `ScheduleWakeup` | 重新排程 [自主進行的 `/loop`](/zh-TW/scheduled-tasks#let-claude-choose-the-interval) 的下一次迭代。Claude 在每次迭代結束時呼叫此工具,以選擇下一次執行的時間,範圍在一分鐘到一小時之間;您不需要直接呼叫它。待處理的喚醒會出現在 [Stop hook input](/zh-TW/hooks#stop-input) 的 `session_crons` 中。{/* plan-availability: feature=loop-dynamic providers=anthropic */}在 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 上不可用,其中沒有間隔的 `/loop` 提示會改為按固定時間表執行 | 否 |

38| `SendMessage` | 傳送訊息給 [agent team](/zh-TW/agent-teams) 隊友,或按 agent ID [恢復 subagent](/zh-TW/sub-agents#resume-subagents)。已停止的 subagents 會在背景中自動恢復。僅在設定 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 時可用 | 否 |39| `SendMessage` | 傳送訊息給 [agent team](/zh-TW/agent-teams) 隊友,或按 agent ID [恢復 subagent](/zh-TW/sub-agents#resume-subagents)。已停止的 subagents 會在背景中自動恢復。結構化的團隊協議訊息需要 agent teams | 否 |

39| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}上傳 `ONBOARDING.md` 並傳回隊友可以在 Claude Code 中開啟的分享連結。在撰寫指南後從 `/team-onboarding` 呼叫。適用於 Pro、Max、Team 和 Enterprise 計畫上的 claude.ai 訂閱者 | 是 |40| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}上傳 `ONBOARDING.md` 並傳回隊友可以在 Claude Code 中開啟的分享連結。在撰寫指南後從 `/team-onboarding` 呼叫。適用於 Pro、Max、Team 和 Enterprise 計畫上的 claude.ai 訂閱者 | 是 |

40| `Skill` | 在主對話中執行 [skill](/zh-TW/skills#control-who-invokes-a-skill) | 是 |41| `Skill` | 在主對話中執行 [skill](/zh-TW/skills#control-who-invokes-a-skill) | 是 |

41| `TaskCreate` | 在任務清單中建立新任務 | 否 |42| `TaskCreate` | 在任務清單中建立新任務 | 否 |


102啟動 subagent 本身不會提示權限。subagent 自己的工具呼叫在執行時會根據您的權限規則進行檢查:103啟動 subagent 本身不會提示權限。subagent 自己的工具呼叫在執行時會根據您的權限規則進行檢查:

103 104 

104* **前景 subagents** 顯示您在主對話中會看到的相同權限提示,在每個工具呼叫發生時。105* **前景 subagents** 顯示您在主對話中會看到的相同權限提示,在每個工具呼叫發生時。

105* **背景 subagents** 不顯示提示它們使用工作階段中已授予的權限執行並自動拒絕任何否則會提示的工具呼叫。拒絕後,subagent 會在沒有該工具的情況下繼續進行106* **背景 subagents** {/* min-version: 2.1.186 */}自 v2.1.186 起在您的主要工作階段中顯示權限提示提示會指出哪個 subagent 在要求按下 Esc 會拒絕該單一工具呼叫而不會停止 subagent。在 v2.1.186 之前,背景 subagents 會自動拒絕任何否則會提示的工具呼叫,並在沒有該工具的情況下繼續

106 107 

107若要首先限制 subagent 可以到達的內容,請縮小其 `tools` 欄位、將 Bash 排除在清單之外,或在您的設定中設定拒絕規則,如 [控制 subagent 功能](/zh-TW/sub-agents#control-subagent-capabilities) 中所述。如需有關選擇前景或背景的更多資訊,請參閱 [在前景或背景中執行 subagents](/zh-TW/sub-agents#run-subagents-in-foreground-or-background)。108若要首先限制 subagent 可以到達的內容,請縮小其 `tools` 欄位、將 Bash 排除在清單之外,或在您的設定中設定拒絕規則,如 [控制 subagent 功能](/zh-TW/sub-agents#control-subagent-capabilities) 中所述。如需有關選擇前景或背景的更多資訊,請參閱 [在前景或背景中執行 subagents](/zh-TW/sub-agents#run-subagents-in-foreground-or-background)。

108 109 

ultrareview.md +16 −13

Details

12 12 

13Ultrareview 是在 Claude Code 網路基礎設施上執行的深度程式碼審查。當您執行 `/code-review ultra` 時,Claude Code 會在遠端沙箱中啟動一群審查代理程式,以尋找您分支或拉取請求中的錯誤。13Ultrareview 是在 Claude Code 網路基礎設施上執行的深度程式碼審查。當您執行 `/code-review ultra` 時,Claude Code 會在遠端沙箱中啟動一群審查代理程式,以尋找您分支或拉取請求中的錯誤。

14 14 

15與本地 `/review` 相比,ultrareview 提供:15與本地 `/code-review` 或 `/review` 相比,ultrareview 提供:

16 16 

17* **更高的信號品質**:每個報告的發現都經過獨立重現和驗證,因此結果專注於真實錯誤而非風格建議17* **更高的信號品質**:每個報告的發現都經過獨立重現和驗證,因此結果專注於真實錯誤而非風格建議

18* **更廣泛的覆蓋範圍**:許多審查代理程式並行探索變更,這會發現單次審查可能遺漏的問題18* **更廣泛的覆蓋範圍**:許多審查代理程式並行探索變更,這會發現中等規模本地審查可能遺漏的問題

19* **無本地資源使用**:審查完全在遠端沙箱中執行,因此您的終端在執行期間保持空閒,可用於其他工作19* **無本地資源使用**:審查完全在遠端沙箱中執行,因此您的終端在執行期間保持空閒,可用於其他工作

20 20 

21Ultrareview 需要使用 Claude.ai 帳戶進行身份驗證,因為它在 Claude Code 網路基礎設施上執行。如果您僅使用 API 金鑰登入,請先執行 `/login` 並使用 Claude.ai 進行身份驗證。使用 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry 的 Claude Code 時,Ultrareview 不可用,對於已啟用零資料保留的組織也不可用。21Ultrareview 需要使用 Claude.ai 帳戶進行身份驗證,因為它在 Claude Code 網路基礎設施上執行。如果您僅使用 API 金鑰登入,請先執行 `/login` 並使用 Claude.ai 進行身份驗證。使用 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry 的 Claude Code 時,Ultrareview 不可用,對於已啟用零資料保留的組織也不可用。


42 42 

43<Tip>43<Tip>

44 如果您的儲存庫太大而無法打包,Claude Code 會提示您改用 PR 模式。推送您的分支並開啟草稿 PR,然後執行 `/code-review ultra <PR-number>`。44 如果您的儲存庫太大而無法打包,Claude Code 會提示您改用 PR 模式。推送您的分支並開啟草稿 PR,然後執行 `/code-review ultra <PR-number>`。

45 

46 如果拉取請求的差異太大,Claude Code 會在任何審查工作執行前以範圍提示拒絕審查。

45</Tip>47</Tip>

46 48 

47啟動前,Claude Code 會顯示確認對話框,其中包含審查範圍(審查分支時包括檔案和行數)、您剩餘的免費執行次數和估計成本。確認後,審查會在背景中繼續進行,您可以繼續使用您的工作階段。該命令僅在您使用 `/code-review ultra` 叫用時執行;Claude 不會自動啟動 ultrareview。49啟動前,Claude Code 會顯示確認對話框,其中包含審查範圍(審查分支時包括檔案和行數)、您剩餘的免費執行次數和估計成本。確認後,審查會在背景中繼續進行,您可以繼續使用您的工作階段。該命令僅在您使用 `/code-review ultra` 叫用時執行;Claude 不會自動啟動 ultrareview。


95 97 

96如需在 GitHub 拉取請求上進行自動審查,[Code Review](/zh-TW/code-review) 直接與您的儲存庫整合,並將發現作為內嵌 PR 評論發佈,無需 CLI 步驟。98如需在 GitHub 拉取請求上進行自動審查,[Code Review](/zh-TW/code-review) 直接與您的儲存庫整合,並將發現作為內嵌 PR 評論發佈,無需 CLI 步驟。

97 99 

98<h2 id="how-ultrareview-compares-to-/review">100<h2 id="how-ultrareview-compares-to-/code-review-and-/review">

99 ultrareview 與 /review 的比較101 ultrareview 與 `/code-review` 和 `/review` 的比較

100</h2>102</h2>

101 103 

102兩個命令都審查程式碼,但它們針對工作流程的不同階段。104這三個命令都審查程式碼,但它們針對工作流程的不同階段。

103 105 

104| | `/review` | `/code-review ultra` |106| | `/code-review` | `/review <pr>` | `/code-review ultra` |

105| ---- | ------------ | -------------------------------- |107| ---- | -------------- | -------------------- | ------------------------------- |

106| 執行位置 | 在您的工作階段中本地執行 | 在雲端沙箱中遠端執行 |108| 目標 | 您的工作差異 | GitHub 拉取請求 | 您的工作差異或拉取請求 |

107| 深度 | 單次審查 | 具有獨立驗證的多代理程式艦隊 |109| 執行位置 | 在您的工作階段中本地執行 | 在您的工作階段中本地執行 | 在雲端沙箱中遠端執行 |

108| 持續時間 | 幾秒到幾分鐘 | 大約 5 10 分鐘 |110| 深度 | 隨著努力引數調整 | 中等 `/code-review` 引擎 | 具有獨立驗證的多代理程式艦隊 |

109| 成本 | 計入正常使用量 | 免費執行次數,然後大約 $5 $20 每次審查作為額外使用量 |111| 持續時間 | 幾秒到幾分鐘 | 幾分鐘 | 大約 5 10 分鐘 |

110| 最適合 | 迭代時的快速反饋 | 在實質性變更前合併時的信心 |112| 成本 | 計入正常使用量 | 計入正常使用量 | 免費執行次數,然後大約 $5 至 $20 每次審查作為使用額度 |

113| 最適合 | 迭代時的快速反饋 | 在批准前審查隊友的拉取請求 | 在實質性變更前合併時的信心 |

111 114 

112使用 `/review` 在工作時獲得快速反饋。在合併實質性變更前使用 `/code-review ultra`,當您想要更深入的審查以捕捉單次審查可能遺漏的問題時115使用 `/code-review` 在工作時獲得快速反饋。使用 `/review <pr>` 審查拉取請求,就像您在批准前會做的那樣。在合併實質性變更前使用 `/code-review ultra`,當您想要更深入的審查以捕捉本地審查可能遺漏的問題時

113 116 

114<h2 id="related-resources">117<h2 id="related-resources">

115 相關資源118 相關資源

Details

34 <span className="digest-feature-pill">v2.1.172</span>34 <span className="digest-feature-pill">v2.1.172</span>

35 </div>35 </div>

36 36 

37 <p className="digest-feature-lede">子代理程式現在可以產生自己的子代理程式。提示下方的子代理程式面板顯示完整的樹狀結構:每一列都會顯示其後代的計數以及返回 <code>main</code> 的路徑。背景子代理程式的深度上限為五層,以防止失控的並行樹狀結構;前景鏈可以在任何深度產生,並且是自我限制的。</p>37 <p className="digest-feature-lede">子代理程式現在可以產生自己的子代理程式。提示下方的子代理程式面板顯示完整的樹狀結構:每一列都會顯示其後代的計數以及返回 <code>main</code> 的路徑。子代理程式鏈的深度上限為五層,以防止失控的並行樹狀結構。</p>

38 38 

39 <p className="digest-feature-try">開啟代理程式檢視以觀看工作展開時的巢狀樹狀結構:</p>39 <p className="digest-feature-try">開啟代理程式檢視以觀看工作展開時的巢狀樹狀結構:</p>

40 40 

workflows.md +2 −1

Details

105進度檢視顯示每個階段及其代理計數、令牌總計和經過時間。頁腳列出每個動作的鍵:105進度檢視顯示每個階段及其代理計數、令牌總計和經過時間。頁腳列出每個動作的鍵:

106 106 

107| 鍵 | 動作 |107| 鍵 | 動作 |

108| :------------ | :------------------------------------------- |108| :------------ | :------------------------------------------------- |

109| `↑` / `↓` | 選擇階段或代理 |109| `↑` / `↓` | 選擇階段或代理 |

110| `Enter` 或 `→` | 深入選定的階段,然後進入代理以讀取其提示、最近的工具呼叫和結果 |110| `Enter` 或 `→` | 深入選定的階段,然後進入代理以讀取其提示、最近的工具呼叫和結果 |

111| `Esc` | 返回一個級別 |111| `Esc` | 返回一個級別 |

112| `j` / `k` | 當代理詳細資訊溢出時在其中捲動 |112| `j` / `k` | 當代理詳細資訊溢出時在其中捲動 |

113| `f` | {/* min-version: 2.1.186 */}按狀態篩選選定階段中的代理清單。再次按以循環 |

113| `p` | 暫停或恢復執行 |114| `p` | 暫停或恢復執行 |

114| `x` | 停止選定的代理,或當焦點在執行上時停止整個工作流程 |115| `x` | 停止選定的代理,或當焦點在執行上時停止整個工作流程 |

115| `r` | 重新啟動選定的執行中代理 |116| `r` | 重新啟動選定的執行中代理 |

Details

58當為 Claude for Enterprise 上的 Claude Code 組織啟用 ZDR 時,某些需要存儲提示或完成的功能會在後端級別自動禁用:58當為 Claude for Enterprise 上的 Claude Code 組織啟用 ZDR 時,某些需要存儲提示或完成的功能會在後端級別自動禁用:

59 59 

60| 功能 | 原因 |60| 功能 | 原因 |

61| --------------------------------------------------- | ------------------------ |61| --------------------------------------------------- | --------------------------------- |

62| [Web 上的 Claude Code](/zh-TW/claude-code-on-the-web) | 需要服務器端存儲對話歷史記錄。 |62| [Web 上的 Claude Code](/zh-TW/claude-code-on-the-web) | 需要服務器端存儲對話歷史記錄。 |

63| Desktop 應用程式的[雲端會話](/zh-TW/desktop#cloud-sessions) | 需要包含提示和完成的持久會話資料。 |63| Desktop 應用程式的[雲端會話](/zh-TW/desktop#cloud-sessions) | 需要包含提示和完成的持久會話資料。 |

64| [Artifacts](/zh-TW/artifacts) | 需要在 Anthropic 營運的基礎設施上存儲已發佈的頁面內容。 |

64| 反饋提交 (`/feedback`) | 提交反饋會將對話資料發送給 Anthropic。 |65| 反饋提交 (`/feedback`) | 提交反饋會將對話資料發送給 Anthropic。 |

65 66 

66這些功能在後端被阻止,無論客戶端顯示如何。如果您在啟動期間在 Claude Code 終端中看到禁用的功能,嘗試使用它會返回一個錯誤,指示組織的政策不允許該操作。67這些功能在後端被阻止,無論客戶端顯示如何。如果您在啟動期間在 Claude Code 終端中看到禁用的功能,嘗試使用它會返回一個錯誤,指示組織的政策不允許該操作。