ניהול זיכרון ב-Claude Code - המדריך המלא

למה זה חשוב

Claude לא באמת "זוכר" כלום בין שיחות. בכל session חדש הוא מתחיל מאפס. מה שיוצר אשליה של זיכרון הם קבצי הוראות שנטענים אוטומטית בכל פעם שאתה מפעיל את Claude Code.

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

המטרה שלנו: שרק מה שבאמת חשוב יטען בכל session. הוראות שרלוונטיות רק ל-Supabase לא צריכות להיטען כשאתה עובד על עיצוב CSS.

מה נטען לזיכרון בכל session

כש-Claude Code נפתח, הוא טוען את הדברים הבאים לפני שאתה בכלל כותב הודעה ראשונה:

• •CLAUDE.md קבצים: מהפרויקט והתיקיות מעליו, עד ~/.claude/CLAUDE.md
• •MEMORY.md: 200 השורות הראשונות של הזיכרון האוטומטי של Claude
• •Rules: קבצים מ-~/.claude/rules/ ומ-.claude/rules/ בפרויקט (אלה בלי paths נטענים תמיד)
• •Skills descriptions: התיאור של כל ה-skills המותקנים (גם אם לא משתמשים בהם)
• •MCP instructions: הוראות מכל שרת MCP מחובר
• •הודעת מערכת: ההנחיות של Claude Code עצמו

כשאתה רואה את ההודעה Large CLAUDE.md will impact performance, זה אומר שכל זה יחד גדול מדי. הפתרון לא תמיד ב-CLAUDE.md עצמו - לפעמים זה skillsכפולים או MCPs שאתה לא משתמש בהם.

ההיררכיה - global vs project vs local

יש שלוש שכבות של הוראות. הן נטענות ביחד ועובדות זו עם זו:

חוק הקדימות: כשיש סתירה, הקובץ הספציפי יותר מנצח. CLAUDE.local.md > ./CLAUDE.md>~/.claude/CLAUDE.md.

CLAUDE.md - ההוראות שלכם

זה הקובץ הראשי. אתה כותב אותו, ו-Claude קורא אותו בכל session. הכלל הבסיסי: מתחת ל-200 שורות. אם הוא גדול יותר, Claude מפספס הוראות.

דוגמה ל-~/.claude/CLAUDE.md גלובלי טוב:

# Global Rules

## General
- Always respond in English
- Don't ask questions when the intent is clear
- Never use em dashes

## Research Before Assuming
- Never make assumptions about library APIs
- Check docs via Context7 first
- Ask only if all research options fail

## Scope Discipline
- Only modify files related to the task
- When fixing X, don't touch Y and Z "while you're at it"

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

MEMORY.md - מה ש-Claude זוכר לבד

יש מערכת זיכרון אוטומטית ב-Claude Code. היא יושבת ב-~/.claude/projects/[project]/memory/. Claude כותב לשם דברים שהוא לומד תוך כדי עבודה.

המבנה: יש MEMORY.md שהוא אינדקס (רק 200 השורות הראשונות נטענות), והוא מצביע על קבצי זיכרון ספציפיים שנטענים רק כשצריך.

# Memory Index

- [projects.md](projects.md) - Active projects with stacks
- [skills-setup.md](skills-setup.md) - Installed plugins and skills
- [feedback_no_em_dashes.md](feedback_no_em_dashes.md) - Never use em dashes
- [courses-clubs.md](courses-clubs.md) - Project-specific patterns

מה כדאי לשמור בזיכרון: העדפות שאמרת ל-Claude בעבר ("אל תשתמש ב-em dashes"), תבניות שגילית ("הפרויקט X משתמש ב-Polar.sh ולא Stripe"), החלטות ארכיטקטורה. מה לא לשמור: מידע שתלוי בזמן (סטטוס PR, משימות נוכחיות).

Rules עם scope - כללים חכמים

זה הטריק הכי חשוב. במקום קובץ CLAUDE.md ענק, תפצל לקבצי rules קטנים ב-~/.claude/rules/ או .claude/rules/, וכל אחד יטען רק כשצריך.

דוגמה: כלל שמיועד לקבצי Fly.io בלבד:

---
paths:
  - "**/fly.toml"
  - "**/*flyio*"
  - "**/provisioning*"
description: Fly.io operations - loads only when touching Fly files
---

# Fly.io Operations

## Destroying an Instance
1. flyctl apps list
2. flyctl machines list --app <name>
...

עכשיו הכלל הזה נטען רק כש-Claude פותח קובץ fly.toml או קובץ provisioning. בכל שאר הזמן הוא לא תופס מקום בהקשר.

תבנית לחלוקה: כל נושא (auth, billing, database, deployment, frontend, testing) בקובץ נפרד עם paths משלו.

Skills - יכולות שנטענות בבקשה

Skills הם כמו rules על סטרואידים. כל skill הוא תיקיה עםSKILL.md שמגדיר מתי להשתמש בו, ואז Claude קורא אותו רק כשמתאים.

