SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

Claude Code自动模式默认设置与权限模式详解

Claude Code v2.1.283起,终端和VS Code会话默认使用auto。了解六种权限模式、VPS无人值守运行的风险,以及defaultMode设置是否会被覆盖。

2026年8月14日自动模式的变化

Claude Code 自动模式会在无需例行权限提示的情况下运行工具调用,并使用单独的分类器模型审核操作。在受保护路径之外执行读取和工作目录编辑时,不会经过分类器审核。自 2026年8月14日 起,Pro、Max 和 Team 计划的新会话默认以自动模式启动。截至 2026年10月27日,文档进一步说明:使用 Claude Code v2.1.283 或更高版本时,自动模式是所有计划和服务提供商的交互式终端及 VS Code 会话的内置初始模式。您可以随时切换模式,已经为自己设置的默认模式不会被覆盖。

文档目前这样说明这一变化:

使用 Claude Code v2.1.283 或更高版本时,自动模式是交互式终端及 VS Code 会话的内置初始权限模式。在更早版本中,它仅是 Pro、Max、Ultra 和 Team 计划的内置初始权限模式。

同一页面上的两条规则比版本号更重要。您在自己的 ~/.claude/settings.json 中设置的 defaultMode 会保留:Claude Code 可能会询问您是否要切换到自动模式;如果您拒绝,它会保留原有设置。组织通过托管设置部署的默认模式也会保留。公告文章最初说明,Enterprise 计划和 Claude API 会暂时继续采用主动选择自动模式的方式;该文章在 2026年10月22日 的更新中说明,Enterprise 管理员会在自动模式成为其组织的默认模式前收到电子邮件。自 v2.1.283 起,文档不再对终端和 VS Code 会话保留这一例外,但使用 v2.1.285 或更高版本时,应用了 HIPAA 配置的组织仍会以手动模式启动。

如果您在 VPS(虚拟专用服务器)上运行 Claude Code,这一变化的影响比在笔记本电脑上更大。权限提示是需要有人在键盘前确认的检查点。您通常不在远程服务器旁,因此会话启动时使用的模式可能会持续数小时。非交互式 claude -p 运行遵循不同规则:使用 v2.1.302 或更高版本时,如果未设置模式,它们会以 default 启动,包括使用第三方服务提供商或关闭遥测的情况。截至 2026年10月31日,当前版本为 v2.1.316,权限模式页面已记录此行为。在 v2.1.302 之前,这两种情况下可能会以 auto 启动,因此如果服务器上可能仍运行旧版本,请在服务器上运行 claude --version。

Claude Code 权限模式:从监管最多到监管最少

共有六种模式。每行开头的名称是您写入设置或传递给 --permission-mode 的值。所有模式都由 Claude Code 自身强制执行,而不是由模型执行,因为判断某个工具调用可以执行哪些操作,是模型外部的控制层负责的工作。

  • default:Claude 在执行大多数修改文件、运行 shell 命令或访问网络的操作前都会询问。工作目录内的读取操作仍会直接执行,不会提示。CLI(命令行界面)将此模式标记为 Manual,并接受 manual 作为别名。
  • plan:Claude 可以读取文件并运行命令进行探索,但不会修改源代码。在您批准计划之前,编辑操作会被阻止;但在具有绕过权限的交互式终端会话中,规划命令不适用分类器,也不会触发提示。
  • acceptEdits:文件编辑会直接执行,不会提示;文件系统命令 mkdir、touch、rm、rmdir、mv、cp 和 sed 也会直接执行。此模式仅适用于工作目录或 additionalDirectories 内的路径。写入受保护路径以及删除已识别的关键路径时仍会提示;只有使用普通文件路径时,touch 才会自动批准。其他所有 shell 命令仍遵循常规权限规则。
  • auto:常规权限提示会由分类器检查取代。显式的 ask 规则仍会强制触发提示。
  • dontAsk:Claude Code 会自动拒绝原本需要提示您的操作。除非某个已安装的 mod 可以批准调用,否则只有工作目录内的文件读取、您的 allow 规则、内置的只读 Bash 命令、预先批准的文档获取操作,以及经 PreToolUse hook 批准的调用会执行。会话不会等待输入。
  • bypassPermissions:跳过提示和安全检查,包括写入 .git、.claude 等受保护路径的操作。

