全站待核实清单

约 8 分钟难度：新手理解章

三类不确定，可信度不同

分类比条目本身更重要，因为它决定了你该怎么对待这个不确定：

类型	含义	你该怎么办
文档未覆盖	官方文档没写，本站不猜	需要的话自己实测，或者等官方补
需要实测	文档有描述但不够具体，或者行为可能因环境而异	在你自己的环境里验证一次
版本差异	已知在某些版本上不同，但没跟踪完整	先确认自己的版本

文档未覆盖

这些是官方文档确实没有说明的地方。本站选择留白而不是推测。

配置与设置

~/.claude.json 的完整字段结构。只核实到官方 settings 文档 Global config settings 一节列出的几个 key。
配置文件自动备份的命名和位置。文档提到会保留最近五份带时间戳的备份，细节未见说明。
--max-budget-usd 的计价基准。是否和 /usage 一样按标准列表价本地计算，未见说明。

hooks

HTTP 类型 hook 的完整配置字段。文档主要在讲它的限制机制（allowedHttpHookUrls、httpHookAllowedEnvVars），配置项本身没有逐条列出。
各事件 stdin 输入 JSON 的完整字段。公共字段确认了，各事件特有字段没有逐个核实。
同一 matcher 组内多个 hook 并行返回冲突的 permissionDecision 时，最终采用哪个。
ConfigChange 事件的输入字段，以及一次批量配置改动触发几次。

权限模式

auto mode 的账户与订阅层级要求。文档提到有要求，具体哪些层级可用没有核实清楚。
分类器与 sandbox 的具体交互。两者都在限制命令行为，谁先生效、判断如何叠加。
soft_deny 触发时的确认界面与 default 模式的权限提示是否相同。

MCP

WaitForMcpServers 工具的具体行为。
channels 机制（服务器主动推消息进会话）的完整配置流程。
自动后台化的边界情况。主对话里超过两分钟的 MCP 调用转为后台任务，但 subagent 调用、IDE 服务器调用不会——这些例外的完整规则。
managed MCP 配置（managed-mcp.json、allowedMcpServers）的部署细节。

CLAUDE.md 与 skills

claudeMdExcludes 对嵌套 rules 目录的匹配细节。「排除一个目录」和「排除目录下的具体文件」行为上是否有区别。
压缩后 CLAUDE.md 重新注入的具体时机：紧接压缩之后，还是下一轮请求时。
skill 的 hooks frontmatter 字段完整配置格式（文档指向另一页，本站未核实）。
skill 的 paths frontmatter 与 .claude/rules/ 的 paths 触发时机是否完全一致。
压缩后重新附加 skill 时「前 5000 token」的截断边界：按 token 硬切还是按段落边界。
effort 各档位在不同模型上的可用性对应表。

subagent

initialPrompt 字段与用户提供的提示词如何拼接。
isolation: worktree 的清理条件中「有改动」的判定标准。
兄弟名册（sibling roster）内容的更新时机，只知道是启动时快照。
并发限额下「恢复已完成 subagent 不检查限额」是否有其他兜底。

headless

--output-format json 返回结构的完整字段（在 Agent SDK 文档里）。
stream-json 各事件类型的完整定义。
claude -p 本身在各类失败下的退出码。只确认了 claude auth status 和 claude ultrareview 两个子命令。

成本

OpenTelemetry 导出的具体指标名与配置（在 monitoring 页）。
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 的确切作用范围。官方 costs 页没有列出这个变量。
prompt caching 里「什么样的上下文变化会导致缓存失效」。

需要实测

文档有描述，但结论的可靠性取决于你的环境。

分类器判断的确定性。同一条命令在同一配置下是否总得到相同结论，文档未说明。这直接影响「能不能靠 auto mode 做确定性防护」这个判断——本站的立场是不能，硬边界要用 permissions.deny。
自动记忆的写入判定。Claude 根据「这条信息未来是否有用」决定要不要存，这个过程不可观测。
/doctor 精简建议的判定规则。文档描述了它保留什么删什么，没有可预测的规则。
「agent team 约为标准会话 7 倍」的测量条件。文档说的是 teammate 在 plan 模式下运行时，其他模式的倍数未给出。
skill 描述被截断后的实际影响。预算按上下文窗口 1% 缩放，但「截断多少会导致匹配失败」需要在自己的 skill 集合上测。

