Tiến độ sẽ không được lưu. Trình duyệt đang chặn lưu dữ liệu (thường do chế độ ẩn danh). Bạn vẫn học bình thường, nhưng đóng tab là mất tiến độ.
Phần luyện tập cần bật JavaScript. Bài đọc vẫn xem được bình thường.Về bài đọc
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èmpermissionDecisionReason. 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 -rfvẫn bị chặn. - Docs nói hook
denycó hiệu lực ở mọi permission mode, kể cảbypassPermissions, vìPreToolUsechạ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.
Tạo .claude/hooks/block-rm.sh:
#!/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 0Biể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.
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:
#!/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 0Bả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.
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:
"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.
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.
Gom lại trong .claude/settings.json, cạnh các hook của bài 6.2:
{
"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.