给 Claude Code 放权限,最容易犯的错不是放太少导致一直点确认,而是一上来就给全开、事后才发现它在你的仓库和家目录里做了什么。这篇不讲抽象安全观,只讲三件事:开工前怎么按任务给权限定级、跑的时候看哪几个信号判断要不要收回、真出了越界改动按什么顺序回退。
给 Claude Code 放权限,最容易犯的错不是放太少导致一直点确认,而是一上来就给全开,事后才发现它在你的仓库和家目录里做了什么。这篇不讲抽象安全观,只讲三件事:开工前怎么按任务给权限定级、跑的时候看哪几个信号判断要不要收回、真出了越界改动按什么顺序回退。
先说清楚一个前提:权限模式不是「安全等级开关」,它控的是哪些动作可以不问你直接执行。同一句需求,在两种模式下落地动作可能差得很远。所以下面的判断标准都围绕一个思路来:按任务的风险定范围,跑起来看信号再调,出事按固定顺序收。
先弄清:权限模式到底在控什么
权限模式管的是「哪些动作可以不问你直接执行」,不是模型听不听话。它不改变模型理解需求的能力,只改变它把想法落地时需不需要经过你点头。所以讨论避坑,实质是讨论:你愿意让哪些动作绕过确认,以及绕过之后你怎么发现它越界。
- 真正要盯的是三类动作:改文件、跑命令、发网络请求。前两类改的是本地现状,第三类可能把内容带出去,危害方向不同。
- 常见的错位认知:以为「只读模式」就没风险。实际读的范围够大时,读本身就是信息收集,读完之后在别处用不上不代表没被看过。
- 另一个错位:把「它会问我」当成安全网。确认弹窗多了人会麻木,连续点同意的次数一多,判断力就下来了,这本身是个风险点。
开工前先给任务定级:三档对照表
定级不用纠结,看两件事:这次会不会改现有文件、会不会碰到仓库外的东西。用下面这张表先给任务归个档,再决定权限放到哪一档,别凭手感。
| 风险档位 | 典型任务 | 读权限 | 写权限 | 命令执行 |
|---|---|---|---|---|
| 低风险 | 只读排查、看日志、写独立脚本 | 可以给得比较宽 | 收到指定目录,最好是个临时目录 | 逐条确认,白名单只放只读命令 |
| 中风险 | 改现有项目、跑测试、装依赖 | 限定在仓库内 | 限定在仓库目录 | 逐条确认或走白名单,装依赖类单独确认 |
| 高风险 | 整库重构、批量改配置、动部署脚本、有生产凭据 | 仓库内 | 仓库内且改动前先看清单 | 先全确认模式跑一遍,看过它要做什么再逐步放宽 |
定级之后还有一条判断标准:如果这个任务你没法在一两分钟内说清「它大概会动哪些目录」,那就先别放宽,按高风险档处理。说不清范围的任务,本身就不适合交给免确认模式。
不适用的情况
这套定级对「探索性质的任务」不完全适用,比如你也不确定要改哪里、让它先看看。这类任务按低风险处理,先只读跑一轮,看清楚它的判断再决定要不要给写权限。反过来,如果你已经知道要改哪几个文件,反而可以把写权限收得更窄。
白名单怎么划才有意义
白名单是按命令前缀划比按整条命令划更实用,但划的时候要想到「这条命令能不能间接执行别的程序」。能带参数、能加载插件、能执行脚本的入口,本质上等于把执行权交出去了,只是换了个壳。
- 带管道的命令要特别小心:前半段看着无害,后半段可能在做别的事,白名单匹配不到管道后面的部分。
- 能读环境变量、能读密钥文件的命令不要进白名单,哪怕它看起来很无害,读出来写到日志里也算泄露路径。
- 包管理器、解释器、构建工具这类能拉取并执行远程内容的入口,单独设一档,别和普通只读命令混在一起。
- 给白名单配一条退出条件:换项目、换机器、换依赖后重新审一遍,别把它当一次配好永久生效的东西。
审查白名单的最小动作
- 列一遍现有条目把当前白名单逐条读一遍,逐条问「这条能不能间接执行别的程序」,能的挑出来单独归类。
- 删掉读密钥类的条目凡是能读环境变量、凭据文件、密钥目录的命令,一律移出白名单,保留逐条确认。
- 标出能联网的条目把会发起网络请求、会下载并执行内容的命令单独标记,跑之前先看它会连哪里。
- 记下重审触发点在笔记里写清哪种情况要重审:换项目、换机器、依赖大改。到期就重看一遍,不靠记忆。
目录范围:最容易越界的地方
从仓库根目录启动,比从家目录启动安全得多,因为工作目录就是它的默认活动范围。很多人图省事在家目录开一个会话,结果它顺手就碰到了旁边的项目和缓存目录,这不是它坏,是你把活动范围设大了。
- 把不该被碰的目录写进拒绝清单:密钥目录、其他项目、系统配置、凭据缓存,这几类是通用项。
- 注意软链接和符号链接会绕过目录限制,这个要人工核一遍,别指望配置自动挡住。
- 跑之前先确认当前工作目录是哪儿,一句 pwd 的成本远低于事后回滚。
- 如果任务确实要跨目录,单独起一个会话,把范围写清楚,别在一个会话里到处跳。
判断标准很简单:如果这个会话的默认范围里包含了你不想让它读的东西,那就换启动位置,而不是指望它在里面自觉。
跑的过程中,看哪些信号该收回权限
权限放出去之后不是就不管了,要盯几个信号。这些信号不需要你懂代码,看到异常就停下来切模式,成本很低。
- 出现你没提过的文件被创建或修改,尤其是配置文件和脚本,这类文件的影响面往往比业务代码大。
- 开始尝试网络下载、安装或执行远程内容,这一步要停下来看它连的是哪里、拿回来的是什么。
- 反复要求同一类确认,说明你的白名单没覆盖到它常用的动作,该补就补,别硬点。
- 反过来,同类危险动作突然不再问了,这更值得停一下,可能是白名单被放宽了,也可能你以为的限制根本没生效。
出现上面任何一条,先切回全确认模式再排查,别在放宽状态下找原因。放宽状态下你看到的每一步都是它想让你看到的,排查信息本身就不完整。
真出问题了,按这个顺序回退
回退最怕的是边查边改,越查越乱。按固定四步走,每一步做完再做下一步,顺序不能反。
- 停切回确认模式或直接中断会话,别让它继续动。这一步不做完,后面所有操作都是在流沙上做。
- 看用版本控制看改动范围,用命令历史看执行过什么,确认有没有把内容发出去。看的时候只记录不改动,避免破坏现场。
- 收撤销越界改动、吊销用过的凭据、必要时回滚环境。凭据这一项容易被忽略,只要它读过或传过,就当已经泄露处理。
- 复盘最后再决定要不要继续用这个模式。复盘放在最后,是因为前面三步没做完时,你对「发生了什么」的判断大概率是错的。
这四步里,最容易省掉的是「看」,因为人急着恢复。但跳过看直接收,你收的可能不是它改的那部分,回头还会再出一次。
不同场景怎么选:够用就行的原则
选模式的原则是够用就行,不是越严越好,也不是越松越省事。按场景套下面三条,基本不会出大偏差。
| 场景 | 建议起点 | 放宽条件 | 不放宽的理由 |
|---|---|---|---|
| 个人临时脚本、离线环境 | 可以放宽,但限定目录 | 任务范围能一句话说清时再放 | 放宽的收益是省点击,代价可控 |
| 团队共享仓库、有 CI 和部署脚本 | 默认全确认起步 | 靠白名单而不是靠信任,白名单要随项目重审 | 共享仓库的改动会影响别人,出错成本外溢 |
| 客户数据、生产环境、第三方接口 | 这一档不适合放宽 | 什么模式都要人来确认 | 一旦带出去就收不回来,没有回滚手段 |
还有一种情况要单独说:如果你打算长期用某个放宽模式,建议在站内工具目录里挑一个能辅助检查配置和权限设置的工具配合用,别只靠记忆维护白名单。工具能查什么、不能查什么,去 /tools 看各工具的能力说明,别假设它能兜住一切。
权限模式的取舍标准不是「信不信它」,而是「出问题时你能不能在两分钟内看清它做了什么」。下一步如果你正在评估某家中转站或 API 服务,先把权限这条线和选服务分开看;选服务看价格与可用性,去 /price-watch 核对当时的数字,权限配置按上面这套标准单独定,两件事别混在一起决策。→
常见问题
Claude Code 权限模式开到最宽是不是效率最高?
短期是,但代价是出错时你无法回溯它做过什么。更稳的做法是从全确认起步,跑一两轮后把确实重复、确实安全的动作加进白名单,逐步放宽。放宽的依据是观察结果,不是对模型的信任度。
给了自动批准,是不是等于它可以随便改我的文件?
不是随便,但边界由你的目录和命令范围决定。工作目录、软链接、能被间接执行的命令都可能成为越界入口。所以自动批准要配合目录限制和拒绝清单一起用,单开一项不解决问题。
怎么判断它执行过的命令有没有风险?
先看命令功能分类:读、写、装、联网、改权限。读和写局限在仓库内的通常可接受;装依赖、联网下载、改系统配置这三类要逐条看。拿不准就当成有风险处理,切回确认模式重跑一遍比事后补救便宜。
团队里多人用同一个仓库,权限怎么统一?
把权限配置当成仓库的一部分来管,随代码一起评审和提交;新人默认从最严档进。同时约定一条硬规则:涉及部署脚本和生产凭据的操作一律人工确认,不因个人习惯放宽。
只读模式就完全安全吗?
不完全。只读的风险在信息面:读的范围过大时,它会把不该看的文件内容带进上下文,后续一旦有输出或联网动作就可能外泄。只读模式也要配目录范围。