Claude Code nevidí súbory projektu: prečo a čo robiť v roku 2026

Známa situácia: požiadate Claude Code, aby opravil súbor, a ono odpovie, že taký súbor neexistuje. Alebo potichu zmení niečo úplne iné, než ste mali na mysli. Otvoríte priečinok — súbor je tam, presne tam, kde má byť. Zdá sa však, že Claude si ho nevšíma.

Takmer vždy je za tým jeden dôvod a nič nie je pokazené. Claude nevidí súbory v celom počítači. Má prístup iba k priečinku, z ktorého ste ho spustili. Spustenie v susednom priečinku alebo pod koreňom projektu môže potrebné súbory umiestniť mimo pracovného stromu. Spustenie z nadradeného priečinka, napríklad domovského, dáva širší rozsah; potomok projektu tým nie je neprístupný. Krok za krokom vysvetlím, prečo to tak funguje a ako Claude sprístupniť potrebné súbory. Príkazy a nastavenia citujem priamo z oficiálnej dokumentácie Claude Code, ktorú som skontroloval začiatkom septembra 2026.

Ďalšie materiály o nastavovaní nástrojov nájdete v dokumentácii Ailoot.

Prečo Claude Code nevidí niektoré súbory projektu?#

Claude Code predvolene pracuje s jedným priečinkom: s tým, v ktorom ste zadali príkaz claude a spustili reláciu. Dokumentácia to uvádza priamo.

Tento priečinok je jeho pracovný adresár. V jeho vnútri Claude číta ľubovoľný súbor bez ďalších otázok: úprava zadania, vyhľadávanie v kóde, čítanie konkrétneho súboru — všetko funguje hneď. Všetko mimo tohto priečinka je však predvolene neprístupné. Claude sa nepozrie do susedného priečinka, priečinka o úroveň vyššie ani na iný disk, kým mu to nepovolíte.

Tu môže záležať na nesúlade pracovného priečinka. Ak projekt leží v /Users/you/my-shop, ale Claude spustíte v susednom /Users/you/other-project, súbor index.html v my-shop je mimo tohto pracovného stromu. Spustenie z /Users/you je iný prípad: my-shop je potomkom a samotný štart z domova ho nerobí neprístupným, hoci kontext je širší než zamýšľaný. Prístup k priečinku tiež neznamená, že každý súbor už bol prečítaný.

Ďalej ukážem, ako to skontrolovať a opraviť: najprv zistíme, z ktorého priečinka bolo Claude spustené, a potom mu rôznymi spôsobmi sprístupníme potrebné súbory — od jednorazového pokynu až po trvalé nastavenie.

Ako skontrolovať, z ktorého priečinka bolo Claude Code spustené?#

Skôr než čokoľvek opravíte, uistite sa, že problém naozaj spôsobuje priečinok. Overíte to jednoducho. V chate požiadajte Claude, aby zobrazilo adresár, v ktorom sa práve nachádza — spustí pwd, čo je bezpečné: príkaz iba zobrazí cestu a ničoho sa nedotkne.

pwd

Odpoveď ukazuje skutočný pracovný adresár. Porovnajte ho s úplnou cestou projektu: /Users/you/other-project je súrodencom /Users/you/my-shop, kým /Users/you je jeho rodičom. V prvom prípade je my-shop mimo pracovného stromu; rodič ho zahŕňa, ale nevyberá konkrétny projekt ako koreň.

Najčistejším riešením tohto nesúladu je spustiť Claude priamo z priečinka projektu. Zavrite aktuálnu reláciu, prejdite v termináli do správneho priečinka a odtiaľ spustite Claude:

# Túto ilustračnú cestu nahraďte skutočným koreňom projektu.
cd /Users/you/my-shop
claude

Teraz bude pracovným priečinkom my-shop a všetky súbory projektu budú dostupné. Rovnaké pravidlo platí aj v editore, ako je VS Code: otvorte priečinok, ktorý obsahuje projekt. Nie priečinok o úroveň vyššie a nie celý disk. Priečinok, ktorý otvoríte, určuje, čo Claude považuje za svoj pracovný adresár.

Ak je opätovné spustenie nepraktické — napríklad ste už Claude v tejto relácii poskytli kontext a nechcete oň prísť — môžete priečinky pridať alebo zmeniť priebežne. Tomu sa venujú nasledujúce dve časti.

Ako ukázať Claude Code súbor v susednom priečinku?#

Niekedy projekt nie je uložený iba v jednom priečinku. Kód je na jednom mieste, obrázky alebo texty v susednom priečinku a zdieľané komponenty niekde neďaleko. Postupne reštartovať Claude v každom priečinku je nepraktické. Lepšie je sprístupniť mu potrebný priečinok a hlavný priečinok ponechať ako pracovný adresár.

