---
title: "Claude Code auto mode 默认开启：2026 年 10 月怎么查模式、怎么关、命令被拦怎么排查"
description: "新版 Claude Code 在终端和 VS Code 里默认进入 auto mode，由分类器代替你审批命令。本文给出查看当前模式、固定为手动模式的配置，以及命令被拦、显示 Not run 时的排查清单。"
url: https://cdnping.org/blog/claude-code-auto-mode-default
language: zh-CN
published: 2026-10-19
category: "开发工具"
tags: ["Claude Code","auto mode","权限模式","分类器","开发工具"]
source: cdnping.org
license: Free to quote and summarize with a link to the url above.
---
# Claude Code auto mode 默认开启：2026 年 10 月怎么查模式、怎么关、命令被拦怎么排查

截至 2026 年 10 月，Claude Code 2.1.283 及以上版本在终端和 VS Code 里没有指定权限模式时，会直接进入 auto mode（自动模式）：命令不再逐条问你，而是由另一个模型，也就是分类器，决定放行还是拦截。想回到逐条确认，把 `permissions.defaultMode` 设为 `default` 即可；想退出服务端分类器，设 `CLAUDE_CODE_AUTO_MODE_SERVER=0`。本文按 10 月 16 日发布的 2.1.302 为准，下面的内容都来自 Anthropic 官方文档与更新日志，版本号以你本机 `claude --version` 为准。

## auto mode 默认开启到底改了什么？

官方[权限模式文档](https://code.claude.com/docs/en/permission-modes)的说法是：2.1.283 起，auto mode 是交互式终端和 VS Code 会话的内置起始模式；更早的版本只在 Pro、Max、Team 套餐且能拉取功能开关的会话里如此。

几个容易混淆的点：

- 在 auto mode 下，分类器会审阅那些原本需要你确认的动作；读取等低风险操作不经过它。
- 不同入口的默认值不同。`claude -p` 和 Agent SDK 在能拉取功能开关的会话里默认是 `default`；2.1.302 的更新日志又写明，在第三方提供方、关闭遥测或全新安装时，没配置权限模式的 `claude -p` 与 SDK 会话也以 `default` 起步，显式传 `--permission-mode auto` 仍然是 auto。
- 如果你的 `~/.claude/settings.json` 里本来就写了非 auto 的 `defaultMode`，会话会继续按它启动。
- auto mode 有使用条件（支持的模型、管理员未禁用、服务端未关闭等）。不满足时 Claude Code 会提示 auto mode 不可用，该会话保持关闭，新开会话后再试；详见官方文档。

## 服务端分类器是什么，怎么退出？

分类器有两种来源：Claude Code 自己发请求的客户端分类器，和随会话请求一起由服务端完成审阅的服务端分类器。文档写明，直连 Anthropic API 时，`-p`、SDK、VS Code、桌面端需要 2.1.281 及以上；从 2.1.282 起，不拉取功能开关的会话（例如关了遥测）默认就走服务端审阅。

想固定使用客户端分类器：

```bash
export CLAUDE_CODE_AUTO_MODE_SERVER=0
```

2.1.302 新增了 `CLAUDE_CODE_AUTO_MODE_MODEL`，用来指定客户端分类器所用的模型，不影响服务端分类器。具体取值格式以[环境变量文档](https://code.claude.com/docs/en/env-vars)为准。

## 怎么确认当前模式，又怎么固定成手动模式？

按 `Shift+Tab` 可以在会话里循环切换模式，界面上会显示当前模式。手动模式在界面里叫 Manual，配置值是 `default`。

要让本机所有终端会话都以手动模式启动，写入 `~/.claude/settings.json`：

```json
{
  "permissions": {
    "defaultMode": "default"
  }
}
```

只想改一次会话，用 `claude --permission-mode default`。命令行参数优先于设置文件里的 `defaultMode`，最后才是内置默认值。

有两个坑：

- 把 `"auto"` 写进项目里的 `.claude/settings.json` 或 `.claude/settings.local.json` 不会生效，要写在 `~/.claude/settings.json`。
- 团队想彻底禁用，需管理员在托管设置里把 `permissions.disableAutoMode` 设为 `"disable"`。

## 命令被拦或显示 “Not run”，怎么定位？

先分清是谁拦的。可以按下面的清单逐项看：

| 现象 | 可能原因 | 做法 |
| --- | --- | --- |
| 灰色 “Not run” | 2.1.296 起，分类器没有给出可用结论的调用显示为灰色，而不是红色错误 | 重试；反复出现时看下一行 |
| 提示服务端没有返回安全结论 | 经过网关或代理时审阅结果被丢弃或改写，或服务端检查超时 | 查看官方[错误说明](https://code.claude.com/docs/en/errors#the-server-returned-no-safety-verdict)；在网关环境可试 `CLAUDE_CODE_AUTO_MODE_SERVER=0` |
| 对话很长后全部被拒 | 上下文太长，分类器无法审阅 | 升级到 2.1.302，新版会先压缩再审阅 |
| 常规操作总被拦 | 目标仓库、服务不在信任范围 | 参考[配置 auto mode](https://code.claude.com/docs/en/auto-mode-config)，在 `autoMode.environment` 里声明可信基础设施 |
| 说不清是规则还是分类器 | 两者都可能拦 | 开启 OpenTelemetry，看 `tool_decision` 事件 |

2.1.301 起，`tool_decision` 事件带有 `classifier_verdict` 和 `permission_mode`，能区分是分类器还是权限规则的决定；设置 `OTEL_LOG_TOOL_DETAILS=1` 后还有 `classifier_category`，标出命中的内置规则。2.1.302 修复了该字段在多数分类器拦截里缺失的问题。

另外，运行 `claude auto-mode defaults` 可以打印内置规则的完整 JSON，便于对照。

## 升级后连不上或变慢，是 auto mode 的问题吗？

不一定。分类器只影响权限决定，网络超时、529、额度问题是另一类。可以先看 [cdnping 的 Anthropic 状态页](/status/anthropic)和 [Claude Code 可用性](/down/claude-code)，再按 [Claude Code 连接超时排查清单](/blog/claude-code-connection-troubleshooting)分层检查。遇到 529 可参考[新版重试与空闲压缩的配置](/blog/claude-code-529-overloaded-retry-idle-compaction)；10 月上旬的异常可对照[9 月 29 日故障和 10 月 7 日支出上限误判](/blog/claude-code-outage-sep29-spend-limit-oct7)。如果你通过自定义接口地址使用 Claude Code，请看[自定义 API 配置](/blog/configure-custom-api-endpoint-claude-code-codex)，第三方提供方上的默认模式与直连不同，以官方文档为准。想了解 Agent 在沙箱里跑命令的另一条思路，可看[Copilot 本地沙箱](/blog/github-copilot-local-sandboxing-ga)。Anthropic 的更新记录也可在 [cdnping 官网动态](/changes)里查看。

## 该关掉 auto mode 吗？

看场景。auto mode 的意义是少打断，代价是把审批交给模型。处理敏感仓库、生产环境凭据或不熟悉的代码时，用 Manual 更稳；日常在本地项目里迭代，保留 auto 并配好可信范围通常够用。无论哪种，都建议先在不重要的目录里试一遍被拦的情形，再决定。

## 参考来源

- [Claude Code 更新日志（2.1.296、2.1.301、2.1.302 等）](https://code.claude.com/docs/en/changelog)
- [Choose a permission mode](https://code.claude.com/docs/en/permission-modes)
- [Configure auto mode](https://code.claude.com/docs/en/auto-mode-config)
- [Environment variables](https://code.claude.com/docs/en/env-vars)