Bài 6.320 phút · 5 thẻ · 8 bài tập · 1 nhiệm vụ

Hook bảo vệ: rm -rf và .env

Chặn trước bằng PreToolUse: một hook chặn rm -rf, một hook chặn ghi .env, luật deny chặn đọc .env, và những gì chặn theo chữ không che được.

Bài 6.2 kiểm tra sau khi Claude làm. Có những việc không thể kiểm sau, vì làm rồi là mất: xóa đệ quy cả một thư mục, ghi đè file .env chứa khóa thật. Bài này chặn chúng trước khi xảy ra, đúng nhiệm vụ của cấp 6: một hook chặn rm -rf và một lớp bảo vệ cho .env. Mỗi lớp đều được thử thật, kể cả những chỗ nó không che được.

Chặn trước, không sửa sau

Công cụ chính là PreToolUse: hook chạy trước khi công cụ chạy, và có thể từ chối. Có hai cách từ chối:

  • Exit 2, lý do in ra stderr (như bài 6.2).
  • Exit 0 và in JSON với permissionDecision: "deny" kèm permissionDecisionReason. Claude Code hủy lần gọi và gửi lý do cho Claude.

Điểm làm hook bảo vệ mạnh hơn mọi thứ trước đó:

  • Hook từ chối thì luật allow không cứu được. Khi thử, chúng tôi cho phép sẵn Bash(rm *), vậy mà rm -rf vẫn bị chặn.
  • Docs nói hook deny có hiệu lực ở mọi permission mode, kể cả bypassPermissions, vì PreToolUse chạy trước mọi kiểm tra mode. Phần này chúng tôi không thử: chính công cụ an toàn của phiên kiểm thử từ chối chạy Claude ở chế độ bỏ qua quyền, và chúng tôi không tìm đường vòng.

Chặn rm -rf

Tạo .claude/hooks/block-rm.sh:

Terminal
#!/bin/bash
# PreToolUse (Bash): refuse recursive force deletes such as rm -rf, rm -fr, rm -r -f
CMD=$(jq -r '.tool_input.command // empty')
if echo "$CMD" | grep -Eq '(^|[;&|(`[:space:]])rm[[:space:]]+([^;&|]*[[:space:]])?(-[[:alnum:]]*[rR][[:alnum:]]*f|-[[:alnum:]]*f[[:alnum:]]*[rR]|(-[rR]|--recursive)[[:space:]]+([^;&|]*[[:space:]])?(-f|--force)|(-f|--force)[[:space:]]+([^;&|]*[[:space:]])?(-[rR]|--recursive))([[:space:]]|$)'; then
  jq -n '{hookSpecificOutput: {hookEventName: "PreToolUse",
    permissionDecision: "deny",
    permissionDecisionReason: "rm -rf is blocked in this project. Delete specific files, or ask the user to run it."}}'
fi
exit 0

Biểu thức dài vì rm -rf có nhiều cách viết. Chúng tôi thử tay từng dạng bằng JSON mẫu:

  • Bị chặn: rm -rf, rm -fr, rm -Rf, rm -r -f, rm --recursive --force, cd x && rm -rf .
  • Cho qua: rm -r build, rm file.txt, npm test, echo 'rm -rf' > notes.txt
  • Chặn thừa: git rm -rf --cached x. Chặn thừa một lệnh hiếm gặp còn hơn để lọt một lệnh nguy hiểm.

Chú ý câu lý do: nó chỉ cho Claude đường đi đúng. Khi chúng tôi nhờ "xóa tmp-build bằng rm -rf", hook chặn, và Claude làm đúng theo lý do: xóa từng file bằng tên, không tìm cách lách. Lý do tốt biến một lần bị chặn thành một hướng dẫn.

Không cho ghi vào .env

Docs có mẫu protect-files.sh chặn Edit và Write vào .env, và cũng nói thẳng: Claude vẫn có thể ghi bằng lệnh shell. Vì vậy script của todo-api kiểm cả Bash. Tạo .claude/hooks/protect-env.sh:

Terminal
#!/bin/bash
# PreToolUse (Edit|Write|Bash): never write to .env files; .env.example is fine
INPUT=$(cat)
is_secret() {
  local name; name=$(basename "$1")
  [[ "$name" == .env || ( "$name" == .env.* && "$name" != .env.example ) ]]
}
block() {
  echo "Blocked: $1 holds secrets and is never written by Claude. Tell the user which variable to set instead." >&2
  exit 2
}
if [ "$(echo "$INPUT" | jq -r '.tool_name')" = "Bash" ]; then
  CMD=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
  # the target of >, >>, tee, sed -i, cp or mv, when it looks like a .env file
  for T in $(echo "$CMD" | grep -Eo '(>>?|tee( -a)?|sed -i[^ ]*|cp|mv)[[:space:]]*([^;&|]*[[:space:]])?[^[:space:];&|]*\.env[[:alnum:]._-]*' | awk '{print $NF}'); do
    is_secret "${T##*>}" && block "${T##*>}"
  done
  exit 0
