En octobre 2026, Claude Code sait lire un PDF tout seul, Cursor lit un PDF que vous joignez à la conversation, et la documentation de Codex CLI décrit l’envoi d’images, mais pas de PDF. Aucun des trois ne cite les fichiers Word (DOCX) parmi les formats qu’il lit directement. Pour les spécifications, manuels, articles et contrats que l’agent utilisera plus d’une fois, convertissez-les en Markdown, gardez les copies dans le projet et indiquez à l’agent où elles se trouvent.

Ce guide concerne les agents de code qui travaillent dans un dossier de projet. Si vous constituez plutôt un dossier séparé de documents de référence, sans code, commencez par notre guide pour préparer des documents pour les agents IA.

Un ordinateur portable ouvert à l’écran flou, à côté d’une pile de documents imprimés tenue par une pince lilas.
Gardez l’original à côté de la copie que lit l’agent.

Ce que chaque agent lit directement

Voici ce qu’indique la documentation de chaque éditeur en octobre 2026.

AgentPDFWord (DOCX)Images
Claude CodeLit les fichiers PDF avec son outil de fichiersAbsent de la liste des types de fichiers pris en chargePNG, JPG et d’autres formats
CursorLit les PDF joints à la conversationNon mentionnéPNG, JPG, GIF, WebP et SVG
Codex CLINon mentionné pour la CLINon mentionnéFormats courants, dont PNG et JPEG

Claude Code lit un PDF court en entier. Un PDF de plus de 10 pages est lu par tranches de 20 pages au maximum, et ces lectures nécessitent le programme pdftoppm de poppler. Sous Windows, vous installez vous-même une version de poppler et l’ajoutez à votre PATH ; sans elle, la lecture échoue. Les détails figurent dans la référence des outils de Claude Code.

Cursor lit les PDF depuis la version 2.4, publiée en janvier 2026. La liste d’exclusion par défaut de Cursor contient toujours les fichiers PDF et plusieurs formats Office, et l’aide de Cursor précise que les fichiers exclus sont bloqués pour l’agent. Joignez donc vous-même le PDF à la conversation plutôt que de compter sur l’agent pour le trouver dans le projet.

Codex CLI accepte des images passées en ligne de commande ou collées dans la saisie. Sa documentation ne décrit pas d’entrée PDF ou Word pour la CLI.

Un agent peut toujours essayer d’extraire le texte d’un document en lançant un programme installé sur votre ordinateur. Cela fonctionne parfois, mais vous ne voyez pas quel texte il a obtenu, et un tableau mal lu passe directement dans sa réponse.

Pourquoi une copie Markdown fonctionne mieux

Le Markdown est du texte brut avec des titres, des listes et des tableaux. Dans un projet, il vous apporte quatre avantages qu’un fichier PDF ou DOCX n’offre pas.

  • L’agent peut y chercher. Une recherche textuelle trouve une expression dans un fichier Markdown. Un fichier DOCX est une archive ZIP de parties XML, si bien qu’une simple recherche textuelle n’y trouve rien.
  • L’agent peut citer des lignes exactes, et vous pouvez retrouver chaque phrase citée dans le fichier et lire ce qui l’entoure.
  • L’agent ne lit que ce dont il a besoin : il cherche dans un long manuel, puis ouvre la seule section utile au lieu de parcourir les pages.
  • Git montre ce qui a changé. Quand une nouvelle édition d’une spécification arrive, le diff liste les lignes modifiées.

Vous voyez aussi exactement ce que lit l’agent. Si un tableau est mal sorti, vous le corrigez une fois dans le fichier Markdown, et toutes les sessions suivantes utilisent la copie corrigée.

Un PDF scanné sans couche de texte ne contient que des images de pages. Il faut un OCR (reconnaissance de texte) avant qu’un agent puisse y chercher. MD Factory reconnaît le texte des PDF scannés sur votre PC. Pour vérifier le résultat, consultez notre guide de conversion des PDF scannés.

Placer les documents dans un dossier docs

Gardez les originaux et leurs copies Markdown dans le projet, à côté du code qui en dépend :

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. Copiez les fichiers PDF et Word dans le dossier docs. MD Factory enregistre chaque fichier Markdown à côté de son original : c’est donc là que les copies apparaîtront.
  2. Dans MD Factory, cliquez sur Ajouter un dossier et choisissez le dossier docs, ou déposez le dossier sur la fenêtre. La conversion démarre aussitôt.
  3. Attendez que chaque fichier affiche un statut : Terminé, À vérifier ou Échec.
  4. Cliquez sur À vérifier à côté d’un fichier pour voir ce qu’il faut contrôler, puis comparez ce passage avec l’original.

Les images d’un document vont dans un dossier qui porte son nom, par exemple partner-api-spec_images. Les fichiers PDF et Word eux-mêmes ne sont pas modifiés.

Gardez les originaux dans le projet. Les numéros de page, les figures et la formulation exacte du texte signé s’y trouvent, et vous en aurez besoin chaque fois que la copie et la réponse de l’agent divergent.

