📘 תיעוד 5

חקירת ספריית .claude

המקום שבו Claude Code קורא את CLAUDE.md, settings.json, hooks, skills, commands, subagents, workflows, rules וזיכרון אוטומטי. סקור את ספריית .claude בפרויקט ואת ~/.claude בספריית הבית.

Claude Code קורא הוראות, הגדרות, skills, subagents וזיכרון מספריית הפרויקט ומ-~/.claude בספריית הבית. בצע commit לקבצי הפרויקט ב-git כדי לשתף אותם עם הצוות. קבצים ב-~/.claude הם תצורה אישית שחלה על כל הפרויקטים.

ב-Windows, ~/.claude מתפרש כ-%USERPROFILE%\.claude. אם מגדירים את CLAUDE_CONFIG_DIR, כל נתיב ~/.claude בדף זה נמצא תחת הספרייה הזו. אותו דבר חל על .claude.json, שבמקרה הרגיל נמצא ב-~/.claude.json.

רוב המשתמשים עורכים רק את CLAUDE.md ואת settings.json. אם במאגר כבר יש AGENTS.md עבור סוכני קוד אחרים, Claude Code יכול לקרוא אותו במקום CLAUDE.md. שאר הספרייה אופציונלי: הוסף skills, rules או subagents לפי הצורך.

#חקירת הספרייה

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

#מה לא מוצג

הסייר מכסה קבצים שאתה כותב ועורך. כמה קבצים קשורים נמצאים במקום אחר:

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

#בחירת הקובץ הנכון

סוגים שונים של התאמה אישית נמצאים בקבצים שונים. השתמש בטבלה זו כדי למצוא לאן שינוי שייך.

#אסמכתת קבצים

הטבלה הזו מפרטת כל קובץ שהסייר מכסה. קבצים בהיקף פרויקט נמצאים במאגר תחת .claude/ (או בשורש עבור CLAUDE.md, .mcp.json ו-.worktreeinclude). קבצים בהיקף גלובלי נמצאים ב-~/.claude/ וחלים על כל הפרויקטים.

[!NOTE]

כמה דברים יכולים לדרוס את מה ששמים בקבצים האלה:

• הגדרות מנוהלות שהארגון פורס מקבלות עדיפות על כל קובץ הגדרות ועל ערך --settings, מלבד החריגים תחת עדיפות הגדרות
• דגלי CLI כמו --permission-mode או --settings דורסים את settings.json עבור אותה הפעלה
• חלק ממשתני הסביבה מקבלים עדיפות על ההגדרה המקבילה, אבל זה משתנה: בדוק את אסמכתת משתני הסביבה עבור כל אחד

ראה עדיפות הגדרות לסדר המלא.

לחץ על שם קובץ כדי לפתוח את הצומת הזה בסייר למעלה.

#שדות frontmatter לפי קובץ

Skills, קבצי command, subagents, output styles ו-rules קוראים את התצורה שלהם מ-YAML frontmatter בראש הקובץ, וכל אחד מקבל סט שדות משלו. הטבלה הזו מפרטת את שמות השדות לכל קובץ ומקשרת לאסמכתה שמתארת אותם.

Agents שנשלחים בתוך תוסף מכבדים תת קבוצה של שדות ה-subagent.

#איתור תקלות בתצורה

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

#נתוני יישום

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

התמליל יכול גם להחזיק את מה ש-Claude Code שולח למודל יחד עם ההודעות:

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

#מנוקה אוטומטית

Claude Code מוחק את הקבצים בנתיבים שלהלן אחרי שהם ישנים יותר מ-cleanupPeriodDays, כל עוד הוא יכול לקבוע בבטחה את תקופת השמירה. ברירת המחדל היא 30 ימים והמינימום הוא 1. הגדרת 0 נכשלת עם שגיאת אימות. אותו סף גיל חל על הסרה אוטומטית של worktrees יתומים.

קובצי סשן ב-sessions/, זיכרון אוטומטי, ותמלילי Claude Desktop ו-Cowork כל אחד לפי כלל שמירה משלו:

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

• זיכרון אוטומטי: הסריקה לא מוחקת את קובצי הזיכרון בתיקיית הזיכרון האוטומטי של פרויקט, projects/<project>/memory/. Claude Code מסיר את התיקייה הזו רק אם היא הייתה ריקה במשך כל תקופת השמירה. לפני v2.1.228, הסריקה התייחסה לתיקיות בתוך תיקיית הזיכרון כאל נתוני סשן ויכלה למחוק קבצים ישנים שמתחתיה.

