[קלוד·LEARN]מבית אנתרופיק ישראל
מאמר

Claude Code לעומק: מהבסיס ל-power user

כבר התקנתם והרצתם. עכשיו slash commands, CLAUDE.md חכם, hooks, סוכני משנה ומצבי הרשאה - מה שהופך אתכם למשתמשי-על.

התקנתם את Claude Code, הרצתם claudeבתוך פרויקט, וכבר ביקשתם ממנו לתקן באג. נהדר - זה הבסיס. המאמר הזה הוא מה שבא אחרי: ההגדרות והכלים שמפרידים בין “מי שמשתמש בקלוד בטרמינל” ל- “מי שבנה לעצמו סביבת עבודה”. כל מה שכאן נתמך באופן רשמי, ורובו נמצא בקבצים שאתם שולטים בהם.

CLAUDE.md לעומק

כבר ראיתם שקובץ CLAUDE.md בשורש הפרויקט נטען אוטומטית. מה שפחות ידוע הוא שיש היררכיה שלמה של קבצים כאלה, שנטענים יחד:

  • גלובלי. ~/.claude/CLAUDE.md - הוראות אישיות שמלוות אתכם בכל פרויקט.
  • פרויקט. ./CLAUDE.md בשורש - משותף לצוות, נכנס ל-git.
  • מקומי. CLAUDE.local.md - אישי לפרויקט הזה בלבד (מוסיפים ל-.gitignore).
  • תת-תיקייה. קובץ בתוך תיקייה נטען כשקלוד נוגע בקבצים שם - שימושי במונורפו.

בנוסף, אפשר לייבא קבצים אחרים לתוך CLAUDE.md בעזרת תחביר @path. למשל @README.md או @docs/architecture.md - וכך לא משכפלים תוכן שכבר קיים. והפקודה /init תיצור עבורכם CLAUDE.md ראשוני שמנתח את הפרויקט ומזהה את פקודות הבנייה והבדיקה.

העיקרון

CLAUDE.md הוא לא קונפיגורציה נאכפת - הוא הקשר בשפה חופשית. כתבו בו את מה שהייתם מסבירים למפתח חדש ביום הראשון: stack, מוסכמות, איך מריצים בדיקות, ומה לא לעשות.

פקודות Slash

פקודות שמתחילות ב-/ שולטות בשיחה עצמה. כמה שחובה להכיר:

  • /clear - מתחילים שיחה נקייה (משחרר את חלון ההקשר), בלי לאבד את זיכרון הפרויקט.
  • /compact - מסכמים את השיחה הנוכחית כדי לפנות מקום בלי להתחיל מחדש.
  • /init - יצירה או שיפור של CLAUDE.md מתוך הקוד.
  • /model - מעבר בין Opus, Sonnet ו-Haiku באמצע העבודה.
  • /agents - ניהול ויצירה של סוכני משנה.
  • /mcp - ניהול חיבורי MCP והתחברות.
  • /context - תצוגה ויזואלית של מה צורך את חלון ההקשר.

החלק החזק באמת: פקודות מותאמות אישית. קובץ markdown בתיקיית .claude/commands/ הופך לפקודה - שם הקובץ הוא שם הפקודה, והתוכן הוא הפרומפט שירוץ. למשל .claude/commands/review.md יוצר את /review. אפשר להעביר ארגומנט עם $ARGUMENTS, ולהגדיר ב-frontmatter אילו כלים מותרים ומה התיאור. קבצים ב-~/.claude/commands/ זמינים בכל הפרויקטים.

Plan mode ומצבי הרשאה

ברירת המחדל של קלוד היא לבקש אישור לכל פעולה משמעותית. אבל יש מצבים שמשנים את זה, ומחליפים ביניהם עם Shift+Tab:

  • default. אישור ידני לכל כלי בשימוש הראשון.
  • acceptEdits. עריכות קבצים מתבצעות אוטומטית; פקודות עדיין דורשות אישור.
  • plan mode. קלוד חוקר ומציג תכנית מלאה - בלי לגעת בקוד - עד שאתם מאשרים.
  • bypassPermissions. בלי שאלות. רק לסביבות מבודדות וחד-פעמיות.

Plan mode הוא הכלי החשוב מבין אלה לעבודה רצינית. במשימה גדולה או מסוכנת - שינוי ארכיטקטוני, refactor רחב - תנו לקלוד לחקור ולהציע גישה לפני שהוא נוגע בכלום. תקראו את התכנית, תתקנו, ורק אז תאשרו ביצוע. זה חוסך גלגולים אחורה.

Hooks - אוטומציה אמיתית

אם אי פעם חשבתם “מהיום, בכל פעם שקלוד עורך קובץ, שירוץ פורמטר” - זה בדיוק מה ש-hooks עושים. Hook הוא פקודה שרצה אוטומטית בנקודת מפתח בשיחה. הקונפיגורציה יושבת ב-settings.json (של הפרויקט או הגלובלי).

האירועים העיקריים:

  • PreToolUse - לפני שכלי רץ (אפשר אפילו לחסום אותו).
  • PostToolUse - אחרי שכלי רץ (למשל פורמטר אחרי עריכה).
  • UserPromptSubmit - כשאתם שולחים הודעה.
  • Stop / SessionStart - בסיום תור או בתחילת שיחה.

מצרפים לכל אירוע matcher (למשל Edit|Write) ואת הפקודה שתרוץ. ההבדל מ-CLAUDE.md חשוב: CLAUDE.md מבקש מקלוד להתנהג בצורה מסוימת, ו-hook אוכףזאת ברמת המערכת - הוא ירוץ בין אם קלוד “זכר” ובין אם לא.

