它到底是什么

--permission-mode 用于在会话启动时指定 Claude Code 的权限模式，决定 Claude 在执行文件编辑、运行 shell 命令等操作前是否需要先征得用户同意。

官方文档（permission-modes 页）确认的可选模式：

• default（官方文档原文："Manual mode appears under its config value, default"，即用户界面里显示为 "Manual" 模式）— Claude 在大多数会修改文件、执行 shell 命令或访问网络的操作前会先停下来询问
• plan — Claude 只做调研、探索并给出方案，不修改代码（官方示例：claude --permission-mode plan）
• acceptEdits — 自动接受文件编辑权限，不逐次询问
• bypassPermissions — 跳过所有权限提示；官方文档明确警告不要在能触及生产环境的仓库中开启此模式
• auto — 官方文档描述的模式，由第二个模型（"classifier"）代替用户审核动作；在 Pro / Max / Team 套餐中，这是账号的默认起始权限模式

默认值：非交互（-p）模式下默认为 default；交互会话的起始模式则取决于套餐与配置（如 Pro/Max/Team 套餐默认起始模式为 auto）。

--permission-mode 的优先级高于 settings.json 中的 defaultMode 设置，即命令行传入的值会覆盖配置文件。

用法

claude --permission-mode plan

等价 settings.json 字段：

{ "defaultMode": "plan" }

与其他 flag 的组合 / 互斥

--dangerously-skip-permissions 在效果上等同于直接指定 --permission-mode bypassPermissions —— 两者都会跳过全部权限提示，包括 shell 命令的确认。

settings.json / env 的等价配置

经典使用场景

• plan：先看 Claude 会做什么改动再决定是否放行，适合代码审查、学习类场景
• acceptEdits：快速原型开发、在可信项目里希望减少逐次确认
• bypassPermissions：仅限容器 / 虚拟机等与生产环境隔离的自动化环境（官方文档明确的安全边界）

常见坑

• 不要在可触达生产环境的仓库里用 bypassPermissions：官方文档明确指出该模式连 shell 命令的确认也会跳过，只应在隔离的容器、VM 等无法连接生产系统的环境中使用
• CLI flag 会覆盖 settings.json 的 defaultMode：如果发现指定的 --permission-mode 没有按预期生效，先排查是否有别的命令行参数（如 --dangerously-skip-permissions）一起传入产生冲突

来源

• CLI reference - Claude Code Docs
• Choose a permission mode - Claude Code Docs
• How to Set Claude Code Permission Mode | ClaudeLog