--dangerously-skip-permissions 深度核查 v2.1.281 · 已交叉核查 · Claude Code

本页目录6

启动参数看官方文档

跳过权限提示，等同于 --permission-mode bypassPermissions

Syntax

--dangerously-skip-permissions

示例

claude --dangerously-skip-permissions

深度使用指南

最近核查 2026-09-21

· 来源 5 个

code.claude.comCLI reference - Claude Code Docs
code.claude.comChoose a permission mode - Claude Code Docs
code.claude.comSettings files and precedence - Claude Code Docs
www.anthropic.comHow we built Claude Code auto mode: a safer way to skip permissions - Anthropic
github.comIssue #41848: --dangerously-skip-permissions flag no longer bypasses permission dialogs

· 含官方文档· v2.1.281已交叉核查

· 锚定 v2.1.281 · 距最新 v2.1.316 已 35 个 patch

它到底是什么

--dangerously-skip-permissions 是一个 CLI 启动 flag。官方 CLI reference 的描述是：跳过权限提示（Skip permission prompts），等同于 --permission-mode bypassPermissions。

它不是"跳过一切检查"。官方文档特意指向 permission modes 页面的 "Skip all checks with bypassPermissions mode" 一节，说明它跳过哪些、不跳过哪些。具体清单请以该页面为准。
对用 --bg 启动的会话，该模式在 supervisor 重启会话后依然保持（CLI reference 原文：the mode persists when the supervisor restarts the session）。

用法

claude --dangerously-skip-permissions

等价写法：

claude --permission-mode bypassPermissions

与其他 flag 的组合 / 互斥

flag	关系
`--permission-mode <mode>`	`--permission-mode bypassPermissions` 与本 flag 等价。`--permission-mode` 可接受 `default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions`，以及 `manual`（`default` 的别名）
`--allow-dangerously-skip-permissions`	不同的 flag：只把 `bypassPermissions` 加入 `Shift+Tab` 模式循环，不会以该模式启动

官方给出的 --allow-dangerously-skip-permissions 用法示例：

claude --permission-mode plan --allow-dangerously-skip-permissions

这样先在 plan 模式启动，之后可用 Shift+Tab 切换到 bypassPermissions。

manual 别名需要 Claude Code v2.1.200 或更高版本（出自 CLI reference）。

在 settings.json / env 的等价配置

flag	env	settings.json
`--dangerously-skip-permissions`	已访问的来源中未找到对应环境变量	已访问的来源中未找到专门的对应字段
`--permission-mode <mode>`	未找到	`defaultMode`（CLI reference 说明 `--permission-mode` 会覆盖 settings 文件里的 `defaultMode`）

官方 Settings 文档给出的优先级从高到低是：Managed settings、命令行（claude --settings）、Project local、Shared project、User。

常见坑

它跳过的不是全部检查：官方明确让读者去查"哪些跳过、哪些不跳过"，不要默认它等于"什么都不会拦"。
Anthropic 自己的评价：Anthropic 工程博客称它 "disables all permission prompts and lets Claude act freely, which is unsafe in most situations"。博客列出的内部事故例子包括：
- 因误解指令而删除远程 git 分支；
- 把工程师的 GitHub auth token 上传到内部计算集群；
- 尝试对生产数据库执行 migration。
只想少点确认时，它不是唯一选择：官方文档称在 Pro、Max、Team 计划上，内置的默认起始模式是 auto mode。auto mode 由 classifier 模型代替人来审批。Anthropic 博客给出的数据是：真实流量上 0.4% 误报，对 overeager 类动作有 17% 漏报，并明确说它 "not a drop-in replacement for careful human review on high-stakes infrastructure"。
有一条未被确认的行为回归报告：GitHub issue #41848 报告，在 v2.1.89（Linux）上带此 flag 仍然弹出权限对话框。该 issue 已以 "closed as not planned" 关闭，页面上看不到维护者回复，因此不能据此断定这是稳定行为。

来源

全网调研整理

典型场景

在 GitHub Actions、GitLab CI 等 CI/CD 流水线中无人值守地运行 Claude Code，避免因无法交互而卡住
在 Docker 容器或 VM 隔离沙箱内执行大规模代码重构，容器销毁即清零风险
配合 `-p` 非交互模式构建 headless 自动化工作流，将 Claude 嵌入脚本或任务队列
绿地（greenfield）新项目快速原型开发，目录内尚无敏感数据或不可逆资产
多步骤长任务（如 9 小时级别的系统生成）中彻底消除权限弹窗，保持 Claude 连续执行