Najjednoduchšie to urobíte priamo v aktívnej relácii týmto príkazom:

/add-dir ../assets

Zadajte /add-dir a cestu k priečinku. Claude bude mať okamžite prístup k jeho súborom rovnako ako k súborom v hlavnom priečinku. Znova si nevypýta povolenie: pre pridaný priečinok platia rovnaké pravidlá ako pre pracovný adresár.

Ak vopred viete, že budete pracovať s viacerými priečinkami, povoľte prístup už pri spustení Claude — použite rovnakú cestu, ale pridajte príznak:

claude --add-dir ../assets

A ak v projekte stále potrebujete ten istý susedný priečinok, nemusíte ho zakaždým pridávať ručne. Súbor nastavení settings.json obsahuje kľúč additionalDirectories. Uveďte v ňom cesty a pri každom spustení Claude sa otvoria automaticky:

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

Jedno upozornenie pre Windows: sieťový priečinok nemôžete pridať pomocou cesty, ako je \\server\shared — Claude takéto cesty neprijíma. Pripojte ho ako samostatný disk s písmenom jednotky a potom toto písmeno zadajte pomocou --add-dir. Bežné lokálne priečinky tento problém nemajú.

Čo ak pridať susedný priečinok nestačí a potrebujete sa presunúť do úplne iného priečinka? Na to slúži samostatný príkaz, ktorému sa venujeme nižšie.

Ako počas relácie presunúť Claude Code do iného priečinka?#

Niekedy pridať susedný priečinok nestačí — potrebujete zmeniť hlavný priečinok a presunúť sa do iného projektu bez straty doterajšieho kontextu. Použite príkaz /cd:

/cd ../another-project

Potom bude Claude nový priečinok považovať za svoj pracovný adresár. Zachováte si celú históriu konverzácie, ale zmení sa miesto, ktoré Claude používa ako východisko pri práci so súbormi. Claude tiež načíta súbor pokynov CLAUDE.md z nového priečinka, ak sa tam nachádza — prispôsobí sa tak pravidlám nového projektu.

O dôvere treba vedieť jednu vec: ak ste v tomto priečinku ešte nepracovali, pri presune sa vás Claude opýta, či mu dôverujete. Je to bezpečnostné opatrenie: súbor pokynov v neznámom priečinku môže obsahovať čokoľvek, preto Claude najprv overí, či ide o váš projekt. Potvrďte to a pokračujte.

Rozdiel medzi týmito dvoma príkazmi je jednoduchý. /add-dir ponechá hlavný priečinok ako pracovný adresár a navyše sprístupní susedný priečinok — hodí sa, keď sú časti projektu roztrúsené. /cd presunie celý pracovný adresár na nové miesto — hodí sa pri prechode do iného projektu. Príkaz /cd bol zavedený vo verzii 2.1.169, takže ak chýba, aktualizujte Claude Code. Samostatný návod nájdete v príručke o tom, ako aktualizovať Claude Code.

To, že Claude Code vidí súbory, je iba základ. Stabilné výsledky nevychádzajú len z prístupu k súborom. Závisia od toho, čo tieto súbory obsahujú a ako okolo projektu vytvárate kontext.

Prečo Claude Code nevidí súbor v podpriečinku?#

Je dôležité nezamieňať si tu dve odlišné situácie. Susedný priečinok (mimo projektu) je úplne neprístupný, kým ho nepridáte. Podpriečinok vnútri projektu je iný: Claude k nemu má prístup, ale od začiatku nemá jeho obsah v kontexte.

Funguje to takto. Pri spustení Claude načíta obsah z najvyšších úrovní projektu. Súbory z podpriečinkov načítava na požiadanie, keď do nich prejde a niečo si prečíta. Dokumentácia opisuje toto správanie pri súboroch s pokynmi a rovnaká logika platí pre kontext všeobecne.

Jednoducho povedané: súbor v hlboko vnorenom podpriečinku nezmizol a je plne dostupný. Claude si ho len ešte nezapamätalo, pretože sa tam nepozrelo — preto môže pôsobiť, že Claude súbor „nevidí“, hoci sa tam nachádza a je dostupný.

Opraviť to môžete jedným riadkom. Zadajte Claude priamo cestu k súboru — napríklad src/components/header.jsx — alebo ho jednoducho požiadajte, aby si súbor najprv prečítalo. Hneď ako sa tam pozrie, súbor sa dostane do kontextu a môžete s ním pracovať ako zvyčajne. Nastavenia meniť netreba.

Kde miznú súbory z ponuky @ a čo s tým má .gitignore?#

