Claude Code Mods: המדריך לבניית מודים בלי לכתוב קוד

מודים (Mods) הם הדרך לשנות את Claude Code עצמו. מוד יכול להוסיף לו חלונית בצד השיחה, פס מידע מעל שורת ההקלדה או פקודה חדשה. הוא יכול גם לעצור או לשנות פעולה רגע לפני ש-Claude מבצע אותה. לא צריך לכתוב קוד: מתארים ל-Claude מה רוצים והוא בונה את המוד, בודק אותו ומפעיל אותו באותה שיחה.

בניתי ככה שלושה מודים, בטרמינל ובאפליקציה של Claude: פס שמראה כמה ניצלתי מהמכסה של המנוי, מוד שמסתיר מפתחות API לפני ש-Claude רואה אותם ופקודה שפותחת סיכום של הסשן בחלונית צד.

איך מוד עובד?

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

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

ל-Claude Code כבר היו Hooks, פקודות או סקריפטים שרצים כשאירוע קורה. Hook יכול לעצור קריאה לכלי או לשנות את הקלט והפלט שלה, אבל הוא רץ מחוץ ל-Claude Code. מוד רץ בתוכו. לכן הוא יכול גם לצייר ממשק, להריץ קוד משלו כשמקלידים פקודה ולהחליף חלקים ש-Claude Code מצייר בעצמו. גם חלק מהדברים ש-Claude Code עושה בעצמו בנויים היום כמודים, למשל הפקודה /diff.

איפה מודים עובדים?

בטרמינל צריך Claude Code מגרסה 2.1.287 ומעלה (בודקים עם claude --version). באפליקציה יש עותק משלה של Claude Code. מודים עובדים בו מגרסה 2.1.286. את הגרסה רואים כשמקלידים /status בשיחה מקומית בלשונית Code. אין מה להפעיל: מודים פעילים כברירת מחדל. בסשן בענן רץ רק תוסף שמגיע לסשן עצמו, כך שהמודים שהתקנתם במחשב לא נטענים שם. באפליקציה כמה רכיבי ממשק עובדים רק בטרמינל.

איך בונים מוד בלי לכתוב קוד?

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

1מתארים את המוד במילים שלכם

בשיחה בתיקייה של הפרויקט כותבים מה המוד צריך לעשות ואיפה רואים אותו:

1. הבקשה, בעברית רגילה.
2. Claude טוען לבד את הסקיל לבניית מודים.
3. הוא קורא את הגדרות הממשק של הגרסה שמותקנת אצלכם, כך שהוא בונה לפיהן ולא לפי מה שהוא זוכר.

2מאשרים את הקבצים ואת הטעינה

Claude כותב את המוד לתיקייה של השיחה, בתוך ~/.claude/dev-mods. במצב Manual מאשרים כל קובץ. כשהקובץ הראשון נשמר, Claude Code שואל אם להפעיל hot reloading לשיחה הזו. בוחרים Enable for this session (1). מעכשיו המוד נטען בסוף התור. כל שינוי בו נטען מחדש בסוף התור שבו נעשה.

1. Enable for this session מפעיל את המוד בסוף התור. Not now משאיר את הקבצים במקום. המוד ייטען רק בפעם הבאה שהשיחה תיפתח.
2. פס המכסה של usage-band, מוד שכבר מותקן בפרויקט.

3בודקים ומבקשים תיקונים

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

מה עושים כשמוד לא נטען

Claude Code כותב בשיחה שורה עמומה עם שם המוד והסיבה (1). מעתיקים אותה ל-Claude ומבקשים תיקון. זה קורה בעיקר בשיחה שבה Claude לא יכול להריץ פקודות, כי אז הוא לא בודק את המוד לפני שהוא מסיים.

הבקשה ששלחתיהעתקה

המוד לא נטען, זו השורה שהופיעה: $ is passed to "refresh", which is not a function declared at the top of this file. תתקן.

אם המוד נטען ועדיין לא מצייר כלום, הסיבה מופיעה ביומן של claude --debug. זכרו גם שבחלונית הצ'אט של התוסף ל-VS Code מודים לא מציירים בכלל.

שלושה מודים שבניתי

פס מכסה מעל שורת ההקלדה

usage-bandמחובר ל: תחילת הסשן, סוף כל תור וציור הפס

כמה ניצלתי מחלון 5 השעות ומהמכסה השבועית, בלי להקליד /usage. הפס מתעדכן אחרי כל תשובה ומראה מתי כל מכסה מתאפסת. הוא ירוק עד 50%, צהוב עד 80% ואדום מעל זה. באפליקציה הוא נראה כמו בצילום הקודם. בטרמינל, כך:

