Claude Code 的常见权限模式
- 在 Claude Code CLI 中,可以使用
Shift + Tab切换常见权限模式。- 严格来说,官方把它们称为“Permission Modes(权限模式)”,用于控制 Claude 在编辑文件、运行命令、访问网络前是否需要询问你。
- 本文主要介绍日常最常见的四种:默认模式、自动编辑模式、规划模式和 YOLO 模式。Claude Code 还支持
auto、dontAsk等权限模式,但它们更偏特定环境或自动化场景,普通用户不一定会用到。
1. 默认模式:最稳妥
默认模式是刚进入 Claude Code 时最常见的状态,也最适合新手和重要项目。
在这种模式下,Claude Code 可以读取项目内容,但当它要修改文件、创建文件、执行 shell 命令或发起网络请求时,通常会先停下来询问你。你可以逐步确认它的每一个动作,权限最保守,但交互也最多。
输入框下方显示的 ? for shortcuts 不是某个工作模式的名称,而是快捷键提示:按 ? 可以查看快捷键说明。
适合场景:
- 第一次接触 Claude Code
- 修改生产项目、重要项目
- 不确定 AI 会怎么改代码时
- 想逐步审查每个操作时
2. 自动编辑模式:最适合日常改代码
自动编辑模式对应官方的
acceptEdits。输入框下方显示 ⏵⏵ accept edits on
开启后,Claude Code 可以在当前工作目录内自动创建和修改文件,不再对每一次文件编辑都询问你。这是日常开发里非常常用的模式,因为它能明显减少确认次数。
但要注意:它不是“完全不询问”。对于很多 shell 命令、访问工作目录之外的路径、写入受保护路径等操作,Claude Code 仍然可能要求你确认。
适合场景:
- 你已经明确要让 Claude Code 修改代码
- 想提高开发效率
- 可以通过编辑器或
git diff事后审查改动 - 项目在 Git 管理下,方便回滚
一句话理解:默认模式是“每一步都看着改”,自动编辑模式是“文件你先改,我稍后看 diff”。
3. 规划模式:只讨论,不动手
规划模式对应官方的
plan。输入框下方显示 ⏸ plan mode on
这个模式适合在真正写代码之前,让 Claude Code 先理解项目、分析需求、拆解方案、列出实现计划。它不会直接修改你的源码。
在规划模式下,Claude Code 可以阅读文件,也可能为了理解项目而请求运行一些探索性命令,但文件编辑不会直接发生。等计划完成后,你可以选择继续讨论,也可以批准它进入执行阶段。
适合场景:
- 项目开发初期
- 需求还没想清楚
- 要做架构调整、复杂重构
- 想先评审 AI 的方案,再决定是否执行
建议用法:复杂任务先开规划模式,把方案聊清楚,再切到自动编辑模式执行。
4. YOLO 模式:权限最大,风险也最大
大家常说的 YOLO 模式,对应官方的
bypassPermissions。可以通过下面的方式启动:
claude --dangerously-skip-permissions
也可以使用等价写法:
claude --permission-mode bypassPermissions
这个模式会跳过权限提示和大部分安全确认,让 Claude Code 的工具调用直接执行。换句话说,它拥有非常高的自主权,能编辑文件、运行命令,风险也最高。
官方也明确建议:只在隔离环境中使用,比如容器、虚拟机、dev container,最好不要直接在你的主力电脑、重要项目或生产环境里使用。
适合场景:
- 临时实验项目
- 容器或虚拟机环境
- 可以随时销毁的测试目录
- 你完全理解风险,并且有备份或 Git 保护
不适合场景:
- 公司生产项目
- 有敏感数据的目录
- 你的用户主目录
- 没有 Git 或备份的项目
小结
| 模式 | 官方名称 | 特点 | 适合场景 |
|---|---|---|---|
| 默认模式 | default | 读取为主,修改和命令通常要确认 | 新手、重要项目 |
| 自动编辑模式 | acceptEdits | 自动接受文件编辑,但不是所有命令都放行 | 日常开发 |
| 规划模式 | plan | 先分析和制定方案,不直接改源码 | 架构设计、复杂需求 |
| YOLO 模式 | bypassPermissions | 跳过权限提示,风险最高 | 隔离环境、临时实验 |
我的建议是:
日常开发优先用“默认模式 + 自动编辑模式”;复杂任务先用“规划模式”;YOLO 模式只放在容器或虚拟机里用,不要在重要项目里裸奔。