החיסרון: התיאור של כל skill נטען בהודעת המערכת בכל session. אם יש לך עשרות skillsמותקנים, התיאורים שלהם תופסים הרבה מקום בהקשר.

הפתרון: auditתקופתי. ב-Claude Code הרץ /memory כדי לראות מה נטען. skills שלא משתמשים בהם - למחוק:

npx skills remove <skill-name>

מתי להשתמש ב-skill ומתי ב-rule? Rule = הוראה שחלה על קבצים מסוימים. Skill = יכולת שלמה עם scripts, references, ותהליך עבודה. Skill כבד יותר מ-rule.

MCPs - חיבורים חיצוניים

MCP (Model Context Protocol) היא הדרך ש-Claude מתחבר לשירותים חיצוניים - Supabase, Vercel, PostHog, Brave Search, וכו'. כל MCPשמחובר מוסיף הוראות להקשר.

לבדוק את כל ה-MCPs המחוברים:

claude mcp list

אם יש MCP שלא מחובר (Needs authentication) או שבור (Failed to connect), להסיר:

claude mcp remove <name>

טיפ: MCPs שמגיעים מ-Claude.ai (לא מקומיים) מנוהלים דרך claude.ai/settings/integrations, לא דרך ה-CLI.

Best Practices - 9 כללי זהב

1. 01

   שמור CLAUDE.md מתחת ל-200 שורות. אם גדול יותר - פצל ל-rules.

2. 02

   השתמש ב-paths frontmatter. כללי תשתית (Fly, Supabase, AWS) לא צריכים להיטען תמיד.

3. 03

   הפרד בין גלובלי לפרויקט. העדפות אישיות ב-~/.claude/, ארכיטקטורה ב-./CLAUDE.md.

4. 04

   השתמש ב-CLAUDE.local.md לדברים אישיים. URLים מקומיים, הערות, sandbox credentials. תוסיף ל-.gitignore.

5. 05

   audit כל חודש. /memory ב-Claude Code, claude plugin list, claude mcp list. מה לא בשימוש - להסיר.

6. 06

   אל תדחוף הכל ל-CLAUDE.md. Claude יודע לקרוא קבצים. עדיף להצביע על מסמך מאשר להדביק אותו פנימה.

7. 07

   תתעד את הסיבה, לא רק את ההוראה. "אל תעשה X" בלי הסבר יישכח. "אל תעשה X כי פעם זה שבר את Y" יזכר.

8. 08

   תן ל-Claude לזכור בעצמו. MEMORY.md האוטומטי עובד טוב. אם תיקנת אותו פעם - הוא ישמור את זה.

9. 09

   תסתכל על CLAUDE.md כחוזה, לא כאנציקלופדיה. זה הוראות, לא ספר. קצר וישיר עובד יותר טוב.

הפרומפט לבדיקה אוטומטית

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

אני רוצה שתבדוק ותסדר את הגדרות הזיכרון של Claude Code שלי.

עשה את הצעדים הבאים:

1. רוץ את הפקודות הבאות ואסוף מידע:
   - ls -la ~/.claude/CLAUDE.md ~/.claude/rules/ ~/.claude/skills/
   - wc -l ~/.claude/CLAUDE.md ~/.claude/rules/**/*.md
   - find . -maxdepth 3 -name "CLAUDE.md" -not -path "*/node_modules/*"
   - claude plugin list (אם יש)
   - claude mcp list

2. נתח את המצב ותגיד לי:
   - כמה שורות יש ב-CLAUDE.md הגלובלי (צריך להיות פחות מ-200)
   - האם יש rules שטעונים בלי scope (paths frontmatter)?
   - כמה CLAUDE.md יש בפרויקטים והאם הם גדולים מדי (מעל 200 שורות)?
   - האם יש skills שכפולים או לא בשימוש?
   - האם יש MCPs לא מחוברים או מיותרים?

3. תן לי דוח ברור:
   - מה טוב: X
   - מה לא: Y
   - 5 דברים ספציפיים שאני יכול לתקן עכשיו

4. אם אני אבקש, תעשה את התיקונים בעצמך:
   - הוסף paths frontmatter ל-rules רלוונטיים
   - פצל CLAUDE.md גדולים ל-rules מכוונים
   - הסר skills/MCPs לא בשימוש (עם אישור שלי)

תתחיל ותתן לי את הדוח.

איך להשתמש:

1. •פתח Claude Code (cd ~ && claude)
2. •העתק את הפרומפט למעלה
3. •הדבק ב-Claude
4. •תקבל דוח מסודר של מה טוב ומה לא
5. •תאשר ל-Claude לתקן (או תתקן ידנית)

תריץ את זה פעם בחודש. ההגדרות שלך יצברו אבק. skills שכחת שהתקנת, MCPs שבורים, CLAUDE.md שגדל בלי שהרגשת. חצי שעה של סדר כל חודש = שעות של Claude שעובד טוב.