Claude Code nie widzi plików (doesn't see files) - jak naprawić

Claude Code

Claude Code nie widzi plików (doesn't see files) - jak naprawić

W skrócie

Prosisz Claude Code o pracę na pliku, a w odpowiedzi słyszysz, że go nie ma. Plik jednak istnieje - problem prawie zawsze dotyczy tego, gdzie narzędzie szuka, a nie tego, czego szuka.

Jak to wygląda w praktyce

Claude Code odpowiada, że nie znajduje wskazanego pliku, zwraca file not found albo pracuje tak, jakby dany plik w projekcie nie istniał. Tymczasem otwierasz go bez problemu we własnym edytorze.

Bywa też, że narzędzie widzi część projektu, ale konsekwentnie pomija konkretny katalog albo świeżo dodany plik, przez co nie potrafi go odczytać ani zmodyfikować.

Dlaczego tak się dzieje

Najczęstsza przyczyna to katalog uruchomienia. Claude Code domyślnie pracuje w bieżącym drzewie roboczym - tym, w którym go odpaliłeś. Jeśli startuje z innego miejsca niż projekt, plik po prostu jest poza jego zasięgiem.

Podobnie działa plik leżący fizycznie poza katalogiem roboczym - w innej gałęzi dysku albo w osobnym repozytorium. Narzędzie nie sięga tam samo z siebie, dopóki mu tego katalogu nie udostępnisz.

Do tego dochodzą reguły ignorowania (np. wpisy pomijające pliki i foldery) oraz sytuacja, w której plik istnieje, ale nie wskazałeś go ani nie znalazł się w tym, co Claude przeszukał. Świeżo utworzony poza sesją plik również może być jeszcze poza jego obrazem projektu.

Jak to rozwiązać krok po kroku

1. Uruchom Claude Code z katalogu głównego projektu - najpierw przejdź do niego (cd), potem wystartuj sesję, żeby drzewo robocze objęło Twoje pliki.
2. Wskaż plik dokładną ścieżką albo poproś wprost o jego odczyt, zamiast liczyć, że narzędzie samo go odnajdzie.
3. Jeśli plik leży poza bieżącym drzewem, dodaj jego katalog do zakresu pracy sesji, żeby stał się dostępny.
4. Sprawdź, czy plik lub folder nie jest pomijany przez reguły ignorowania, i w razie potrzeby zawęź te reguły.
5. Dla świeżo utworzonych plików poproś o ponowne rozejrzenie się po katalogu, żeby Claude zaktualizował obraz projektu.
6. Opisz układ katalogów i najważniejsze pliki w pliku CLAUDE.md, żeby narzędzie od początku wiedziało, gdzie czego szukać.

Jak sprawdzić, że zadziałało

Poproś Claude o odczyt spornego pliku albo o wypisanie zawartości katalogu, w którym on leży. Jeśli plik pojawia się na liście i daje się otworzyć, znaczy że jest już w zasięgu narzędzia i problem został usunięty.

Wróć do listy problemów z Claude Code

Szkolenie Claude Code - od zera do zespołu agentów AI -->

Szkolenie Claude Code - od zera do zespołu agentów AI

Tryb planowania, tryby uprawnień, komendy, MCP, hooki i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma terminy gwarantowane - odbędzie się niezależnie od liczby zgłoszeń.

Sprawdź szkolenie Claude Code

To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5