![[claude code] 04 进阶篇：权限、Hooks 与自动化](http://pic.xiahunao.cn/yaotu/[claude code] 04 进阶篇：权限、Hooks 与自动化)
04 进阶篇权限、Hooks 与自动化精细控制 Claude Code 的行为边界让 AI 安全地为你工作。4.1 分层权限系统Claude Code 的权限系统分为三层权限模式粗粒度 → allow/deny 规则细粒度 → 沙盒隔离层权限模式回顾模式读取编辑命令切换方式普通模式自动需确认需确认ShiftTab自动接受编辑自动自动需确认ShiftTab计划模式自动不执行不执行ShiftTab4.2 allow/deny 规则配置配置文件位置文件作用范围优先级~/.claude/settings.json全局所有项目低.claude/settings.json项目团队共享中.claude/settings.local.json项目个人高规则语法{permissions:{allow:[Read,Glob,Grep,Bash(npm run test),Bash(npm run build),Bash(git status),Bash(git diff),Bash(git log*)],deny:[Bash(rm -rf *),Bash(git push --force),Bash(curl * | bash),Read(./.env*),Read(./**/secrets/*)]}}规则匹配模式模式含义示例Read允许/拒绝所有读取读取任意文件Write允许/拒绝所有写入修改任意文件Bash(npm run test)精确匹配命令仅匹配npm run testBash(npm run:*)前缀匹配冒号分隔匹配npm run test、npm run build等Bash(git *)通配符匹配匹配所有 git 命令Read(./.env*)Glob 匹配文件路径匹配.env、.env.local等实战配置示例前端项目{permissions:{allow:[Read,Glob,Grep,Bash(npm run:*),Bash(npx:*),Bash(git *),Bash(node *)],deny:[Bash(npm publish*),Bash(git push --force*),Read(./.env*)]}}Python 项目{permissions:{allow:[Read,Glob,Grep,Bash(python *),Bash(pytest *),Bash(pip install *),Bash(git *),Bash(poetry *)],deny:[Bash(pip install --user *),Bash(git push --force*),Read(./**/credentials*)]}}最佳实践先用普通模式观察 Claude 常用哪些命令再逐步添加 allow 规则始终添加 deny 规则保护危险操作rm -rf、git push --force敏感文件用Read(./path*)deny 规则保护不要使用--dangerously-skip-permissions除非在 CI 等受信环境4.3 Hooks 系统Hooks 是 Claude Code 的自动化引擎在特定生命周期事件触发时执行自定义命令。8 大生命周期事件事件触发时机可用变量能否阻断典型用途SessionStart会话开始无否环境初始化UserPromptSubmit用户按回车前prompt是危险指令过滤PreToolUse工具执行前tool_name,tool_input是权限审计PostToolUse工具执行后tool_name,tool_input,tool_output否自动格式化NotificationClaude 需要用户输入notification_text否桌面通知Stop响应完全结束无否摘要日志SubagentStop子代理任务结束subagent_name,result否子任务统计PreCompact对话压缩前无否备份历史Hook 配置结构{hooks:{事件名:[{matcher:匹配模式正则,hooks:[{type:command,command:要执行的 shell 命令}]}]}}可用环境变量变量含义适用事件$CLAUDE_TOOL_NAME被调用的工具名PreToolUse, PostToolUse$CLAUDE_TOOL_INPUT工具输入JSONPreToolUse, PostToolUse$CLAUDE_TOOL_INPUT_FILE_PATH文件路径文件操作工具$CLAUDE_TOOL_OUTPUT工具输出JSONPostToolUse$CLAUDE_PROMPT用户提示文本UserPromptSubmit4.4 Hook 实战示例示例一自动格式化PostToolUse每次 Claude 编辑文件后自动运行 Prettier{hooks:{PostToolUse:[{matcher:Write|Edit,hooks:[{type:command,command:npx prettier --write \$CLAUDE_TOOL_INPUT_FILE_PATH\ 2/dev/null || true}]}]}}示例二ESLint 检查PostToolUse编辑 JS/TS 文件后自动 lint{hooks:{PostToolUse:[{matcher:Write|Edit,hooks:[{type:command,command:npx eslint \$CLAUDE_TOOL_INPUT_FILE_PATH\ --fix 2/dev/null || true}]}]}}示例三安全审计PreToolUse阻止 Claude 读取敏感文件{hooks:{PreToolUse:[{matcher:Read,hooks:[{type:command,command:echo \$CLAUDE_TOOL_INPUT\ | jq -r .file_path | grep -qE \\.(env|key|pem)$ echo BLOCK: 不允许读取敏感文件 exit 1 || exit 0}]}]}}示例四桌面通知NotificationClaude 需要输入时发送系统通知{hooks:{Notification:[{matcher:,hooks:[{type:command,command:osascript -e display notification \Claude Code 需要你的输入\ with title \Claude Code\}]}]}}Linux 替代方案{command:notify-send Claude Code 需要你的输入}Windows 替代方案{command:powershell -Command \[System.Reflection.Assembly]::LoadWithPartialName(System.Windows.Forms); [System.Windows.Forms.MessageBox]::Show(Claude Code 需要你的输入, Claude Code)\}示例五会话日志Stop每次会话结束记录摘要{hooks:{Stop:[{matcher:,hooks:[{type:command,command:echo \[$(date %Y-%m-%d %H:%M)] Session ended in $(pwd)\ ~/.claude/session-log.txt}]}]}}示例六Python 自动格式化PostToolUse{hooks:{PostToolUse:[{matcher:Write|Edit,hooks:[{type:command,command:echo \$CLAUDE_TOOL_INPUT\ | jq -r .file_path | grep -qE \\.py$ black \$CLAUDE_TOOL_INPUT_FILE_PATH\ 2/dev/null || true}]}]}}4.5 自动化工作流工作流一代码质量门禁{hooks:{PostToolUse:[{matcher:Write|Edit,hooks:[{type:command,command:FILE\$CLAUDE_TOOL_INPUT_FILE_PATH\; case \$FILE\ in *.py) black \$FILE\ flake8 \$FILE\;; *.ts|*.tsx) npx prettier --write \$FILE\ npx eslint \$FILE\ --fix;; *.go) gofmt -w \$FILE\;; esac 2/dev/null || true}]}]}}工作流二自动测试{hooks:{PostToolUse:[{matcher:Write|Edit,hooks:[{type:command,command:FILE\$CLAUDE_TOOL_INPUT_FILE_PATH\; case \$FILE\ in *test*.py) pytest \$FILE\ -q;; *test*.ts) npx jest \$FILE\;; esac 2/dev/null || true}]}]}}工作流三Git 安全防护{hooks:{PreToolUse:[{matcher:Bash,hooks:[{type:command,command:echo \$CLAUDE_TOOL_INPUT\ | jq -r .command | grep -qiE (push --force|reset --hard|clean -f|rm -rf /) echo BLOCK: 危险 Git 操作被阻止 exit 1 || exit 0}]}]}}4.6 沙盒模式在隔离环境中运行命令防止意外损害{security:{sandbox:true}}沙盒模式下Claude 执行的命令被限制在安全范围内。最佳实践生产环境或共享服务器上建议开启沙盒模式。4.7 Hook 注意事项注意事项说明保持轻量Hook 在每次工具调用时执行慢 Hook 会严重拖慢体验错误容忍用2/dev/null || true防止 Hook 报错阻断流程matcher 是正则Write|Edit匹配 Write 或 Edit 工具阻断返回非零PreToolUse Hook exit 1 会阻断工具执行配置位置全局~/.claude/settings.json或项目.claude/settings.local.json4.8 小结概念关键要点权限模式三种模式ShiftTab 切换allow/deny细粒度控制支持精确匹配和通配符Hooks8 大生命周期事件实现自动化常用 Hook格式化、lint、安全审计、通知沙盒生产环境建议开启Hook 原则轻量、容错、正则匹配上一篇03 项目篇CLAUDE.md 与项目配置下一篇05 实战篇MCP 服务器与技能扩展
04 进阶篇权限、Hooks 与自动化精细控制 Claude Code 的行为边界让 AI 安全地为你工作。4.1 分层权限系统Claude Code 的权限系统分为三层权限模式粗粒度 → allow/deny 规则细粒度 → 沙盒隔离层权限模式回顾模式读取编辑命令切换方式普通模式自动需确认需确认ShiftTab自动接受编辑自动自动需确认ShiftTab计划模式自动不执行不执行ShiftTab4.2 allow/deny 规则配置配置文件位置文件作用范围优先级~/.claude/settings.json全局所有项目低.claude/settings.json项目团队共享中.claude/settings.local.json项目个人高规则语法{permissions:{allow:[Read,Glob,Grep,Bash(npm run test),Bash(npm run build),Bash(git status),Bash(git diff),Bash(git log*)],deny:[Bash(rm -rf *),Bash(git push --force),Bash(curl * | bash),Read(./.env*),Read(./**/secrets/*)]}}规则匹配模式模式含义示例Read允许/拒绝所有读取读取任意文件Write允许/拒绝所有写入修改任意文件Bash(npm run test)精确匹配命令仅匹配npm run testBash(npm run:*)前缀匹配冒号分隔匹配npm run test、npm run build等Bash(git *)通配符匹配匹配所有 git 命令Read(./.env*)Glob 匹配文件路径匹配.env、.env.local等实战配置示例前端项目{permissions:{allow:[Read,Glob,Grep,Bash(npm run:*),Bash(npx:*),Bash(git *),Bash(node *)],deny:[Bash(npm publish*),Bash(git push --force*),Read(./.env*)]}}Python 项目{permissions:{allow:[Read,Glob,Grep,Bash(python *),Bash(pytest *),Bash(pip install *),Bash(git *),Bash(poetry *)],deny:[Bash(pip install --user *),Bash(git push --force*),Read(./**/credentials*)]}}最佳实践先用普通模式观察 Claude 常用哪些命令再逐步添加 allow 规则始终添加 deny 规则保护危险操作rm -rf、git push --force敏感文件用Read(./path*)deny 规则保护不要使用--dangerously-skip-permissions除非在 CI 等受信环境4.3 Hooks 系统Hooks 是 Claude Code 的自动化引擎在特定生命周期事件触发时执行自定义命令。8 大生命周期事件事件触发时机可用变量能否阻断典型用途SessionStart会话开始无否环境初始化UserPromptSubmit用户按回车前prompt是危险指令过滤PreToolUse工具执行前tool_name,tool_input是权限审计PostToolUse工具执行后tool_name,tool_input,tool_output否自动格式化NotificationClaude 需要用户输入notification_text否桌面通知Stop响应完全结束无否摘要日志SubagentStop子代理任务结束subagent_name,result否子任务统计PreCompact对话压缩前无否备份历史Hook 配置结构{hooks:{事件名:[{matcher:匹配模式正则,hooks:[{type:command,command:要执行的 shell 命令}]}]}}可用环境变量变量含义适用事件$CLAUDE_TOOL_NAME被调用的工具名PreToolUse, PostToolUse$CLAUDE_TOOL_INPUT工具输入JSONPreToolUse, PostToolUse$CLAUDE_TOOL_INPUT_FILE_PATH文件路径文件操作工具$CLAUDE_TOOL_OUTPUT工具输出JSONPostToolUse$CLAUDE_PROMPT用户提示文本UserPromptSubmit4.4 Hook 实战示例示例一自动格式化PostToolUse每次 Claude 编辑文件后自动运行 Prettier{hooks:{PostToolUse:[{matcher:Write|Edit,hooks:[{type:command,command:npx prettier --write \$CLAUDE_TOOL_INPUT_FILE_PATH\ 2/dev/null || true}]}]}}示例二ESLint 检查PostToolUse编辑 JS/TS 文件后自动 lint{hooks:{PostToolUse:[{matcher:Write|Edit,hooks:[{type:command,command:npx eslint \$CLAUDE_TOOL_INPUT_FILE_PATH\ --fix 2/dev/null || true}]}]}}示例三安全审计PreToolUse阻止 Claude 读取敏感文件{hooks:{PreToolUse:[{matcher:Read,hooks:[{type:command,command:echo \$CLAUDE_TOOL_INPUT\ | jq -r .file_path | grep -qE \\.(env|key|pem)$ echo BLOCK: 不允许读取敏感文件 exit 1 || exit 0}]}]}}示例四桌面通知NotificationClaude 需要输入时发送系统通知{hooks:{Notification:[{matcher:,hooks:[{type:command,command:osascript -e display notification \Claude Code 需要你的输入\ with title \Claude Code\}]}]}}Linux 替代方案{command:notify-send Claude Code 需要你的输入}Windows 替代方案{command:powershell -Command \[System.Reflection.Assembly]::LoadWithPartialName(System.Windows.Forms); [System.Windows.Forms.MessageBox]::Show(Claude Code 需要你的输入, Claude Code)\}示例五会话日志Stop每次会话结束记录摘要{hooks:{Stop:[{matcher:,hooks:[{type:command,command:echo \[$(date %Y-%m-%d %H:%M)] Session ended in $(pwd)\ ~/.claude/session-log.txt}]}]}}示例六Python 自动格式化PostToolUse{hooks:{PostToolUse:[{matcher:Write|Edit,hooks:[{type:command,command:echo \$CLAUDE_TOOL_INPUT\ | jq -r .file_path | grep -qE \\.py$ black \$CLAUDE_TOOL_INPUT_FILE_PATH\ 2/dev/null || true}]}]}}4.5 自动化工作流工作流一代码质量门禁{hooks:{PostToolUse:[{matcher:Write|Edit,hooks:[{type:command,command:FILE\$CLAUDE_TOOL_INPUT_FILE_PATH\; case \$FILE\ in *.py) black \$FILE\ flake8 \$FILE\;; *.ts|*.tsx) npx prettier --write \$FILE\ npx eslint \$FILE\ --fix;; *.go) gofmt -w \$FILE\;; esac 2/dev/null || true}]}]}}工作流二自动测试{hooks:{PostToolUse:[{matcher:Write|Edit,hooks:[{type:command,command:FILE\$CLAUDE_TOOL_INPUT_FILE_PATH\; case \$FILE\ in *test*.py) pytest \$FILE\ -q;; *test*.ts) npx jest \$FILE\;; esac 2/dev/null || true}]}]}}工作流三Git 安全防护{hooks:{PreToolUse:[{matcher:Bash,hooks:[{type:command,command:echo \$CLAUDE_TOOL_INPUT\ | jq -r .command | grep -qiE (push --force|reset --hard|clean -f|rm -rf /) echo BLOCK: 危险 Git 操作被阻止 exit 1 || exit 0}]}]}}4.6 沙盒模式在隔离环境中运行命令防止意外损害{security:{sandbox:true}}沙盒模式下Claude 执行的命令被限制在安全范围内。最佳实践生产环境或共享服务器上建议开启沙盒模式。4.7 Hook 注意事项注意事项说明保持轻量Hook 在每次工具调用时执行慢 Hook 会严重拖慢体验错误容忍用2/dev/null || true防止 Hook 报错阻断流程matcher 是正则Write|Edit匹配 Write 或 Edit 工具阻断返回非零PreToolUse Hook exit 1 会阻断工具执行配置位置全局~/.claude/settings.json或项目.claude/settings.local.json4.8 小结概念关键要点权限模式三种模式ShiftTab 切换allow/deny细粒度控制支持精确匹配和通配符Hooks8 大生命周期事件实现自动化常用 Hook格式化、lint、安全审计、通知沙盒生产环境建议开启Hook 原则轻量、容错、正则匹配上一篇03 项目篇CLAUDE.md 与项目配置下一篇05 实战篇MCP 服务器与技能扩展