זהירות עם hooks

Hook רץ עם ההרשאות שלכם, אוטומטית. hook ש-PreToolUse שמריץ פקודה הרסנית הוא בדיוק כמו להריץ אותה בעצמכם. בדקו סקריפט לפני שמחברים אותו לאירוע שרץ בכל פעולה.

סוכני משנה

סוכן משנה (subagent) הוא מופע נפרד של קלוד עם חלון הקשר משלו. כשמשימה דורשת לקרוא הרבה קבצים - למשל “מצא איפה בקוד מטופל X” - אפשר לשלוח אותה לסוכן משנה, שיחקור ויחזיר רק את המסקנה. כך השיחה הראשית לא מתמלאת בעשרות קבצים שלא תצטרכו שוב.

יש סוכנים מובנים (למשל סוכן חקירה מהיר לקריאה בלבד), ואפשר להגדיר סוכנים מותאמים בקובץ markdown תחת .claude/agents/. ב-frontmatter מגדירים שם, תיאור (מתי קלוד יפנה אליו), אילו כלים מותרים, ואיזה מודל. דפוס נפוץ: סוכן reviewer בעל גישת קריאה בלבד, שמופעל אחרי כל שינוי משמעותי.

MCP - חיבור לעולם

MCP (Model Context Protocol) מחבר את Claude Code לכלים חיצוניים - GitHub, Linear, Slack, Postgres ועוד - בלי העתק-הדבק. מוסיפים שרת בפקודה claude mcp add, וההגדרות יכולות להישמר ברמת המשתמש או בקובץ .mcp.json משותף לצוות. זה נושא בפני עצמו, ויש לו מדריך נפרד - אבל שווה לדעת שזה החוט שמחבר את הטרמינל החכם לשאר המערכות שלכם.

תהליכי עבודה מעשיים

כשמרכיבים את הכול יחד, נוצרים דפוסים חוזרים:

  • refactor בטוח. plan mode כדי לראות את הגישה, אישור, ביצוע, ו-hook שמריץ בדיקות אחרי כל עריכה.
  • חקירה לפני שינוי. סוכן משנה שממפה את האזור הרלוונטי ומחזיר תקציר, לפני שנוגעים בקוד.
  • סקירה עצמית. פקודת /review מותאמת שמריצים על הדיף לפני commit.
  • סטנדרט צוותי. CLAUDE.md משותף + .mcp.json + סוכנים בפרויקט, כך שכל מי שמושך את הריפו מקבל את אותה סביבה.

כללי אצבע ל-power user

שלושה עקרונות שמסכמים את הכול. ראשון: השקיעו ב-CLAUDE.md - זו ההשקעה עם ההחזר הגבוה ביותר, כי היא משפרת כל שיחה עתידית. שני: השתמשו ב-plan mode כברירת מחדל למשימות גדולות - עדיף לתקן תכנית מאשר לגלגל קוד אחורה. שלישי: אל תאמצו הכול בבת אחת. הוסיפו פקודה מותאמת אחת, hook אחד, סוכן אחד - וכשהם מוכיחים את עצמם, הרחיבו.

ההבדל בין משתמש רגיל ל-power user הוא לא בידע סודי, אלא בכך שהשני הפך את הסביבה שלו לקבצים - שאפשר לשתף, לגרסן, ולשפר. כל מה שתיארנו כאן יושב בתיקיית .claude שלכם, וגדל יחד עם הפרויקט.

שאלות נפוצות

מה זה CLAUDE.md ואיפה הוא יושב?
CLAUDE.md הוא קובץ הוראות שקלוד קורא אוטומטית בכל שיחה. הוא יכול לשבת בשורש הפרויקט (הקשר לפרויקט הספציפי), ב-~/.claude/CLAUDE.md (הוראות גלובליות לכל הפרויקטים), ובתת-תיקיות. אפשר גם לייבא קבצים נוספים עם תחביר @path.
איך יוצרים slash command מותאם אישית?
יוצרים קובץ markdown בתיקיית .claude/commands/ בפרויקט (או ב-~/.claude/commands/ לפקודות אישיות חוצות-פרויקטים). שם הקובץ הופך לשם הפקודה, והתוכן הוא הפרומפט. אפשר להעביר ארגומנטים עם $ARGUMENTS ולהגדיר frontmatter.
מה זה hooks ב-Claude Code?
Hooks הם פקודות שרצות אוטומטית בנקודות מפתח - למשל לפני שימוש בכלי (PreToolUse), אחריו (PostToolUse), או בסיום השיחה (Stop). מגדירים אותם ב-settings.json. שימוש נפוץ: להריץ פורמטר אחרי כל עריכה, או לאכוף בדיקה לפני פקודה.
מה זה סוכן משנה (subagent)?
סוכן משנה הוא מופע נפרד של קלוד עם חלון הקשר משלו, שמופעל למשימה ממוקדת (למשל חיפוש רחב בקבצים) ומחזיר רק את המסקנה. כך השיחה הראשית לא מתמלאת בפרטים. אפשר להגדיר סוכנים מותאמים בתיקיית .claude/agents/.
מה זה plan mode ומתי משתמשים בו?
Plan mode הוא מצב שבו קלוד חוקר ומציג תכנית מלאה בלי לבצע שינויים, עד שאתם מאשרים. מתאים למשימות גדולות או מסוכנות שבהן רוצים לראות את הגישה לפני שנוגעים בקוד. מחליפים מצבי הרשאה עם Shift+Tab.