Documentation 2026-05-09 04:57 UTC to 2026-05-10 23:03 UTC

24| `API Error: Repeated 529 Overloaded errors` | [Server errors](#api-error-repeated-529-overloaded-errors) |24| `API Error: Repeated 529 Overloaded errors` | [Server errors](#api-error-repeated-529-overloaded-errors) |

25| `Request timed out` | [Server errors](#request-timed-out)，或如果訊息提及您的網際網路連線，則為 [Network](#unable-to-connect-to-api) |25| `Request timed out` | [Server errors](#request-timed-out)，或如果訊息提及您的網際網路連線，則為 [Network](#unable-to-connect-to-api) |

26| `<model> is temporarily unavailable, so auto mode cannot determine the safety of...` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |26| `<model> is temporarily unavailable, so auto mode cannot determine the safety of...` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |

27| `Auto mode could not evaluate this action and is blocking it for safety` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |

28| `Auto mode classifier transcript exceeded context window` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |

27| `You've hit your session limit` / `You've hit your weekly limit` | [Usage limits](#youve-hit-your-session-limit) |29| `You've hit your session limit` / `You've hit your weekly limit` | [Usage limits](#youve-hit-your-session-limit) |

28| `Server is temporarily limiting requests` | [Usage limits](#server-is-temporarily-limiting-requests) |30| `Server is temporarily limiting requests` | [Usage limits](#server-is-temporarily-limiting-requests) |

29| `Request rejected (429)` | [Usage limits](#request-rejected-429) |31| `Request rejected (429)` | [Usage limits](#request-rejected-429) |

79 81 

80* 檢查 [status.claude.com](https://status.claude.com) 以了解活躍的事件82* 檢查 [status.claude.com](https://status.claude.com) 以了解活躍的事件

81* 等待一分鐘，然後再次傳送您的訊息。您的原始訊息仍在對話中，因此對於長提示，您可以輸入 `try again` 而不是貼上整個內容。83* 等待一分鐘，然後再次傳送您的訊息。您的原始訊息仍在對話中，因此對於長提示，您可以輸入 `try again` 而不是貼上整個內容。

82* 如果錯誤持續存在且沒有發佈的事件，請執行 `/feedback` 以便 Anthropic 可以使用您的請求詳細資訊進行調查。如果您的提供者上 `/feedback` 不可用，請參閱 [Report an error](#report-an-error)。84* 如果錯誤持續存在且沒有發佈的事件，請執行 `/feedback` 以便 Anthropic 可以使用您的請求詳細資訊進行調查。如果您的提供者上 `/feedback` 不可用，請參閱 [回報錯誤](#report-an-error)。

83 85 

84### API Error: Repeated 529 Overloaded errors86### API Error: Repeated 529 Overloaded errors

85 87 

116 118 

117### Auto mode cannot determine the safety of an action119### Auto mode cannot determine the safety of an action

118 120 

119[auto mode](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 用來分類動作的模型已過載，因此 auto mode 阻止了該動作而不是未經檢查地批准它。121用來 [auto mode](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 分類動作的模型無法產生決定，因此 auto mode 沒有自動批准該動作。您看到的訊息取決於分類器失敗的原因。

122 

123在您的工作目錄內的讀取、搜尋和編輯會跳過分類器，因此它們在所有這些情況下都能繼續工作。

124 

125當分類器模型過載時：

120 126 

121```text theme={null}127```text theme={null}

122<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.128<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.

123```129```

124 130 

125在您的工作目錄內的讀取、搜尋和編輯會跳過分類器，因此它們在中斷期間繼續工作。

126 

127**要做什麼：**131**要做什麼：**

128 132 

129* 幾秒鐘後重試；Claude 看到相同的訊息，通常會自動重試133* 幾秒鐘後重試；Claude 看到相同的訊息，通常會自動重試

130* 如果重試持續失敗，繼續進行唯讀任務，稍後再回到被阻止的動作134* 如果重試持續失敗，繼續進行唯讀任務，稍後再回到被阻止的動作

131* 這是暫時的，與 [auto mode eligibility](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 無關；您不需要更改設定135* 這是暫時的，與 [auto mode eligibility](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 無關；您不需要更改設定

132 136 

137當分類器傳回無法解析的回應時：

138 

139```text theme={null}

140Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details

141```

142 

143**要做什麼：**

144 

145* 重試該動作；這通常在下一次嘗試時成功

146* 執行 `claude --debug` 並重複該動作以在偵錯日誌中查看基礎分類器回應

147 

148當對話已增長到超過分類器的上下文視窗時：

149 

150```text theme={null}

151Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

152```

153 

154在互動式工作階段中，auto mode 會針對該動作回退到正常的權限提示，以便您可以手動批准或拒絕它。在 [非互動式模式](/zh-TW/headless) 中，執行會中止，因為文字記錄只會增長，重試無法成功。

155 

156**要做什麼：**

157 

158* 在出現的提示中批准或拒絕該動作

159* 執行 `/compact` 以減少對話大小，以便後續動作再次適應分類器視窗內

160 

133## 使用限制161## 使用限制

134 162 

135這些錯誤表示與您的帳戶或計畫相關的配額已達到。它們與影響所有人的 [server errors](#server-errors) 不同。163這些錯誤表示與您的帳戶或計畫相關的配額已達到。它們與影響所有人的 [server errors](#server-errors) 不同。

470| `ElicitationResult` | After a user responds to an MCP elicitation, before the response is sent back to the server |470| `ElicitationResult` | After a user responds to an MCP elicitation, before the response is sent back to the server |

471| `SessionEnd` | When a session terminates |471| `SessionEnd` | When a session terminates |

472 472 

473當多個 hooks 相符時，每個都傳回自己的結果。對於決策，Claude Code 選擇最具限制性的答案。傳回 `deny` 的 `PreToolUse` hook 會取消工具呼叫，無論其他的傳回什麼。一個 hook 傳回 `ask` 會強制權限提示，即使其餘的傳回 `allow`。來自 `additionalContext` 的文字會從每個 hook 保留並一起傳遞給 Claude。

474 

475每個 hook 都有一個 `type` 來決定它如何執行。大多數 hooks 使用 `"type": "command"`，它執行 shell 命令。還有四種其他類型可用：473每個 hook 都有一個 `type` 來決定它如何執行。大多數 hooks 使用 `"type": "command"`，它執行 shell 命令。還有四種其他類型可用：

476 474 

477* `"type": "http"`：POST 事件資料到 URL。請參閱 [HTTP hooks](#http-hooks)。475* `"type": "http"`：POST 事件資料到 URL。請參閱 [HTTP hooks](#http-hooks)。

479* `"type": "prompt"`：單輪 LLM 評估。請參閱[基於提示的 hooks](#prompt-based-hooks)。477* `"type": "prompt"`：單輪 LLM 評估。請參閱[基於提示的 hooks](#prompt-based-hooks)。

480* `"type": "agent"`：具有工具存取的多輪驗證。Agent hooks 是實驗性的，可能會改變。請參閱[基於 Agent 的 hooks](#agent-based-hooks)。478* `"type": "agent"`：具有工具存取的多輪驗證。Agent hooks 是實驗性的，可能會改變。請參閱[基於 Agent 的 hooks](#agent-based-hooks)。

481 479 

480### 合併來自多個 hooks 的結果

481 

482當多個 hooks 相符同一事件時，每個 hook 的命令都會執行到完成，然後 Claude Code 合併結果。一個 hook 傳回 `deny` 不會阻止同級 hooks 執行。不要依賴一個 hook 的 `deny` 來抑制另一個 hook 中的副作用。

483 

484所有匹配的 hooks 完成後，Claude Code 合併它們的輸出。對於 `PreToolUse` 權限決策，最具限制性的答案獲勝：`deny` 覆蓋 `ask`，`ask` 覆蓋 `allow`。來自 `additionalContext` 的文字會從每個 hook 保留並一起傳遞給 Claude。

485 

486下面的範例在 `Bash` 上註冊了兩個 `PreToolUse` hooks。第一個將每個命令附加到日誌檔案並退出 0。第二個執行一個指令碼，當命令包含 `rm -rf` 時退出 2 以拒絕：

487 

488```json theme={null}

489{

490 "hooks": {

491 "PreToolUse": [

492 {

493 "matcher": "Bash",

494 "hooks": [

495 {

496 "type": "command",

497 "command": "jq -r .tool_input.command >> ~/.claude/bash.log"

498 },

499 {

500 "type": "command",

501 "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-rm-rf.sh"

502 }

503 ]

504 }

505 ]

506 }

507}

508```

509 

510當 Claude 嘗試執行 `rm -rf /tmp/build` 時，兩個 hooks 並行執行。日誌記錄 hook 將命令寫入 `~/.claude/bash.log` 並退出 0，這表示沒有決策。防護欄 hook 退出 2，這拒絕了工具呼叫。拒絕獲勝，所以 Claude Code 阻止命令並向 Claude 顯示防護欄的 stderr。日誌項仍然被寫入，因為日誌記錄 hook 已經執行。

511 

482### 讀取輸入並傳回輸出512### 讀取輸入並傳回輸出

483 513 

484Hooks 透過 stdin、stdout、stderr 和退出代碼與 Claude Code 通訊。當事件觸發時，Claude Code 將事件特定的資料作為 JSON 傳遞到您的指令的 stdin。您的指令讀取該資料、執行其工作，並透過退出代碼告訴 Claude Code 接下來要做什麼。514Hooks 透過 stdin、stdout、stderr 和退出代碼與 Claude Code 通訊。當事件觸發時，Claude Code 將事件特定的資料作為 JSON 傳遞到您的指令的 stdin。您的指令讀取該資料、執行其工作，並透過退出代碼告訴 Claude Code 接下來要做什麼。

722| `.claude/settings.local.json` | 單個專案 | 否，gitignored |752| `.claude/settings.local.json` | 單個專案 | 否，gitignored |

723| 受管理的原則設定 | 組織範圍 | 是，由管理員控制 |753| 受管理的原則設定 | 組織範圍 | 是，由管理員控制 |

724| [Plugin](/zh-TW/plugins) `hooks/hooks.json` | 啟用外掛時 | 是，與外掛捆綁 |754| [Plugin](/zh-TW/plugins) `hooks/hooks.json` | 啟用外掛時 | 是，與外掛捆綁 |

725| [Skill](/zh-TW/skills) 或[Agent](/zh-TW/sub-agents) frontmatter | 當 skill 或 Agent 處於活動狀態時 | 是，在元件檔案中定義 |755| [Skill](/zh-TW/skills) 或[agent](/zh-TW/sub-agents) frontmatter | 當 skill 或 agent 處於活動狀態時 | 是，在元件檔案中定義 |

726 756 

727在 Claude Code 中執行 [`/hooks`](/zh-TW/hooks#the-hooks-menu) 以瀏覽按事件分組的所有配置的 hooks。若要一次禁用所有 hooks，請在設定檔中設定 `"disableAllHooks": true`。757在 Claude Code 中執行 [`/hooks`](/zh-TW/hooks#the-hooks-menu) 以瀏覽按事件分組的所有配置的 hooks。若要一次禁用所有 hooks，請在設定檔中設定 `"disableAllHooks": true`。

728 758 

206| `includeCoAuthoredBy` | **已棄用**：改用 `attribution`。是否在 git 提交和拉取請求中包含 `co-authored-by Claude` 署名（預設：`true`） | `false` |206| `includeCoAuthoredBy` | **已棄用**：改用 `attribution`。是否在 git 提交和拉取請求中包含 `co-authored-by Claude` 署名（預設：`true`） | `false` |

207| `includeGitInstructions` | 在 Claude 的系統提示中包含內建提交和 PR 工作流程指示和 git 狀態快照（預設：`true`）。設定為 `false` 以移除兩者，例如在使用您自己的 git 工作流程 skills 時。`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` 環境變數在設定時優先於此設定 | `false` |207| `includeGitInstructions` | 在 Claude 的系統提示中包含內建提交和 PR 工作流程指示和 git 狀態快照（預設：`true`）。設定為 `false` 以移除兩者，例如在使用您自己的 git 工作流程 skills 時。`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` 環境變數在設定時優先於此設定 | `false` |

208| `language` | 設定 Claude 的首選回應語言（例如 `"japanese"`、`"spanish"`、`"french"`）。Claude 預設會以此語言回應。也設定[語音聽寫](/zh-TW/voice-dictation#change-the-dictation-language)語言 | `"japanese"` |208| `language` | 設定 Claude 的首選回應語言（例如 `"japanese"`、`"spanish"`、`"french"`）。Claude 預設會以此語言回應。也設定[語音聽寫](/zh-TW/voice-dictation#change-the-dictation-language)語言 | `"japanese"` |

209| `maxSkillDescriptionChars` | {/* min-version: 2.1.105 */}[skill 清單](/zh-TW/skills#skill-descriptions-are-cut-short)中每個 skill 的字元上限，Claude 每輪看到的 `description` 和 `when_to_use` 文字的組合（預設：`1536`）。超過此長度的文字會被截斷。提高以保持長描述完整，代價是每輪更多內容；降低以在 [`skillListingBudgetFraction`](#available-settings) 下適應更多 skills。需要 Claude Code v2.1.105 或更新版本 | `2048` |

209| `minimumVersion` | 防止背景自動更新和 `claude update` 安裝低於此版本的版本。當從 `"latest"` 頻道切換到 `"stable"` 時透過 `/config` 提示您保持在目前版本或允許降級。選擇保持設定此值。也適用於[managed 設定](/zh-TW/permissions#managed-settings)以釘選組織範圍的最小值 | `"2.1.100"` |210| `minimumVersion` | 防止背景自動更新和 `claude update` 安裝低於此版本的版本。當從 `"latest"` 頻道切換到 `"stable"` 時透過 `/config` 提示您保持在目前版本或允許降級。選擇保持設定此值。也適用於[managed 設定](/zh-TW/permissions#managed-settings)以釘選組織範圍的最小值 | `"2.1.100"` |

210| `model` | 覆蓋 Claude Code 使用的預設模型。`--model` 和 [`ANTHROPIC_MODEL`](/zh-TW/model-config#environment-variables) 會覆蓋此設定以進行一個工作階段 | `"claude-sonnet-4-6"` |211| `model` | 覆蓋 Claude Code 使用的預設模型。`--model` 和 [`ANTHROPIC_MODEL`](/zh-TW/model-config#environment-variables) 會覆蓋此設定以進行一個工作階段 | `"claude-sonnet-4-6"` |

211| `modelOverrides` | 將 Anthropic 模型 ID 對應到提供者特定的模型 ID，例如 Bedrock 推論設定檔 ARN。每個模型選擇器項目在呼叫提供者 API 時使用其對應的值。請參閱[按版本覆蓋模型 ID](/zh-TW/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |212| `modelOverrides` | 將 Anthropic 模型 ID 對應到提供者特定的模型 ID，例如 Bedrock 推論設定檔 ARN。每個模型選擇器項目在呼叫提供者 API 時使用其對應的值。請參閱[按版本覆蓋模型 ID](/zh-TW/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |

223| `showClearContextOnPlanAccept` | 在計畫接受畫面上顯示「清除內容」選項。預設為 `false`。設定為 `true` 以還原選項 | `true` |224| `showClearContextOnPlanAccept` | 在計畫接受畫面上顯示「清除內容」選項。預設為 `false`。設定為 `true` 以還原選項 | `true` |

224| `showThinkingSummaries` | 在互動式工作階段中顯示[擴展思考](/zh-TW/model-config#extended-thinking)摘要。未設定或 `false`（互動模式中的預設值）時，思考區塊由 API 編輯並顯示為摺疊的存根。編輯只會改變您看到的內容，而不是模型生成的內容：若要減少思考支出，請[降低預算或停用思考](/zh-TW/model-config#extended-thinking)。非互動模式（`-p`）和 SDK 呼叫者無論此設定如何都始終接收摘要 | `true` |225| `showThinkingSummaries` | 在互動式工作階段中顯示[擴展思考](/zh-TW/model-config#extended-thinking)摘要。未設定或 `false`（互動模式中的預設值）時，思考區塊由 API 編輯並顯示為摺疊的存根。編輯只會改變您看到的內容，而不是模型生成的內容：若要減少思考支出，請[降低預算或停用思考](/zh-TW/model-config#extended-thinking)。非互動模式（`-p`）和 SDK 呼叫者無論此設定如何都始終接收摘要 | `true` |

225| `showTurnDuration` | 在回應後顯示輪次持續時間訊息，例如「Cooked for 1m 6s」。預設：`true`。在 `/config` 中顯示為**顯示輪次持續時間** | `false` |226| `showTurnDuration` | 在回應後顯示輪次持續時間訊息，例如「Cooked for 1m 6s」。預設：`true`。在 `/config` 中顯示為**顯示輪次持續時間** | `false` |

227| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}為 Claude 每輪看到的[skill 清單](/zh-TW/skills#skill-descriptions-are-cut-short)保留的模型內容視窗分數（預設：`0.01` = 1%）。當清單超過預算時，最少使用的 skills 的描述會摺疊為裸名稱，以便 Claude 仍可叫用它們，但不會看到原因。提高以保持更多描述可見，代價是每輪更多內容。`/doctor` 顯示目前的截斷計數和受影響的 skills。需要 Claude Code v2.1.105 或更新版本 | `0.02` |

226| `skillOverrides` | {/* min-version: 2.1.129 */}按 skill 名稱鍵入的每個 skill 可見性覆蓋。值為 `"on"`、`"name-only"`、`"user-invocable-only"` 或 `"off"`。讓您隱藏或摺疊 skill 而無需編輯其 SKILL.md。不適用於 plugin skills，這些由 `/plugin` 管理。`/skills` 功能表將這些寫入 `.claude/settings.local.json`。請參閱[從設定覆蓋 skill 可見性](/zh-TW/skills#override-skill-visibility-from-settings)。需要 Claude Code v2.1.129 或更新版本 | `{"legacy-context": "name-only", "deploy": "off"}` |228| `skillOverrides` | {/* min-version: 2.1.129 */}按 skill 名稱鍵入的每個 skill 可見性覆蓋。值為 `"on"`、`"name-only"`、`"user-invocable-only"` 或 `"off"`。讓您隱藏或摺疊 skill 而無需編輯其 SKILL.md。不適用於 plugin skills，這些由 `/plugin` 管理。`/skills` 功能表將這些寫入 `.claude/settings.local.json`。請參閱[從設定覆蓋 skill 可見性](/zh-TW/skills#override-skill-visibility-from-settings)。需要 Claude Code v2.1.129 或更新版本 | `{"legacy-context": "name-only", "deploy": "off"}` |

227| `skipWebFetchPreflight` | 跳過[WebFetch 網域安全檢查](/zh-TW/data-usage#webfetch-domain-safety-check)，該檢查在擷取前將每個請求的主機名稱傳送到 `api.anthropic.com`。在阻止流量到 Anthropic 的環境中設定為 `true`，例如 Bedrock、Vertex AI 或 Foundry 部署，具有限制性的出站。跳過時，WebFetch 嘗試任何 URL 而不諮詢黑名單 | `true` |229| `skipWebFetchPreflight` | 跳過[WebFetch 網域安全檢查](/zh-TW/data-usage#webfetch-domain-safety-check)，該檢查在擷取前將每個請求的主機名稱傳送到 `api.anthropic.com`。在阻止流量到 Anthropic 的環境中設定為 `true`，例如 Bedrock、Vertex AI 或 Foundry 部署，具有限制性的出站。跳過時，WebFetch 嘗試任何 URL 而不諮詢黑名單 | `true` |

228| `spinnerTipsEnabled` | 在 Claude 工作時在微調器中顯示提示。設定為 `false` 以停用提示（預設：`true`） | `false` |230| `spinnerTipsEnabled` | 在 Claude 工作時在微調器中顯示提示。設定為 `false` 以停用提示（預設：`true`） | `false` |

746 746 

747### Skill 描述被截斷747### Skill 描述被截斷

748 748 

749Skill 描述會載入上下文，以便 Claude 知道可用的內容。所有 skill 名稱始終包含在內，但如果您有許多 skills，描述會被縮短以適應字元預算，這可能會去除 Claude 需要匹配您的請求的關鍵字。預算在上下文視窗的 1% 處動態縮放，回退為 8,000 個字元。749Skill 描述會載入上下文，以便 Claude 知道可用的內容。所有 skill 名稱始終包含在內，但如果您有許多 skills，描述會被縮短以適應字元預算，這可能會去除 Claude 需要匹配您的請求的關鍵字。預算在模型上下文視窗的 1% 處動態縮放。當預算溢出時，您最少叫用的 skills 的描述會首先被捨棄，因此您實際使用的 skills 會保留其完整文字。執行 `/doctor` 以查看預算是否溢出以及哪些 skills 受到影響。

750 750 

751若要提高限制，請設定 `SLASH_COMMAND_TOOL_CHAR_BUDGET` 環境變數。若要為其他 skills 釋放預算，請在 [`skillOverrides`](#override-skill-visibility-from-settings) 中將低優先順序項目設定為 `"name-only"`，以便它們列出而不顯示描述。您也可以在來源處修剪 `description` 和 `when_to_use` 文字：前置關鍵使用案例，因為每個項目的結合文字無論預算如何都限制在 1,536 個字元。751若要提高預算，請設定 [`skillListingBudgetFraction`](/zh-TW/settings#available-settings) 設定（例如 `0.02` = 2%）或 `SLASH_COMMAND_TOOL_CHAR_BUDGET` 環境變數為固定字元計數。若要為其他 skills 釋放預算，請在 [`skillOverrides`](#override-skill-visibility-from-settings) 中將低優先順序項目設定為 `"name-only"`，以便它們列出而不顯示描述。您也可以在來源處修剪 `description` 和 `when_to_use` 文字：前置關鍵使用案例，因為每個項目的結合文字無論預算如何都限制在 1,536 個字元。此上限可透過 [`maxSkillDescriptionChars`](/zh-TW/settings#available-settings) 進行設定。

752 752 

753## 相關資源753## 相關資源

754 754