SpyBara
Go Premium

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

4 files changed +67 −7. View all changes and history on the product overview
2026
Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58

errors.md +31 −3

Details

24| `API Error: Repeated 529 Overloaded errors` | [服务器错误](#api-error-repeated-529-overloaded-errors) |24| `API Error: Repeated 529 Overloaded errors` | [服务器错误](#api-error-repeated-529-overloaded-errors) |

25| `Request timed out` | [服务器错误](#request-timed-out),或如果消息提到您的互联网连接,则为[网络](#unable-to-connect-to-api) |25| `Request timed out` | [服务器错误](#request-timed-out),或如果消息提到您的互联网连接,则为[网络](#unable-to-connect-to-api) |

26| `<model> is temporarily unavailable, so auto mode cannot determine the safety of...` | [服务器错误](#auto-mode-cannot-determine-the-safety-of-an-action) |26| `<model> is temporarily unavailable, so auto mode cannot determine the safety of...` | [服务器错误](#auto-mode-cannot-determine-the-safety-of-an-action) |

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

28| `Auto mode classifier transcript exceeded context window` | [服务器错误](#auto-mode-cannot-determine-the-safety-of-an-action) |

27| `You've hit your session limit` / `You've hit your weekly limit` | [使用限制](#youve-hit-your-session-limit) |29| `You've hit your session limit` / `You've hit your weekly limit` | [使用限制](#youve-hit-your-session-limit) |

28| `Server is temporarily limiting requests` | [使用限制](#server-is-temporarily-limiting-requests) |30| `Server is temporarily limiting requests` | [使用限制](#server-is-temporarily-limiting-requests) |

29| `Request rejected (429)` | [使用限制](#request-rejected-429) |31| `Request rejected (429)` | [使用限制](#request-rejected-429) |


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-CN/permission-modes#eliminate-prompts-with-auto-mode) 用来分类操作的模型已过载,因此 auto mode 阻止了该操作而不是无检查地批准它。121[auto mode](/zh-CN/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 资格](/zh-CN/permission-modes#eliminate-prompts-with-auto-mode)无关;您不需要更改设置135* 这是暂时的,与 [auto mode 资格](/zh-CN/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-CN/headless)中,运行会中止,因为记录只会增长,重试无法成功。

155 

156**要做什么:**

157 

158* 在出现的提示中批准或拒绝该操作

159* 运行 `/compact` 以减少对话大小,以便后续操作再次适应分类器窗口

160 

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

134 162 

135这些错误意味着与您的帐户或计划相关的配额已达到。它们与影响所有人的[服务器错误](#server-errors)不同。163这些错误意味着与您的帐户或计划相关的配额已达到。它们与影响所有人的[服务器错误](#server-errors)不同。

hooks-guide.md +32 −2

Details

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 会取消工具调用,无论其他的返回什么。一个返回 `ask` 的 hook 会强制权限提示,即使其余的返回 `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 是实验性的,可能会改变。请参阅 [基于代理的 hooks](#agent-based-hooks)。478* `"type": "agent"`:具有工具访问权限的多轮验证。Agent hooks 是实验性的,可能会改变。请参阅 [基于代理的 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 接下来要做什么。

settings.md +2 −0

Details

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-CN/voice-dictation#change-the-dictation-language)语言 | `"japanese"` |208| `language` | 配置 Claude 的首选响应语言(例如 `"japanese"`、`"spanish"`、`"french"`)。Claude 将默认以此语言响应。也设置[语音听写](/zh-CN/voice-dictation#change-the-dictation-language)语言 | `"japanese"` |

209| `maxSkillDescriptionChars` | {/* min-version: 2.1.105 */}[skill 列表](/zh-CN/skills#skill-descriptions-are-cut-short)中每个 skill 的 `description` 和 `when_to_use` 文本组合的字符上限(默认:`1536`)。超过此长度的文本被截断。提高以保持长描述完整,代价是每轮更多上下文;降低以在 [`skillListingBudgetFraction`](#available-settings) 下适应更多 skills。需要 Claude Code v2.1.105 或更高版本 | `2048` |

209| `minimumVersion` | 防止后台自动更新和 `claude update` 安装低于此版本的版本。从 `"latest"` 渠道切换到 `"stable"` 时通过 `/config` 提示您保持在当前版本或允许降级。选择保持设置此值。也在[managed 设置](/zh-CN/permissions#managed-settings)中有用,以固定组织范围的最低版本 | `"2.1.100"` |210| `minimumVersion` | 防止后台自动更新和 `claude update` 安装低于此版本的版本。从 `"latest"` 渠道切换到 `"stable"` 时通过 `/config` 提示您保持在当前版本或允许降级。选择保持设置此值。也在[managed 设置](/zh-CN/permissions#managed-settings)中有用,以固定组织范围的最低版本 | `"2.1.100"` |

210| `model` | 覆盖用于 Claude Code 的默认模型。`--model` 和 [`ANTHROPIC_MODEL`](/zh-CN/model-config#environment-variables) 覆盖此用于一个会话 | `"claude-sonnet-4-6"` |211| `model` | 覆盖用于 Claude Code 的默认模型。`--model` 和 [`ANTHROPIC_MODEL`](/zh-CN/model-config#environment-variables) 覆盖此用于一个会话 | `"claude-sonnet-4-6"` |

211| `modelOverrides` | 将 Anthropic 模型 ID 映射到特定于提供商的模型 ID,例如 Bedrock 推理配置文件 ARN。每个模型选择器条目在调用提供商 API 时使用其映射值。请参阅[按版本覆盖模型 ID](/zh-CN/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |212| `modelOverrides` | 将 Anthropic 模型 ID 映射到特定于提供商的模型 ID,例如 Bedrock 推理配置文件 ARN。每个模型选择器条目在调用提供商 API 时使用其映射值。请参阅[按版本覆盖模型 ID](/zh-CN/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |


223| `showClearContextOnPlanAccept` | 在 Plan Mode 接受屏幕上显示"清除上下文"选项。默认为 `false`。设置为 `true` 以恢复该选项 | `true` |224| `showClearContextOnPlanAccept` | 在 Plan Mode 接受屏幕上显示"清除上下文"选项。默认为 `false`。设置为 `true` 以恢复该选项 | `true` |

224| `showThinkingSummaries` | 在交互式会话中显示[扩展思考](/zh-CN/model-config#extended-thinking)摘要。未设置或 `false`(交互模式中的默认值)时,思考块由 API 编辑并显示为折叠的存根。编辑仅改变您看到的内容,而不是模型生成的内容:要减少思考支出,[降低预算或禁用思考](/zh-CN/model-config#extended-thinking)。非交互模式(`-p`)和 SDK 调用者无论此设置如何都始终接收摘要 | `true` |225| `showThinkingSummaries` | 在交互式会话中显示[扩展思考](/zh-CN/model-config#extended-thinking)摘要。未设置或 `false`(交互模式中的默认值)时,思考块由 API 编辑并显示为折叠的存根。编辑仅改变您看到的内容,而不是模型生成的内容:要减少思考支出,[降低预算或禁用思考](/zh-CN/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 */}为[skill 列表](/zh-CN/skills#skill-descriptions-are-cut-short)预留的模型上下文窗口的分数,Claude 每轮看到(默认:`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。不适用于插件 skills,这些通过 `/plugin` 管理。`/skills` 菜单将这些写入 `.claude/settings.local.json`。请参阅[从设置覆盖 skill 可见性](/zh-CN/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。不适用于插件 skills,这些通过 `/plugin` 管理。`/skills` 菜单将这些写入 `.claude/settings.local.json`。请参阅[从设置覆盖 skill 可见性](/zh-CN/skills#override-skill-visibility-from-settings)。需要 Claude Code v2.1.129 或更高版本 | `{"legacy-context": "name-only", "deploy": "off"}` |

227| `skipWebFetchPreflight` | 跳过[WebFetch 域安全检查](/zh-CN/data-usage#webfetch-domain-safety-check),该检查在获取前将每个请求的主机名发送到 `api.anthropic.com`。在阻止到 Anthropic 的流量的环境中设置为 `true`,例如 Bedrock、Vertex AI 或 Foundry 部署,具有限制性出站。跳过时,WebFetch 尝试任何 URL 而不咨询阻止列表 | `true` |229| `skipWebFetchPreflight` | 跳过[WebFetch 域安全检查](/zh-CN/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` |

skills.md +2 −2

Details

744 744 

745### Skill 描述被截断745### Skill 描述被截断

746 746 

747Skill 描述被加载到上下文中,以便 Claude 知道什么可用。所有 skill 名称始终包括,但如果你有许多 skills,描述会被缩短以适应字符预算,这可能会删除 Claude 需要匹配你的请求的关键字。预算在上下文窗口的 1% 处动态扩展,回退为 8,000 个字符。747Skill 描述被加载到上下文中,以便 Claude 知道什么可用。所有 skill 名称始终包括,但如果你有许多 skills,描述会被缩短以适应字符预算,这可能会删除 Claude 需要匹配你的请求的关键字。预算按模型上下文窗口的 1% 进行扩展。当预算溢出时,你调用最少的 skills 的描述会首先被删除,因此你实际使用的 skills 会保留其完整文本。运行 `/doctor` 以查看预算是否溢出以及哪些 skills 受到影响。

748 748 

749要提高限制,设置 `SLASH_COMMAND_TOOL_CHAR_BUDGET` 环境变量。要为其他 skills 释放预算,在 [`skillOverrides`](#override-skill-visibility-from-settings) 中将低优先级条目设置为 `"name-only"`,以便它们列出而不显示描述。你也可以在源处修剪 `description` 和 `when_to_use` 文本:前置关键用例,因为每个条目的组合文本被限制为 1,536 个字符,无论预算如何。749要提高预算,设置 [`skillListingBudgetFraction`](/zh-CN/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-CN/settings#available-settings) 进行配置。

750 750 

751## 相关资源751## 相关资源

752 752