版本差异（已知但未跟踪完整）

这些行为在不同版本上不同，本站记录了已知的变化点，但不保证完整。遇到与本站描述不符时，先确认版本。

主题	已知变化
settings key 归属	v2.1.119 之前一批 `/config` 偏好项存在 `~/.claude.json` 而非 `settings.json`。更早的版本未跟踪
`settings.local.json` 位置	v2.1.211 起在 git 仓库根读写，之前在启动目录
Windows managed 路径	v2.1.75 起不再读 `C:\ProgramData\ClaudeCode\`
`defaultMode: auto` 来源限制	v2.1.142 起忽略项目层和 local 层
`autoMode` 来源限制	v2.1.207 之前 `.claude/settings.local.json` 也在读取范围内
MCP 缺 `type` 报错措辞	v2.1.202 变过
skill 重复调用	v2.1.202 之前每次重新调用都追加一份完整副本
`${CLAUDE_SKILL_DIR}` 在 allow 规则里替换	需要 v2.1.129+
skill 布尔字段取值	v2.1.218 之前只认 `true` / `false`
Explore 的模型	v2.1.198 之前固定 Haiku，之后继承主对话
subagent 嵌套深度默认值	v2.1.172–216 是 5 且不可改；v2.1.217–218 是 1；v2.1.219 起是 3
subagent `tools` 全部解析失败	v2.1.208 之前会带零工具启动而不是拒绝
subagent frontmatter hook 信任要求	v2.1.218 之前可从未信任文件夹运行
subagent 输出扫描	需要 v2.1.210+
rules 无效 glob 的影响	v2.1.207 之前会让该规则求值过的每个文件读取都失败
`/usage` 总数是否跨 `/clear` 累积	v2.1.211 起归零，之前累积到进程结束
`--json-schema` 无效 schema	v2.1.205 之前静默产出非结构化输出
`--max-turns` 与排队消息	v2.1.205 之前那条消息被丢弃
`--permission-prompt-tool` 慢启动服务器	v2.1.206 之前会以「MCP 工具未找到」退出
`daemon` 子命令路由	v2.1.199 之前带前置 `--dangerously-skip-permissions` 时不执行
`/doctor` 精简检查	需要 v2.1.206+
`manual` 作为 `default` 别名	需要 v2.1.200+
`classifyAllShell`	需要 v2.1.193+
`claude mcp login` / `logout`	需要 v2.1.186+
保留 MCP 服务器名与 `name` 里的 `:`	v2.1.218 之前被接受
`--append-subagent-system-prompt`	需要 v2.1.205+
`--forward-subagent-text`	需要 v2.1.211+
`auto-mode defaults` / `reset` 命令	分别需要 v2.1.208+ / v2.1.212+
`--max-budget-usd` 上限强制	需要 v2.1.217+
fork 命令名	v2.1.212 起是 `/subtask`；v2.1.161–211 是 `/fork`。现在的 `/fork` 语义不同

本站的核实方式

写清楚这一点，是为了让你能判断本站结论的可靠程度：

主要来源是官方文档。每章末尾的「参考」列出了具体页面。
不推测。文档没写的就写进「还没确认的点」，不用「应该是」「大概」填空。
版本敏感的行为标注版本号。因为 Claude Code 的迭代速度让「当前行为」这个说法很快过期。
过期内容不删。发现某个结论错了或者失效了，在原位加更新说明，保留原文——因为搜到旧报错的人需要知道「这个说法曾经是对的，现在变了」。

发现本站的错误，提 issue 或直接在页面底部点编辑。带上你的版本号会让修正快很多。

这一节有错或讲不清？提个 Issue 直接改文档请作者催更