אוטומציה אמיתית מתחילה ב- config.

לפני שאתה כותב prompt אחד טוב, יש לך הזדמנות לכתוב config אחד טוב — שיעבוד עבורך מאות פעמים. זה ההבדל הכי גדול בין שימוש שטחי ב-Claude Code לבין מינוף אמיתי שלו, וזה גם המקום שאליו רוב המפתחים פשוט לא נכנסים. הם פותחים את ה-CLI, מתחילים לדבר, ומתפלאים שהוא לא "זוכר" את ההעדפות שלהם.

ב-Claude Code יש שלוש רמות הגדרות שמתערבבות זו בזו לפי סדר עדיפויות ברור — ולא להבין את הסדר הזה זה הכישלון השכיח ביותר שאני רואה אצל לקוחות BDNHOST.

User settings נמצא ב-~/.claude/settings.json וחל על כל הפרויקטים שלך. זה המקום ל-theme, ל-model ברירת מחדל, ולהעדפות אישיות שאתה לא רוצה לחזור על עצמך בכל פרויקט. Project settings נמצא ב-.claude/settings.json בשורש הפרויקט — נכלל ב-git, חל על כל הצוות. זה המקום ל-hooks ו-permissions שייחודיים לפרויקט: hook שחוסם git push --force על ה-main, או הגדרת מודל ספציפי לעבודה הזו. Project local ב-.claude/settings.local.json — לא נכנס ל-git, נועד לעקיפות אישיות שלך מעל ה-project settings.

סדר העדיפויות (Precedence)

כשיש סתירה — איזו הגדרה גוברת? מהחזק לחלש: Enterprise (managed-settings.json שמנוהל מרחוק) → Project local → Project → User. במילים אחרות, אם הארגון שלך אסר על שימוש במודל מסוים ב-enterprise — אף הגדרת user או project לא תעקוף את זה. אם אתה רוצה לעקוף הגדרת project לבדיקה אישית, השתמש ב-local.

טעות קלאסית: לכתוב hooks ב-~/.claude/settings.json במקום ב-.claude/settings.json. כתוצאה — ה-hooks שלך פועלים גם בפרויקטים שלא צריכים אותם, וגרוע יותר, חברי צוות שלך לא מקבלים את אותה הגנה כי ההגדרה לא נכנסת ל-git.

תיאוריה היא נחמדה. אבל הקסם של hooks מתגלה רק כשאתה רואה דפוסים אמיתיים בפעולה. הנה חמישה שאני משתמש בהם בעבודה היומיומית של BDNHOST — כל אחד מהם החליף לי 50+ prompts חוזרניים.

(א) Block Destructive — חוסם מחיקה / push --force / DROP TABLE

#!/bin/bash
# ~/.claude/hooks/block-destructive.sh
input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command // ""')

if echo "$cmd" | grep -qE 'rm -rf|git push --force|DROP TABLE'; then
  echo "❌ Blocked destructive command: $cmd" >&2
  exit 1
fi
exit 0

(ב) Auto-Format on Save — מריץ prettier/black אחרי כל Edit

#!/bin/bash
# ~/.claude/hooks/auto-format.sh (PostToolUse + matcher: "Edit|Write")
input=$(cat)
file=$(echo "$input" | jq -r '.tool_input.file_path // ""')

case "$file" in
  *.js|*.ts|*.tsx|*.jsx) prettier --write "$file" ;;
  *.py) black "$file" ;;
  *.go) gofmt -w "$file" ;;
esac
exit 0

(ג) Daily Summary — Stop hook שכותב סיכום יומי

#!/bin/bash
# ~/.claude/hooks/daily-summary.sh (Stop)
date_str=$(date +%Y-%m-%d)
log_dir="$HOME/.claude/logs"
mkdir -p "$log_dir"
input=$(cat)
session=$(echo "$input" | jq -r '.session_id')
echo "[$session] closed at $(date -Is)" >> "$log_dir/$date_str.log"

(ד) Approval Gate — ההוק ש-הציל לי את חשבון ה-WhatsApp

זה הדפוס שאני משתמש בו לפעולות בעלות blast radius חיצוני — שליחת הודעות, פרסום פוסטים, חיוב כרטיסי אשראי. ה-hook מזהה את הכלי, שולח התראה לטלגרם עם תוכן הפעולה, ומחכה לקובץ אישור. אם תוך 60 שניות לא קיבל אישור — הפעולה נחסמת.

#!/bin/bash
# ~/.claude/hooks/approval-gate.sh (PreToolUse + matcher: "mcp__whatsapp__.*")
input=$(cat)
tool=$(echo "$input" | jq -r '.tool_name')
body=$(echo "$input" | jq -r '.tool_input.message // .tool_input.text')

