# Claude Code nevidí súbory projektu: prečo a čo robiť v roku 2026
> Prečo Claude Code nevie nájsť súbory projektu: spustili ste ho z nesprávneho priečinka, súbor je v podpriečinku alebo je v .gitignore. Ako povoliť prístup pomocou add-dir, cd a settings.
Source: https://ailoot.ai/blog/sk/claude-code-cant-see-project-files/
Canonical: https://ailoot.ai/blog/sk/claude-code-cant-see-project-files/
Language: sk
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-199
Revision: sha256-50b80f904fceeb7d4fedb6b2c343afd27475ca08f7d7f642ea8689c5c28f66e9
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](https://ailoot.ai/docs/).
[Sprievodcovia Ailoot](https://ailoot.ai/docs/)
## Prečo Claude Code nevidí niektoré súbory projektu?
Hlavné zistenie
Claude Code nečíta súbory z celého disku, ale iba z priečinka, z ktorého ste ho spustili. Tento priečinok sa nazýva pracovný adresár. Claude môže bez opýtania vidieť a čítať všetko, čo sa nachádza v ňom a v jeho podpriečinkoch. Všetko mimo neho — v susednom priečinku, o úroveň vyššie alebo na inom disku — je neprístupné, kým mu prístup nepovolíte. Najčastejším dôvodom, prečo súbor „nie je viditeľný“, je teda jednoduchý: Claude ste spustili z iného priečinka. Najprv skontrolujte, odkiaľ presne ste ho otvorili.
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.
Claude má predvolene prístup k súborom v priečinku, z ktorého ste ho spustili.
— Claude Code Docs, Configure permissions, oficiálna dokumentácia
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é?
Hlavné zistenie
Spýtajte sa Claude, v ktorom priečinku sa nachádza, alebo ho požiadajte, aby pomocou príkazu `pwd` zobrazilo aktuálny adresár — iba ho skontroluje a nič nezmení. Porovnajte zobrazenú cestu so skutočným umiestnením projektu. Ak sa cesty líšia, našli ste dôvod: Claude bolo spustené z nesprávneho priečinka. Ešte spoľahlivejším riešením je zavrieť reláciu a spustiť Claude priamo z priečinka projektu: prejdite doň v termináli a zadajte tam `claude`.
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.
```bash
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:
```bash
# 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?
Hlavné zistenie
Bez reštartovania relácie pridajte potrebný priečinok priamo v chate príkazom `/add-dir`: zadajte `/add-dir` a cestu k priečinku. Jeho súbory potom budú dostupné rovnako ako súbory v hlavnom priečinku. Ak chcete povoliť prístup hneď pri spustení Claude, pridajte k príkazu `claude` príznak `--add-dir` s cestou. A ak chcete, aby sa priečinok otváral automaticky zakaždým, pridajte ho v nastaveniach pod kľúč `additionalDirectories`. Vo všetkých troch prípadoch možno súbory v pridanom priečinku čítať bez samostatných potvrdení.
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.
Pre súbory v ďalších adresároch platia rovnaké pravidlá prístupu ako pre hlavný pracovný adresár: čítajú sa bez výzvy.
— Claude Code Docs, Configure permissions, oficiálna dokumentácia
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:
```bash
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:
```json
{
"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?
Hlavné zistenie
Príkaz `/cd` zmení hlavný pracovný priečinok bez ukončenia relácie: zadajte `/cd` a cestu a Claude sa tam presunie so zachovanou históriou konverzácie. Počas presunu načíta súbor pokynov `CLAUDE.md` z nového priečinka a ak ste tam ešte nepracovali, požiada vás o potvrdenie, že mu dôverujete. Rozdiel oproti príkazu `/add-dir` je v tom, že `/add-dir` sprístupní susedný priečinok popri hlavnom, zatiaľ čo `/cd` presunie celý pracovný adresár na nové miesto. Príkaz je dostupný od verzie 2.1.169.
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](https://ailoot.ai/blog/sk/update-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.
[Sprievodcovia Ailoot](https://ailoot.ai/docs/)
## Prečo Claude Code nevidí súbor v podpriečinku?
Hlavné zistenie
Podpriečinky fungujú inak než susedné priečinky: Claude k nim má prístup, ale ich obsah sa hneď nedostane do jeho kontextu. Súbory s pokynmi a obsah podpriečinkov načíta až na požiadanie, keď v nich niečo hľadá. Pri spustení ich nenačítava. Súbor v hlboko vnorenom podpriečinku preto môže byť „neviditeľný“, kým Claude priamo neposkytnete jeho cestu. Riešenie je jednoduché: zadajte Claude presnú cestu k súboru alebo ho požiadajte, aby si súbor najprv prečítalo, a potom sa zobrazí.
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.
Claude vyhľadáva súbory v podpriečinkoch pracovného adresára. Namiesto načítania pri spustení ich pridá, keď číta súbory v týchto podpriečinkoch.
— Claude Code Docs, Manage Claude's memory, oficiálna dokumentácia
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?
Hlavné zistenie
Keď zadáte symbol `@`, Claude Code zobrazí zoznam súborov, z ktorých si môžete vybrať. Predvolene sa v ňom skrýva všetko, čo je uvedené v `.gitignore` — servisné priečinky, súbory s nastaveniami prostredia a výstupy zostavenia. Súbor teda môže byť presne tam, kde má byť, a napriek tomu sa v ponuke `@` nezobrazí. Toto správanie riadi nastavenie `respectGitignore`: predvolene je zapnuté a tieto súbory skrýva. Nastavte ho na `false` a ponuka zobrazí aj súbory uvedené v `.gitignore`. Cestu k takémuto súboru môžete vždy zadať ručne.
Ď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`:
```json
{
"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?
Hlavné zistenie
Niekedy je priečinok správny, no Claude stále odmieta prečítať jeden konkrétny súbor. Dôvodom býva obmedzenie v nastaveniach. Súbor `settings.json` môže obsahovať pravidlá `deny`, ktoré blokujú čítanie konkrétnych súborov; najčastejšie ide o súbory `.env s kľúčmi a heslami. Existuje aj nastavenie, ktoré úplne blokuje čítanie všetkého mimo pracovných priečinkov. Skontrolujte obe možnosti v `settings.json`. Pamätajte tiež, že obmedzenie pre `.env` je predvolené bezpečnostné opatrenie a nemali by ste ho odstraňovať bez dobrého dôvodu.
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á:
```json
{
"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:
```json
{
"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?
Hlavné zistenie
Začnite kontrolou priečinka: požiadajte Claude, aby pomocou `pwd` zobrazilo aktuálny adresár, a porovnajte ho s umiestnením projektu. Ak sa nezhodujú, spustite Claude znova z priečinka projektu alebo sa tam presuňte pomocou `/cd`. Potrebujete súbory zo susedného priečinka? Sprístupnite ho pomocou `/add-dir`. Nevidíte súbor v podpriečinku? Zadajte Claude jeho cestu priamo. Chýba súbor v ponuke `@`? Súvisí to s `.gitignore` — zmeňte `respectGitignore`. Je jeden súbor uzamknutý? Skontrolujte, či ho neblokuje pravidlo `deny` v `settings.json`.
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](https://ailoot.ai/blog/sk/claude-code-second-brain/) podrobne vysvetľujem, ako vytvárať kontext okolo Claude, aby malo na pamäti celý projekt a nestratilo niť.
### Zdroje
- [Claude Code - Configure permissions, oficiálna dokumentácia](https://docs.claude.com/en/docs/claude-code/permissions) - predvolený pracovný adresár, --add-dir a /add-dir, /cd, additionalDirectories, prístup bez výziev, sieťové cesty
- [Claude Code - Manage Claude's memory, oficiálna dokumentácia](https://docs.claude.com/en/docs/claude-code/memory) - načítavanie súborov z podpriečinkov na požiadanie, CLAUDE.md, importy
- [Claude Code - Settings reference, oficiálna dokumentácia](https://docs.claude.com/en/docs/claude-code/settings-reference) - respectGitignore a ponuka @, blockReadsOutsideWorkingDirectories a verzia 2.1.257
- [Claude Code - Settings, oficiálna dokumentácia](https://docs.claude.com/en/docs/claude-code/settings) - pravidlá deny a blokovanie čítania súboru .env
Ďalšie materiály o práci s nástrojmi nájdete v [dokumentácii Ailoot](https://ailoot.ai/docs/).
[Sprievodcovia Ailoot](https://ailoot.ai/docs/)
[Prejsť na Ailoot](https://ailoot.ai/)
## Otázky a odpovede: Claude Code nevidí súbory projektu: prečo a čo robiť v roku 2026
### Prečo je spustenie z domova odlišné od susedného projektu?
Projekt pod domovským priečinkom je potomkom, takže štart z domova ho nevylučuje z pracovného stromu; dáva širší kontext než zamýšľaný. Súrodenec pracovného priečinka leží mimo neho. Pred diagnózou prístupu porovnajte úplné cesty.
### Znamená prístup k podpriečinku načítanie jeho súborov do kontextu?
Nie. Zadajte agentovi cestu a požiadajte o čítanie. Pri odmietnutí prezrite príslušné oprávnenia; chýbanie vo výberovej ponuke a odmietnuté čítanie sú odlišné problémy.
## Ailoot · Spoločnosť a jej portfólio projektov
Ailoot stavia na dlhodobých prevádzkových skúsenostiach, širokej klientskej základni, stabilných službách a priebežnom sledovaní KPI.
Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách.
Ailoot využíva tieto prevádzkové skúsenosti na poskytovanie prístupu cez API k funkciám AI v produktoch zákazníkov, agentoch, aplikáciách a automatizáciách.