客户端集成进阶用户更新于

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 即可。

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 表示拦截并将标准错误内容回传给模型。脚本必须做到永不崩溃,否则一次异常会挡住所有命令,因此整体应包裹异常处理后放行。

python
#!/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 中登记绝对路径:

json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [{ "type": "command", "command": "/绝对路径/guard-bash.py" }]
      }
    ]
  }
}

适合写进钩子的典型场景包括:删除根目录或通配删除、在生产数据库上执行删除或清空语句、把密钥直接写在命令行里。

验证改动是否生效

改动后用一个临时会话确认,无需改动正在工作的会话:

bash
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 兜底,最后才考虑钩子与宽规则。一次改完容易掩盖问题来源,分步调整能清楚看到哪项真正解决了你的等待。

若配置后仍频繁出现鉴权或连接错误,请转到 连接与恢复;账户、余额与用量问题见 价格、余额与用量。