审批模式

Qwen Code 提供三种不同的权限模式，使您能够根据任务复杂度和风险等级，灵活控制 AI 与您的代码及系统的交互方式。

权限模式对比

模式	文件编辑	Shell 命令	适用场景	风险等级
Plan	❌ 仅支持只读分析	❌ 不执行	• 代码探索 • 规划复杂变更 • 安全的代码审查	最低
Default	✅ 需手动批准	✅ 需手动批准	• 新的/不熟悉的代码库 • 关键系统 • 团队协作 • 学习与教学	低
Auto-Edit	✅ 自动批准	❌ 需手动批准	• 日常开发任务 • 重构与代码优化 • 安全的自动化	中
YOLO	✅ 自动批准	✅ 自动批准	• 可信的个人项目 • 自动化脚本/CI/CD • 批量处理任务	最高

快速参考指南

以“计划模式”（Plan Mode）开始：适合在做出更改前先充分理解代码
在“默认模式”（Default Mode）下工作：适用于大多数开发工作的平衡之选
切换到“自动编辑模式”（Auto-Edit）：当你需要执行大量安全的代码修改时
谨慎使用“YOLO 模式”：仅限于受控环境中、可信的自动化任务

Tip

你可在会话中通过 Shift+Tab（Windows 上为 Tab）快速切换模式。终端状态栏会显示当前模式，让你随时清楚 Qwen Code 拥有哪些权限。

1. 使用“计划模式”进行安全的代码分析

“计划模式”会指示 Qwen Code 仅通过只读操作分析代码库并生成修改计划，非常适合探索代码库、规划复杂变更或安全地审查代码。

何时使用规划模式

多步骤实现：当你的功能需要修改多个文件时
代码探索：当你希望在修改任何内容之前，先全面调研代码库时
交互式开发：当你希望与 Qwen Code 迭代调整开发方向时

如何使用计划模式（Plan Mode）

在会话中启用计划模式

你可以在会话过程中通过 Shift+Tab（Windows 上为 Tab）循环切换权限模式，从而进入计划模式。

若当前处于普通模式（Normal Mode），按 Shift+Tab（Windows 上为 Tab）将首先进入 auto-edits 模式，终端底部会显示 ⏵⏵ accept edits on；再次按下 Shift+Tab（Windows 上为 Tab）即可进入计划模式，此时终端底部显示 ⏸ plan mode。

以计划模式启动新会话

要以计划模式启动新会话，请输入 /approval-mode 命令，然后选择 plan：


/approval-mode

在计划模式下运行“无界面”查询（headless queries）

你也可以直接使用 -p 参数或 --prompt 选项，在计划模式下运行查询：


qwen --prompt "什么是机器学习？"

示例：规划一次复杂的重构


/approval-mode plan


我需要将我们的认证系统重构为使用 OAuth2。请制定一份详细的迁移计划。

Qwen Code 会分析当前实现，并生成一份全面的计划。你可通过后续提问进一步细化：


向后兼容性如何保障？
数据库迁移应如何处理？

将计划模式设为默认模式


// .qwen/settings.json
{
  "permissions": {
    "defaultMode": "plan"
  }
}

2. 使用默认模式实现受控交互

默认模式是与 Qwen Code 协作的标准方式。在此模式下，你对所有潜在高风险操作保有完全控制权——Qwen Code 在修改任何文件或执行 Shell 命令前，均会主动请求你的批准。

何时使用默认模式

初次接触代码库：当你正在探索一个不熟悉的项目，并希望格外谨慎时
关键系统：当处理生产环境代码、基础设施或敏感数据时
学习与教学：当你希望了解 Qwen Code 执行的每一步操作时
团队协作：当多人共同开发同一代码库时
复杂操作：当变更涉及多个文件或复杂逻辑时

如何使用默认模式

在会话期间启用默认模式

你可以在会话中通过 Shift+Tab（Windows 上为 Tab）在权限模式间循环切换，从而进入默认模式。如果你当前处于其他任意模式，按 Shift+Tab（Windows 上为 Tab）最终将循环回到默认模式；此时终端底部不会显示任何模式指示符。

以默认模式启动新会话

