Claude Code sieht Projektdateien nicht: Warum und was du 2026 tun kannst

Ein vertrautes Bild: Du bittest Claude Code, eine Datei zu bearbeiten, und es antwortet, dass es diese Datei nicht gibt. Oder es ändert stillschweigend etwas völlig anderes als das, was du gemeint hast. Du öffnest den Ordner – die Datei ist da, genau dort, wo sie sein sollte. Aber Claude scheint sie nicht zu bemerken.

Fast immer gibt es dafür einen Grund, und nichts ist kaputt. Claude sieht nicht die Dateien auf dem ganzen Computer. Es kann nur auf den Ordner zugreifen, von dem aus du es gestartet hast. Startest du in einem benachbarten Ordner oder unterhalb des Projektstamms, können benötigte Dateien außerhalb des Arbeitsbaums liegen. Ein Start in einem übergeordneten Ordner wie Home gibt dagegen einen breiteren Bereich frei; er macht ein darunterliegendes Projekt nicht unerreichbar. Ich erkläre Schritt für Schritt, warum das so funktioniert und wie du Claude Zugriff auf die benötigten Dateien gibst. Ich zitiere Befehle und Einstellungen direkt aus der offiziellen Claude-Code-Dokumentation, die ich Anfang September 2026 geprüft habe.

Zusätzliche Materialien zur Konfiguration von Tools findest du in der Ailoot-Dokumentation.

Warum kann Claude Code manche Projektdateien nicht sehen?#

Standardmäßig arbeitet Claude Code mit einem Ordner: dem Ordner, in dem du den Befehl claude eingegeben und die Sitzung gestartet hast. Die Dokumentation sagt das ausdrücklich.

Dieser Ordner ist sein Arbeitsverzeichnis. Darin liest Claude jede Datei ohne zusätzliche Rückfragen: einen Prompt bearbeiten, Code durchsuchen, eine bestimmte Datei lesen – all das funktioniert sofort. Alles außerhalb dieses Ordners ist jedoch standardmäßig gesperrt. Ein benachbarter Ordner, ein Ordner eine Ebene höher, ein anderes Laufwerk – Claude sieht dort erst nach deiner Freigabe nach.

Ein abweichender Arbeitsordner kann diesen Eindruck erklären. Liegt dein Projekt unter /Users/you/my-shop, Claude startet aber in /Users/you/other-project, ist die index.html des benachbarten Projekts außerhalb des Arbeitsbaums. Ein Start in /Users/you ist anders: my-shop liegt darunter und wird nicht allein wegen des Home-Starts unerreichbar. Der Kontext ist lediglich breiter als beabsichtigt. Zugang zu einem Ordner bedeutet außerdem nicht, dass schon jede Datei gelesen wurde.

Als Nächstes zeige ich dir, wie du das prüfst und behebst: Zuerst stellen wir fest, aus welchem Ordner Claude gestartet wurde. Dann geben wir ihm auf verschiedene Weisen Zugriff auf die benötigten Dateien – von einer einmaligen Anweisung bis zu einer dauerhaften Einstellung.

Wie kannst du prüfen, aus welchem Ordner Claude Code gestartet wurde?#

Bevor du etwas behebst, vergewissere dich, dass tatsächlich der Ordner das Problem ist. Das lässt sich leicht prüfen. Bitte Claude im Chat, das aktuelle Verzeichnis anzuzeigen. Es führt dann pwd aus. Das ist sicher: Der Befehl zeigt nur den Pfad an und verändert nichts.

pwd

Die Antwort zeigt das tatsächliche Arbeitsverzeichnis. Vergleiche vollständige Pfade: /Users/you/other-project ist ein Nachbar von /Users/you/my-shop, /Users/you dagegen dessen übergeordneter Ordner. Im Nachbarfall liegt my-shop außerhalb des Arbeitsbaums. Im übergeordneten Fall gehört es dazu, ist aber nicht als spezifischer Projektstamm ausgewählt.

Am saubersten behebst du diese Abweichung, indem du Claude direkt aus dem Projektordner startest. Schließe die aktuelle Sitzung, wechsle im Terminal in den richtigen Ordner und starte Claude von dort:

