Use Claude Code

Permission modes

Permission modes 这一页讲的，就是 Permission modes 这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

Choose a permission mode

页面性质

第三方中文解释页

使用建议

先看人话解释，再对照原页命令和代码

这页不是官方原文，而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留，解释部分则尽量讲成人能照着做的话。

如果你碰到特别敏感的配置、权限或企业环境差异，最好顺手点上面的“查看原始文档”再核一遍。

这一页先讲明白

这页主要讲 Permission modes：Control whether Claude asks before editing files or running commands. Cycle modes with Shift+Tab in the CLI or use the mode selector in VS Code, Desktop, and claude.ai.

你可以把它当成"Use Claude Code"这块里专门管这一摊事的说明书。

你可以把"Permission modes"理解成 Use Claude Code 这一栏里的一把专门工具。这页不是让你背书，而是教你什么时候该把这把工具拿出来。

原文这页大多会按 Available modes、Switch permission modes、Auto-approve file edits with acceptEdits mode、Analyze before you edit with plan mode 这些环节往下讲。

翻成人话，大概就是：Switch permission modes

第一，先别一上来全开全配。先按最小一步试通，确认没跑偏，再继续往下加。

第二，命令、配置名、参数名这些硬东西尽量保留原样。人话解释是帮你听懂，不是帮你改关键字。

第三，照着原文这几个环节挨个过：Available modes -> Switch permission modes -> Auto-approve file edits with acceptEdits mode -> Analyze before you edit with plan mode。像下地先看水路、再试机器、再正式开干，一步一步最稳。

终端里敲

原页关键片段：Switch permission modes 1

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

claude --permission-mode plan

改配置

原页关键片段：Switch permission modes 2

这一段说完，最后还得写到配置里才算真的生效。

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

终端里敲

原页关键片段：Switch permission modes 3

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

claude remote-control --permission-mode acceptEdits

终端里敲

原页关键片段：Auto-approve file edits with acceptEdits mode

真到动手的时候了，下面这条直接敲一遍，看它回什么。

claude --permission-mode acceptEdits

终端里敲

原页关键片段：Analyze before you edit with plan mode

真到动手的时候了，下面这条直接敲一遍，看它回什么。

claude --permission-mode plan

改配置

原页关键片段：Set plan mode as the default

光知道意思还不够，这里得把规矩落进配置里，下面这块照着填。

{
  "permissions": {
    "defaultMode": "plan"
  }
}

终端里敲

原页关键片段：Allow only pre-approved tools with dontAsk mode

先别急着往下翻，下面这条命令跑完，心里才有底。

claude --permission-mode dontAsk

终端里敲

原页关键片段：Skip all checks with bypassPermissions mode

先别急着往下翻，下面这条命令跑完，心里才有底。

claude --permission-mode bypassPermissions

预留广告位

正文中段响应式广告 等你后面真接 AdSense，这里再放正式广告。

Documentation Index

这里不是让你背"Documentation Index"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Available modes

这一块主要是在说"Available modes"真到手上该怎么用，哪里最容易踩坑。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

Switch permission modes

看到这里，就把"Switch permission modes"当成一件真要上手的活来看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

终端里敲

Switch permission modes 1

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

claude --permission-mode plan

改配置

Switch permission modes 2

这一段说完，最后还得写到配置里才算真的生效。

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

终端里敲

Switch permission modes 3

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

claude remote-control --permission-mode acceptEdits

Auto-approve file edits with acceptEdits mode

这里不是让你背"Auto-approve file edits with acceptEdits mode"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

终端里敲

Auto-approve file edits with acceptEdits mode

真到动手的时候了，下面这条直接敲一遍，看它回什么。

claude --permission-mode acceptEdits

Analyze before you edit with plan mode

这里不是让你背"Analyze before you edit with plan mode"这个词，而是让你看它真干活时怎么使。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

终端里敲

Analyze before you edit with plan mode

真到动手的时候了，下面这条直接敲一遍，看它回什么。

claude --permission-mode plan

Review and approve a plan

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Set plan mode as the default

这里不是让你背"Set plan mode as the default"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

改配置

Set plan mode as the default

光知道意思还不够，这里得把规矩落进配置里，下面这块照着填。

{
  "permissions": {
    "defaultMode": "plan"
  }
}

Eliminate prompts with auto mode

看到这里，就把"Eliminate prompts with auto mode"当成一件真要上手的活来看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

What the classifier blocks by default

这段看着像个标题，其实是在说"What the classifier blocks by default"管到哪儿。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Boundaries you state in conversation

这段看着像个标题，其实是在说"Boundaries you state in conversation"管到哪儿。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

When auto mode falls back

When auto mode falls back 到底什么时候值得上，这一段就是在算这笔账。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Allow only pre-approved tools with dontAsk mode

这一段主要是在把"Allow only pre-approved tools with dontAsk mode"讲实，不是只摆个标题给你看。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

终端里敲

Allow only pre-approved tools with dontAsk mode

先别急着往下翻，下面这条命令跑完，心里才有底。

claude --permission-mode dontAsk

Skip all checks with bypassPermissions mode

这一段主要是在把"Skip all checks with bypassPermissions mode"讲实，不是只摆个标题给你看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

终端里敲

Skip all checks with bypassPermissions mode

先别急着往下翻，下面这条命令跑完，心里才有底。

claude --permission-mode bypassPermissions

Protected paths

这里不是让你背"Protected paths"这个词，而是让你看它真干活时怎么使。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

第 1 步：Switch permission modes 1

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

claude --permission-mode plan

改配置

第 2 步：Switch permission modes 2

这一段说完，最后还得写到配置里才算真的生效。

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

终端里敲

第 3 步：Switch permission modes 3

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

claude remote-control --permission-mode acceptEdits

终端里敲

第 4 步：Auto-approve file edits with acceptEdits mode

真到动手的时候了，下面这条直接敲一遍，看它回什么。

claude --permission-mode acceptEdits

一眼看懂这一页

先把这页到底在讲什么看明白，再去碰具体命令和配置，最不容易绕晕。

Permission modes
   |
   v
这是 Use Claude Code 里的一摊要紧活
   |
   v
先弄懂，再下手

文末提醒

这站会按官方 docs 的导航和内容变化继续重生成，原站加页、删页、改页时，这里会跟着更新。

人话解释会尽量顺着原页往下讲，但命令、参数名、配置名这些硬东西还是保留原样，免得你抄过去跑不起来。