在会话期间按 Shift+Tab,可依次在 default、acceptEdits 和 plan 之间切换。从 auto 开始,第一次按键会降级到 default。状态栏会显示切换后的模式,例如 ⏵⏵ auto mode on 或灰色的 ⏸ manual mode on。其他模式默认不在该切换循环中。您的账户满足相关要求后,auto 才会加入循环。只有在会话启动时使用 --permission-mode bypassPermissions、--dangerously-skip-permissions 或 --allow-dangerously-skip-permissions,或在用户、--settings 或托管设置中使用 defaultMode: "bypassPermissions" 时,bypassPermissions 才会加入循环。dontAsk 永远不会出现在该循环中,因此请使用 claude --permission-mode dontAsk 设置它。

Auto 模式还需要较新的模型。该要求通常是它完全不显示的原因。截至 27 October 2026,文档列出的支持模型包括 Anthropic API 上的 Claude Opus 4.6 或更高版本、Sonnet 4.6 或更高版本、Haiku 5.5,或 Fable 模型;Amazon Bedrock、Google Cloud 和 Microsoft Foundry 支持的列表更短。文档还说明,Sonnet 4.5 等较旧模型在任何提供商上都不受支持。如果 Claude Code 报告 Auto 模式不可用,请先检查这些要求以及任何 disableAutoMode 设置。Anthropic 也可以在服务器端关闭 Auto 模式;收到该响应的会话会一直关闭 Auto 模式,直到会话结束。因此,请稍后启动新会话,不要在旧会话中等待。

两项控制在所有模式中都有效,包括 bypassPermissions:deny 规则和显式 ask 规则。当仍有其他工具可用时,这两项都不适用于 EndConversation。无论会话以哪种模式启动,这些都是您始终保留的控制手段。

自动模式分类器会阻止的操作

分类器是一个独立模型。它会读取待执行的操作,并判断该操作是否符合您的请求。文档用一句话说明了它的职责:

一个独立的分类器模型会在操作执行前进行审查,阻止超出您请求范围、针对无法识别基础设施,或疑似受到 Claude 读取的恶意内容驱动的操作。

以下是默认阻止的操作,也是服务器运维人员最常遇到的类别:

  • 下载并执行代码,例如 curl | bash
  • 生产环境部署和迁移
  • 强制推送
  • 修改共享基础设施
  • 打开隧道或反向 shell,使本地服务可从公网访问
  • 将有效凭据或令牌打印到会话记录或文件中

以下操作默认允许:

  • 在工作目录中操作本地文件
  • 安装锁定文件或清单中声明的依赖项
  • 只读 HTTP 请求
  • 推送到当前工作仓库中的分支,包括默认分支;但名称表示部署目标或发布目标的非默认分支除外。推送内容仍会经过分类器的其他规则检查。

不要依据上面的摘要进行操作。运行 claude auto-mode defaults,以 JSON 格式输出完整规则列表,并阅读随已安装版本一同发布的规则集。/auto-mode-setup 是独立的命令:它会根据您的项目和其中的近期会话拟定 autoMode.environment 条目;如果您接受草案,它会将条目写入 ~/.claude/settings.json。承担版本要求的是该命令,而不是 claude auto-mode defaults。在 Pro、Max、Ultra 和 Team 计划中,/auto-mode-setup 需要 v2.1.228 或更高版本;在原生 Windows 上需要 v2.1.233 或更高版本。在 Enterprise 计划中,或使用 Claude Console API key 时,需要 v2.1.283 或更高版本。在 v2.1.304 之前,对于不获取功能标志的会话,/auto-mode-setup 不会出现在会话中,例如关闭遥测的服务器,或使用第三方提供商的服务器。如果您的服务器属于这种情况,请先更新。

在依赖此机制前,还需要注意两个已记录的限制。第一,在 Claude Code 自己发送的分类器请求中,分类器可以看到您的消息、除文件读取和搜索等只读查询之外的工具调用,以及您的 CLAUDE.md 内容;工具结果会被移除。因此,Claude 读取的文件或网页中的文本无法直接影响分类器。第二,当分类器连续 3 次阻止某个操作,或在同一会话中阻止 20 次操作时,自动模式会暂停,Claude Code 会恢复向您请求确认。批准待处理的操作后,自动模式会恢复。这些阈值无法配置。使用 -p 标志、且不带 --permission-prompt-tool 的非交互式运行没有可供请求确认的人员。文档明确说明,Claude Code 不会停止运行:被阻止的操作不会执行,但 Claude 会继续工作。