• תמלילי Claude Desktop ו-Cowork: Claude Code שומר את התמליל של סשן שהתחלת או שהמשכת לאחרונה ב-Claude Desktop או ב-Cowork בכל גיל. כדי לתת לתמלילים האלה מגבלת גיל, הגדר desktopSessionCleanupPeriodDays. דורש Claude Code v2.1.248 או חדש יותר. גרסאות קודמות מוחקות אותם אחרי cleanupPeriodDays.

  Claude Code מוחק את התמלילים האלה אחרי cleanupPeriodDays במקום זאת באחד מהמקרים האלה:

  • הגדרות מנוהלות מגדירות cleanupPeriodDays
  • תצורת HIPAA חלה על הסשנים שלך

Claude Code מדלג על סריקת הגיל במקרים האלה:

• מצב bare: כשמריצים claude -p עם --bare, Claude Code לא מריץ את הסריקה באותו סשן.
• סריקה מושהית: אם Claude Code לא יכול לקבוע בבטחה את תקופת השמירה, הוא משהה את סריקת ניקוי השמירה. אירוע retention_sweep מפרט כל תצורה שמשהה אותו. כשהסיבה היא קובץ הגדרות שלא ניתן לקרוא או לנתח, או שגיאות הגדרות שבהן cleanupPeriodDays או desktopSessionCleanupPeriodDays הוגדרו במפורש, Claude Code גם מציג אזהרה ב-/status עד שמתקנים את שגיאות ההגדרות. כשהגדרות מנוהלות מספקות cleanupPeriodDays, Claude Code מריץ את הסריקה לפי הערך המנוהל בכל אחד מהמקרים.

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

#תיקיית הטיוטה של הסשן

ה-scratchpad הוא תיקייה לפי סשן ש-Claude Code נותן ל-Claude עבור קבצים זמניים: תוצאות ביניים, סקריפטי עזר וטיוטות שלא שייכים לפרויקט שלך. כש-Claude אומר שהוא שמר משהו "to the scratchpad", הקובץ נמצא שם. Claude משתמש בו במקום /tmp, ויכול ליצור, לערוך ולקרוא קבצים בו בלי בקשת הרשאה.

ה-scratchpad נמצא תחת תיקיית הזמני של Claude Code ולא תחת ~/.claude. מצא את הנתיב של הסשן הנוכחי לפי הפלטפורמה שלך:

• macOS: /private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/
• Linux: /tmp/claude-<uid>/<project>/<session-id>/scratchpad/, או אותה צורה תחת $TMPDIR כשהמערכת מגדירה אחד
• Windows: %TEMP%\claude\<project>\<session-id>\scratchpad\

<project> הוא נתיב תיקיית העבודה שלך, שבו כל תו שאינו אות או ספרה מוחלף ב--, למשל -Users-you-my-project. אם מגדירים CLAUDE_CODE_TMPDIR, העץ עובר תחת התיקייה הזו במקום זאת. Hooks מקבלים את הנתיב של הסשן הנוכחי כ-scratchpad_dir.

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

לסשן יש scratchpad רק כשכל אלה מתקיימים:

• אתה מחובר עם חשבון claude.ai ולא עם מפתח API
• הסשן משתמש ב-API של Anthropic, לא ב-Amazon Bedrock, ב-Agent Platform של Google Cloud, או ב-Microsoft Foundry
• enableArtifact לא מוגדר ל-false

#נשמר עד שמוחקים אותם

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

#קובצי מצב שכדאי לשמור

לפי התכונות שבשימוש, ~/.claude/ מחזיק גם קבצים שהטבלאות תחת נתוני יישום לא מפרטות. מתוכם, מטמונים וקובצי נעילה בטוחים למחיקה. שמור את קובצי המצב האלה:

• .credentials.json: פרטי ההתחברות שלך
• agent-memory/: זיכרון subagent
• jobs/ ו-daemon/: מצב סשן רקע

#אחסון בטקסט גלוי

תמלילים והיסטוריה לא מוצפנים במנוחה. הרשאות הקבצים של מערכת ההפעלה הן ההגנה היחידה. אם כלי קורא קובץ .env או שפקודה מדפיסה פרט גישה, הערך הזה נכתב אל projects/<project>/<session>.jsonl. כדי לצמצם חשיפה:

