随着 Claude Code v2.1.200 将默认权限模式从 "default" 更名为 "Manual"，本文提供一份最新、完整的权限模式使用指南，帮你根据实际场景选择合适的权限策略。
四种权限模式总览
| 模式 | 命令行参数 | 行为特点 | 适用场景 |
|---|---|---|---|
| Manual（原 default） | --permission-mode manual | 每次工具调用都需手动确认 | 首次使用、高风险操作、学习阶段 |
| Plan | --permission-mode plan | 只读分析，不执行任何修改 | 代码审查、方案设计、探索代码库 |
| Accept Edits | --permission-mode acceptEdits | 自动接受文件编辑，其他操作仍需确认 | 日常开发，信任编辑但谨慎对待命令执行 |
| Bypass | --permission-mode bypassPermissions | 跳过所有权限检查 | CI/CD、沙箱环境、完全自动化任务 |
Manual 模式详解（新默认名称）
Manual 是最安全的模式，也是新手第一次使用 Claude Code 时的推荐起点。
bash
claude --permission-mode manual
# 或在 settings.json 中设置json
{
"defaultMode": "manual"
}在这个模式下，每当 Claude 想要：
- 读写文件
- 执行 Bash 命令
- 调用 MCP 工具
- 启动子代理
都会弹出确认提示，等待你按 y（允许）、n（拒绝）或 a（永久允许该操作类型）。
Plan 模式详解
Plan 模式下，Claude 只能读取和分析代码，不能执行任何修改操作。适合：
bash
claude --permission-mode plan
> 分析这个项目的架构，找出潜在的性能瓶颈
# Claude 只读分析，输出建议报告，不会修改任何文件Accept Edits 模式详解
这是许多资深用户日常使用的模式：信任 Claude 的文件编辑，但仍对命令执行保持警惕。
bash
claude --permission-mode acceptEditsjson
{
"defaultMode": "acceptEdits",
"permissions": {
"ask": ["Bash(rm*)", "Bash(git push*)"]
}
}Bypass 模式详解（高风险）
跳过所有权限检查，通常只在隔离的沙箱环境（如 Docker 容器、CI Runner）中使用。
bash
# 危险：仅在隔离环境中使用！
claude --dangerously-skip-permissions安全建议：永远不要在生产服务器或包含敏感数据的机器上使用 Bypass 模式。
参数级权限控制（Week 25 新增能力）
结合 Claude Code Week 25 引入的参数级权限规则，可以做更精细的控制：
json
{
"permissions": {
"deny": [
"Agent(model:opus)",
"Bash(command:rm -rf*)"
],
"ask": [
"Bash(git push*)"
],
"allow": [
"Read(*)",
"Edit(*.py)"
]
}
}团队场景推荐配置
json
// .claude/settings.json（团队共享配置）
{
"defaultMode": "acceptEdits",
"permissions": {
"deny": [
"Bash(rm -rf*)",
"Bash(git push --force*)",
"Agent(model:opus)"
],
"ask": [
"Bash(git push*)",
"Bash(npm publish*)"
]
}
}快速切换模式（会话内）
bash
# 在会话中直接用 /config 切换（Week 25 新增）
> /config permission-mode=plan
# 或使用快捷键循环切换（Shift+Tab）总结
- 新手/首次使用：Manual（原 default）
- 只想看方案不想改代码：Plan
- 日常开发主力模式：Accept Edits + 精细化 deny/ask 规则
- CI/CD/沙箱自动化：Bypass（务必隔离环境）
v2.1.200 的改名让这套体系的命名更加直观：Manual 意味着「你说了算，每一步」，这比含糊的 "default" 更清楚地传达了模式的核心行为。
来源：Claude Code Permission Modes 与 Changelog v2.1.200 — Anthropic，2026-07