Ďalším častým dôvodom, prečo si myslíte, že Claude „stratilo“ súbor, je výber súborov. Keď zadáte @, zobrazí sa zoznam, z ktorého môžete jednoducho vybrať súbor bez zadávania celej cesty. Zoznam však neukazuje všetko.

Ponuka @ predvolene skrýva súbory uvedené v .gitignore. Tento súbor určuje, čo sa nemá pridať do zdieľaného repozitára: servisné priečinky, súbory obsahujúce heslá a nastavenia prostredia či dokončené výstupy zostavenia. Dôvod je jasný — zvyčajne s týmito súbormi nepotrebujete pracovať ručne, takže by zoznam iba zahlcovali. Niekedy však niektorý z nich potrebujete a v ponuke sa nezobrazuje.

Toto správanie riadi nastavenie respectGitignore. Predvolene je zapnuté, takže súbory z .gitignore sa v ponuke nezobrazujú. Ak ich chcete vidieť, zmeňte ho na false:

{
  "respectGitignore": false
}

To isté môžete urobiť aj bez úpravy súboru, a to pomocou príkazu /config v Claude Code. Prepínač sa volá „Respect .gitignore in file picker“. Zrušte jeho začiarknutie a skryté súbory sa vrátia do ponuky.

Dôležité upozornenie: respectGitignore sa týka iba ponuky @ a nesúvisí s prístupom k súborom. Aj keď je súbor v zozname skrytý, vždy môžete jeho cestu zadať ručne a Claude ho prečíta. Ponuka slúži na pohodlný výber; neurčuje hranice prístupu.

Čo robiť, ak Claude Code nedokáže prečítať konkrétny súbor?#

Ak je priečinok určite správny a prístup je povolený, no Claude stále nečíta konkrétny súbor, pravdepodobne je obmedzený. Obmedzenia sa nachádzajú v súbore nastavení settings.json a sú dvoch druhov.

Prvým je cielené obmedzenie pre konkrétne súbory. V nastaveniach ide o pravidlá deny, ktoré sa najčastejšie vzťahujú na súbor .env, v ktorom sú uložené kľúče a heslá:

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

Takéto pravidlo blokuje Claude čítanie určených súborov, a je to zámer. Kľúče a heslá by sa nemali dostať do konverzácie s modelom, preto je .env predvolene uzamknutý. Ak zistíte, že Claude nechce čítať .env alebo podobný súbor obsahujúci tajné údaje, je to zámerné a toto obmedzenie by ste nemali odstraňovať bez presvedčivého dôvodu.

Druhým druhom je všeobecné obmedzenie pre všetko mimo pracovných priečinkov. Riadi ho nastavenie blockReadsOutsideWorkingDirectories. Keď je zapnuté, Claude odmietne čítať akýkoľvek súbor mimo pracovného adresára, aj keď sa ho pokúsite otvoriť priamo. Ak je nastavené na true a potrebujete externý súbor, pridajte jeho priečinok pomocou /add-dir alebo toto obmedzenie vypnite:

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

Toto nastavenie bolo zavedené vo verzii 2.1.257. Ak ste už vyskúšali všetko ostatné a súbor je stále neprístupný, oplatí sa skontrolovať deny aj blockReadsOutsideWorkingDirectories.

Kde začať, ak Claude Code nevidí súbory?#

Tu je stručný postup, ktorým môžete prejsť od začiatku do konca.

1. Skontrolujte pracovný priečinok: požiadajte Claude, aby pomocou pwd zobrazilo aktuálny adresár, a porovnajte ho s umiestnením projektu.
2. Ak sa priečinky líšia, spustite Claude znova zo správneho priečinka (cd project a potom claude) alebo sa tam presuňte príkazom /cd.
3. Potrebujete súbory zo susedného priečinka? Pridajte ho pomocou /add-dir alebo príznaku --add-dir pri spúšťaní Claude.
4. Súbor z podpriečinka nie je v kontexte? Zadajte Claude jeho cestu priamo alebo ho požiadajte, aby si súbor prečítalo.
5. Chýba súbor v ponuke @? Príčinou je .gitignore. Nastavte respectGitignore na false alebo zrušte začiarknutie políčka v /config.
6. Je konkrétny súbor uzamknutý? Skontrolujte pravidlá deny a blockReadsOutsideWorkingDirectories v settings.json.

V deviatich prípadoch z desiatich vyrieši všetko už prvý krok: Claude bolo spustené z nesprávneho priečinka. Prístup k súborom je základ, ale projekt za vás nevybuduje. V sprievodcovi o Druhom mozgu v Claude Code podrobne vysvetľujem, ako vytvárať kontext okolo Claude, aby malo na pamäti celý projekt a nestratilo niť.

Ďalšie materiály o práci s nástrojmi nájdete v dokumentácii Ailoot.