Qwen Code 启动时的初始模式即为默认模式。如果你已切换过模式并希望返回默认模式，请运行：


/approval-mode default

在默认模式下运行“无头”查询

运行无头命令时，默认行为即为默认模式。你也可以显式指定该模式：


qwen --prompt "分析此代码是否存在潜在缺陷"

示例：安全地实现功能


/approval-mode default


我需要为我们的应用添加用户头像功能。头像应存储在 S3 存储桶中，并将对应 URL 保存至数据库。

Qwen Code 将分析你的代码库并提出实施计划。随后，它会在执行以下操作前请求批准：

创建新文件（控制器、模型、迁移文件）
修改现有文件（新增数据库字段、更新 API 接口等）
执行任何 Shell 命令（如数据库迁移、依赖安装）

你可以逐项审查每项拟议的变更，并分别批准或拒绝。

将默认模式设为默认行为


// .qwen/settings.json
{
  "permissions": {
    "defaultMode": "default"
  }
}

3. 自动编辑模式

自动编辑模式指示 Qwen Code 自动批准所有文件编辑操作，但对 Shell 命令仍需手动审批。该模式可在保障系统安全的前提下显著加速开发流程。

何时使用自动接受编辑模式

日常开发：适用于大多数编码任务
安全自动化：允许 AI 修改代码，同时防止意外执行危险命令
团队协作：在共享项目中使用，避免对他人造成意外影响

如何切换至此模式



# 通过命令切换
/approval-mode auto-edit

# 或使用快捷键
Shift+Tab（Windows 上为 Tab） # 从其他模式切换

工作流示例

你要求 Qwen Code 重构某个函数
AI 分析代码并提出修改建议
自动应用所有文件更改，无需确认
若需运行测试，它将请求批准以执行 npm test

4. YOLO 模式 —— 全自动模式

YOLO 模式赋予 Qwen Code 最高权限，自动批准所有工具调用，包括文件编辑和 Shell 命令。

何时使用 YOLO 模式

自动化脚本：运行预定义的自动化任务
CI/CD 流水线：在受控环境中自动执行
个人项目：在完全可信的环境中快速迭代
批量处理：需要多步命令链的任务

Warning

谨慎使用 YOLO 模式：AI 可凭借您终端的权限执行任意命令。请确保：

您信任当前代码库
您完全理解 AI 将执行的所有操作
重要文件已备份或已提交至版本控制系统

如何启用 YOLO 模式


# 临时启用（仅当前会话有效）
/approval-mode yolo

# 设为项目默认模式
/approval-mode yolo --project

# 设为用户全局默认模式
/approval-mode yolo --user

配置示例


// .qwen/settings.json
{
  "permissions": {
    "defaultMode": "yolo",
    "confirmShellCommands": false,
    "confirmFileEdits": false
  }
}

自动化工作流示例


 
# 全自动重构任务
qwen --prompt "运行测试套件，修复所有失败的测试，然后提交更改"
 
# 无需人工干预，AI 将自动完成：
 
# 1. 运行测试命令（自动批准）
 
# 2. 修复失败的测试用例（自动编辑文件）
 
# 3. 执行 git commit（自动批准）

模式切换与配置

键盘快捷键切换

在 Qwen Code 会话期间，使用 Shift+Tab（Windows 上为 Tab）快速循环切换以下三种模式：


默认模式 → 自动编辑模式 → YOLO 模式 → 规划模式 → 默认模式

持久化配置


// 项目级配置：./.qwen/settings.json
// 用户级配置：~/.qwen/settings.json
{
  "permissions": {
    "defaultMode": "auto-edit",  // 可选值："plan" 或 "yolo"
    "confirmShellCommands": true,
    "confirmFileEdits": true
  }
}

模式使用建议

初次接触代码库：从 计划模式（Plan Mode） 开始，以确保安全探索
日常开发任务：使用 自动接受编辑（Auto-Accept Edits）（默认模式），高效且安全
自动化脚本：在受控环境中使用 YOLO 模式（YOLO Mode） 实现完全自动化
复杂重构：先使用 计划模式（Plan Mode） 进行详细规划，再切换至合适模式执行