PDFs und Word-Dateien für Claude Code, Cursor und Codex

Mit Stand Oktober 2026 kann Claude Code eine PDF selbst lesen, Cursor liest eine PDF, die Sie an den Chat anhängen, und die Dokumentation der Codex CLI beschreibt Bildeingaben, aber keine PDFs. Keines der drei Tools nennt Word-Dateien (DOCX) unter den Formaten, die es direkt liest. Spezifikationen, Handbücher, Fachartikel und Verträge, die der Agent mehr als einmal braucht, wandeln Sie am besten in Markdown um, legen die Kopien im Projekt ab und sagen dem Agenten, wo sie liegen.

Diese Anleitung richtet sich an Coding-Agenten, die in einem Projektordner arbeiten. Wenn Sie keinen Code, sondern einen eigenen Ordner mit Referenzdokumenten aufbauen, beginnen Sie mit unserer Anleitung zur Vorbereitung von Dokumenten für KI-Agenten.

Was jeder Agent direkt liest

Das steht mit Stand Oktober 2026 in der Dokumentation der jeweiligen Hersteller.

Claude Code liest eine kurze PDF vollständig. Eine PDF mit mehr als 10 Seiten liest es in Abschnitten von bis zu 20 Seiten, und dafür braucht es das Programm pdftoppm aus poppler. Unter Windows installieren Sie einen poppler-Build selbst und fügen ihn zu PATH hinzu; ohne ihn schlägt das Lesen fehl. Details stehen in der Tool-Referenz von Claude Code.

Cursor liest PDFs seit Version 2.4, die im Januar 2026 erschienen ist. Die Standard-Ignorierliste von Cursor enthält weiterhin PDF-Dateien und mehrere Office-Formate, und laut der Hilfe von Cursor gilt: Ignorierte Dateien sind für den Agenten gesperrt. Hängen Sie die PDF daher selbst an den Chat an, statt darauf zu setzen, dass der Agent sie im Projekt findet.

Die Codex CLI nimmt Bilder an – über die Befehlszeile oder eingefügt in die Eingabe. PDF- oder Word-Eingaben für die CLI beschreibt die Dokumentation nicht.

Ein Agent kann zwar versuchen, Text mit einem auf Ihrem Computer installierten Programm aus einem Dokument zu ziehen. Manchmal klappt das, aber Sie sehen nicht, welchen Text er bekommen hat, und eine falsch gelesene Tabelle landet direkt in seiner Antwort.

Warum eine Markdown-Kopie besser funktioniert

Markdown ist reiner Text mit Überschriften, Listen und Tabellen. In einem Projekt bringt das vier Vorteile, die eine PDF- oder DOCX-Datei nicht bietet.

• Der Agent kann sie durchsuchen. Eine Textsuche findet einen Ausdruck in einer Markdown-Datei. Eine DOCX-Datei ist ein ZIP-Archiv aus XML-Teilen, deshalb findet eine einfache Textsuche darin nichts.
• Der Agent kann Zeilen wörtlich zitieren, und Sie können jeden zitierten Satz in der Datei finden und den Zusammenhang lesen.
• Der Agent liest nur, was er braucht: Er durchsucht ein langes Handbuch und öffnet dann genau den passenden Abschnitt, statt sich durch die Seiten zu arbeiten.
• Git zeigt, was sich geändert hat. Kommt eine neue Fassung einer Spezifikation, listet der Diff die geänderten Zeilen auf.

Außerdem sehen Sie genau, was der Agent liest. Ist eine Tabelle falsch herausgekommen, korrigieren Sie sie einmal in der Markdown-Datei, und jede spätere Sitzung arbeitet mit der korrigierten Kopie.

Eine gescannte PDF ohne Textebene besteht nur aus Bildern der Seiten. Bevor ein Agent sie durchsuchen kann, braucht sie OCR (Texterkennung). MD Factory erkennt Text in gescannten PDFs auf Ihrem PC. Wie Sie das Ergebnis prüfen, lesen Sie in unserer Anleitung zum Umwandeln gescannter PDFs.

