Claude Code 指南第 3 章进阶

权限模式什么时候该放手让它跑

新版 Claude Code 默认用 auto 模式,由安全分类器替你审大部分操作。这一章讲清六种模式怎么选、要不要彻底放开、放开之前该准备好什么。

更新于 2026年10月17日 · 依据 Claude Code 2.1.301 官方文档核对 · AGI Dawn 编辑部 · 审定 kk

全部章节
本页

先说结论

  • 日常开发用默认的 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 返回里夹带了诱导指令,也没有分类器替你拦。

彻底放开之前做三件事:

  1. 提交:git status 干净,或者至少 git stash 一下。回退的前提是有地方可回。
  2. 隔离密钥:项目里的 .env 用 deny 规则挡住;家目录下的凭据(~/.ssh、~/.aws、云服务的登录配置)同样在它够得着的范围内,能移走就移走,或者在容器里运行。
  3. 挡住不可逆的命令:用 deny 规则拦下 git push、部署脚本、数据库写操作;回退项目内的改动用 git checkout . 和 git clean -fd,更稳妥的是每个任务开一个分支。

更进一步,把 Claude Code 放进容器或单独的开发机里运行。环境本身就是沙箱,放开权限的顾虑就小得多,这也是官方推荐的用法。

用规则补足边界

模式决定默认行为,规则在任何模式下都生效。项目的 .claude/settings.json 示例:

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 模式服务端审核,遇到问题按那一段处理。