第二种行为在远程服务器上尤其容易造成问题,具体有两种情况。交互式会话触发限制后会停在确认提示处,等待没有查看终端的人处理。-p 运行则永远不会等待,因此任务可能在部分步骤被阻止、未执行的情况下结束。同一服务器上的另一个 Claude Code 会话不能替代这个人,因为从一个会话发送到另一个会话的文本永远不会被视为您的同意,也不能回答待处理的权限提示;因此,暂停在提示处的会话仍需要人工回答。缩小代理计划执行的任务范围,是解决问题的另一部分;让代理尽量执行可行的最小变更的技能可以避免会话扩展到分类器会阻止的大范围操作。技能会引导单个任务,而输出样式会直接修改系统提示;因此,要求进行小范围、精确变更的样式会在会话的每一轮中生效,而不仅适用于启动该样式时调用的单个任务。

settings.json 中模式的存放位置

上面的所有内容都是设置文件中的一个对象。

{
  "permissions": {
    "defaultMode": "auto",
    "allow": [
      "Bash(npm run test *)",
      "Bash(git status)"
    ],
    "ask": [
      "Bash(git push *)",
      "Bash(docker compose up *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./secrets/**)",
      "Bash(curl *)"
    ]
  }
}

规则按以下顺序评估:deny、ask,然后是 allow。按此顺序遇到的第一个匹配项决定结果;较窄的规则不会覆盖前面较宽的规则。针对 Bash(aws *) 的 deny 规则会阻止 aws s3 ls,即使你同时允许了该确切命令。因此,allow 规则不能从 deny 规则中开辟例外。Read 和 Edit 的 deny 或 ask 规则支持 gitignore 否定语法:在同一设置文件的 deny 列表中,Read(*.env) 后跟 Read(!sample.env),可将名为 sample.env 的文件从前一条规则中排除。该例外只适用于来自同一设置源的较早相对路径规则;它不能覆盖其他设置源中的 deny 规则,也不能重新开放整个目录已被阻止的目录中的文件。

ask 是在自动模式中真正有用的规则类型。自动模式会取消常规提示,而 ask 规则会针对你希望由人员确认的特定命令重新启用提示。部署命令应放在那里。如果你希望在代码离开该主机前设置检查点,Bash(git push *) 也应放在那里。将凭据文件放入 deny 是另一部分,这与首先让凭据无法被代理访问相配合。

以下是设置文件,顺序按优先级从低到高排列:

  • ~/.claude/settings.json:你的用户设置,应用于每个项目。
  • .claude/settings.json:项目设置,提交到代码仓库。
  • .claude/settings.local.json:你为某个代码仓库设置的专用设置。Claude Code 创建该文件时会将其加入 Git 忽略;如果手动创建,请将它加入 .gitignore。
  • 由管理员部署的托管设置。在 Linux 上,该文件是 /etc/claude-code/managed-settings.json。任何内容都不能覆盖托管权限规则,包括命令行标志。

这里有一个有明确文档说明原因的陷阱。defaultMode: "auto" 来自 .claude/settings.json 或 .claude/settings.local.json 时不会生效。这样,代码仓库无法通过提交设置文件来为自身启用自动模式。bypassPermissions 在这两个文件中也会被忽略。在其中设置 auto 后,Claude Code 会回退到内置默认值,跳过 ~/.claude/settings.json 中的任何 defaultMode,且不会在任何位置打印错误。如果该版本或套餐的内置默认值为 Manual,会话会静默地以 default 模式启动。将该行移到 ~/.claude/settings.json。运行 /permissions,列出每条活动规则及其来源文件。

关闭模式的两个开关

管理员可以使用两个禁用开关,二者都接受字符串 "disable",而不是布尔值。

{
  "permissions": {
    "disableAutoMode": "disable",
    "disableBypassPermissionsMode": "disable"
  }
}

文档规定,这两个设置可在任意设置文件中接受字符串 "disable"。它们最适合用于无法被覆盖的受管设置。

disableAutoMode会从 Shift+Tab 周期中移除 auto,使用 --permission-mode auto 启动的会话则会改为以手动模式启动。disableBypassPermissionsMode对旁路模式执行相同操作,而且可在任意作用域中生效。因此,您可以将它设置在自己的 ~/.claude/settings.json 中,禁止自己进入不希望在凌晨2点的生产服务器上使用的模式。如果服务器由其他人共用,则应将这两个设置放入 /etc/claude-code/managed-settings.json,因为用户设置文件归用户所有,而受管设置文件不归用户所有。

