Claude Code жоба файлдарын көрмейді: себебі және 2026 жылы не істеу керек

Таныс жағдай: сіз Claude Code-тан файлды түзетуді сұрайсыз, ал ол ондай файл жоқ деп жауап береді. Немесе сіз айтқаннан мүлде басқа нәрсені үнсіз өзгертіп жібереді. Қалтаны ашсаңыз — файл өз орнында тұр. Бірақ Claude оны байқамайтын сияқты.

Көбіне бұған бір ғана себеп бар, ештеңе бұзылған жоқ. Claude бүкіл компьютердегі файлдарды көрмейді. Ол тек іске қосылған қалтаға ғана қатынай алады. Көрші қалтада не жоба түбірінен төмен іске қосу қажетті файлдарды жұмыс ағашынан тыс қалдыруы мүмкін. Үй қалтасы сияқты ата-анадан бастау керісінше ауқымды кеңейтеді; ішіндегі жобаны қолжетімсіз етпейді. Мұның неге осылай жұмыс істейтінін және Claude-қа қажетті файлдарға қатынасты қалай беруге болатынын кезең-кезеңімен түсіндіремін. Командалар мен баптауларды 2026 жылғы қыркүйектің басында тексерген Claude Code ресми құжаттамасынан тікелей келтіріп отырмын.

Құралдарды баптау туралы қосымша материалдарды Ailoot құжаттамасынан таба аласыз.

Неліктен Claude Code кейбір жоба файлдарын көрмейді?#

Әдепкіде Claude Code бір қалтамен жұмыс істейді: claude пәрменін енгізіп, сеансты бастаған жеріңізбен. Құжаттамада бұл тікелей айтылған.

Бұл — оның жұмыс каталогы. Оның ішіндегі кез келген файлды Claude қосымша сұрақсыз оқиды: сұрау мәтінін өңдеу, кодты іздеу, белгілі бір файлды оқу — бәрі бірден орындалады. Бірақ бұл қалтадан тыс нәрсенің бәрі әдепкіде қолжетімсіз. Көрші қалтаны, бір деңгей жоғарыдағы қалтаны немесе басқа дискіні рұқсат бермейінше Claude іздемейді.

Жұмыс қалтасының сәйкессіздігі осында маңызды болуы мүмкін. Жобаңыз /Users/you/my-shop болып, Claude-ты көрші /Users/you/other-project қалтасынан бастасаңыз, my-shop ішіндегі index.html сол жұмыс ағашынан тыс қалады. /Users/you ішінен бастау — басқа жағдай: my-shop оның ішкі қалтасы және тек үйден басталғандықтан қолжетімсіз болмайды, бірақ таңдалған контекст қажеттен кең. Қалтаға қолжетімділік әр файл оқылып қойғанын да білдірмейді.

Келесі бөлімдерде мұны қалай тексеріп, түзетуге болатынын көрсетемін: алдымен Claude қай қалтадан іске қосылғанын анықтаймыз, содан кейін оған керек файлдарға әртүрлі жолмен — бір реттік нұсқаудан бастап тұрақты баптауға дейін — қатынас береміз.

Claude Code қай қалтадан іске қосылғанын қалай тексеруге болады?#

Бірдеңені түзетпес бұрын, мәселе шынымен қалтада екеніне көз жеткізіңіз. Мұны тексеру оңай. Чатта Claude-тан қазір қай каталогта тұрғанын көрсетуді сұраңыз — ол қауіпсіз pwd пәрменін орындайды: пәрмен тек жолды көрсетіп, ештеңеге тимейді.

pwd

Жауап нақты жұмыс қалтасын көрсетеді. Оны жобаның толық жолымен салыстырыңыз: /Users/you/other-project — /Users/you/my-shop қалтасының көршісі, ал /Users/you — оның ата-анасы. Көрші жағдайда my-shop жұмыс ағашынан тыс; ата-ана жағдайда ол ауқымға кіреді, бірақ нақты жоба түбірі болып таңдалмаған.

Бұл сәйкессіздікті шешудің ең оңай жолы — Claude-ты тікелей жоба қалтасынан іске қосу. Ағымдағы сеансты жауып, терминалда керек қалтаға өтіп, Claude-ты сол жерден іске қосыңыз:

# Мысал жолын өз жобаңыздың нақты түбірімен алмастырыңыз.
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.md нұсқау файлы болса, Claude оны да алады, яғни жаңа жобаның ережелеріне бейімделеді.

Сенімге қатысты бір жайтты ескеріңіз: бұл қалтада бұрын жұмыс істемеген болсаңыз, 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
}

Файлды өңдемей-ақ, Claude Code ішіндегі /config пәрменін қолданып та солай істеуге болады. Ондағы ауыстырғыш «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. Көрші қалтадағы файлдар керек пе? Claude-ты іске қосқанда /add-dir немесе --add-dir жалаушасымен қосыңыз.
4. Ішкі қалтадағы файл мәнмәтінде жоқ па? Claude-қа жолын тікелей беріңіз немесе файлды оқуын сұраңыз.
5. Файл @ мәзірінде жоқ па? Бұл .gitignore-ға байланысты. respectGitignore мәнін false деп орнатыңыз немесе /config ішіндегі белгіні алып тастаңыз.
6. Бір нақты файл бұғатталған ба? settings.json ішіндегі deny және blockReadsOutsideWorkingDirectories ережелерін тексеріңіз.

Он жағдайдың тоғызына жуығында бірінші қадамның өзі мәселені шешеді: Claude басқа қалтадан іске қосылған болады. Файлдарға қол жеткізу — негіз ғана, ол жобаңызды өздігінен құрып бермейді. Жоба толық есте қалып, ой желісі үзілмеуі үшін Claude айналасында мәнмәтінді қалай құру керегін Claude Code-тағы Second Brain нұсқаулығымда егжей-тегжейлі түсіндірдім.

Құралдармен жұмыс істеу туралы қосымша материалдарды Ailoot құжаттамасынан табыңыз.