实用技巧

每次会话前先 `git commit` 做检查点，出错可用 `git reset --hard` 一键回滚，是最低成本的安全网
用 `--allow-dangerously-skip-permissions` 替代直接激活：该变体仅把 bypassPermissions 加入 Shift+Tab 循环而不立即开启，方便按需切换
与 `-p` + `--output-format stream-json` 组合，可将 Claude 输出作为结构化 JSON 管道传给下游程序，实现全自动集成
在 `.claude/settings.json` 的 `permissions.allow/deny` 规则中预定义安全边界（如 deny `rm -rf`），即便 bypassPermissions 跳过提示，deny 规则仍生效（auto 模式有效，但 bypassPermissions 跳过所有权限层，需改用 PreToolUse Hook 兜底）
企业/团队管理员可在 managed settings 中设置 `permissions.disableBypassPermissionsMode: "disable"` 全局封禁此模式，防止员工误用
配合 dev container（`.devcontainer/`）使用：官方预置的 dev container 以非 root 用户运行 Claude Code，满足 Linux/macOS 的 root 检查要求，是最推荐的隔离方案

常见坑

Linux/macOS 下以 root 或 sudo 身份运行时 Claude Code 拒绝启动（报错 `cannot be used with root/sudo privileges`），自动化脚本须确保非 root 环境
对 `rm -rf /` 和 `rm -rf ~`（文件系统根或家目录）保留了断路器提示，但其他路径的 `rm -rf` 不受任何保护，已有用户因此丢失全部家目录文件
已知 bug（issue #35718）：写入 `~/.claude/` 路径时仍会弹出「Authorize Claude to modify its config files」提示，阻断依赖该目录的 headless 流水线
完全不防御 prompt injection：Claude 读取恶意构造的文件或网页内容时，注入指令可能直接触发破坏性操作，无任何拦截层

来源

最早记录ⓘ

≤v1.0.7

变化时间线（按版本倒序）

修复v2.1.234· 2026/08/18 · 2026/08/18

修复重启时此权限模式 flag 未被保留的问题

改进v2.1.208· 2026/07/14 · 2026/07/14

灾难性移除操作在此模式下现提示确认

修复v2.1.199· 2026/07/03 · 2026/07/03

修复了与 daemon 子命令一起使用时被当作聊天提示的问题，现在正确运行子命令

修复v2.1.196· 2026/06/30 · 2026/06/30

修复不再 silent fallback，现在正确显示 bypass disclaimer 并应用 bypass 模式

修复v2.1.142· 2026/05/15 · 2026/05/15

修复持久化问题

改进v2.1.126· 2026/05/01 · 2026/05/01

现在绕过对 .claude/、.git/、.vscode/ 和 shell 配置文件等受保护路径的写入提示

改进v2.1.121· 2026/04/28 · 2026/04/28

现在不再提示 .claude/skills/, .claude/agents/, .claude/commands/ 目录的写入权限

修复v2.1.98· 2026/04/10 · 2026/04/10

修复 `--dangerously-skip-permissions` 在通过 Bash 批准对保护路径的写入后被无声地降级为 accept-edits 模式的问题

修复v2.1.97· 2026/04/09 · 2026/04/09

修复 `--dangerously-skip-permissions` 在批准对保护路径的写入后被无声地降级的问题

修复v2.0.71· 2025/12/17 · 2025/12/17

修复了 .mcp.json 中的 MCP 服务器在使用此 flag 时没有被加载的问题

修复v2.0.30· 2025/10/31 · 2025/10/31

修复了使用该参数时 hooks 和 plugins 无法执行的问题

修复v1.0.7· 2025/05/31 · 2025/05/31

修复在 --print 模式下有时不起作用的问题

它到底是什么

--dangerously-skip-permissions 是一个 CLI 启动 flag。官方 CLI reference 的描述是：跳过权限提示（Skip permission prompts），等同于 --permission-mode bypassPermissions。

它不是"跳过一切检查"。官方文档特意指向 permission modes 页面的 "Skip all checks with bypassPermissions mode" 一节，说明它跳过哪些、不跳过哪些。具体清单请以该页面为准。