הפס שימושי רק במנוי Pro או Max. כשעובדים עם מפתח API, Claude Code לא מקבל נתוני מכסה ואין לפס מה להציג.

הסתרת מפתחות API מפלט של כלים

hide-keysמחובר ל: כל קריאה לכלי

בתיקייה של הפרויקט יש קובץ .env עם מפתח לשירות המיילים. המוד בודק כל פלט שחוזר מכלי. אם יש בו מפתח, טוקן או ערך מקובץ env, הוא מחליף אותו ב-[hidden] לפני ש-Claude רואה את הפלט.

1. Claude רואה את שמות המשתנים, אבל במקום הערכים מגיע אליו [hidden].
2. ההודעה שהמוד מקפיץ בכל הסתרה.

סיכום הסשן בחלונית צד

recapמחובר ל: הפקודה /summary, תחילת הסשן וציור החלונית

מקלידים /summary ונפתחת חלונית עם מה שנעשה בשיחה, אילו קבצים שונו ונקראו, מה הוחלט ומה עוד פתוח. הסיכום לא נכנס לשיחה: המוד שואל את המודל שאלת צד על התמליל ומציג את התשובה בחלונית. הכפתור רענון (1) מכין סיכום חדש. כל רענון הוא קריאה למודל. לכן הוא נספר במכסה.

החלק "מה עוד פתוח" (2) שימושי במיוחד. הוא אוסף הערות ש-Claude כתב באמצע העבודה ושקל לפספס בגלילה.

הבקשה למוד הזה היא הדוגמה משלב 1.

איך שומרים מוד לשיחות הבאות?

מוד ש-Claude בנה נטען רק בשיחה שבה נבנה. אחרי תקופה Claude Code גם מוחק את התיקייה שלו (לפי ההגדרה cleanupPeriodDays). כדי לשמור אותו, מעתיקים את תיקיית המוד מ-~/.claude/dev-mods/<מזהה השיחה>/ לתיקייה קבועה. אני העתקתי את שלושת המודים ל-C:\work\mods, הוספתי לידם קובץ .claude-plugin/marketplace.json קצר שמפרט אותם והתקנתי אותם לפרויקט:

claude plugin marketplace add C:\work\mods --scope project
claude plugin install usage-band@my-mods --scope project
claude plugin install hide-keys@my-mods --scope project
claude plugin install recap@my-mods --scope project

ההתקנה עם --scope project רושמת את המודים בהגדרות של הפרויקט. לכן הם נטענים בכל שיחה בתיקייה הזו (בטרמינל ובאפליקציה) ולא בפרויקטים אחרים. כדי שייטענו בכל מקום משתמשים ב---scope user. אם הפרויקט משותף ב-git והמודים בתיקייה מקומית, --scope local רושם אותם רק אצלכם. לניסיון חד-פעמי מספיק claude --plugin-dir ואחריו הנתיב לתיקיית המוד. כשמתקינים בטרמינל בזמן ששיחה פתוחה, מקלידים בה /reload-plugins כדי שהמוד ייטען. באפליקציה הפקודה /plugin install לא זמינה. שם מתקינים מהכפתור + שליד שורת ההקלדה, דרך Plugins ואז Add plugin.

1. השורה שמונה את המודים שפעילים בשיחה.
2. ההיקף שבו הם הותקנו, כאן הפרויקט.

כדי לשתף מוד, מעלים את התיקייה למאגר ב-GitHub עם קובץ ה-marketplace. מי שרוצה להשתמש בו מוסיף את המאגר עם /plugin marketplace add ומתקין עם /plugin install. אפשר גם להגיש אותו לספריית התוספים של Claude.

איך מכבים מוד?

• מוד אחד: ב-/plugin, בלשונית Installed, מכבים אותו או מסירים. באפליקציה עושים את זה מהכפתור + שליד שורת ההקלדה, דרך Plugins ואז Manage plugins.
• כל המודים שהתקנתם, לשיחה אחת: מפעילים את Claude Code עם claude --safe-mode. זה מכבה גם התאמות אישיות אחרות.
• כל המודים שהתקנתם, בכל השיחות: מוסיפים "disableAllHooks": true לקובץ ~/.claude/settings.json. זה עוצר גם Hooks רגילים ושורת סטטוס מותאמת.

--safe-mode ו-disableAllHooks לא עוצרים את המודים המובנים של Claude Code. אותם מכבים אחד אחד ב-/plugin, חוץ מ-sec-default שאי אפשר לכבות.

מה בודקים לפני שמתקינים מוד של מישהו אחר?

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

