权限模式什么时候该放手让它跑
新版 Claude Code 默认用 auto 模式,由安全分类器替你审大部分操作。这一章讲清六种模式怎么选、要不要彻底放开、放开之前该准备好什么。
全部章节
本页
先说结论
- 日常开发用默认的 auto 模式就好:常规操作不再弹确认,越界或危险的操作会被分类器拦下。
- 想彻底不被打断,可以用 bypassPermissions(启动参数
--dangerously-skip-permissions)。官方建议只在容器或虚拟机里用。我们的看法是:在 git 管理、能随时回滚、没有密钥和生产配置的项目里,个人开发也可以用,但要清楚 git 只能退回项目里已跟踪的改动,目录外的写入、推送与部署、已经发出去的数据都撤不回。 - 涉及生产环境、真实数据库、支付或密钥的目录,不要彻底放开:用 auto 或 acceptEdits,再用 deny 规则把删除、推送、部署这类命令挡在外面。
六种模式
| 模式 | 不问就能做的事 | 适合 |
|---|---|---|
default(界面显示为 Manual,命令行与 defaultMode 也接受 manual) | 只读 | 逐项审核、敏感工作 |
acceptEdits | 读、改文件、常见文件命令(mkdir、touch、mv、cp 等) | 一边看一边迭代代码 |
plan | 读,以及 auto 可用时分类器放行的命令;先出方案再动手 | 改动前先摸清代码库 |
auto | 全部,后台由分类器做安全检查 | 长任务、不想被确认打断 |
dontAsk | 工作目录内的读取和预先批准的工具,其余会弹确认的一律拒绝 | 锁死权限的 CI 和脚本 |
bypassPermissions | 全部 | 容器、虚拟机(官方建议);或你清楚风险边界的可回滚项目 |
Claude Code v2.1.283 起,交互式终端会话默认就是 auto 模式;auto 不可用时(模型或账号不满足条件)会退回 Manual。
怎么切换:会话里按 Shift+Tab 在 auto、Manual(default)、acceptEdits、plan 之间循环,状态栏会显示当前模式;启动时用 claude --permission-mode <模式>。bypassPermissions 要在启动时授权:--dangerously-skip-permissions 或 --permission-mode bypassPermissions 会直接进入;--allow-dangerously-skip-permissions 只把它加进可选模式,之后再用 Shift+Tab 切过去。/permissions 用来管理 allow、ask、deny 规则,不切换模式。
auto 模式在做什么
auto 模式下,每个需要审核的操作会先交给一个独立的分类器判断:超出你请求范围的、指向陌生基础设施的、看起来是被读到的恶意内容诱导的,都会被拦下并通知你。被拦的操作可以在 /permissions 的 Recently denied 里重试。连续被拦 3 次或累计 20 次,它会暂停 auto,恢复逐项询问。
通过 ANTHROPIC_BASE_URL 接入(包括本站)时,安全审核默认会先交给服务端。如果反复出现「服务器没有返回安全判定」一类的提示,设置环境变量 CLAUDE_CODE_AUTO_MODE_SERVER=0,让 Claude Code 自己另发分类器请求(会额外消耗少量 tokens,计入账单)。
什么时候值得彻底放开
auto 已经去掉了大部分确认,想无人值守又不想开容器,先用 auto。bypass 适合的是另一类场景:在容器或虚拟机里跑长时间批量任务,或者你确信这个目录和这台机器上没有任何不可逆的东西。
bypass 下它可以读写项目以外的文件、联网、执行任何命令;如果读到的网页或 MCP 返回里夹带了诱导指令,也没有分类器替你拦。
彻底放开之前做三件事:
- 提交:
git status干净,或者至少git stash一下。回退的前提是有地方可回。 - 隔离密钥:项目里的
.env用 deny 规则挡住;家目录下的凭据(~/.ssh、~/.aws、云服务的登录配置)同样在它够得着的范围内,能移走就移走,或者在容器里运行。 - 挡住不可逆的命令:用 deny 规则拦下
git push、部署脚本、数据库写操作;回退项目内的改动用git checkout .和git clean -fd,更稳妥的是每个任务开一个分支。
更进一步,把 Claude Code 放进容器或单独的开发机里运行。环境本身就是沙箱,放开权限的顾虑就小得多,这也是官方推荐的用法。
用规则补足边界
模式决定默认行为,规则在任何模式下都生效。项目的 .claude/settings.json 示例:
{
"permissions": {
"defaultMode": "acceptEdits",
"allow": ["Bash(npm test)", "Bash(npm run *)", "Bash(git status)", "Bash(git diff *)"],
"deny": ["Bash(git push *)", "Read(./.env)", "Read(./.env.*)"]
}
}deny在所有模式下都生效,包括 bypassPermissions。allow在 bypassPermissions 下没有意义,因为本来就全部放行。defaultMode: "auto"写在项目的.claude/settings.json里不生效,要写在~/.claude/settings.json。
这个文件可以提交进仓库,团队共用同一套规则,见 团队用法。比规则更强的护栏是 Hooks,可以在操作执行前用脚本做任意判断,见 Hooks 与自动化。
常见问题
放开后它会不会乱删东西?
很少。它会先读再改,删除前通常会说明理由;删除系统关键路径(如 rm -rf ~)在任何模式下都会被拦下或询问。项目内被改坏的文件可以用 git 退回,项目外的改动和已经执行的推送、部署撤不回,所以上一节的准备不能省。
放开后还要看它做了什么吗?
要,但看的是结果而不是过程:任务结束后 git diff,再跑一遍测试。
和 AGI Dawn 有关系吗?
权限模式是 Claude Code 本地的行为。唯一相关的是上面提到的 auto 模式服务端审核,遇到问题按那一段处理。