# Ersetze den Beispielpfad durch deinen tatsächlichen Projektstamm.
cd /Users/you/my-shop
claude

Jetzt ist my-shop der Arbeitsordner, und alle Projektdateien sind sichtbar. Dieselbe Regel gilt in einem Editor wie VS Code: Öffne den Ordner, der das Projekt enthält. Nicht den Ordner eine Ebene darüber und nicht das gesamte Laufwerk. Der geöffnete Ordner bestimmt, was Claude als sein Arbeitsverzeichnis betrachtet.

Wenn ein Neustart umständlich ist – zum Beispiel, weil du Claude in dieser Sitzung bereits Kontext gegeben hast und ihn nicht verlieren möchtest –, kannst du Ordner auch während der Sitzung hinzufügen oder wechseln. Darum geht es in den nächsten beiden Abschnitten.

Wie kannst du Claude Code eine Datei in einem benachbarten Ordner zeigen?#

Manchmal liegt ein Projekt nicht in nur einem Ordner. Der Code befindet sich an einem Ort, Bilder oder Texte in einem benachbarten Ordner und gemeinsam genutzte Komponenten irgendwo in der Nähe. Claude der Reihe nach in jedem Ordner neu zu starten, ist umständlich. Gib ihm lieber Zugriff auf den benötigten Ordner und behalte den Hauptordner als Arbeitsverzeichnis bei.

Am einfachsten geht das direkt in der aktiven Sitzung mit diesem Befehl:

/add-dir ../assets

Gib /add-dir und den Ordnerpfad ein. Claude erhält dann sofort Zugriff auf die darin enthaltenen Dateien, genauso wie auf die Dateien im Hauptordner. Es fragt nicht erneut nach einer Berechtigung: Für den hinzugefügten Ordner gelten dieselben Regeln wie für das Arbeitsverzeichnis.

Wenn du schon im Voraus weißt, dass du mit mehreren Ordnern arbeiten wirst, gib Claude den Zugriff gleich beim Start – mit demselben Pfad, aber einem Flag:

claude --add-dir ../assets

Wenn du in einem Projekt ständig denselben benachbarten Ordner brauchst, musst du ihn nicht jedes Mal manuell hinzufügen. Die Einstellungsdatei settings.json enthält den Schlüssel additionalDirectories. Trage dort die Pfade ein, und sie werden bei jedem Start von Claude automatisch geöffnet:

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

Ein Hinweis zu Windows: Einen Netzwerkordner mit einem Pfad wie \\server\shared kannst du nicht hinzufügen – Claude akzeptiert solche Pfade nicht. Binde ihn als separates Laufwerk mit einem Laufwerksbuchstaben ein und übergib diesen Buchstaben dann mit --add-dir. Bei gewöhnlichen lokalen Ordnern gibt es dieses Problem nicht.

Was ist, wenn das Hinzufügen eines benachbarten Ordners nicht genügt und du stattdessen ganz in einen anderen Ordner wechseln musst? Dafür gibt es einen eigenen Befehl, um den es im nächsten Abschnitt geht.

Wie kannst du Claude Code während einer Sitzung in einen anderen Ordner wechseln lassen?#

Manchmal reicht es nicht, einen benachbarten Ordner hinzuzufügen. Du musst den Hauptordner ändern und zu einem anderen Projekt wechseln, ohne den bisherigen Kontext zu verlieren. Verwende dafür den Befehl /cd:

/cd ../another-project

Danach behandelt Claude den neuen Ordner als sein Arbeitsverzeichnis. Der gesamte Gesprächsverlauf bleibt erhalten, aber der Ort, den Claude als Bezugspunkt für Dateien verwendet, wechselt zum neuen Speicherort. Claude übernimmt auch die Anweisungsdatei CLAUDE.md aus dem neuen Ordner, sofern dort eine vorhanden ist – es passt sich also den Regeln des neuen Projekts an.