为什么 VPS 上的自动模式需要隔离边界

分类器一次只检查一个操作。它不会限制已批准操作随后执行的内容。文档明确说明:

分类器是按操作实施的控制措施,不是隔离边界。因此,无人值守运行仍需设置隔离边界,以实现纵深防御;而对于 --dangerously-skip-permissions,隔离边界并非可选,而是必需的。

因此,在远程主机上,应将自动模式与可接受丢失的环境配合使用,而不是使用 bypassPermissions 并寄希望于不会出问题。文档规定绕过模式只能用于隔离环境:没有互联网访问权限的容器、虚拟机或开发容器。在这些环境中,Claude Code 无法破坏宿主系统。运行数据库和反向代理的 VPS 不属于这些环境。

服务器上的安全措施主要有3项。使用普通用户运行 Claude Code,绝不要使用 root。为该用户提供一个工作目录,不要让它接触其他有读取价值的内容。与其修复主机,不如重建主机;这也是使用 每次任务结束后都销毁的一次性虚拟机 的原因。这些措施背后的加固细节包括创建用户和配置防火墙规则,详见 在 VPS 上运行 Claude Code 的完整安全检查,此处不再重复。

Claude Code 会自行强制执行 root 规则。在 Linux 和 macOS 上,如果使用 sudo 或 root 身份,它会拒绝以绕过模式启动:

--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons

在受识别的沙盒中会跳过这项检查。因此,对于自主运行的容器,文档建议使用以非 root 用户运行 Claude Code 的开发容器。如果你通过 SSH 从手机或笔记本电脑驱动代理,同样的原则也适用于 在 tmux 中保持运行的 Claude Code 会话:会话运行期间,没有人监控提示内容。在登录本身成功之前,其他步骤都无法开始。因此,如果主机以 Permission denied (publickey) 拒绝你的连接,详细的 SSH 输出会告诉你实际遇到的是5种故障中的哪一种。

在 Ubuntu VPS 上设置 Bash 沙箱

内置沙箱会限制 Claude 运行的沙箱 Bash 命令对文件系统和网络的访问,操作系统也会对其子进程执行相同限制。被排除的命令和获准在无沙箱环境中重试的命令会在沙箱外运行。在 Linux 上需要安装两个软件包。

sudo apt-get install bubblewrap socat

启动 Claude Code 并运行 /sandbox。此时会打开包含 Mode、Overrides 和 Config 选项卡的面板。如果缺少必需的软件包,面板只显示 Dependencies 选项卡,并列出需要安装的软件包。依赖项检查会在启动时执行,因此安装软件包后要重启 Claude Code,否则面板仍会将这些软件包报告为缺失。

在 Ubuntu 24.04 及更高版本中,默认的 AppArmor 策略会阻止 bubblewrap 创建所需的用户命名空间,因此沙箱无法启动。检查你的服务器是否受此影响:

sysctl kernel.apparmor_restrict_unprivileged_userns

如果输出为 0,或显示密钥不存在,则无需执行任何操作。如果输出为 1,则 bwrap 需要使用自己的配置文件:

sudo tee /etc/apparmor.d/bwrap > /dev/null <<'EOF'
abi <abi/4.0>,
include <tunables/global>

profile bwrap /usr/bin/bwrap flags=(unconfined) {
  userns,
  include if exists <local/bwrap>
}
EOF
sudo systemctl reload apparmor

此配置文件只应用于 bwrap 本身,不应用于它在沙箱内运行的命令。然后在设置中进一步收紧边界:

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "denyRead": ["~/"],
      "allowRead": ["."]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

该代码块应放在项目的 .claude/settings.json 中,因为只有在项目设置中,. 才会解析为项目根目录。将相同行放入 ~/.claude/settings.json 后,. 会解析为 ~/.claude,这样 denyRead 规则会继续阻止访问项目文件,并导致每个命令都无法读取其需要编辑的代码。

请注意,此设置无法覆盖以下内容。沙箱会限制 Bash 及其子进程。内置文件工具在 Claude Code 进程内部运行,而 MCP(模型上下文协议)服务器和钩子是独立进程,会在主机上不受限制地运行。若要将这些组件全部置于同一边界内,请在容器、虚拟机或 @anthropic-ai/sandbox-runtime 软件包中运行整个 Claude Code 进程;截至本文撰写时,该软件包仍是 beta 研究预览版。