Dokumente in einen docs-Ordner legen

Legen Sie die Originale und ihre Markdown-Kopien im Projekt ab, neben dem Code, der von ihnen abhängt:

payments-service/
  AGENTS.md
  docs/
    partner-api-spec.pdf
    partner-api-spec.md
    partner-api-spec_images/
    supplier-contract.docx
    supplier-contract.md
  src/

1. Kopieren Sie die PDF- und Word-Dateien in den docs-Ordner. MD Factory speichert jede Markdown-Datei neben ihrem Original, die Kopien landen also genau dort.
2. Klicken Sie in MD Factory auf „Ordner hinzufügen“ und wählen Sie den docs-Ordner, oder ziehen Sie den Ordner auf das Fenster. Die Konvertierung startet sofort.
3. Warten Sie, bis jede Datei einen Status zeigt: „Abgeschlossen“, „Überprüfung erforderlich“ oder „Fehlgeschlagen“.
4. Klicken Sie neben einer Datei auf „Überprüfung erforderlich“, um zu sehen, was zu prüfen ist, und vergleichen Sie diese Stelle mit dem Original.

Bilder aus einem Dokument landen in einem Ordner, der nach ihm benannt ist, zum Beispiel partner-api-spec_images. Die PDF- und Word-Dateien selbst bleiben unverändert.

Behalten Sie die Originale im Projekt. Seitenzahlen, Abbildungen und der genaue unterschriebene Wortlaut stehen dort, und Sie brauchen sie, sobald Kopie und Antwort des Agenten voneinander abweichen.

Dem Agenten die Dateien zeigen

Geben Sie dem Agenten in seiner Anweisungsdatei eine kurze Liste der Dokumente. Claude Code liest CLAUDE.md oder, wenn das Projekt keine CLAUDE.md hat, AGENTS.md. Codex und Cursor lesen AGENTS.md. Zum Beispiel:

## Referenzdokumente

Markdown-Kopien von PDF- und Word-Dateien liegen in docs/.
Das Original jeder Kopie liegt daneben.

- `docs/partner-api-spec.md`: API-Spezifikation des Partners, Version 3.2
- `docs/supplier-contract.md`: Liefervertrag, Fassung 2026

Durchsuche docs/, bevor du Fragen zur Partner-API oder zum Vertrag beantwortest.
Zitiere die Abschnittsüberschrift, auf die du dich stützt.
Bearbeite keine Dateien in docs/.

Schreiben Sie die Pfade wie oben in Backticks, nicht als @docs/partner-api-spec.md. In CLAUDE.md ist ein @-Pfad ein Import: Claude Code lädt die ganze Datei zu Beginn jeder Sitzung. Ein Pfad in Backticks bleibt eine einfache Erwähnung, und Claude öffnet die Datei, wenn eine Aufgabe sie braucht.

Halten Sie die Liste kurz. Codex liest keine weiteren Anweisungsdateien mehr, sobald diese zusammen 32 KiB erreichen, sein Standardlimit.

Für eine einzelne Aufgabe erwähnen Sie die Datei im Prompt:

• Geben Sie in Claude Code @ ein und wählen Sie die Datei. Claude Code fügt ihren Inhalt in die Unterhaltung ein – sofern er ins Leselimit passt, standardmäßig 25.000 Tokens. Bei einer längeren Datei bitten Sie Claude, sie zuerst zu durchsuchen.
• Geben Sie in Cursor @ ein und wählen Sie die Datei oder den ganzen docs-Ordner, wie beschrieben in der Hilfe von Cursor.
• Geben Sie in der Codex CLI @ ein, um einen Dateipfad einzufügen, oder hängen Sie mit dem Befehl /mention eine Datei an, wie beschrieben im Prompting-Leitfaden für Codex.

Ein Prompt, der das Dokument nennt und um Zitate bittet, könnte so aussehen:

Lies die Abschnitte „Authentication“ und „Rate limits“ in
docs/partner-api-spec.md. Passe den API-Client daran an.
Zitiere für jede Änderung die Zeile der Spezifikation, auf die sie sich stützt.

