Claude Code 权限模式决定了 agent 在不暂停询问的情况下可以执行哪些操作。一共有四种:plan 只读不改,default 根据权限规则在编辑和执行命令前询问,acceptEdits 无需询问直接应用文件修改但仍询问命令,bypassPermissions 则一概不问。选择哪种模式,代表了你对该目录下 agent 的信任程度。
一旦输入请求的人不再是这台机器的主人,这个判断就会变得复杂。本文将先解析 Claude Code 官方定义的这几种模式,再探讨在共享房间中会发生哪些变化。
四种模式
plan。 agent 只读取文件、搜索并推理,最终生成一份计划。它不会编辑也不会运行任何东西。该模式适用于“告诉我你会怎么做”,以及让其他人浏览他们不应该修改的代码库。
default。 agent 在每次编辑和运行每条命令前都会询问,除非你的权限规则已经允许了该特定工具或规则模式。非常适合结对场景,此时你在旁看着,每个 prompt 都是一次实际的决策。
acceptEdits。 文件修改无需 prompt 直接生效;命令仍会询问。在撤销错误修改代价极低(处于版本控制之下)、但运行错误命令代价很高的代码仓库中,这种模式非常有用。
bypassPermissions。 一概不问。Anthropic 建议仅在沙箱或一次性环境中使用此模式,因为一条错误或被注入的指令都会以你本地的完整权限执行。
从 plan 到 bypassPermissions 的阶梯,以及当 agent 被共享时无论何种模式都会暂停的四类操作。
为什么模式针对的是目录,而不是人
权限模式是针对会话设置的,在实践中也就是针对工作目录设置的。当你独自一人时,这是合理的粒度:文档仓库可以使用 acceptEdits,基础设施仓库使用 default,一次性实验则用 bypassPermissions。
但只要第二个人可以发送请求,这种设计就不够用了。他们的请求会以你的会话模式运行。一个只需要看代码的合伙人,现在却能直接编辑代码,只因你上周为自己设置了 acceptEdits。模式本身并没有“按人区分”的维度。
房间里会有哪些变化
在 muti 房间中,agent 仍然拥有一个 Claude Code 权限模式,这是你在为目录创建 agent 时选择的。在此之上,增加了两层机制。
按人设定的权限。 来自非主人的每个请求,要么单次审批(Approve),要么由你为该人针对该 agent 授予的长期“always allow”覆盖。你可以随时 Revoke 这项长期授权;该用户已排队的请求将被 Cancel。
始终暂停的四类操作。 无论处于何种模式、拥有何种授权,向共享分支推送代码、删除、花钱以及触碰凭证,都会停下来等待主人确认。即使是处于 bypassPermissions 的 agent,只要请求来自其他人,执行这些操作时也会暂停。背后的考量见四类 agent 执行前必须先询问的操作。
实用落地指南
- **供他人探索排查:**在
plan模式下创建 agent。访客可以提问,磁盘上的内容不会发生任何改变。 - 与信任的人进行日常协作:
acceptEdits,并为这些人设置长期授权。命令依然会询问;四类关键操作依旧会暂停。 - 你自己的抛弃型沙箱:
bypassPermissions完全没问题,因为房间里没有其他人。一旦你 Invite 了别人,就得重新评估。 - 目录中包含生产环境凭证的任何场景:
default,不设长期授权,并为不需要这些凭证的部分配置单独的 agent。
常见问题
房间会覆盖 Claude Code 的模式吗? 不会。在单次运行中,agent 能做什么依然由模式决定。房间增加的是谁可以启动运行,以及哪些操作无论如何都必须暂停。
请求者可以选择模式吗? 不能。只有主人可以为每个 agent 选择模式。请求者可以在其请求中要求只读行为,主人也可以在审批时回复“以只读方式继续”。
共享 agent 可以使用 bypassPermissions 吗? 仅适用于绝对不会发生不可逆操作的目录,即便如此,四类操作依然会暂停。另一篇文章详细讨论了为什么 bypassPermissions 对你自己合适,对其他人却很危险。
Codex 呢? Codex 有自己的审批设置,结构与此类似。在房间中,按人授权和四类始终暂停的操作以完全相同的方式生效。
针对目录设置模式,针对人员设置授权,并让那四类操作按规矩询问。这就是整套模型。为你的 agent 建一个房间,亲自上手体验吧。
发布于