每种部署应采用哪种模式?

个人笔记本上的单个仓库

使用 auto,并针对需要人工确认的操作设置 ask 规则。您就在键盘前,分类器回退机制确实可以请求您的确认,而且影响范围限制在您控制的一台计算机内。14 August 的默认设置就是为这种情况编写的。

共享 VPS

为每个用户使用 auto,并在各自的 ~/.claude/settings.json 中设置。运行 Claude Code 的账户不能是 root,也不能读取其他用户的工作目录。在 /etc/claude-code/managed-settings.json 中将 disableBypassPermissionsMode 部署为 "disable",同时配置用于保护共享路径的拒绝规则。共享主机最能说明 bypassPermissions 不适用,因为该模式假设的隔离边界并不存在:其他租户就在这个边界内。

CI 和无人值守会话

使用 dontAsk,并明确列出作业所需的命令(allow)。没有任何人会查看提示时,自动拒绝才是正确的故障处理方式。自动模式同样以非交互方式运行,但 -p 运行遇到分类器反复阻止操作时不会停止:被阻止的操作会跳过,Claude 会继续工作,因此作业可能在部分步骤未完成的情况下结束。仅在可从镜像重建的容器或虚拟机中使用 bypassPermissions,不要在同时运行重要服务的主机上使用它。

FAQ

Claude Code 何时将自动模式设为默认模式?

对于 Pro、Max 和 Team 计划的新会话,自动模式于 2026 年 8 月 14 日成为默认模式。截至 2026 年 10 月 27 日,文档说明,使用 Claude Code v2.1.283 或更高版本时,自动模式是所有计划和提供商的交互式终端及 VS Code 会话的内置启动模式。但应用 HIPAA 配置的组织除外:使用 v2.1.285 或更高版本时,这些组织的会话以手动模式启动。非交互式 claude -p 运行以 default 启动,除非您设置了模式。在 v2.1.302 之前,使用第三方提供商或关闭遥测的运行可能以 auto 启动;从 v2.1.302 起,它们也以 default 启动。您自行设置的默认模式会保持不变,除非您接受一次性切换提示;组织管理的默认模式不会改变。查看状态栏即可确认会话实际使用的模式;自动模式下显示 ⏵⏵ auto mode on。

在 VPS 上,我应该使用自动模式还是 bypassPermissions?

应使用自动模式,并配合隔离边界。分类器会在操作执行前进行检查。对受保护路径以外位置的读取和工作目录修改会跳过检查。但文档明确说明,自动模式是逐项操作的控制机制,不是隔离边界。因此,无人值守运行仍应使用容器、虚拟机,或一台您愿意重建的服务器。bypassPermissions 会完全跳过检查,文档仅建议在隔离环境中使用。Claude Code 在 Linux 上拒绝以 root 身份在该模式下启动,并输出 --dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons。

如何阻止服务器上的任何人使用自动模式或绕过模式?

在 /etc/claude-code/managed-settings.json 中,将 permissions.disableAutoMode 和 permissions.disableBypassPermissionsMode 设置为字符串 "disable"。托管设置的优先级高于所有其他作用域,因此用户设置文件和命令行标志都无法覆盖这些设置。disableAutoMode 会从 Shift+Tab 循环中移除 auto,而使用 --permission-mode auto 启动的会话会改为以手动模式启动。disableBypassPermissionsMode 也可在任何作用域中使用,因此单个用户可以在自己的 ~/.claude/settings.json 中设置它。

为什么我的 defaultMode: "auto" 设置没有生效?

因为该设置位于错误的文件中。defaultMode: "auto" 来自 .claude/settings.json 或 .claude/settings.local.json 时不会生效,因此仓库无法通过附带设置文件来为自身启用自动模式。Claude Code 会改用内置默认模式,跳过用户设置中的任何 defaultMode,且不会输出错误;如果内置默认模式是手动模式,会话就会以 default 模式启动。将设置移至 ~/.claude/settings.json,然后运行 /permissions,确认每条生效规则来自哪个文件。如果自动模式仍不可用,请检查模型要求:Sonnet 4.5 等较旧模型在任何提供商上都不受支持。

这篇文章对您有帮助吗?