规划与权限


先规划后实施

规划模式适用于需求尚未明确、修改范围较大,或需要先审查方案的任务。Claude Code 可读取资料、分析结构并提出计划,通常不直接编辑源文件。可在启动时使用 claude --permission-mode plan,或在会话中通过 /plan 提出规划任务。

/plan 请为{现有内容管理项目}规划“{按标签筛选文章}”功能。

请先检查现有页面、数据结构和相关测试。
方案应包含:{用户操作流程、涉及文件、接口影响、实施步骤和验证方法}。

优先复用现有组件,不新增无关功能。
如存在多种方案,请说明各自的维护成本和适用条件。
本轮先完成方案,暂不进入实施。

计划出现后,应检查其是否覆盖实际需求,并确认影响范围和检查方法。可以要求继续修改计划,也可选择批准执行及相应权限模式。批准后,后续操作按所选模式处理,不应认为“批准计划”等同于所有后续动作均无须检查。

image-20261025163038590

理解权限模式

权限模式决定哪些操作需要询问、哪些操作可以直接进行。当前版本的交互式终端和 VS Code 已支持以 auto 作为内置起始模式;用户配置、组织策略、模型和版本仍可能改变实际行为。使用前应查看状态栏,确认当前模式。

模式主要行为使用考虑
Manual,配置值 default对文件编辑和多数命令进行审批适合逐项了解实际操作
acceptEdits自动接受文件编辑及范围内部分常见文件系统命令适合已明确修改范围,并在执行后检查差异
plan先调研与规划,通常不改源文件适合方案审查及复杂任务拆解
auto由独立分类器审查相关动作,减少常规询问适合目标明确且能够核验结果的任务
dontAsk通常拒绝原本需要弹出询问的操作适合已配置明确允许范围的流程
bypassPermissions跳过大部分审批应限于充分隔离、可承受影响的环境

auto 不等于跳过检查;acceptEdits 也不等于只允许修改文本。规划模式可以执行符合当前审批规则的探索命令,不能将其视为覆盖一切操作的只读沙盒。尤其在已启用绕过权限能力的交互会话中,不应依赖 Plan 模式阻止实际变更。

会话中可按 Shift+Tab 切换权限模式,具体次数取决于起始模式及可用选项,应以状态栏为准。希望逐项确认时,可显式使用以下方式启动:

claude --permission-mode default

审查操作请求

出现审批请求时,应先检查动作内容、目标路径和作用范围,再决定是否允许。命令名称相同,不代表执行影响相同;例如查看 Git 状态、创建提交和推送远端是不同操作,应分别理解。

对于当前无法判断的命令,可先要求说明用途、输入、输出及可能影响。需要长期允许某类操作时,应选择足够具体的范围,避免将一次性需求扩大为不必要的长期授权。

image-20261025164009199

/permissions 可查看和管理规则。规则按拒绝、询问、允许的顺序匹配,较具体的允许规则不能覆盖已经匹配的拒绝规则。项目说明和提示词用于表达要求,权限规则用于限制实际调用,两者应配合使用。

image-20261025163739791

评论

登录后查看