Zum Thema Vertrauen solltest du wissen: Wenn du in diesem Ordner noch nicht gearbeitet hast, fragt Claude beim Wechsel, ob du ihm vertraust. Das ist eine Schutzmaßnahme: Eine Anweisungsdatei in einem unbekannten Ordner könnte beliebige Inhalte haben. Deshalb prüft Claude zuerst, ob es dein Projekt ist. Bestätige das, und fahre dann fort.

Der Unterschied zwischen den beiden Befehlen ist einfach. /add-dir behält den Hauptordner als Arbeitsverzeichnis bei und öffnet zusätzlich einen benachbarten Ordner – nützlich, wenn Teile eines Projekts verstreut liegen. /cd verlegt das gesamte Arbeitsverzeichnis an einen neuen Ort – nützlich, wenn du zu einem anderen Projekt wechselst. Der Befehl /cd wurde in Version 2.1.169 eingeführt. Falls er fehlt, aktualisiere Claude Code. Eine separate Anleitung erklärt, wie du Claude Code aktualisierst.

Dass Claude Code Dateien sieht, ist nur die Grundlage. Stabile Ergebnisse entstehen nicht allein durch Dateizugriff. Entscheidend ist, was in den Dateien steht und wie du den Kontext rund um das Projekt aufbaust.

Warum kann Claude Code eine Datei in einem Unterordner nicht sehen?#

Hier dürfen zwei unterschiedliche Situationen nicht verwechselt werden. Ein benachbarter Ordner (außerhalb des Projekts) ist vollständig gesperrt, bis du ihn hinzufügst. Bei einem Unterordner innerhalb des Projekts ist es anders: Claude kann darauf zugreifen, behält seinen Inhalt aber nicht von Anfang an im Blick.

So funktioniert es: Beim Start lädt Claude die Inhalte aus den obersten Ebenen des Projekts. Dateien aus Unterordnern lädt es bei Bedarf, wenn es dort etwas liest. Die Dokumentation beschreibt dieses Verhalten für Anweisungsdateien; dieselbe Logik gilt allgemein für den Kontext.

Einfach gesagt: Die Datei in einem tief verschachtelten Unterordner ist nicht verschwunden und vollständig zugänglich. Claude hat sie nur noch nicht im Gedächtnis, weil es dort noch nicht nachgesehen hat. Das erklärt, warum es den Eindruck machen kann, Claude „könne die Datei nicht sehen“, obwohl sie vorhanden und zugänglich ist.

Das lässt sich mit einer einzigen Zeile beheben. Gib Claude direkt den Dateipfad – zum Beispiel src/components/header.jsx – oder bitte es einfach, die Datei zuerst zu lesen. Sobald es dort nachsieht, gelangt die Datei in den Kontext, und du kannst wie gewohnt damit arbeiten. Einstellungen musst du nicht ändern.

Wo verschwinden Dateien aus dem @-Menü, und was hat .gitignore damit zu tun?#

Ein weiterer häufiger Grund für den Eindruck, Claude habe eine Datei „verloren“, ist die Dateiauswahl. Wenn du @ eingibst, erscheint eine Liste, aus der du bequem eine Datei auswählen kannst, ohne den vollständigen Pfad einzugeben. Doch die Liste zeigt nicht alles.

Standardmäßig blendet das @-Menü Dateien aus, die in .gitignore aufgeführt sind. Diese Datei legt fest, was nicht zum gemeinsam genutzten Repository hinzugefügt werden soll: Dienstordner, Dateien mit Passwörtern und Umgebungsvariablen sowie fertige Build-Ausgaben. Der Gedanke dahinter ist nachvollziehbar – normalerweise musst du diese Dateien nicht manuell bearbeiten, und sie würden die Liste nur überladen. Manchmal brauchst du aber doch eine davon, und sie erscheint nicht im Menü.

Die Einstellung respectGitignore steuert dieses Verhalten. Sie ist standardmäßig aktiviert, sodass Dateien aus .gitignore nicht im Menü erscheinen. Wenn du sie sehen möchtest, setze den Wert auf false:

{
  "respectGitignore": false
}