• הורד את cleanupPeriodDays כדי לקצר כמה זמן Claude Code שומר תמלילים
• הגדר desktopSessionCleanupPeriodDays כדי לתת גם לתמלילי Claude Desktop ו-Cowork מגבלת גיל
• הגדר את משתנה הסביבה CLAUDE_CODE_SKIP_PROMPT_HISTORY כדי לדלג על כתיבת תמלילים והיסטוריית הנחיות בכל מצב. במצב לא אינטראקטיבי אפשר במקום זאת להעביר --no-session-persistence יחד עם -p, או להגדיר persistSession: false ב-TypeScript Agent SDK. ל-Python SDK אין אפשרות מקבילה.
• השתמש בכללי הרשאה כדי למנוע קריאה של קובצי פרטי גישה

#ניקוי נתונים מקומיים

הרץ את claude purge כדי למחוק את המצב ש-Claude Code מחזיק עבור פרויקט אחד. הוא מוחק:

• תמלילים וזיכרון אוטומטי תחת projects/
• רשומות tasks/, debug/ ו-file-history/ לכל סשן
• שורות פרומפט תואמות ב-history.jsonl
• הרשומה של הפרויקט ב-~/.claude.json

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

הפקודה מדפיסה את תוכנית המחיקה המלאה ומבקשת אישור לפני שהיא מסירה דבר.

לפני v2.1.288 הפקודה הייתה claude project purge.

הדוגמאות למטה משתמשות ב-~/work/my-repo כמציין מקום. החלף אותו בנתיב לפרויקט שלך. אם אין מצב שתואם לנתיב, הפקודה מדפיסה שגיאה ויוצאת עם סטטוס 1.

תצוגה מקדימה של התוכנית בלי למחוק דבר:

claude purge ~/work/my-repo --dry-run

התוכנית מפרטת כל פריט תואם ולמה הוא נכלל:

Purge plan for /home/user/work/my-repo:

  dir:    /home/user/.claude/projects/-home-user-work-my-repo
           project transcripts (.jsonl) and memory/
  config: projects["/home/user/work/my-repo"]
           project entry in ~/.claude.json (trust, history, MCP servers)
  filter: /home/user/.claude/history.jsonl
           12 prompt(s) typed in this project

shell-snapshots/ are not project-scoped and will not be touched
backups/ may still contain this project entry in old .claude.json snapshots (/home/user/.claude/backups); at most 5 are kept and they rotate out automatically
Dry run: 3 item(s) would be deleted.

מחיקה עם בקשת אישור אחת:

claude purge ~/work/my-repo

הפקודה מדפיסה את אותה תוכנית, ואז שואלת Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N] ומוחקת רק אם עונים y.

השמט את הנתיב כדי לבחור פרויקט מרשימה אינטראקטיבית.

דילוג על בקשת האישור לשימוש בסקריפטים:

claude purge ~/work/my-repo --yes

אפשרויות נוספות:

• העבר --all במקום נתיב כדי לנקות מצב של כל הפרויקטים בבת אחת, וזה מוחק את history.jsonl לגמרי במקום לסנן אותו.
• העבר -i כדי לעבור על תוכנית המחיקה פריט אחר פריט.

הפקודה משאירה את shell-snapshots/ ואת backups/ בלי לגעת בהם, כי הם לא מוגדרים לפי פרויקט, ומזהירה עליהם בפלט התוכנית. אם מישהו הריץ /heapdump במכונה, מחק גם את קבצי .heapsnapshot שהוא כתב. תמונת heap מכילה את השיחה המלאה וכל פרטי ההזדהות שהתהליך החזיק, וסריקת השמירה והניקוי לא נוגעים בה.

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

אל תמחק את ~/.claude.json, את ~/.claude/settings.json או את ~/.claude/plugins/: אלה מחזיקים את פרטי החשבון, ההעדפות והתוספים המותקנים.

#משאבים קשורים

• ניהול הזיכרון של Claude: כתיבה וארגון של CLAUDE.md, כללים וזיכרון אוטומטי
• הגדרת הגדרות: הגדרת הרשאות, hooks, משתני סביבה וברירות מחדל של מודל
• יצירת כישורים: בניית פרומפטים ותהליכי עבודה לשימוש חוזר
• הגדרת סוכני משנה: הגדרת סוכנים מתמחים עם הקשר משלהם