开发实践

操作权限与工具审批

分别设置工具审批与全局、项目、会话沙箱,核对命令和安装授权的实际范围。

需要让码哥读写文件、运行命令的成员约 8 分钟阅读
操作入口
编码输入框旁 → 操作权限 / 会话沙箱;设置 → 常规 → 安全与权限
完成结果
能核对沙箱的实际生效范围、工具审批方式和单次安装授权,确认执行结果。
本篇目录

1. 在执行前选择权限方式

桌面端在编码输入框旁点击当前权限名称,打开「操作权限」。这里决定 AI 调用工具时如何确认,不是模型使用授权;更换权限方式不能解决账号或模型不可用问题。

1. 在执行前选择权限方式参考表
桌面端选项适用行为
请求批准编辑文件、执行命令和访问外部资源前询问。
按需审批自动接受项目内编辑,对检测到的风险操作询问。
完全访问权限常规操作沿用会话授权,沙箱范围由独立设置控制;仍需确认要求单次批准的操作。
计划模式分析并制定计划,不修改文件或执行命令。

2. 读清请求后再批准

码哥工具调用审批窗口,展示运行测试的命令、项目目录、授权范围和审批按钮
实际工具审批卡片:核对测试命令 pnpm run test、项目目录和授权范围,再选择拒绝、允许一次或卡片提供的会话范围选项。 真实产品界面 · 演示数据
  1. 任务出现审批卡片时,查看工具名称、目标文件或命令参数。
  2. 核对执行目录、涉及路径与请求的网络或外部资源,确认与任务范围一致。
  3. 涉及脚本时检查实际行为;看不懂时先要求解释,必要时拒绝并提出更小范围的方案。
  4. 只需要本次执行时选择「允许一次」;需要会话范围授权时,先理解卡片说明和后续任务边界。
  • 是否会安装依赖、覆盖文件或删除数据?
  • 连接的是本地测试环境还是生产服务?
  • 是否会上传内容、改变远端状态或使用敏感凭据?

3. 区分单次、会话与额外授权

部分请求提供「本次会话全部允许」,部分沙箱外执行只提供本次授权。以实际卡片列出的选项为准,不把一次批准理解为永久允许。跨工作区访问也可能单独请求路径授权,需要重新核对目标。

  1. 范围不符合预期时点击「拒绝」,在对话中补充允许的目录或替代命令。
  2. 只分析方案时使用「计划模式」,确认后再选择可执行的权限方式继续。
  3. 切换模式后查看当前选中状态;若切换失败,先处理错误,不假设新权限已生效。

4. 按全局、项目和会话设置沙箱

沙箱控制工具可操作的范围,审批决定操作是否需要批准,两者分别配置。全局默认开启;项目与会话可继承上级、单独开启或关闭。一般按会话、项目、全局顺序确定生效值,管理员策略可约束选择。

  1. 在「设置 → 常规 → 安全与权限」检查「默认开启工作区沙箱」。未单独设置的项目与新会话继承此值。
  2. 需要对项目单独设置时,进入项目权限中的「工作区沙箱」;也可从输入框旁的会话沙箱面板进入「项目设置」。
  3. 仅调整当前会话时,打开「会话沙箱设置」,选择继承、开启或关闭,查看状态和设置来源。
  4. 设置自动保存。运行中变更显示「下一批工具调用生效」时,当前操作继续按原设置执行,等待新设置实际生效。

5. 单独核对全局工具安装

沙箱开启时,安装到系统或用户环境的工具需要单次人工授权。「完全访问权限」或已记住的常规会话授权不会跳过这一步。明确安装在项目内的依赖继续按原有规则处理。

  1. 阅读安装命令、安装位置与影响的执行电脑,区分项目依赖、用户环境和系统安装。
  2. 核对单次授权提示后决定允许或拒绝;拒绝时可要求采用已有工具或项目内方案。
  3. 查看真实退出码、安装日志和最终检查,确认安装确实完成。管道后附加日志裁剪命令仍可能显示文本,不能据此把前一步失败当作成功。

6. 卡住或拒绝后如何继续

反馈异常时记录执行电脑、时间、权限模式、沙箱来源、工具名、脱敏参数与错误提示。会话范围授权可从输入框上方关闭,不影响其他会话。

  1. 任务停住时先区分等待前序任务、等待授权与执行中,再检查当前卡片是否仍等待决定,不要重复发送相同任务。
  2. 误拒绝后说明你允许的具体操作,让码哥重新提出必要请求。
  3. 审批或沙箱设置保存失败时,保留错误并重新加载状态;确认连接恢复后再重试,不假设新权限已经生效。
  4. 任务完成后查看工具输出与修改内容,再运行相应检查;获准执行不等于执行成功。