# Notify on Telegram
curl -s "https://api.telegram.org/bot$TG_TOKEN/sendMessage" \
  -d chat_id=$TG_CHAT_ID \
  -d text="🛡 Approve $tool? Reply /approve or /deny within 60s. Body: $body"

# Wait for approval file
for i in $(seq 1 60); do
  [ -f /tmp/claude-approve ] && rm /tmp/claude-approve && exit 0
  sleep 1
done
echo "❌ No approval — blocking $tool" >&2
exit 1

(ה) Lint Before Commit

#!/bin/bash
# ~/.claude/hooks/lint-before-commit.sh (PreToolUse + matcher: "Bash")
input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command // ""')

if echo "$cmd" | grep -q '^git commit'; then
  npm run lint || { echo "❌ Lint failed" >&2; exit 1; }
fi
exit 0

לפעמים, השליטה הכי חזקה ב-Claude Code מגיעה לא מ-hook ולא מ-permission, אלא ממשתנה סביבה אחד פשוט. Env vars הם המתג הסמוי שמשנה את התנהגות ה-CLI ברמה הבסיסית — מאיזה API key הוא משתמש, איך הוא מתחבר ל-MCP servers, ואיך הוא מתחבר ל-Bedrock או Vertex.

ה-vars שאני משתמש בהם הכי הרבה

ANTHROPIC_API_KEY — האסימון שלך. אפשר לשים ב-shell env או ב-settings.json תחת "env". אני מעדיף shell env כדי לא לסכן commit בטעות. ANTHROPIC_BASE_URL — אם אתה עובד מאחורי proxy ארגוני או דרך OpenRouter, כאן אתה מגדיר את ה-endpoint. שימושי גם ל-Bedrock עם CLAUDE_CODE_USE_BEDROCK=1.

MCP_TIMEOUT — ברירת מחדל היא 30 שניות, וזה מספיק ל-90% מה-MCP servers. אבל אם אתה רץ על Asana MCP או Canva MCP שמבצעים API calls ארוכים, אתה רוצה להעלות את זה ל-60000 (מילישניות). MCP_TOOL_TIMEOUT — כמו MCP_TIMEOUT אבל ספציפי לכל קריאת tool, לא להתחברות הראשונית.

MCP_DEBUG=true — מצב דיבאג. כשמ-MCP server נופל בשקט (וזה קורה), הפעלת זה תראה לך בדיוק מה נשלח ב-stdio ולמה השרת לא ענה. הצלתי איתו עשרות שעות של דיבאג. DISABLE_TELEMETRY=1 — אם אתה לא רוצה שיהיה דיווח אנונימי ל-Anthropic. DISABLE_AUTOUPDATER=1 — לסביבות CI שאתה לא רוצה ש-Claude יעדכן את עצמו באמצע ריצה.

ה-hook שלך לא רץ. אתה לא יודע למה. אין הודעת שגיאה. ברוך הבא לפינת הדיבאג של Claude Code hooks — מקום שבו אכלתי שעות, ושיש לו עכשיו checklist של 5 בעיות נפוצות.

(1) JSON syntax error משבית את הכל

אם יש פסיק חסר או מרכאה לא סגורה ב-~/.claude/settings.json — Claude Code לא יציג שגיאה. הוא פשוט יתעלם מכל ה-hooks וימשיך לעבוד כרגיל. תמיד תוודא עם:

jq . ~/.claude/settings.json

(2) הקובץ לא executable

הסקריפט שלך עובד פרפקט ב-shell, אבל לא רץ מ-Claude Code? כנראה שכחת chmod +x. Claude מנסה להפעיל אותו ככלי ולא דרך shell, אז הוא צריך הרשאת הרצה.

(3) stdout invisible

כל הדפסה ב-echo או print רגילים הולכת ל-stdout. Claude לא מציג stdout של hooks. אם אתה רוצה לראות הודעת שגיאה — חייב לכתוב ל-stderr:

echo "Error: command blocked" >&2  # נראה
echo "Some debug info"             # לא נראה

(4) Timeout מסלק את ה-hook בשקט

ברירת המחדל היא 60 שניות. אם ה-hook שלך עושה I/O רשתי או מחכה לקלט — סביר שתעבור את זה. הוסף timeout מפורש קצר יותר ב-settings.json תחת "timeout", או הפוך את ה-hook לאסינכרוני (התחל תהליך ב-background ויצא מיד).

(5) Input parsing נכשל בשקט

ה-hook מקבל JSON ב-stdin. אם אתה משתמש ב-cat בלי לפענח — אתה מקבל את הטקסט הגולמי, לא ערכים שדות. תמיד תחיל jq:

input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command')