排查 Claude Code 自动模式的两类故障
文章区分自动模式在当前会话中不可用,以及模式已启用但安全分类器无法给出判断或拦截操作。排查清单按症状指向启用条件、配置作用域、分类器请求和 Bedrock 模型访问权限。
AI 深度解读
Claude Code 的 Auto 模式有两种容易混淆的故障。一种是按 Shift+Tab 找不到 Auto,会话从一开始就没有运行权限分类器。另一种是状态栏已经显示 ⏵⏵ auto mode on,但某条命令被拒绝,或者会话突然恢复逐条询问。
作者按这两条线整理了排查方法。对经常让 Claude Code 跑脚本、改文件的开发者,最实用的是先判断故障在哪一层,再决定该查模型和配置、查网关,还是给发布命令保留人工确认。
按 Shift+Tab 找不到 Auto,先查会话有没有资格开启
Auto 把权限判断交给分类器,减少每次执行命令前的确认。作者在 2026-11-06 核对的文档显示,Team 和 Enterprise 默认开放 Auto,但管理员可在托管配置里将 permissions.disableAutoMode 设为 "disable"。这会把 Auto 移出模式轮换,即使传了 claude --permission-mode auto,会话也会从 Manual 启动。Anthropic 服务端也可能关闭该功能或拒绝当前账号,被拒的会话会一直保持关闭,之后要开新会话再试。
模型支持要连供应商一起看。Anthropic API 和 Claude Platform on AWS 支持 Claude Opus 4.6 及以上、Sonnet 4.6 及以上、Haiku 5.5 或 Fable。Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 和通过已登录 Claude 应用网关接入的会话,要求 Sonnet 5 及以上、Opus 4.7 及以上、Haiku 5.5 或 Fable。Sonnet 4.5 在这些供应商上都无法使用 Auto。
原文给了两个容易混在一起的版本边界。自 v2.1.283 起,交互式终端和 VS Code 会话内置从 Auto 启动。按 v2.1.302 的行为,claude -p 和 Agent SDK 仍从 Manual 启动,对应配置值 default。非交互任务可以显式传 --permission-mode auto 启用分类器,也可以用 --allowedTools 提供允许列表。
下面这份用户配置把交互会话的起始模式设为 Auto,同时让推送代码和创建 PR 继续弹出确认。
{
"permissions": {
"defaultMode": "auto",
"ask": [
"Bash(git push *)",
"Bash(gh pr create *)"
]
}
}
关注 "defaultMode": "auto" 所在的文件。它要放在 ~/.claude/settings.json,写进项目的 .claude/settings.json 或 .claude/settings.local.json 会失效,bypassPermissions 也有这个限制。项目配置仍可选 Manual、acceptEdits 或 plan。示例中按命令内容匹配的 ask 规则,在 Auto 下也会弹出确认。
Auto 已经开启,报错决定下一步该查哪里
看到 cannot determine the safety,先看报错有没有点名分类器模型。限流、过载、超时或连接失败可以先重试,读取和工作目录内的编辑仍可继续。Amazon Bedrock 上每次重试都报同一个模型不可用,则要查账号有没有调用它的权限。如果提示分类器响应无法解析,反复发生时用 claude --debug 看细节。
另一些失败与会话内容有关。之前的对话触发独立安全检查时,在原会话重试会得到同样的结果,这类拒绝也不计入 Auto 暂停阈值。可以切换权限模式,人工审核并批准该操作,或者开新会话。对话过长又是另一种情况,交互会话会回退到普通权限确认,可以用 /compact 压缩上下文。缺少提示工具的非交互 -p 任务会跳过该操作,继续往下跑。
no safety verdict 指服务端审查没有返回判定,客户端会拒绝该动作,连续收到 10 次无判定响应就会结束当前轮次。 如果经过 LLM 网关,查它有没有截断流、剥掉请求头、丢弃 safeguards 字段或改写响应。网关无法完整透传时,可用 CLAUDE_CODE_AUTO_MODE_SERVER=0 让客户端改走自己的分类器请求,也可把变量放进配置的 env。直连 Anthropic API 时,该变量要求 Claude Code v2.1.281 或以上。在运行中的 Auto 会话里,可用 /status 查看 Auto mode server 是 Enabled 还是 Disabled。
计费提示也和这条链路有关。服务端审查随会话的模型请求完成,原文称这部分不额外收费。审查结果没到会话时,客户端会发起自己的分类器请求,可计费账号可能因此看到会话不符合免费条件的提示。按 Enter 会继续执行,分类请求沿用原计费方式,按 Esc 则取消当前挂起的动作。按作者核对的文档,Pro、Max、Ultra 和 Team 不会看到这条提示。
同一类内部操作反复被拦,先核对分类器看到了什么
分类器连续拦截 3 次,或在同一会话累计拦截 20 次,Auto 就会暂停并恢复人工确认。批准弹窗里的操作后,Auto 会继续运行,这两个阈值无法调整。对于已经拿到分类判定的拦截,可打开 /permissions 的 Recently blocked,读完命令后按 r 批准重试。这个批准只管当前一次。需要长期处理的命令模式可配 autoMode.allow,缺失的内部环境信息则补到 autoMode.environment。
按原文,分类器默认信任工作目录和会话启动时已经配置的远端。团队仓库、内部域名或制品服务可以写进用户或托管配置的 autoMode.environment,项目级配置里的 autoMode 会被忽略。编辑数组时保留 "$defaults",否则会整段替换内置条目。也可以用 /auto-mode-setup 生成草案,审核后再接受,最后用 claude auto-mode config 查看实际生效的配置。
作者在 2026-11-06 用 Claude Code 2.1.197 实际跑了 claude auto-mode defaults 和 claude auto-mode config。在没有自定义配置的机器上,两条命令都返回了含 environment、allow、soft_deny、hard_deny 的 JSON,内置条目分别为 9、16、55 和 1。实测到此为止,作者没有启动交互式 Auto 会话,也没有调用模型做实时分类。
我的判断
先查 Auto 能不能启动,再查某次动作为什么被拦,是这篇排障指南最有价值的部分。同样是恢复人工确认,账号或模型不支持、分类器累计拦截达到阈值、上下文太长,对应的处理完全不同。尤其在 CI 里,任务继续跑完也可能有某一步被跳过,判断结果要回到那一步预期产生的文件、日志或退出状态。
作者测的是 2.1.197 的配置输出。涉及 v2.1.281、v2.1.283、v2.1.302 的行为来自文档,实测里的条目数量也只能当作那次输出的快照。原文没有对照数据说明补齐内部仓库和域名能减少多少误拦,把网关改写或环境信息缺失列为常见原因属于排障经验。遇到自家网关,先用 /status 和具体报错缩小范围。
如果日常最烦的是改文件也要确认,acceptEdits 就值得先考虑。希望减少 Bash 提示时,原文还给了 Manual 配合 /sandbox 的 auto-allow。固定的 CI 流程可以用 --permission-mode dontAsk 搭配明确的 --allowedTools。原文把 --dangerously-skip-permissions 留给以非 root 用户运行的隔离容器或虚拟机。Auto 更适合长任务里操作种类较多的情形,而推送和发布这种明确的人工审批点,用 permissions.ask 比写在对话里更可靠,也少受上下文压缩影响。
能拿来做什么
- 给前端仓库跑长任务前,先按
Shift+Tab确认 Auto 是否可选。能选却总从 Manual 启动时,查~/.claude/settings.json里的permissions.defaultMode。完全找不到入口时,再核对模型、供应商和组织策略。 - 让 Claude Code 自动改代码和跑测试时,把
git push、gh pr create和团队实际用的发布命令写进permissions.ask,把确认留在有外部影响的步骤。 - 内部仓库或制品服务反复被拦时,先从
/permissions核对具体动作和目的地,再把确认可信的条目补进autoMode.environment,保留"$defaults"并检查实际生效的配置。 - 在 Node 项目的 CI 中用
claude -p时,显式选择权限模式,并检查关键产物是否生成。固定流程可用--permission-mode dontAsk配合--allowedTools,让允许运行的工具直接体现在命令里。