Claude Code 自动化配置:减少确认与等待
把 permissions.defaultMode 设为 auto,再配合 Bash 超时和工作区目录设置,Claude Code 会自行判断大部分工具调用,只在你真正需要决策时停下来。本页给出可直接复制到 ~/.claude/settings.json 的配置,并说明每一项解决什么实际问题。
配置只影响客户端行为,不会改变模型能力、计费规则或你的 API Key 权限。若尚未安装客户端,先按 Claude Code 安装指南 完成安装与密钥配置,再回到本页调整使用体验。
先分清三种「不顺畅」
多数人以为痛点是要不停点确认,实际排查下来,耗时通常来自另外三处。先定位再改配置,比一次性抄全套更有效。
| 现象 | 实际原因 | 对应设置 |
|---|---|---|
| 每条命令都要等几秒 | 自动模式的判定每次都要执行一遍 | 用 allow 规则让常见命令跳过判定 |
| 命令中途报超时失败 | Bash 默认超时为 120 秒,上限 600 秒 | BASH_DEFAULT_TIMEOUT_MS |
| 读取项目外文件时又问一次 | 路径不在工作目录内 | additionalDirectories |
其中第一条最值得理解:命中 allow 规则的工具调用不会进入判定流程,所以补充规则既减少询问,也减少等待。这是性价比最高的一项调整。
配置速查
把下面的内容写入 ~/.claude/settings.json。带 <尖括号> 的部分需要替换成你自己的值。配置文件允许 // 注释;如果你的版本不接受,删除注释后保存为纯 JSON 即可。
{
"permissions": {
"defaultMode": "auto",
"allow": [
"Bash(git status)",
"Bash(git diff *)",
"Bash(git log *)"
],
"deny": [
"Read(//home/<用户名>/.ssh/**)"
],
"ask": [
"Bash(git push --force*)",
"Bash(git reset --hard*)",
"Bash(rm -rf*)"
],
"additionalDirectories": [
"/home/<用户名>/deploy"
]
},
"env": {
"BASH_DEFAULT_TIMEOUT_MS": "300000",
"BASH_MAX_TIMEOUT_MS": "1800000"
}
}
若你使用本站的 Claude Code 接入,env 中的 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL 与模型变量按 DeepSeek 接入说明 或对应模型页面填写,不要与本页的 BASH_* 项混为一谈。
逐项说明
permissions.defaultMode 设为 auto 后,新会话直接进入自动模式,由客户端判断每条工具调用的放行与拦截。你也可以在交互界面按 Shift + Tab 循环切换,或启动时使用 claude --permission-mode auto。
permissions.allow 从窄到宽都可以,例如 Bash(git status)、Bash(go test *)。请注意宽规则有代价:Bash(bash *)、Bash(ssh *)、Bash(curl *) 这类写法在效果上接近「允许执行任意命令」,并且会让判定完全跳过。若你确实需要宽规则,必须同时用 deny 或 ask 兜底。
permissions.deny 与 permissions.ask 优先级为 deny 高于 ask、ask 高于 allow,因此它们可以覆盖较宽的 allow 规则。deny 是无条件拒绝;ask 是即使命中 allow 也强制询问。凭据目录建议放进 deny,破坏性命令建议放进 ask。
additionalDirectories 用于登记工作目录之外、但你需要经常读写的路径。未登记时,首次读取工作区外文件会额外询问一次。
BASH_DEFAULT_TIMEOUT_MS 与 BASH_MAX_TIMEOUT_MS 的默认值是 120 秒和 600 秒。编译、构建、跨机操作都容易触及上限,一旦超时就要重跑整轮。示例放宽到 5 分钟与 30 分钟,可按实际任务耗时调整。
让安全规则比判定更可靠
自动模式的判断由模型完成,属于概率性结论;而钩子(hook)是确定性规则。把已经踩过的坑写成钩子,就不必依赖模型每次都想起来。
钩子脚本遵循一个简单契约:退出码 0 表示放行,退出码 2 表示拦截并将标准错误内容回传给模型。脚本必须做到永不崩溃,否则一次异常会挡住所有命令,因此整体应包裹异常处理后放行。
#!/usr/bin/env python3
"""命令执行前检查:0 放行,2 拦截并回传原因。"""
import json, re, sys
def main():
try:
payload = json.load(sys.stdin)
if payload.get("tool_name") != "Bash":
sys.exit(0)
cmd = (payload.get("tool_input") or {}).get("command") or ""
if re.search(r"\brm\s+-rf\s+/(\s|$)", cmd):
sys.stderr.write("BLOCKED: 拒绝删除根目录\n")
sys.exit(2)
except SystemExit:
raise
except Exception:
pass
sys.exit(0)
if __name__ == "__main__":
main()
保存后在 settings.json 中登记绝对路径:
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [{ "type": "command", "command": "/绝对路径/guard-bash.py" }]
}
]
}
}
适合写进钩子的典型场景包括:删除根目录或通配删除、在生产数据库上执行删除或清空语句、把密钥直接写在命令行里。
验证改动是否生效
改动后用一个临时会话确认,无需改动正在工作的会话:
claude --permission-mode auto --debug-file /tmp/cc.debug -p 'echo hi'
grep -E 'verifyAutoModeGateAccess|Skipping auto mode classifier|classifier_request_finished' /tmp/cc.debug
canEnterAuto=true 表示自动模式可用;出现 Skipping auto mode classifier 表示该命令已被 allow 规则命中、跳过了判定;durationMs 的数值则是尚未覆盖的命令所产生的等待成本。
两个常见误区
第一,自动模式不是安全边界。它的判断跑在你配置的模型上,把它当作便利功能,安全仍然依靠 deny、ask 规则与钩子。
第二,非标准模型名会影响上下文压缩。若客户端不识别你的模型名,会给出提示并按假定的窗口大小执行自动压缩;实际窗口更小时可能迟迟不触发,最终请求失败。修法是设置 CLAUDE_CODE_MAX_CONTEXT_TOKENS,或在 modelPicker 中为该行补充 behavesAs,填入真实窗口值。填错比不填更糟。
建议的调整顺序
先只加 defaultMode 与 Bash 超时,使用一周;再查看 /permissions 中被拒绝的记录,把高频且安全的命令补进 allow;随后加 deny 与 ask 兜底,最后才考虑钩子与宽规则。一次改完容易掩盖问题来源,分步调整能清楚看到哪项真正解决了你的等待。
若配置后仍频繁出现鉴权或连接错误,请转到 连接与恢复;账户、余额与用量问题见 价格、余额与用量。
相关指南
Claude Code 安装、API 配置与 Windows 排错
安装 Claude Code,配置自定义 API 地址与密钥,验证 Windows、macOS、Linux 环境变量,排查 401、403、429 和连接问题,并了解 Claude Desktop、Kimi 与 GLM 的配置入口。
DeepSeek API 与 Claude Code 配置指南
使用 I Code Easy API Key 和 deepseek-flash 在 Claude Code 中接入 DeepSeek V4.1 Flash,包含 Windows、macOS、Linux 配置、验证与常见错误排查。
连接慢或请求失败时如何排查与恢复?
按 401、403、429、超时和 Gemini 路径错误分别检查。确认是网络慢之后,再改用 jp 或 sg 备用域名。