Dai a Claude Code, Cursor e Codex i tuoi PDF e file Word

A ottobre 2026, Claude Code sa leggere un PDF da solo, Cursor legge un PDF che alleghi alla chat, e la CLI di Codex documenta l'input di immagini ma non dei PDF. Nessuno dei tre include i file Word (DOCX) tra i formati che legge direttamente. Per specifiche, manuali, articoli e contratti che l'agente userà più volte, convertili in Markdown, tieni le copie nel progetto e dì all'agente dove si trovano.

Questa guida è per gli agenti di programmazione che lavorano in una cartella di progetto. Se stai creando una cartella a parte di documenti di riferimento e non un progetto di codice, parti dalla nostra guida su come preparare i documenti per gli agenti IA.

Cosa legge direttamente ogni agente

Questo è ciò che dice la documentazione di ciascun fornitore a ottobre 2026.

Claude Code legge intero un PDF breve. Un PDF di oltre 10 pagine viene letto a intervalli di al massimo 20 pagine per volta, e queste letture richiedono il programma pdftoppm di poppler. Su Windows devi installare tu una build di poppler e aggiungerla al PATH; senza, la lettura fallisce. I dettagli sono nel riferimento agli strumenti di Claude Code.

Cursor ha aggiunto la lettura dei PDF nella versione 2.4, rilasciata a gennaio 2026. L'elenco di esclusione predefinito di Cursor include ancora i file PDF e vari formati Office, e la guida di Cursor dice che i file ignorati sono bloccati per l'agente. Allega tu il PDF alla chat invece di aspettarti che l'agente lo trovi nel progetto.

La CLI di Codex accetta immagini passate dalla riga di comando o incollate nel prompt. La sua documentazione non descrive l'input di PDF o Word per la CLI.

Un agente può comunque provare a estrarre il testo da un documento eseguendo un programma installato sul tuo computer. A volte funziona, ma non vedi quale testo ha ottenuto, e una tabella letta male finisce direttamente nella sua risposta.

Perché una copia Markdown funziona meglio

Il Markdown è testo semplice con titoli, elenchi e tabelle. In un progetto, ti dà quattro cose che un PDF o un file DOCX non offrono.

• L'agente può cercarci dentro. Una ricerca di testo trova una frase in un file Markdown. Un file DOCX è un archivio ZIP di parti XML, quindi una semplice ricerca di testo non trova nulla al suo interno.
• L'agente può citare righe esatte, e tu puoi trovare ogni frase citata nel file e leggere cosa la circonda.
• L'agente legge solo ciò che gli serve: cerca in un manuale lungo, poi apre l'unica sezione che conta invece di scorrere le pagine.
• Git mostra cosa è cambiato. Quando arriva una nuova edizione di una specifica, il diff elenca le righe modificate.

Vedi anche esattamente cosa legge l'agente. Se una tabella è venuta male, la correggi una volta nel file Markdown, e ogni sessione successiva usa la copia corretta.

Un PDF scansionato senza livello di testo è fatto solo di immagini di pagine. Ha bisogno dell'OCR (riconoscimento del testo) prima che un agente possa cercarci dentro. MD Factory riconosce il testo nei PDF scansionati sul tuo PC. Per controllare il risultato, consulta la nostra guida alla conversione dei PDF scansionati.

Mettere i documenti in una cartella docs

Tieni gli originali e le loro copie Markdown dentro il progetto, accanto al codice che ne dipende:

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. Copia i file PDF e Word nella cartella docs. MD Factory salva ogni file Markdown accanto al suo originale, quindi è qui che compariranno le copie.
2. In MD Factory, fai clic su Aggiungi cartella e scegli la cartella docs, oppure trascina la cartella nella finestra. La conversione parte subito.
3. Attendi che ogni file mostri uno stato: Completato, Da controllare o Fallito.
4. Fai clic su Da controllare accanto a un file per vedere cosa verificare, poi confronta quella parte con l'originale.

Le immagini di un documento vanno in una cartella che prende il suo nome, ad esempio partner-api-spec_images. I file PDF e Word in sé non vengono modificati.

Tieni gli originali nel progetto. Numeri di pagina, figure e il testo esatto firmato stanno lì, e ti serviranno ogni volta che la copia e la risposta dell'agente non concordano.

Indicare i file all'agente

Dai all'agente un breve elenco di documenti nel suo file di istruzioni. Claude Code legge CLAUDE.md, oppure AGENTS.md quando il progetto non ha un CLAUDE.md. Codex e Cursor leggono AGENTS.md. Ad esempio:

## Documenti di riferimento

Le copie Markdown dei file PDF e Word sono in docs/.
L'originale di ogni copia si trova accanto a essa.

