# Claude 代码 Bash 模式 **状态**：生产就绪 ✅ **最后更新**：2025-11-07 **依赖项**：Claude Code CLI（最新版本） **官方文档**： ** ** ## 快速入门（10 分钟） ### 1\.了解 Bash 工具 Bash 工具是 Claude Code 用于执行命令行操作的主要界面。与专用工具（Read、Grep、Glob）不同，Bash 工具为复杂的工作流程提供直接 shell 访问。 **主要特征**： * **会话持久性** ：命令在会话中的持久 bash 会话中运行 * **环境继承** ：继承环境变量和工作目录 * **输出限制**：在 30,000 个字符处截断输出 * **默认超时**：2 分钟（最多可配置 10 分钟） **何时使用 Bash 工具**： * ✅ 运行 CLI 工具（git、npm、wrangler、gh 等） * ✅ 命令链（顺序操作） * 流程编排（构建、测试、部署） * ✅ 环境设置和管理 **何时不使用 Bash 工具**： * ❌ 读取文件 → 使用 **Read** 工具代替 * ❌ 搜索文件模式 → 使用 **Glob** 工具代替 * ❌ 搜索内容 → 使用 **Grep** 工具代替 * ❌ 编辑文件 → 使用 **编辑** 工具代替 ### 2\.基本命令模式 # 单个命令 npm 安装 # 使用 && 进行顺序（第一次失败时停止） npm 安装 && npm 运行构建 # 顺序使用 ; （无论如何继续） npm 安装； npm 运行构建 # 并行执行（进行多个 Bash 工具调用） # 调用1：git status # 调用 2：git diff # 调用3：git log **黄金法则** ：当您关心故障时使用“&&”，当您不关心故障时使用“;”，当操作独立时使用并行调用。 ### 3\.配置您的第一个钩子挂钩允许您在工具执行之前/之后运行代码。这是一个简单的审计记录器： { “钩子”：{ “预工具使用”：[ { “匹配器”：“重击”， “钩子”：[ { “类型”：“命令”， "command": "echo \"[$(date -Iseconds)] $(echo \"$CLAUDE_TOOL_INPUT\" | jq -r '.tool_input.command')\" >> ~/.claude/bash-audit.log" } ] } ] } } 将其保存到 `~/.claude/settings.json` 以使用时间戳记录每个 bash 命令。 ** ** ## 五种核心模式 ### 模式 1：命令链 **何时使用**：顺序操作，其中每个操作都取决于先前的成功 **语法**：`命令1 && 命令2 && 命令3` **示例**：构建和部署工作流程 npm install && npm run build && npx wrangler 部署 **为什么重要**： * 在第一次失败时停止（防止级联错误） * 维护干净的错误消息（确切地知道失败的原因） * 保存令牌（无需检查命令之间的状态） **反模式**：当你关心失败时使用`;` # ❌ 错误：即使安装失败也会继续 npm 安装； npm 运行构建 # ✅ 正确：如果安装失败则停止 npm 安装 && npm 运行构建 **高级**：使用`||`条件执行 # 运行测试，或回显失败消息 npm 测试 || echo“测试失败，未部署” # 尝试 npm ci，回退到 npm install npm ci || npm 安装 ### 模式 2：并行执行 **何时使用** ：可以同时运行的独立操作 **如何**：在一条消息中调用多个 Bash 工具 **示例**：Git 工作流程预提交分析 # Claude 在一条消息中进行 3 个并行 Bash 调用：调用1：git状态调用 2：git diff --staged 调用 3： git log -5 --oneline **好处**： * 比顺序快约 40%（调用之间无需等待） * 减少上下文使用（所有结果一起到达） * 更好的用户体验（即时出现） **重要**：仅并行化真正独立的操作。如果调用 2 依赖于调用 1 的输出，则按顺序运行。 ### 模式 3：用于多行内容的 HEREDOC **何时使用** ：Git 提交、文件创建、带有换行符的复杂字符串 **语法** : `cat <<'EOF' ... EOF` **示例**：带有详细消息的 Git 提交 git commit -m "$(cat <<'EOF' feat(auth): 添加 JWT 验证中间件为 Clerk 身份验证实现自定义 JWT 模板支持。提取用户上下文的电子邮件和元数据声明。 🤖 使用 Claude 代码生成共同作者：Claude EOF ）” **为什么单引号** : `<<'EOF'` 防止内容中的变量扩展。如果您希望变量扩展，请使用`<<"EOF"`。 **常见错误**：忘记 `$()` 包装器周围的引号 # ❌错误：换行符丢失 git commit -m $(cat <<'EOF' 1号线 2号线 EOF ） # ✅ 正确：保留换行符 git commit -m "$(cat <<'EOF' 1号线 2号线 EOF ）” ### 模式 4：输出捕获和处理 **何时使用** ：使用前需要处理命令输出 **模式** ：用 `$()` 命令替换 **示例** : 获取当前分支名称分支=$(git rev-parse --abbrev-ref HEAD) echo "当前分支：$BRANCH" **示例**：基于输出的条件逻辑如果 git diff --安静；然后 echo“未检测到任何变化” 否则 echo“检测到更改，正在运行测试...” npm测试菲 **限制**：输出被截断为 30,000 个字符。对于大输出： # 限制输出 npm 测试 2>&1 |头-100 # 或者保存到文件 npm test > test-results.txt && tail -50 test-results.txt ### 模式 5：条件执行 **何时使用** ：根据条件采取不同的操作 **模式** ：使用 `&&` / `||` 测试命令 **示例**：仅在文件更改时运行测试 git diff --安静 || npm测试 **示例**：基于文件存在的不同命令 [ -f package-lock.json ] && npm ci || npm 安装 **示例**：多条件逻辑如果 [ -f pnpm-lock.yaml ];然后即插即用安装 elif [ -f 纱线.lock ];然后纱线安装否则 npm 安装菲 ** ** ## Hooks：高级自动化挂钩是在工具执行之前/之后运行的 shell 命令或 Claude 提示符。他们是您的保安、清洁人员和自动化助手。 ### PreToolUse：安全卫士 **用途**：在工具执行之前运行，可以阻止或修改行为 **退出代码**： * `0` = 允许执行 * `1` = 出现一般错误的块 * `2` = 带有自定义错误消息的块（来自 stderr） #### 使用案例 1：阻止危险命令 **文件**：`~/.claude/hooks/dangerous-command-guard.py` #!/usr/bin/env python3 导入 json 导入系统进口再 # 从标准输入读取钩子输入数据 = json.load(sys.stdin) 命令 = data.get('tool_input', {}).get('命令', '') # 要阻止的危险模式危险= [ r'rm\s+-rf\s+/', # 删除根目录 r'dd\s+if=', # 磁盘操作 r'mkfs\.', # 格式化文件系统 r':()\{.*\}:', # 叉子炸弹 r'sudo\s+rm', # 须藤删除 r'git\s+push.*--force.*main', # 强制推送到 main ] 对于 DANGEROUS 中的模式： if re.search(模式, 命令): print(f"BLOCKED: 危险命令模式 '{pattern}'", file=sys.stderr) 系统退出(2) # 允许执行系统退出(0) **设置配置**： { “钩子”：{ “预工具使用”：[ { “匹配器”：“重击”， “钩子”：[ { “类型”：“命令”， “命令”：“python3 ~/.claude/hooks/dangerous-command-guard.py” } ] } ] } } #### 用例 2：记录所有 Bash 命令 { “匹配器”：“重击”， “钩子”：[ { “类型”：“命令”， "command": "echo \"[$(date -Iseconds)] $(echo \"$CLAUDE_TOOL_INPUT\" | jq -r '.tool_input.command')\" >> ~/.claude/bash-audit.log" } ] } **结果**：每个 bash 命令都用时间戳记录到 `~/.claude/bash-audit.log` #### 用例 3：强制执行包管理器检查锁文件并阻止错误的包管理器： #!/bin/bash # 文件：~/.claude/hooks/package-manager-enforcer.sh COMMAND=$(echo "$CLAUDE_TOOL_INPUT" | jq -r '.tool_input.command') 如果 [ -f pnpm-lock.yaml ] && echo "$COMMAND" | grep -qE '^(npm|yarn)';然后 echo“错误：此存储库使用 pnpm。请使用 'pnpm' 而不是 'npm' 或 'yarn'。” >&2 2号出口菲如果[-fyarn.lock]&&回显“$COMMAND”| grep -qE '^(npm|pnpm) ';然后 echo“错误：此存储库使用纱线。请使用‘yarn’而不是‘npm’或‘pnpm’。” >&2 2号出口菲出口0 ### PostToolUse：清理人员 **用途**：成功执行工具后运行（仅限退出代码 0） **示例**：文件编辑后自动格式化 { "matcher": "写入|编辑", “钩子”：[ { “类型”：“命令”， "command": "FILE=$(echo \"$CLAUDE_TOOL_INPUT\" | jq -r '.tool_input.file_path'); [ -f \"$FILE\" ] && prettier --write \"$FILE\" || true" } ] } **示例**：代码更改后运行测试 { "matcher": "写入|编辑", “钩子”：[ { “类型”：“命令”， "command": "FILE=$(echo \"$CLAUDE_TOOL_INPUT\" | jq -r '.tool_input.file_path'); if echo \"$FILE\" | grep -qE '\\.(ts|tsx|js|jsx)$'; 然后 npm test -- \"$FILE\"; fi" } ] } ### SessionStart：环境设置 **目的**：在会话开始时运行一次，设置环境 **示例**：加载项目特定环境 { “钩子”：{ “会话开始”：[ { “匹配器”：“*”， “钩子”：[ { “类型”：“命令”， "command": "[ -f .envrc ] && source .envrc || true; env > $CLAUDE_ENV_FILE" } ] } ] } } **挂钩中可用的环境变量**： * `$CLAUDE_TOOL_INPUT` \- 工具调用的 JSON 字符串 * `$CLAUDE_ENV_FILE` \- 环境文件路径 * 标准环境变量（`$HOME`、`$USER`、`$PWD` 等） ** ** ## Git 工作流程（经过生产测试） Anthropic 的工程团队在 90% 以上的 git 交互中使用了这些模式。 ### 模式：智能 Git 提交 **第 1 步**：收集上下文（并行调用） # 拨打1 git 状态 # 拨打 2 git diff --暂存 # 拨打 3 git log -5 --oneline **为什么并行**：独立操作，更快的响应，更好的用户体验 **第2步**：分析变化 * 查看**实际代码更改**（不仅仅是文件名！） * 匹配 git log 中的提交消息样式 * 关注“为什么”而不是“什么” * 保持信息简洁（1-2句话） **第 3 步**：使用 HEREDOC 提交 git add [文件] && git commit -m "$(cat <<'EOF' feat(auth): 添加 JWT 验证中间件为 Clerk 身份验证实现自定义 JWT 模板支持。提取用户上下文的电子邮件和元数据声明。 🤖 使用 Claude 代码生成共同作者：Claude EOF ）” **第 4 步**：验证 git 状态 **重要**：如果预提交挂钩修改文件： 1. 检查作者身份： `git log -1 --format='%an %ae'` 2. 检查未推送：`git status`（应显示“ahead of origin”） 3. 如果两者都安全： `git add . && git commit --amend --no-edit` 4. 如果不安全： `git add . && git commit -m“应用预提交挂钩更改”` ### 模式：拉取请求创建 **第 1 步**：了解分支状态（并行） # 拨打1 git 状态 # 拨打 2 git diff 主要...HEAD # 拨打 3 git log main..HEAD --oneline **第 2 步**：分析所有提交（不仅仅是最新的！） * 自从分支与主分支分离后发生了什么变化？ * 这个分支的总体目标是什么？ * 什么需要测试？ **第 3 步**：使用 gh CLI 创建 PR gh pr create --title "feat: 用户身份验证" --body "$(cat <<'EOF' ## 总结 - 与 Clerk 实施 JWT 验证 - 添加登录/注销端点 - 更新用户表的数据库架构 ## 测试计划 - [ ] 验证 JWT 令牌验证 - [ ] 测试登录流程 - [ ] 测试注销流程 - [ ] 确认数据库迁移工作正常 🤖 使用 Claude 代码生成 EOF ）” **结果**：专业公关，有清晰的总结和测试计划 ** ** ## CLI 工具集成 ### GitHub CLI (gh) Claude 默认了解 gh CLI。常见模式： # 查看公关评论 gh api 存储库/所有者/存储库/pulls/123/comments # 检查 CI 状态 gh 运行列表 --limit 5 # 创建问题 gh issues create --title“Bug：描述”--body“详细信息此处” # 公关评论 gh 公关评论 123 --body“LGTM！🚀” ### 牧马人 (Cloudflare) 本地安装带有“npx”前缀： # 部署工作人员 npx 牧马人部署 # 运行 D1 迁移 npx wrangler d1 迁移应用 my-db --remote # 尾部日志 npx牧马人尾巴 # 执行D1查询 npx wrangler d1 执行 my-db --command "SELECT * FROM users LIMIT 5" ### 自定义 CLI 工具 **如何向 Claude 教授 CLI**： **选项 1**：CLAUDE.md 中的文档 ## 自定义工具 **mycli**：内部部署工具用法：`mycli deploy --env production --service api` 帮助：`mycli --help` 了解完整选项配置：项目根目录中的`.mycli.json` **选项2**：让克劳德发现遇到 mycli 命令时，请先运行“mycli --help”以发现可用选项。 **选项 3**：创建自定义命令 (`.claude/commands/deploy.md`) 使用我们的内部 mycli 工具进行部署： 1. 运行 `mycli --version` 来验证安装 2.检查当前环境：`mycli env current` 3. 部署到暂存：`mycli deploy --env staging --service api` 4. 运行冒烟测试：`mycli test Smoke --env staging` 5. 如果测试通过，则部署到生产：`mycli deploy --env production --service api` ** ** ## 安全配置 ### 1\.危险命令防护（PreToolUse Hook）请参阅捆绑脚本：`scripts/dangerous-command-guard.py` **块**： * `rm -rf /`（删除根目录） * `dd if=` （磁盘操作） * `mkfs.*` （格式化文件系统） * `:(){ :|:& };:` （叉子炸弹） * `sudo rm`（危险的 sudo 删除） * `git push --force main` （强制推送到主分支） **安装**： # 复制脚本 cp 脚本/dangerous-command-guard.py ~/.claude/hooks/ chmod +x ~/.claude/hooks/dangerous-command-guard.py # 在 ~/.claude/settings.json 中配置 { “钩子”：{ “预工具使用”：[ { “匹配器”：“重击”， “钩子”：[ { “类型”：“命令”， “命令”：“python3 ~/.claude/hooks/dangerous-command-guard.py” } ] } ] } } ### 2\.生产文件保护防止修改生产配置文件： { "matcher": "写入|编辑", “钩子”：[ { “类型”：“命令”， "command": "FILE=$(echo \"$CLAUDE_TOOL_INPUT\" | jq -r '.tool_input.file_path // 空'); if echo \"$FILE\" | grep -qE '(^|\\/)(product\\.env|\\.env\\.product|prod\\.config)$'; then echo '错误：无法修改生产配置文件' >&2; exit 2;菲” } ] } ### 3\.审计日志记录记录所有 bash 命令以确保合规性： { “匹配器”：“重击”， “钩子”：[ { “类型”：“命令”， "command": "echo \"[$(date -Iseconds)] 用户：$USER |命令：$(echo \"$CLAUDE_TOOL_INPUT\" | jq -r '.tool_input.command')\" >> ~/.claude/audit.log" } ] } **查看审核日志**：尾 -50 ~/.claude/audit.log ** ** ## 自定义命令 (.claude/commands/) 自定义命令是 Markdown 文件，在调用时会扩展为提示。 ### 创建自定义命令 **文件**：`.claude/commands/deploy-staging.md` 将当前分支部署到暂存环境： 1.验证分支不是main（如果是main则退出） 2. 运行完整的测试套件（npm test） 3. 构建生产包（npm run build） 4. 使用 wrangler 部署到 staging (npx wrangler deploy --env staging) 5. 针对暂存 URL 运行冒烟测试 6. 与用户共享部署 URL **用法**：用户：/deploy-staging Claude：[从 markdown 文件执行工作流程] ### 自定义命令的最佳实践 ✅ **做**： * 使它们原子化（一个清晰的工作流程） * 包括验证步骤 * 记录预期状态 * 添加回滚指令 * 使用命令式语言 ❌ **不要**： * 让它们太复杂（分成多个命令） * 包括交互式提示 * 假设状态（始终验证） **命令库示例**： * `/deploy-staging` \- 部署到暂存 * `/deploy-production` \- 部署到生产环境（带有安全检查） * `/run-tests` \- 运行完整的测试套件 * `/check-types` \- TypeScript 类型检查 * `/format-code` \- 格式化所有代码文件 * `/create-migration` \- 创建数据库迁移 ** ** ## 关键规则 ### 永远这样做 ✅ **1\.首先使用专用工具** Bash 功能强大，但对于使用专用工具的任务来说效率低下： # ❌错误：使用Bash读取文件猫文件.txt # ✅ 正确：使用阅读工具读取（文件路径=“文件.txt”） # ❌错误：使用 Bash 进行文件搜索找到。 -名称“*.ts” # ✅ 正确：使用 Glob 工具全局（模式=“**/*.ts”） # ❌ 错误：使用 Bash 进行内容搜索 grep“模式”文件.txt # ✅ 正确：使用 Grep 工具 Grep(模式=“模式”，路径=“文件.txt”) **为什么**：专用工具速度更快，使用更少的标记，并提供更好的格式。 **2\.引用带有空格的路径** # ❌ 错误：空格分隔 cd /用户/用户名/我的文档 # ✅ 正确：引用的路径 cd "/用户/名称/我的文档" **3\.使用 && 表示依赖关系** # ❌ 错误：即使安装失败也会继续 npm 安装； npm 运行构建 # ✅ 正确：失败时停止 npm 安装 && npm 运行构建 **4\.并行独立操作** # ❌ 错误：可以并行时的顺序 git 状态 && git diff && git 日志 # ✅ 正确：在一条消息中进行 3 个并行 Bash 工具调用 **5\.用于多行字符串的 HEREDOC** #❌错误：逃离噩梦 git commit -m "line1\nline2\nline3" # ✅ 正确：HEREDOC git commit -m "$(cat <<'EOF' 1号线第2行 3号线 EOF ）” **6\.始终提供描述** # ❌ 错误：没有用户上下文 Bash（命令=“complex-script.sh”） # ✅ 正确：目的明确重击（命令=“complex-script.sh”，描述 =“在临时数据库上运行集成测试” ） ### 永远不要这样做❌ **1\.不要使用交互式命令** 需要用户输入的命令将挂起： # ❌错误：将挂起等待输入 vim文件.txt 纳米文件.txt 少输出.txt npm install # 如果package.json有提示 # ✅ 正确：使用非交互式替代方案 # 使用编辑/写入工具进行文件编辑 npm 安装--是 **2\.不要与换行符链接** # ❌ 错误：未按预期工作命令1 命令2 # ✅ 正确：使用 && 或 ; 命令1 && 命令2 **3\.不要忽略退出代码** # ❌ 错误：即使命令失败也会显示成功消息有风险的命令；回声“成功！” # ✅ 正确：检查退出代码有风险的命令 && 回显“成功！” ||回声“失败！” **4\.不要过度使用 CD** 在代理模式下，工作目录在调用之间不会保留： # ❌ 错误：cd 不持久 # 调用 1: cd /path/to/project # 调用 2: npm test # 在原始目录中运行！ # ✅ 正确：使用绝对路径或--prefix npm test --prefix /路径/到/项目 # ✅ 或在单个命令中链接 cd /path/to/project && npm 测试 **5\.不要跳过错误处理** # ❌错误：没有错误处理 ./脚本.sh ./cleanup.sh # ✅ 正确：处理失败 ./script.sh || { echo "脚本失败" >&2; 1号出口； } ./cleanup.sh ** ** ## 已知问题预防此技能可防止 **12** 记录的来源问题： ### 问题 #1：未找到 Git Bash cygpath 命令 (Windows) **错误**：`bash：第1行：cygpath：找不到命令` **来源**： **为什么会发生**：Bash工具尝试在MSYS/Git Bash上使用cygpath（仅限Cygwin） **预防**： * 在 Windows 上使用 WSL 代替 Git Bash * 如果使用 Git Bash，请配置 `CLAUDE_CODE_GIT_BASH_PATH` * 如果需要 cygpath，请安装 Cygwin ### 问题 #2：管道命令失败 **错误**：`echo test|grep test`返回错误而不是“test” **来源**： **为什么会发生**：某些配置中的管道解析问题 **预防**： # ❌避免直接管道 echo 测试|grep 测试 # ✅ 使用显式 bash -c bash -c '回声测试 | grep 测试' # ✅ 或者使用专门的工具（Grep 工具代替） ### 问题 #3：命令超时（悬置 Promise） **错误**：`挂起的 Promise 被取消` **来源**：Bash 工具默认超时为 2 分钟 **为什么会发生**：没有超时配置的长时间运行命令 **预防**： # 对于长时间操作，明确设置超时重击（命令=“npm运行构建”，超时=600000, # 10 分钟描述=“构建生产包（可能需要几分钟）” ） # 或者在后台运行重击（命令 =“npm run build > build.log 2>&1 &”，描述=“在后台开始构建” ） ### 问题#4：输出截断损失 **错误**：响应中缺少重要输出 **来源**：Bash 工具将输出截断为 30,000 个字符 **为什么会发生**：大型命令输出超出限制 **预防**： # ❌错误：完整输出可能会被截断 npm测试 # ✅ 正确：限制输出 npm 测试 2>&1 |头-100 # ✅ 或保存到文件 npm test > test-results.txt && tail -50 test-results.txt ### 问题 #5：“未找到合适的 Shell”(Windows) **错误**：CLI 失败，并显示“找不到合适的 shell” **来源**： **为什么会发生**：Git Bash 环境中的 Shell 检测问题 **预防**： * 显式设置SHELL环境变量 * 使用WSL以获得更好的兼容性 * 安装最新的 Claude Code CLI 版本 ### 问题 #6：Bash 工具访问丢失 **错误**：Claude 失去了运行 Bash() 工具的能力 **来源**： **为什么会发生**：会话状态损坏，通常是在过夜空闲之后 **预防**： * 如果 Bash 不可用，请重新启动 Claude Code 会话 * 使用“/permissions”命令检查权限 * 使用 `restart: true` 参数重置 bash 会话 ### 问题 #7：交互式提示挂起 **错误**：命令无限期挂起，无输出 **为什么会发生**：命令需要交互式输入（密码、确认） **预防**： # ❌ 错误：会挂起 npm install # 如果package.json有交互式提示 # ✅ 正确：非交互式标志 npm 安装--是 # ✅ 正确：通过 stdin 提供输入回声“是”|需要确认的命令 ### 问题#8：权限被拒绝错误 **错误**：“权限被拒绝”或“找不到命令” **为什么会发生**：脚本无法执行或不在 PATH 中 **预防**： # 首先使脚本可执行 chmod +x script.sh && ./script.sh # 使用完整路径 /usr/local/bin/mycli 部署 # 或者直接使用解释器 python3脚本.py 节点脚本.js ### 问题#9：环境变量不持久 **错误**：一个命令中设置的变量在下一个命令中不可用**为什么会发生**：代理线程在调用之间重置环境 **预防**： # ❌ 错误：跨调用拆分 # 调用1：导出API_KEY=abc123 # 调用 2:curl -H "Authorization: $API_KEY" ... # $API_KEY 为空！ # ✅ 正确：相同的命令导出 API_KEY=abc123 && curl -H "授权：$API_KEY" ... # ✅ 或者使用 SessionStart 钩子 ### 问题 #10：未检测到 Git Commit Hook 修改 **错误**：预提交挂钩更改文件，但提交失败 **为什么会发生**：挂钩在暂存后修改文件 **预防**： # 由于钩子更改而提交失败后： # 1.检查是否可以修改（不是推送，是你写的） git log -1 --format='%an %ae' # 2. 如果安全的话，修改 git 添加 . && git commit --amend --no-edit # 3. 如果不安全，则进行新的提交 git 添加 . && git commit -m“应用预提交挂钩更改” ### 问题 #11：通配符权限匹配不起作用 **错误**：`Bash(*)`或`Bash(*:*)`不授予访问权限**来源**： **为什么会发生**：白名单中的语法不匹配 **预防**： // ❌ 错误 {“allowedTools”：[“Bash(*)”]} // ✅ 正确 {“allowedTools”：[“Bash”]} // 或者特定的模式 {“allowedTools”：[“Bash（git *）”，“Bash（npm *）”]} ### 问题#12：危险的命令执行 **错误**：意外的 `rm -rf /` 或强制推送到主 **为什么会发生**：破坏性操作没有防护栏 **预防**：使用带有危险命令防护的 PreToolUse 挂钩（请参阅安全部分） ** ** ## 使用捆绑资源 ### 脚本（脚本/） **1\. anger-command-guard.py** 目的：PreToolUse 钩子阻止危险的 bash 模式用法：在 settings.json 中配置（请参阅安全部分） **2\. bash-audit-logger.sh** 用途：记录所有带时间戳的 bash 命令用法：配置为 PreToolUse 钩子 **3\. package-manager-enforcer.sh** 目的：基于锁定文件强制执行 pnpm/yarn/npm 用法：配置为 PreToolUse 挂钩 ### 参考文献（参考文献/） **1\. git-workflows.md** 深入研究 git 自动化模式、提交消息格式、PR 创建 **2\. hooks-examples.md** 常见场景的完整hooks配置示例 **3\. cli-tool-integration.md** 如何将自定义 CLI 工具与 Claude Code 集成 **4\. security-best-practices.md** bash 自动化的综合安全指南 **5\. Troubleshooting-guide.md** 所有 12 个已知问题的详细解决方案 ### 模板（模板/） **1\. settings.json** 带有钩子示例的完整settings.json **2\.危险命令.json** 要阻止的危险模式列表 **3\. custom-command-template.md** 用于创建 .claude/commands/ 文件的模板 **4\. github-workflow.yml** GitHub Actions 与 Claude Code 集成 **5\. .envrc.example** 用于环境管理的 direnv 集成 ** ** ## 依赖关系 **必填**： * 克劳德代码 CLI（最新版本） * bash 4.0+（持久会话支持） **可选（针对特定功能）**： * `jq` （钩子中的 JSON 处理） - `brew install jq` / `apt install jq` * `gh`（GitHub CLI 集成）-`brew install gh` / `apt install gh` * Python 3.7+（用于基于Python的钩子） * direnv（环境管理）-`brew install direnv` ** ** ## 官方文档 * **Bash 工具参考**： * **克劳德代码钩子**： * **克劳德代码最佳实践**： * **使用 MCP 执行代码**： * **Cloudflare 代码模式** ： ** ** ## 制作示例该技能基于以下领域的实际使用情况： * **WordPress Auditor** ：Git 工作流程、PR 自动化 * **claude-skills repo** ：自定义命令，钩子配置 * **多个客户端项目**：CLI 工具编排 **测量的影响**： * 代币节省：~55%（与手动试错相比） * 错误预防：12 个已记录的问题 → 0 次发生 * 节省时间：通过并行执行，工作流程加快约 40% * 安全性：100%危险命令防范，带钩子 ** ** ## 完整设置清单 * Claude Code CLI 安装并更新 * Bash 4.0+ 可用（`bash --version`） * 安装 jq（用于钩子）：`brew install jq` 或 `apt install jq` * 安装了 gh CLI（用于 git 工作流程）：`brew install gh` 或 `apt install gh` * 创建设置目录：`mkdir -p ~/.claude/hooks` * 将钩子脚本复制到`~/.claude/hooks/` * 使脚本可执行：`chmod +x ~/.claude/hooks/*.sh` * 使用所需的钩子配置`~/.claude/settings.json` *经过测试的危险指挥守卫 * 验证 bash 审计日志记录 * 在 `.claude/commands/` 中创建了第一个自定义命令 * 测试了 git 工作流程模式 ** ** **有问题吗？有问题吗？** 1. 详细解决方案请查看 `references/troubleshooting-guide.md` 2. 查看 `references/hooks-examples.md` 以获取配置示例 3.查阅官方文档： 4. 验证上述设置清单中的所有步骤

克劳德代码 Bash 模式

包含技能