Antworten prüfen und Kopien aktualisieren

Bevor Sie sich auf eine Antwort verlassen, suchen Sie die zitierte Stelle selbst. Der erste Befehl ist für PowerShell, der zweite für Git Bash:

Select-String -Path docs\*.md -Pattern "rate limit"
grep -n -i "rate limit" docs/*.md

Steht das Zitat nicht in der Markdown-Datei, sehen Sie im Original nach. Steht es auch dort nicht, hat der Agent es nicht aus dem Dokument. Für Seitenzahlen und Abbildungen öffnen Sie immer das Original.

Achten Sie auf Ihre .gitignore-Datei. Die Suche von Claude Code überspringt Dateien aus .gitignore, Claude kann eine Datei aber trotzdem durchsuchen oder lesen, wenn Sie den Pfad nennen. Cursor hält Dateien aus .gitignore vom Agenten fern – es sei denn, eine Zeile mit ! in .cursorignore lässt sie wieder zu. Wenn die Dokumente nicht in Git landen dürfen, führen Sie für Claude Code jeden Dateipfad in der Anweisungsdatei auf und tragen Sie für Cursor diese Zeile in .cursorignore ein: !docs/

Referenzdateien sollten sich nur ändern, wenn Sie es entscheiden. Sehen Sie sich nach jeder Aufgabe den Diff an. Wenn Claude Code den docs-Ordner nicht anfassen soll, legen Sie eine Edit-Deny-Regel dafür an.

Kommt eine neue Fassung, ersetzen Sie das Original im docs-Ordner unter demselben Dateinamen und fügen es erneut in MD Factory hinzu. Haben Sie die alte Markdown-Kopie nicht bearbeitet, ersetzt MD Factory sie. Haben Sie sie bearbeitet, bekommt die neue Kopie einen nummerierten Namen, zum Beispiel partner-api-spec (2).md, und Ihre Änderungen bleiben in der alten Datei. Ein Diff der Markdown-Datei zeigt dann, welche Abschnitte sich geändert haben und welcher Code eventuell nachziehen muss.

Vertrauliche Dokumente: was der Agent sendet

MD Factory konvertiert Dokumente auf Ihrem PC und lädt sie nicht hoch, das betrifft aber nur die Konvertierung. Wenn der Agent die Markdown-Kopie liest, geht der Text wie der Rest Ihres Prompts an den Modellanbieter.

• Claude Code läuft auf Ihrem Computer, sendet Prompts und Modellausgaben aber über das Netzwerk. Wie lange Anthropic diese Daten speichert, hängt von Kontotyp und Datenschutzeinstellungen ab; siehe Datenspeicherung in Claude Code.
• Cursor schreibt, dass beim Öffnen einer Datei durch den Agenten ihr Inhalt in die Anfrage an das Modell einfließen kann.
• Codex nutzt OpenAI als Standard-Modellanbieter.

Bevor ein Agent ein vertrauliches Dokument liest:

• Konvertieren und ergänzen Sie nur die Dokumente, die die Aufgabe braucht.
• Fällt ein Dokument unter eine Vertraulichkeitsvereinbarung oder einen Kundenvertrag, prüfen Sie, ob es erlaubt ist, den Text an einen externen KI-Dienst zu senden.
• Bewahren Sie Dokumente, die der Agent nicht lesen darf, außerhalb des Projektordners auf. Deny-Regeln in Claude Code und Ignore-Dateien in Cursor sperren die eingebauten Datei-Tools. Beide Hersteller weisen aber darauf hin, dass manche Terminalbefehle solche Dateien trotzdem lesen können; siehe Berechtigungen in Claude Code und Ignore-Dateien in Cursor.
• Behandeln Sie Dokumente von anderen als nicht vertrauenswürdige Eingabe: Sie können Text enthalten, der einen Agenten steuern soll. Prüfen Sie die Befehle und Änderungen, die der Agent vorschlägt.