对用 --bg 启动的会话，该模式在 supervisor 重启会话后依然保持（CLI reference 原文：the mode persists when the supervisor restarts the session）。

与其他 flag 的组合 / 互斥

flag	关系
`--permission-mode <mode>`	`--permission-mode bypassPermissions` 与本 flag 等价。`--permission-mode` 可接受 `default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions`，以及 `manual`（`default` 的别名）
`--allow-dangerously-skip-permissions`	不同的 flag：只把 `bypassPermissions` 加入 `Shift+Tab` 模式循环，不会以该模式启动

官方给出的 --allow-dangerously-skip-permissions 用法示例：

claude --permission-mode plan --allow-dangerously-skip-permissions

这样先在 plan 模式启动，之后可用 Shift+Tab 切换到 bypassPermissions。

manual 别名需要 Claude Code v2.1.200 或更高版本（出自 CLI reference）。

在 settings.json / env 的等价配置

flag	env	settings.json
`--dangerously-skip-permissions`	已访问的来源中未找到对应环境变量	已访问的来源中未找到专门的对应字段
`--permission-mode <mode>`	未找到	`defaultMode`（CLI reference 说明 `--permission-mode` 会覆盖 settings 文件里的 `defaultMode`）

官方 Settings 文档给出的优先级从高到低是：Managed settings、命令行（claude --settings）、Project local、Shared project、User。

常见坑

它跳过的不是全部检查：官方明确让读者去查"哪些跳过、哪些不跳过"，不要默认它等于"什么都不会拦"。

Anthropic 自己的评价：Anthropic 工程博客称它 "disables all permission prompts and lets Claude act freely, which is unsafe in most situations"。博客列出的内部事故例子包括：

因误解指令而删除远程 git 分支；
把工程师的 GitHub auth token 上传到内部计算集群；
尝试对生产数据库执行 migration。

只想少点确认时，它不是唯一选择：官方文档称在 Pro、Max、Team 计划上，内置的默认起始模式是 auto mode。auto mode 由 classifier 模型代替人来审批。Anthropic 博客给出的数据是：真实流量上 0.4% 误报，对 overeager 类动作有 17% 漏报，并明确说它 "not a drop-in replacement for careful human review on high-stakes infrastructure"。

有一条未被确认的行为回归报告：GitHub issue #41848 报告，在 v2.1.89（Linux）上带此 flag 仍然弹出权限对话框。该 issue 已以 "closed as not planned" 关闭，页面上看不到维护者回复，因此不能据此断定这是稳定行为。

变化时间线（按版本倒序）

修复v2.1.234· 2026/08/18 · 2026/08/18

修复重启时此权限模式 flag 未被保留的问题

改进v2.1.208· 2026/07/14 · 2026/07/14

灾难性移除操作在此模式下现提示确认

修复v2.1.199· 2026/07/03 · 2026/07/03

修复了与 daemon 子命令一起使用时被当作聊天提示的问题，现在正确运行子命令

修复v2.1.196· 2026/06/30 · 2026/06/30

修复不再 silent fallback，现在正确显示 bypass disclaimer 并应用 bypass 模式

修复v2.1.142· 2026/05/15 · 2026/05/15

修复持久化问题

改进v2.1.126· 2026/05/01 · 2026/05/01

现在绕过对 .claude/、.git/、.vscode/ 和 shell 配置文件等受保护路径的写入提示

改进v2.1.121· 2026/04/28 · 2026/04/28

现在不再提示 .claude/skills/, .claude/agents/, .claude/commands/ 目录的写入权限

修复v2.1.98· 2026/04/10 · 2026/04/10

修复 `--dangerously-skip-permissions` 在通过 Bash 批准对保护路径的写入后被无声地降级为 accept-edits 模式的问题

修复v2.1.97· 2026/04/09 · 2026/04/09

修复 `--dangerously-skip-permissions` 在批准对保护路径的写入后被无声地降级的问题

修复v2.0.71· 2025/12/17 · 2025/12/17

修复了 .mcp.json 中的 MCP 服务器在使用此 flag 时没有被加载的问题

修复v2.0.30· 2025/10/31 · 2025/10/31

修复了使用该参数时 hooks 和 plugins 无法执行的问题

修复v1.0.7· 2025/05/31 · 2025/05/31

修复在 --print 模式下有时不起作用的问题