当 OpenCode 能够读取文件、修改代码、执行 Shell 命令并访问外部资源时，权限审批就不再只是一个“是否弹窗”的交互问题，而是开发效率与操作风险之间的工程权衡。策略过松，误删文件、泄露凭据或执行破坏性命令的风险会上升；策略过严，频繁确认又会打断思路，让自动化开发退化为不断点击批准。
先区分风险，而不是统一拦截
OpenCode 的权限规则通常可以产生三种结果：allow 表示直接执行，ask 表示请求用户批准，deny 表示明确阻止。规则还可以针对操作类型、命令或路径细化，而不是只能设置一个全局开关，具体语法应以所用版本的 OpenCode 权限文档 为准。
平衡审批体验的关键，是把操作按后果划分为不同等级。只读检索、查看版本状态和运行本地静态检查，通常具有较低风险；修改项目文件、安装依赖和访问网络属于中等风险；删除文件、向远端推送、读取敏感配置、访问工作区外目录以及执行来源不明的脚本，则应视为高风险操作。
- 低风险操作：在限定工作区内默认放行，例如读取普通源码、搜索文本、查看差异和执行不会修改状态的检查命令。
- 中风险操作：默认询问，并在审批界面展示目标、范围与预期影响，例如批量改写文件或更新依赖。
- 高风险操作：默认拒绝，确有需要时再通过临时、窄范围规则开放，不应依赖使用者每次保持警惕。
用“默认询问，精确例外”建立基线
较稳妥的初始策略是将未识别操作设置为 ask，再为高频且可预测的安全动作配置 allow，为不可接受的动作配置 deny。这样既能避免未知工具静默获取权限，也不会让每一次读取、搜索或测试都触发审批。OpenCode 的规则支持通配符匹配，并采用后匹配规则覆盖前面规则的方式，因此可以先写宽泛基线，再追加具体例外，规则顺序必须经过测试。
例如，团队可以允许查看仓库状态、运行测试和搜索源码，但将删除命令、强制推送、修改凭据文件以及访问项目外目录设为拒绝或询问。这里不应简单按“bash 是否危险”判断，而要关注具体命令、参数、目标路径和执行环境。同一个工具既可能运行无副作用的检查，也可能执行不可逆操作。
把审批范围压缩到最小
审批越宽泛，后续行为越难预测。一次批准最好只覆盖当前命令、当前文件或当前会话，避免把“允许修改某个生成文件”扩大成“允许修改整个主目录”。对于工作区外访问，尤其要采用明确的目录白名单，因为路径写法上的便利并不代表目标已经属于当前工作区；相关边界说明可参考 官方文档中的 External Directories。
敏感文件也应单独处理，例如环境变量文件、私钥、云平台凭据、生产配置和包含访问令牌的脚本。即使普通读取已被放行，也应通过更具体的规则阻止这些路径。对补丁涉及多个文件的场景，应以其中风险最高的目标决定审批结果，避免低风险文件掩盖敏感文件操作。
减少无价值弹窗，提高审批质量
开发流畅性并不等于减少所有提示，而是减少重复且没有决策价值的提示。审批界面应尽量回答三个问题：准备执行什么、会影响哪里、失败后能否恢复。对于文件修改，应展示路径和差异摘要；对于命令执行，应保留完整命令与参数；对于网络访问，应显示目标域名和用途。
可以允许用户对重复的低风险动作给予会话级授权，但不要轻易转化为永久全局授权。自动批准模式更适合隔离良好、权限有限且结果可回滚的环境；即便启用自动批准，明确的 deny 规则仍应作为底线。官方说明指出，自动模式只会自动处理原本需要询问的请求，不会绕过显式拒绝规则，详情见 Auto mode 说明。
不同环境采用不同策略
个人本地开发、共享开发机和持续集成环境不应使用同一套权限配置。本地环境可以对测试、格式化和仓库内编辑适度放行；共享环境应加强外部目录、网络和进程控制；持续集成环境没有人工审批条件，应采用预先定义的最小权限白名单，并通过容器、临时凭据和只读挂载限制影响范围。
团队还应对规则进行版本管理和代码评审。权限策略本质上属于安全配置，任何新增 allow 都应说明业务理由、适用范围和退出条件。定期检查审批日志，可以发现哪些提示频繁出现但风险很低，哪些规则过宽，以及是否存在持续被拒绝的异常工具调用。
一套可落地的实施顺序
- 盘点 OpenCode 实际使用的工具、命令、路径和外部服务。
- 将未知操作设为 ask，把明显不可逆或敏感的行为设为 deny。
- 从日志中识别高频低风险操作，为其建立精确 allow 规则。
- 对写入、联网和工作区外访问保留上下文完整的审批提示。
- 在沙箱或测试仓库中验证规则顺序、通配符和路径边界。
- 定期收缩临时授权，删除不再使用的例外，并复核版本升级带来的配置变化。
好的权限策略不是让 OpenCode“什么都不能做”，也不是让它“什么都自动做”，而是让可预测、可回滚的动作快速通过，让不可逆、越界或涉及秘密信息的动作被可靠拦住。
总结
OpenCode 权限审批的最佳平衡点来自分级治理：低风险动作精确放行，中风险动作提供高质量审批，高风险动作默认拒绝；同时按命令、路径、会话和环境缩小授权范围。先建立保守基线，再根据真实使用记录逐步优化，比一次性开放大量权限更安全，也更容易形成稳定、流畅且可审计的开发体验。