Du kannst das auch ohne Bearbeitung der Datei tun, indem du in Claude Code den Befehl /config verwendest. Die Option heißt dort „Respect .gitignore in file picker“. Deaktiviere sie, und die ausgeblendeten Dateien erscheinen wieder im Menü.

Ein wichtiger Hinweis: respectGitignore gilt nur für das @-Menü und hat nichts mit dem Dateizugriff zu tun. Auch wenn eine Datei in der Liste ausgeblendet ist, kannst du ihren Pfad jederzeit manuell eingeben, und Claude liest sie. Das Menü ist eine Komfortfunktion; es legt die Zugriffsgrenze nicht fest.

Was solltest du tun, wenn Claude Code eine bestimmte Datei nicht lesen kann?#

Wenn der Ordner sicher stimmt und der Zugriff grundsätzlich freigegeben ist, Claude aber trotzdem eine bestimmte Datei nicht lesen will, ist der Zugriff wahrscheinlich eingeschränkt. Einschränkungen stehen in der Einstellungsdatei settings.json und es gibt zwei Arten.

Die erste Art sind gezielte Einschränkungen für bestimmte Dateien. In den Einstellungen stehen sie als deny-Regeln. Am häufigsten betreffen sie die Datei .env, in der Schlüssel und Passwörter gespeichert sind:

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

Eine solche Regel hindert Claude daran, die angegebenen Dateien zu lesen – und das ist beabsichtigt. Schlüssel und Passwörter sollten nicht in einem Gespräch mit dem Modell landen. Deshalb ist .env standardmäßig gesperrt. Wenn Claude .env oder eine ähnliche Datei mit Geheimnissen nicht lesen will, ist das so vorgesehen. Du solltest diese Einschränkung nicht ohne triftigen Grund entfernen.

Die zweite Art ist eine allgemeine Einschränkung für alles außerhalb der Arbeitsordner. Dafür ist die Einstellung blockReadsOutsideWorkingDirectories zuständig. Ist sie aktiviert, weigert sich Claude, Dateien außerhalb des Arbeitsverzeichnisses zu lesen, selbst wenn du versuchst, sie direkt zu öffnen. Steht sie auf true und brauchst du eine externe Datei, füge entweder ihren Ordner mit /add-dir hinzu oder deaktiviere die Einschränkung:

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

Diese Einstellung wurde in Version 2.1.257 eingeführt. Wenn du alles andere versucht hast und die Datei weiterhin gesperrt ist, solltest du sowohl deny als auch blockReadsOutsideWorkingDirectories prüfen.

Wo solltest du anfangen, wenn Claude Code keine Dateien sieht?#

Hier ist ein kurzer Plan, den du Schritt für Schritt durchgehen kannst.

1. Prüfe den Arbeitsordner: Bitte Claude, mit pwd das aktuelle Verzeichnis anzuzeigen, und vergleiche es mit dem Speicherort des Projekts.
2. Unterscheiden sich die Ordner, starte Claude aus dem richtigen Ordner neu (cd project, dann claude) oder wechsle mit dem Befehl /cd dorthin.
3. Benötigst du Dateien aus einem benachbarten Ordner? Füge ihn mit /add-dir oder beim Starten von Claude mit dem Flag --add-dir hinzu.
4. Eine Datei aus einem Unterordner ist nicht im Kontext? Gib Claude ihren Pfad direkt oder bitte es, die Datei zu lesen.
5. Fehlt eine Datei im @-Menü? Das liegt an .gitignore. Setze respectGitignore auf false oder deaktiviere das Kästchen in /config.
6. Ist eine bestimmte Datei gesperrt? Prüfe die Regeln deny und blockReadsOutsideWorkingDirectories in settings.json.

In neun von zehn Fällen löst der erste Schritt alles: Claude wurde aus dem falschen Ordner gestartet. Dateizugriff ist die Grundlage, aber er baut dein Projekt nicht für dich auf. In meinem Leitfaden zum Second Brain in Claude Code habe ich ausführlich beschrieben, wie du den Kontext rund um Claude aufbaust, damit es das gesamte Projekt im Blick behält und nicht den Faden verliert.

Weitere Materialien zur Arbeit mit Tools findest du in der Ailoot-Dokumentation.