fi
FILE=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
is_secret "$FILE" && block "$(basename "$FILE")"
exit 0

Bản đầu của chúng tôi có lỗi: ngoại lệ cho .env.example áp lên cả câu lệnh, nên cp .env.example .env lọt qua, vì trong câu có chữ .env.example. Bản trên kiểm tên của từng đích ghi, và chặn được cả >> .env, tee -a .env, sed -i … .env, cp … .env, nhưng vẫn cho ghi .env.example. Bài học: thử script với những trường hợp gần đúng, không chỉ trường hợp hiển nhiên.

Khi thử với Claude, lần Edit vào .env bị chặn, và Claude chỉ người dùng dòng cần thêm thay vì thử qua shell.

Không cho đọc .env

Lần thử đó còn cho thấy một điều quan trọng: trước khi định sửa, Claude đã đọc .env hai lần, một lần bằng cat, một lần bằng Read, và giá trị khóa đã vào ngữ cảnh. Hook chỉ chặn ghi; đọc là chuyện khác.

Chặn đọc không cần hook: dùng luật deny trong .claude/settings.json:

JSON
"permissions": {
  "deny": ["Read(./.env)", "Read(./.env.*)", "Read(!.env.example)"]
}
  • Read(./.env) chặn công cụ đọc file của Claude. Theo docs, nó còn áp cho lệnh Bash mà Claude Code phân tích được, như cat, head, tail, sed, và chặn luôn Edit, Write trên cùng file.
  • Read(!.env.example) là ngoại lệ kiểu .gitignore: file mẫu vẫn đọc được.

Khi thử: Read .env bị từ chối, .env.example vẫn đọc được. Nhờ thẳng "chạy cat .env", dù có luật allow Bash(cat *), Claude Code vẫn từ chối, vì deny luôn thắng allow. Giá trị bí mật xuất hiện 0 lần trong nhật ký phiên.

Giới hạn của việc chặn theo chữ

Cả hook lẫn luật ở trên đều nhìn vào câu lệnh, nên có những đường chúng không thấy:

  • Một script Python hay Node tự mở file, như node -e "fs.writeFileSync('.env', …)".
  • Lệnh đọc mà không nêu tên file: grep -r KEY . chạy ở thư mục chứa .env.
  • Xóa theo cách khác: find . -delete, hoặc lệnh được mã hóa rồi giải mã lúc chạy.

Docs nói rõ: luật Read/Edit không áp cho tiến trình con tự đọc, ghi file; muốn chặn ở mức hệ điều hành thì bật sandbox. Docs cũng nhắc trường if chỉ là bộ lọc kiểu cố gắng.

Vậy hook bảo vệ để làm gì? Nó chặn những sai lầm thường gặp: Claude vội vàng, Claude hiểu nhầm yêu cầu, Claude làm theo một issue có chữ độc như bài 5.3. Nó không phải hàng rào chống một kẻ cố tình. Hãy xếp lớp: token tối thiểu (cấp 5), luật deny, hook, sandbox khi cần, và bạn đọc kỹ trước khi duyệt.

Bộ bảo vệ cho todo-api

Gom lại trong .claude/settings.json, cạnh các hook của bài 6.2:

JSON
{
  "permissions": {
    "deny": ["Read(./.env)", "Read(./.env.*)", "Read(!.env.example)"]
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-rm.sh" }
        ]
      },
      {
        "matcher": "Edit|Write|Bash",
        "hooks": [
          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-env.sh" }
        ]
      }
    ]
  }
}

Trước khi commit: chmod +x hai script, thử từng script bằng JSON mẫu với cả trường hợp phải chặn lẫn phải cho qua, rồi mở /hooks kiểm tra chúng đã được nạp.

Cấp 6 khép lại ở đây. Bạn có ba loại hook: ghi nhận (6.1), kiểm tra sau (6.2) và chặn trước (6.3). Đây là những luật chạy mỗi lần, không cần Claude nhớ. Cấp 7 dùng chúng làm nền để làm những việc lớn hơn một cách an toàn: plan mode, checkpoint và các phiên dài.

Luyện tập bài 6.3

5 thẻ ghi nhớ, 8 bài tập chấm ngay trên trang, 1 nhiệm vụ làm trên máy.

Bắt đầu luyện tập

Tra cứu liên quan

Gõ để tìm trong tra cứu, mẫu cấu hình và bài học. Không dấu cũng được.