Indiquer les fichiers à l’agent

Donnez à l’agent une courte liste de documents dans son fichier d’instructions. Claude Code lit CLAUDE.md, ou AGENTS.md si le projet n’a pas de CLAUDE.md. Codex et Cursor lisent AGENTS.md. Par exemple :

## Documents de référence

Les copies Markdown des fichiers PDF et Word sont dans docs/.
L’original de chaque copie se trouve à côté.

- `docs/partner-api-spec.md` : spécification de l’API partenaire, version 3.2
- `docs/supplier-contract.md` : contrat fournisseur, édition 2026

Cherche dans docs/ avant de répondre aux questions sur l’API partenaire ou le contrat.
Cite le titre de la section sur laquelle tu t’appuies.
Ne modifie pas les fichiers de docs/.

Écrivez les chemins entre accents graves, comme ci-dessus, et non sous la forme @docs/partner-api-spec.md. Dans CLAUDE.md, un chemin avec @ est une importation : Claude Code charge le fichier entier au début de chaque session. Un chemin entre accents graves reste une simple mention, et Claude ouvre le fichier quand une tâche en a besoin.

Gardez la liste courte. Codex cesse de lire les fichiers d’instructions dès que leur taille cumulée atteint 32 Kio, sa limite par défaut.

Pour une tâche ponctuelle, mentionnez le fichier dans votre requête :

  • Dans Claude Code, tapez @ et choisissez le fichier. Claude Code ajoute son contenu à la conversation s’il tient dans la limite de lecture, 25 000 tokens par défaut. Pour un fichier plus long, demandez d’abord à Claude d’y faire une recherche.
  • Dans Cursor, tapez @ et choisissez le fichier ou tout le dossier docs, comme l’explique l’aide de Cursor.
  • Dans Codex CLI, tapez @ pour insérer un chemin de fichier, ou utilisez la commande /mention pour joindre un fichier, comme l’explique le guide de rédaction des requêtes de Codex.

Une requête qui nomme le document et demande des citations peut ressembler à ceci :

Lis les sections « Authentication » et « Rate limits » de
docs/partner-api-spec.md. Adapte le client API en conséquence.
Pour chaque modification, cite la ligne de la spécification sur laquelle elle s’appuie.

Vérifier les réponses et mettre à jour les copies

Avant de vous fier à une réponse, retrouvez vous-même le passage cité. Utilisez la première commande dans PowerShell et la seconde dans Git Bash :

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

Si la citation ne figure pas dans le fichier Markdown, cherchez dans l’original. Si elle n’y est pas non plus, l’agent ne l’a pas tirée du document. Pour les numéros de page et les figures, ouvrez toujours l’original.

Surveillez votre fichier .gitignore. La recherche de Claude Code ignore les fichiers listés dans .gitignore, mais Claude peut toujours chercher dans un fichier ou le lire si vous indiquez son chemin. Cursor tient les fichiers de .gitignore à l’écart de l’agent sauf si une ligne commençant par ! dans .cursorignore les réintègre. Si les documents doivent rester hors de Git, listez chaque chemin de fichier dans le fichier d’instructions pour Claude Code, et ajoutez cette ligne à .cursorignore pour Cursor : !docs/

Les fichiers de référence ne devraient changer que sur votre décision. Regardez le diff après chaque tâche. Si vous voulez que Claude Code ne touche pas au dossier docs, ajoutez une règle de refus Edit pour ce dossier.

Quand une nouvelle édition arrive, remplacez l’original dans le dossier docs en gardant le même nom de fichier, puis ajoutez-le de nouveau à MD Factory. Si vous n’avez pas modifié l’ancienne copie Markdown, MD Factory la remplace. Sinon, la nouvelle copie reçoit un nom numéroté, par exemple partner-api-spec (2).md, et vos modifications restent dans l’ancien fichier. Un diff du fichier Markdown montre alors quelles sections ont changé et quel code devra peut-être suivre.

Documents confidentiels : ce que l’agent envoie

MD Factory convertit les documents sur votre PC et ne les envoie nulle part, mais cela ne concerne que la conversion. Quand l’agent lit la copie Markdown, le texte part chez le fournisseur du modèle comme le reste de votre requête.

Avant qu’un agent lise un document confidentiel :

  • Convertissez et ajoutez uniquement les documents nécessaires à la tâche.
  • Si un document relève d’un accord de confidentialité ou d’un contrat client, vérifiez qu’il autorise l’envoi du texte à un service d’IA externe.
  • Gardez hors du dossier du projet les documents que l’agent ne doit pas lire. Les règles de refus de Claude Code et les fichiers d’exclusion de Cursor bloquent les outils de fichiers intégrés. Les deux éditeurs signalent toutefois que certaines commandes du terminal peuvent quand même lire ces fichiers : voir les autorisations de Claude Code et les fichiers d’exclusion de Cursor.
  • Traitez les documents venant d’autres personnes comme des données non fiables : ils peuvent contenir du texte écrit pour orienter un agent. Vérifiez les commandes et les modifications que l’agent propose.