• לקרוא ולכתוב קבצים בכל מקום שהמשתמש שלכם יכול, להפעיל תוכנות ולגשת לרשת.
• לקרוא משתני סביבה וקובצי הגדרות, כולל מפתחות API שנמצאים בהם.
• לראות כל בקשה שלכם וכל פעולה של Claude.
• לשנות בקשה או פעולה ואפילו לשלוח בקשה כאילו הקלדתם אותה.
• לאשר פעולה בלי לשאול אתכם.
• להשתמש במכסה שלכם בקריאות למודל.

ה-sandboxing של Claude Code מבודד רק את הפקודות ש-Claude מריץ. תהליך שמוד מפעיל רץ מחוצה לו. מנגד, מוד לא יכול לשנות את חלון בקשת ההרשאה ואת מה שמוצג בו.

רואים מה מוד עושה בלי להריץ אותו

הפקודה claude plugin validate קוראת את הקוד של מוד בלי להריץ אותו. היא מפרטת לאילו אירועים הוא מחובר ומה הוא מבקש מ-Claude Code לעשות. מורידים את התיקייה של המוד (למשל עם git clone) ומריצים עליה:

claude plugin validate ./hide-keys

בשורה hooks רואים שהמוד מחובר רק לקריאות לכלים. השורה calls מראה שכל מה שהוא מבקש מ-Claude Code הוא להקפיץ הודעה, בלי גישה לקבצים, לרשת או לתהליכים. מוד שמבקש יותר יפרט את זה כאן. השורה האמצעית מסמנת hook שיכול לעצור או לשנות פעולה ואין לו .catch. לפי התיעוד, אם hook כזה נופל אחרי שהכלי רץ, התוצאה המקורית ממשיכה הלאה. אצל hide-keys זה אומר שהמפתח יגיע ל-Claude. לכן כדאי לבקש מ-Claude להוסיף .catch שעונה במקום ה-hook כשהוא נופל.

בתוכניות Team ו-Enterprise ובכל מחשב עם הגדרות מנוהלות, Claude Code טוען מוד מובנה בשם sec-default לפני כל מוד שהמשתמש התקין. הוא לא נותן למוד לאשר פעולה שכלל deny דוחה ולא לשנות את מה שהארגון מנהל. מנהלים יכולים לטעון לפניו מודים משלהם ולקבוע מאילו מאגרים מותר להתקין תוספים.

מודים מוכנים להתחלה

Anthropic מפרסמת שלושה מודים לדוגמה במאגר claude-code-playground, כל אחד עם הסבר איך נבנה. הם משותפים כמו שהם, בלי תמיכה:

• token-weatherתחזית מזג אוויר לחלון ההקשר מעל שורת ההקלדה, עם גרף קטן של התורים האחרונים.
• blast-radiusעוצר פקודה מסוכנת כמו rm -rf או force push, מראה מה היא תשנה ומחכה ל-Proceed או ל-Cancel.
• replay-theaterפקודה /replay שעוברת על העריכות שנעשו בתור האחרון, אחת אחת.

git clone https://github.com/anthropics/claude-code-playground.git
cd claude-code-playground/claude-code/mods
claude --plugin-dir ./token-weather

גם בתוך Claude Code יש מודים מובנים. הם רשומים ב-/plugin תחת Built-in. בין השאר: הפקודה /diff, הטעינה של קובצי AGENTS.md והסקיל לבניית מודים. אחד מהם כבוי כברירת מחדל ושווה להכיר: cc-plugin-you-should-know, סוכן צד שעוקב אחרי משימות ארוכות ומציג מעל שורת ההקלדה הערה כשיש משהו שכדאי לדעת. אם הוא זמין בחשבון שלכם, מפעילים אותו עם /plugin enable cc-plugin-you-should-know@builtin.

מוד, Hook, סקיל או MCP: מה מתאים לכם?

ארבעתם מרחיבים את Claude Code, כל אחד בדרך אחרת. אם סקיל או Hook שכבר קיים עושה את מה שצריך, אין סיבה לבנות מוד.

המקורות הרשמיים

• Customize Claude Code with mods: ההכרזה של Anthropic, מה מודים יכולים לעשות ו-sec-default בארגונים
• Mods overview: איפה מודים עובדים, מה מוד יכול לגשת אליו, גרסאות והמודים המובנים
• Create a mod: בקשה מ-Claude, hot reloading, שמירת מוד ו-claude plugin validate
• Manage mods for your organization: הגדרות מנוהלות ובדיקת מוד בארגון
• Getting started with Claude Code mods: המדריך של Anthropic לבניית מוד ראשון
• claude-code-playground/claude-code/mods: שלושת מודי הדוגמה
• anthropics/claude-code/mods: הקוד של חלק מהמודים המובנים