Claude Code לא רואה קובצי פרויקט: למה ומה לעשות ב-2026

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

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

חומרים נוספים על הגדרת כלים זמינים בתיעוד של Ailoot.

למה Claude Code לא רואה קובצי פרויקט מסוימים?#

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

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

כאן חוסר התאמה של תיקיית העבודה עשוי להשפיע. נניח שהפרויקט הוא /Users/you/my-shop, אבל הפעלתם את Claude מ-/Users/you/other-project, תיקייה סמוכה. קובץ index.html שבתוך my-shop נמצא מחוץ לאותו עץ עבודה. הפעלה מ-/Users/you היא מקרה אחר: my-shop נמצא תחתיה ואינו לא נגיש רק משום שהתחלתם מהבית, אם כי ההקשר שנבחר רחב מהמתוכנן. גישה לתיקייה גם אינה אומרת שכל קובץ כבר נקרא.

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

איך לבדוק מאיזו תיקייה Claude Code הופעל?#

לפני שתתקנו משהו, ודאו שהתיקייה היא אכן הבעיה. קל לבדוק זאת. בקשו מ-Claude בצ'אט להציג באיזו ספרייה הוא נמצא כרגע — הוא יריץ את pwd, פקודה בטוחה: היא רק מציגה את הנתיב ואינה נוגעת בדבר.

pwd

התשובה מציגה את תיקיית העבודה בפועל. השוו אותה לנתיב הפרויקט המלא: /Users/you/other-project סמוכה ל-/Users/you/my-shop, ואילו /Users/you היא תיקיית האב שלו. במקרה של תיקייה סמוכה, my-shop מחוץ לעץ העבודה; תיקיית האב כוללת אותו אך אינה בוחרת את הפרויקט המסוים כשורש.

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

# Replace this illustrative path with your actual project root.
cd /Users/you/my-shop
claude

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

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

איך להציג ל-Claude Code קובץ שנמצא בתיקייה סמוכה?#

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

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

/add-dir ../assets

הזינו /add-dir ואת נתיב התיקייה, ול-Claude תהיה מיד גישה לקבצים שבה באותם תנאים כמו לקבצים בתיקייה הראשית. הוא לא יבקש שוב רשות: על התיקייה שנוספה חלים אותם כללים כמו על ספריית העבודה.

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

claude --add-dir ../assets

וכשאתם זקוקים לאותה תיקייה סמוכה בפרויקט באופן קבוע, אין צורך להוסיף אותה ידנית בכל פעם. בקובץ ההגדרות settings.json יש מפתח בשם additionalDirectories. רשמו בו את הנתיבים, והם ייפתחו אוטומטית בכל פעם ש-Claude מופעל:

{
  "permissions": {
    "additionalDirectories": ["../assets", "../shared"]
  }
}

הסתייגות אחת לגבי Windows: אי אפשר להוסיף תיקיית רשת באמצעות נתיב כמו \\server\shared — Claude לא מקבל נתיבים כאלה. יש לחבר אותה ככונן נפרד עם אות כונן, ואז להעביר את האות באמצעות --add-dir. לתיקיות מקומיות רגילות אין בעיה כזו.

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

איך להעביר את Claude Code לתיקייה אחרת במהלך פעילות?#

לפעמים הוספת תיקייה סמוכה אינה מספיקה — צריך לשנות את התיקייה הראשית ולעבור לפרויקט אחר בלי לאבד את ההקשר שצברתם. השתמשו בפקודה /cd:

/cd ../another-project

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

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

ההבדל בין שתי הפקודות פשוט. /add-dir משאירה את התיקייה הראשית כספריית העבודה ופותחת בנוסף תיקייה סמוכה — שימושי כשחלקי פרויקט מפוזרים במקומות שונים. /cd מעבירה את כל ספריית העבודה למיקום חדש — שימושי כשעוברים לפרויקט אחר. הפקודה /cd נוספה בגרסה 2.1.169, ולכן אם היא חסרה, עדכנו את Claude Code. יש לי מדריך נפרד על איך לעדכן את Claude Code.

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

למה Claude Code לא רואה קובץ בתיקיית משנה?#

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

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

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

אפשר לפתור זאת בשורה אחת. מסרו ל-Claude את נתיב הקובץ ישירות — למשל, src/components/header.jsx — או פשוט בקשו ממנו לקרוא את הקובץ תחילה. ברגע שיבדוק אותו, הקובץ ייכנס להקשר ותוכלו לעבוד איתו כרגיל. אין צורך לשנות הגדרות.

איפה קבצים נעלמים מתפריט @, ומה הקשר ל-.gitignore?#

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

כברירת מחדל, תפריט @ מסתיר קבצים שמופיעים ב-.gitignore. הקובץ הזה מציין מה לא אמור להתווסף למאגר המשותף: תיקיות שירות, קבצים שמכילים סיסמאות והגדרות סביבה, ופלטי בנייה שהושלמו. ההיגיון ברור — בדרך כלל אין צורך לעבוד עם הקבצים האלה ידנית, ולכן הם רק יעמיסו על הרשימה. אבל לפעמים צריך אחד מהקבצים האלה, והוא לא מופיע בתפריט.

ההגדרה respectGitignore שולטת בכך. היא מופעלת כברירת מחדל, ולכן קבצים מתוך .gitignore אינם מופיעים בתפריט. אם תרצו לראות אותם, שנו את ערכה ל-false:

{
  "respectGitignore": false
}

אפשר לעשות זאת גם בלי לערוך את הקובץ, באמצעות הפקודה /config בתוך Claude Code. המתג שם נקרא “Respect .gitignore in file picker.” בטלו את הסימון שלו, והקבצים המוסתרים יחזרו לתפריט.

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

מה לעשות אם Claude Code לא מצליח לקרוא קובץ מסוים?#

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

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

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

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

הסוג השני הוא הגבלה כללית על כל מה שנמצא מחוץ לתיקיות העבודה. ההגדרה blockReadsOutsideWorkingDirectories שולטת בכך. כשהיא מופעלת, Claude מסרב לקרוא כל קובץ מחוץ לספריית העבודה, גם אם תנסו לפתוח אותו ישירות. אם ערכה הוא true ואתם זקוקים לקובץ חיצוני, הוסיפו את התיקייה שלו באמצעות /add-dir או כבו את ההגבלה:

{
  "permissions": {
    "blockReadsOutsideWorkingDirectories": false
  }
}

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

מאיפה להתחיל אם Claude Code לא רואה קבצים?#

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

1. בדקו את תיקיית העבודה: בקשו מ-Claude להציג את הספרייה הנוכחית באמצעות pwd והשוו אותה למיקום הפרויקט.
2. אם התיקיות שונות, הפעילו מחדש את Claude מהתיקייה הנכונה (cd project ואז claude), או עברו אליה באמצעות הפקודה /cd.
3. זקוקים לקבצים מתיקייה סמוכה? הוסיפו אותה באמצעות /add-dir או הדגל --add-dir בעת הפעלת Claude.
4. קובץ מתיקיית משנה אינו בהקשר? מסרו ל-Claude את הנתיב שלו ישירות או בקשו ממנו לקרוא את הקובץ.
5. קובץ חסר בתפריט @? מדובר ב-.gitignore. הגדירו את respectGitignore ל-false או בטלו את הסימון בתיבה ב-/config.
6. קובץ מסוים נעול? בדקו את כללי deny ו-blockReadsOutsideWorkingDirectories ב-settings.json.

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

מצאו חומרים נוספים על עבודה עם כלים בתיעוד של Ailoot.