- `docs/partner-api-spec.md`: specifica dell'API per i partner, versione 3.2
- `docs/supplier-contract.md`: contratto con il fornitore, edizione 2026

Cerca in docs/ prima di rispondere alle domande sull'API per i partner o sul contratto.
Cita il titolo della sezione su cui ti sei basato.
Non modificare i file in docs/.

Scrivi i percorsi tra apici inversi, come sopra, non come @docs/partner-api-spec.md. In CLAUDE.md, un percorso con @ è un'importazione: Claude Code carica l'intero file all'inizio di ogni sessione. Un percorso tra apici inversi resta una semplice menzione, e Claude apre il file quando un compito lo richiede.

Mantieni l'elenco breve. Codex smette di leggere i file di istruzioni quando insieme raggiungono 32 KiB, il suo limite predefinito.

Per un singolo compito, cita il file nel prompt:

• In Claude Code, digita @ e scegli il file. Claude Code aggiunge il suo contenuto alla conversazione se rientra nel limite di lettura, 25.000 token per impostazione predefinita. Per un file più lungo, chiedi a Claude di cercarci prima dentro.
• In Cursor, digita @ e scegli il file o l'intera cartella docs, come descritto nella guida di Cursor.
• Nella CLI di Codex, digita @ per inserire il percorso di un file, oppure usa il comando /mention per allegare un file, come descritto nella guida ai prompt di Codex.

Un prompt che nomina il documento e chiede citazioni potrebbe essere così:

Leggi le sezioni "Authentication" e "Rate limits" di
docs/partner-api-spec.md. Aggiorna il client dell'API in modo che le rispetti.
Per ogni modifica, cita la riga della specifica su cui si basa.

Controllare le risposte e aggiornare le copie

Prima di fidarti di una risposta, trova tu stesso il passaggio citato. Usa il primo comando in PowerShell e il secondo in Git Bash:

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

Se la citazione non è nel file Markdown, cerca nell'originale. Se non c'è nemmeno lì, l'agente non l'ha presa dal documento. Per numeri di pagina e cifre, apri sempre l'originale.

Fai attenzione al file .gitignore. La ricerca di Claude Code salta i file in gitignore, anche se Claude può comunque cercare o leggere un file che nomini con il suo percorso. Cursor tiene i file in gitignore lontani dall'agente a meno che una riga che inizia con ! in .cursorignore non li riammetta. Se i documenti devono restare fuori da Git, elenca ogni percorso di file nel file di istruzioni per Claude Code, e aggiungi questa riga a .cursorignore per Cursor: !docs/

I file di riferimento dovrebbero cambiare solo quando lo decidi tu. Guarda il diff dopo ogni compito. Se vuoi che Claude Code lasci stare la cartella docs, aggiungi per essa una regola di negazione per Edit.

Quando arriva una nuova edizione, sostituisci l'originale nella cartella docs mantenendo lo stesso nome file, e aggiungilo di nuovo a MD Factory. Se non hai modificato la vecchia copia Markdown, MD Factory la sostituisce. Se l'hai modificata, la nuova copia riceve un nome numerato, ad esempio partner-api-spec (2).md, e le tue modifiche restano nel vecchio file. Un diff del file Markdown mostra poi quali sezioni sono cambiate e quale codice potrebbe doverle seguire.

Documenti riservati: cosa invia l'agente

MD Factory converte i documenti sul tuo PC e non li carica, ma questo riguarda solo la conversione. Quando l'agente legge la copia Markdown, il testo va al fornitore del modello come il resto del prompt.

• Claude Code gira sul tuo computer ma invia prompt e output del modello attraverso la rete. Per quanto tempo Anthropic conservi quei dati dipende dal tipo di account e dalle impostazioni sulla privacy: vedi la conservazione dei dati in Claude Code.
• Cursor dice che quando l'agente apre un file, il suo contenuto può essere incluso nella richiesta al modello.
• Codex usa OpenAI come fornitore di modelli predefinito.

Prima che un agente legga un documento riservato:

• Converti e aggiungi solo i documenti che servono al compito.
• Se un documento è coperto da un accordo di riservatezza o da un contratto con un cliente, verifica se consente di inviare il testo a un servizio IA esterno.
• Tieni fuori dalla cartella del progetto i documenti che l'agente non deve leggere. Le regole di negazione di Claude Code e i file di esclusione di Cursor bloccano gli strumenti per i file integrati. Entrambi i fornitori precisano che alcuni comandi del terminale possono comunque leggere tali file: vedi i permessi di Claude Code e i file di esclusione di Cursor.
• Considera i documenti di altre persone come input non attendibile: possono contenere testo scritto per orientare un agente. Controlla i comandi e le modifiche che l'agente propone.