它到底是什么

claude auto-mode reset 是 claude auto-mode 子命令组的一部分，用来丢弃你对 auto mode 分类器（classifier）的自定义配置，回到内置默认值。官方 CLI reference 的描述是：通过删除用户设置文件中的 autoMode 段来恢复默认的 auto mode 配置。

• 同组的其他子命令：claude auto-mode defaults（以 JSON 打印内置规则）、claude auto-mode config（打印应用你的设置后的生效配置）、claude auto-mode critique（让模型审阅你自定义的 allow / soft_deny / hard_deny 规则）。
• 版本要求：Claude Code v2.1.212 或更高（官方文档明确标注）。
• Auto mode 本身是让 Claude Code 通过分类器审查工具调用、而不是逐次弹出权限提示的权限模式。autoMode 设置块用于告诉分类器你信任哪些仓库、bucket 和域名，也可以覆盖默认的 block / allow 规则。

用法 / 语法

claude auto-mode reset
claude auto-mode reset --yes

不带 --yes 时，命令会先汇总将要删除的内容，再询问 Reset auto mode configuration to defaults?，确认后才写入文件。

Shell 集成 / 自动化

官方示例就是带 --yes 的形式，适合脚本或初始化流程中免交互执行：

claude auto-mode reset --yes

重置后可以用 claude auto-mode config 核对生效配置：

claude auto-mode reset --yes && claude auto-mode config

与会话内命令的关系

在 auto mode 配置文档中未见同名的会话内 slash 命令。会话内与 autoMode 配置相关的入口有两个，它们和 reset 是不同的功能：

这两个入口写入的目标文件和 reset 修改的是同一个，所以 reset 会一并清除它们写入的 autoMode 内容。

运行约束 / 限制

经典使用场景

官方文档对该命令用途的描述只有「丢弃自定义配置、回到内置默认值」。以下场景是据此推断的，文档并未把 reset 明确列为这些情况的修复办法：

• 自定义规则改坏了：比如 soft_deny 等数组漏写 "$defaults"，导致内置规则被整段替换。reset 可以整体回到内置默认值。
• 想从头重新配置：先 reset，再运行 /auto-mode-setup 或手写 autoMode.environment，最后用 claude auto-mode config 确认生效结果。

常见坑

• 重置后并不一定回到"纯默认":managed settings 和 --settings 里的 autoMode 规则依然叠加生效。如果 claude auto-mode config 的输出和 defaults 不一致，先检查这两处。
• 删除的是整个 autoMode 段：官方描述是"removes the autoMode section"，因此该段内的所有键（如 environment、allow、soft_deny、hard_deny、classifyAllShell）都会一起消失，不是只清某一项。
• 文档未提及备份或撤销机制：如果你的自定义规则有价值，先自行复制 ~/.claude/settings.json 中的 autoMode 块。
• 它不会关闭 auto mode:reset 处理的只是分类器的规则配置。权限模式本身的切换属于另一套机制，见 Permission modes 文档。

来源

• CLI reference - Claude Code Docs
• Configure auto mode - Claude Code Docs
• Choose a permission mode - Claude Code Docs