Comment utiliser IronPDF avec Claude Code
Associer un agent de codage IA avec une bibliothèque PDF semble simple jusqu'à ce que le premier extrait généré fasse référence à une méthode inexistante. Claude Code est l'outil de codage agentique d'Anthropic, lisant une base de code, éditant des fichiers, et exécutant des commandes directement à partir d'une session de terminal, d'une extension VS Code ou JetBrains, d'une application de bureau ou du web, ce qui en fait un choix raisonnable pour les parties répétitives du travail PDF : connecter un moteur de rendu, façonner un modèle HTML, ajouter des en-têtes et pieds de pages à travers une douzaine de types de rapports.
IronPDF rend le HTML, CSS et JavaScript en PDF via un moteur Chromium intégré, donc le code qu'un agent doit produire est réduit, et le HTML qu'il doit produire est la partie qui traite de la mise en page. Cette distinction est importante. Laissez Claude Code gérer le modèle et la plomberie, et gardez l'appel de rendu lui-même suffisamment court pour être audité d'un coup d'œil. IronPDF porte également plus de poids en termes de données d'entraînement que la plupart des bibliothèques PDF .NET : plus de 20 millions de téléchargements NuGet et des années de documentation publique signifient que Claude Code connaît déjà ses appels de rendu principaux, ce qui raccourcit la distance entre l'invite et le code fonctionnel, bien que l'étape de vérification ci-dessous s'applique toujours. Ce guide explique la configuration du projet, les modèles d'invitation qui fonctionnent, et l'étape de vérification qui attrape les API inventées avant qu'elles n'atteignent une construction.
Le groupe de pointe de Claude a de nouveau bougé en 2026. Claude Code propose maintenant Fable 5.1, que sa documentation décrit adapté à des tâches nécessitant plus qu'une simple séance, aux côtés d'Opus 5.5, Sonnet 5.5 et Haiku 5.5, et celui que vous choisissez dépend de la tâche devant vous plutôt qu'un classement. Ce guide fonctionne avec n'importe lequel d'entre eux. Tout ce qui suit est écrit pour maintenir quel que soit le modèle de pointe qui répond à l'invite, et /model bascule entre eux en cours de session.
Attendez-vous à ce que le document lui-même change avec ce choix. La même incitation donnée à deux modèles retourne deux factures, avec des espacements différents, un accent différent, un moyen différent de diviser un tableau sur plusieurs pages. Ce qui reste constant est tout ce que vous avez spécifié, donc épinglez le nombre de pages, le texte en en-tête, et le format de pied de page, et laissez le reste varier.
Démarrage rapideOuvrez une session dans un projet .NET et demandez le document plutôt que le code :
Hey Claude Code, add IronPDF to this project and build me a
one-page PDF that says "Hello from IronPDF". Render it with
ChromePdfRenderer, save it to output.pdf in the project root,
then build and run it so I can open the file.
Claude Code gère cela de bout en bout. Il ajoute le package NuGet, écrit les quelques lignes qui construisent un ChromePdfRenderer, appelle RenderHtmlAsPdf sur votre balisage, et SaveAs le résultat sur le disque, exécute dotnet build, corrige ce qui échoue à compiler, et vous dit où le fichier est arrivé. Ce que vous revoyez est une différence.
Il décide également de tout ce que vous laissez ouvert, et pour un hello world, cela fonctionne : il prendra la version la plus récente du paquet, suivra le cadre cible existant du projet, et nommera la classe de manière raisonnable. Pour un vrai travail, trois ajouts gardent ces décisions à vous :
- Épinglez la version : nommez la version d'IronPDF que vous ciblez, afin que l'agent travaille avec une surface API plutôt que de faire la moyenne entre plusieurs.
- Enceignez les dépendances : dites qu'IronPDF est le seul paquet qu'il peut ajouter, pour qu'une seconde bibliothèque PDF ne se retrouve jamais dans la différence.
- Permettez-lui de s'arrêter : demandez-lui d'utiliser uniquement des API documentées et de le dire lorsqu'il n'est pas sûr, ce qui transforme une invention silencieuse en une question à laquelle vous pouvez répondre.
Flux de travail minimal (5 étapes)
- Téléchargez la bibliothèque PDF C# de NuGet
- Lancez une session Claude Code depuis la racine du projet pour que l'agent puisse lire le code existant.
- Enregistrez vos contraintes dans
CLAUDE.mdpour que chaque session les héritent. - Demandez d'abord le modèle HTML, puis le code de rendu qui l'utilise.
- Compilez, exécutez, ouvrez le PDF et vérifiez chaque nom d'API dans la référence API.
Que fait réellement Claude Code dans un projet PDF .NET ?
Claude Code passe la plupart de son temps de travail sur le développement ordinaire : lire une base de code, écrire et refactoriser des classes, exécuter des constructions et piloter la boucle de test depuis un terminal, une extension IDE, l'application de bureau ou le web. La génération de documents se situe à l'intérieur de cette même boucle et n'a besoin de rien de spécial.
Pour le travail PDF, la moitié mécanique est prise en charge. Il écrit le modèle HTML et la classe de rendu, modifie le CSS lorsqu'un tableau se divise sur une page, efface les fichiers incorrects et les régénère, remodèle une douzaine de modèles de rapports en une seule passe, exécute dotnet build, lit l'erreur du compilateur, et recommence. Vous décrivez le document et révisez une différence, ce qui est une conversation bien plus courte que de coller des extraits d'un côté à l'autre.
Cela laisse une décision, et elle reste la vôtre : ce qui rend le PDF. Donné une liberté totale, un agent assemble un pipeline de documents à partir de ce qu'il a le plus souvent vu à l'entraînement, et c'est là que réside le risque.
- Les documents sensibles ont besoin d'une bibliothèque sécurisée : les PDF qu'une entreprise génère sont ses contrats, factures, et dépôts légaux. Plusieurs outils PDF open-source largement copiés sont abandonnés aujourd'hui, avec des failles de sécurité connues publiquement que personne ne corrige, et un pipeline construit sur eux peut fuiter les documents qu'il traite.
- Le volume est facturé par jeton : rendre une facture est facile, en rendre cinquante mille du jour au lendemain est la partie difficile. Un agent qui résout cela en code est facturé pour chaque mot qu'il lit et écrit, aux tarifs d'Opus 5.5 de 4 à 20 dollars par million de tokens, et la facture revient chaque fois que le problème se reproduit. IronPDF livre ce travail à l'intérieur de la bibliothèque, où il est résolu une fois.
- Les pipelines improvisés n'apportent aucune preuve : personne n'en a exécuté un à travers mille documents, mesuré ou publié un résultat que vous pouvez vérifier. IronPDF a une surface API documentée derrière, et le test en série publie un résultat daté que vous pouvez relancer vous-même.
- Un vrai package bat un deviné : les agents installent parfois des noms de package qui semblent corrects, une astuce assez courante pour qu'elle ait gagné un nom, "slopsquatting", et n'importe qui peut enregistrer ces noms et les remplir de logiciels malveillants. Nommer un seul paquet connu dans votre incitation ferme cette porte.
Pointez Claude Code vers IronPDF et le travail de l'agent se réduit à ce dans quoi il excelle vraiment : écrire le HTML, câbler le moteur de rendu, et exécuter la construction jusqu'à ce que le document soit correct.
Comment configurer Claude Code ?
Installez-le une fois, authentifiez-vous avec un compte Claude, et vous êtes prêt. La vue d'ensemble de Claude Code d'Anthropic couvre ce qu'est l'outil et comment installer les extensions VS Code et JetBrains si vous préférez ne pas travailler dans un terminal, et le démarrage rapide explique l'installation et la première session sur macOS, Windows, et Linux. Anthropic publie des vidéos tutorielles sur sa chaîne YouTube si vous préférez regarder une première session avant de l'exécuter.
Une fois que claude ouvre une session et vous répond, revenez ici. Le reste de ce guide suppose juste cela et rien de plus.
Comment configurer un projet dans lequel Claude Code peut travailler ?
Vous commencez avec un projet .NET normal et ajoutez IronPDF avant même que l'agent ne l'ouvre. Donner à l'agent un projet qui compile déjà supprime toute une catégorie de confusion : il n'a jamais besoin de deviner quelle bibliothèque PDF vous avez en tête.
dotnet new console -n PdfReportDemo
cd PdfReportDemo
dotnet add package IronPdf --version 2026.10.3
claude
La commande finale démarre une session Claude Code dans le répertoire actuel, ce qui définit les limites de lecture et d'édition de l'agent à ce dossier. Le schéma documenté est de changer dans le répertoire du projet et d'exécuter le CLI à partir de là. Le terminal, les extensions VS Code et JetBrains, l'application de bureau, et le web utilisent tous le même moteur sous-jacent, donc un fichier CLAUDE.md, les paramètres de projet, et tous les serveurs MCP configurés pour ce projet se poursuivent quel que soit le support qui reprend la session suivante.
Deux détails de configuration font gagner du temps plus tard :
CLAUDE.md: le fichier d'instructions au niveau du projet que Claude Code lit au début de chaque session. Enregistrez le cadre cible, qu'IronPDF est la bibliothèque PDF, et que le code généré doit utiliser uniquement des API documentées.- Index de la documentation IronPDF :
llms.txtrépertorie les URLs de documentation valides sous une forme lisible par un agent.
Ensemble, ils remplacent "écrire le code IronPDF de mémoire" par "lire la documentation, puis écrire le code." Une incitation écrit le fichier pour vous :
Create CLAUDE.md at the project root with a PDF section stating that this
project uses IronPDF for all PDF generation, that you must read
https://ironpdf.com/llms.txt before writing PDF code and use only APIs
documented there, that https://ironpdf.com/skill.md should be loaded if the
tooling supports skill files, that ChromePdfRenderer is the HTML to PDF entry
point, and that no competing PDF package may be added.
Autre chose qui doit appartenir au projet avant le premier rendu. Sans clé de licence, IronPDF rend le document en mémoire mais déclenche une exception de licence lorsque le code enregistre le PDF ou lit ses octets, donc la clé est insérée au démarrage de l'application, avant tout autre appel IronPdf. Clés de licence IronPDF explique où en obtenir une et toutes les manières de l'appliquer.
Comment demander du code IronPDF qui compile ?
Obtenez la sortie la plus fiable en séparant les deux moitiés du travail. La mise en page vit en HTML et CSS, où un agent est en terrain familier. Le rendu réside dans une poignée d'appels C#, où la précision compte et la surface est petite.
Une incitation qui fonctionne ressemble plus à une spécification qu'à une demande de fonctionnalité :
Create an invoice template at Templates/invoice.html using plain HTML and inline CSS. Include a header with a company name placeholder, a line-item table with description, quantity, unit price, and total columns, and a totals block aligned right. Do not add JavaScript. Then write InvoiceRenderer.cs that loads that file, substitutes placeholder values, and renders it with ChromePdfRenderer. Use only methods documented at ironpdf.com. If unsure of a method name, stop and ask.
Trois choses font que cette incitation tient le coup :
- Elle nomme les chemins de fichiers : l'agent construit une structure que vous pouvez naviguer au lieu d'en inventer une.
- Elle contraint le HTML : JavaScript non sollicité amène des questions de temps de rendu qui ne sont pas agréables à déboguer dès le premier jour.
- Elle donne une porte de sortie : "si vous n'êtes pas sûr, arrêtez-vous et demandez" fait de l'incertitude avouée une réponse acceptable, et les agents la prennent.
CLAUDE.md. Chaque session ultérieure dans ce projet commence avec eux déjà chargés.Attendez-vous à une courte séquence de retour : lisez le modèle avec File.ReadAllText, remplacez les valeurs de remplacement, passez le résultat à ChromePdfRenderer et sa méthode RenderHtmlAsPdf, puis écrivez le document sur le disque avec SaveAs. Lorsque le HTML fait référence à des images ou des feuilles de style locales par chemin relatif, le moteur de rendu a besoin d'un chemin de base pour les résoudre, qui est transmis en tant que second argument de RenderHtmlAsPdf et est couvert en détail par le tutoriel HTML vers PDF. Une variante asynchrone existe pour les applications web où bloquer un thread de demande n'est pas acceptable.
Claude Code peut-il se connecter à IronPDF via MCP ?
Claude Code se connecte à des outils externes et des sources de données via le Model Context Protocol, une norme ouverte pour les intégrations d'outils AI. Les serveurs MCP donnent à l'agent l'accès à des outils, bases de données et API au-delà de ses données d'entraînement, et Claude Code en ajoute un avec une seule commande depuis le CLI, documenté dans la référence MCP.
L'intégration d'IronPDF aujourd'hui est l'accès à la documentation, et elle ne nécessite aucun processus serveur : orientez Claude Code vers llms.txt pour la surface de l'API indexée, vers le fichier de compétence skill.md pour les conventions et les modèles courants, et vers la référence API pour confirmer un nom de méthode avant qu'il ne soit expédié. Entre les trois, un agent lit la documentation actuelle au lieu de reconstruire l'API d'IronPDF de mémoire, ce qui couvre le même problème de méthode obsolète que MCP est autrement utilisé pour résoudre. Rien de tout cela ne nécessite un processus serveur, un fichier de configuration, ou un redémarrage entre mises à jour ; ce sont trois URL qu'un agent peut récupérer à l'intérieur de la session qu'il exécute déjà.
Alimentez ces trois sources dans une session comme vous le feriez pour tout contexte de projet, collé directement ou référencé à partir de CLAUDE.md, et chaque invite de cette session les hérite.
Que devriez-vous vérifier avant de faire confiance au code PDF généré ?
Chaque nom d'API, à chaque fois. Cette habitude sépare un flux de travail agent productif d'un frustrant.
Parcourez quatre contrôles dans l'ordre :
- Il compile : exécutez
dotnet build. Un nom de méthode halluciné échoue à la compilation, l'endroit le moins cher où l'attraper. - L'API est réelle : cherchez chaque nom de classe et de méthode dans la référence API. Un nom qui compile mais est déprécié apparaît toujours dans les notes de version.
- Le PDF est correctement rendu : ouvrez le résultat. Les problèmes de rendu, comme une police manquante, une image non résolue ou un tableau coupé sur plusieurs pages, ne sont pas visibles par des erreurs.
- Le chemin d'erreur est pris en charge : le code généré omet souvent les vérifications de nullité, la gestion des fichiers introuvables et le nettoyage. Demandez ceux-ci explicitement dans une incitation de suivi.
Le deuxième contrôle mérite d'être souligné pour quiconque est nouveau dans ce domaine. Un agent qui invente renderer.ConvertHtmlToPdfDocument() produit quelque chose en forme plausible à partir d'un modèle, pas un dysfonctionnement. Le fait que cela soit vraisemblablement formé le rend dangereux, car cela semble correct. Le compilateur est insensible à cela, raison pour laquelle construire tôt et souvent est bénéfique. Considérez chaque nom de membre non familier comme une question, et les quatre contrôles ci-dessus deviennent une habitude de cinq minutes au lieu d'une session de débogage.
Quelles sont les limites pratiques à connaître à l'avance ?
Les travaux PDF assistés par agent ont une structure, et la connaître évite des sessions perdues.
| Tâches | Convient | Pourquoi |
|---|---|---|
| Auteur de modèles HTML et CSS | Fort | Bien représenté, facile à vérifier visuellement |
| Configuration de rendu type | Fort | Surface API petite et stable |
| Variantes de modèles répétitifs | Fort | Réplication de modèles sur de nombreux fichiers |
| Options de configuration avancées | Mixte | Les noms d'options changent entre les versions |
| Configuration de licence et de déploiement | Faible | Spécifique au compte, donc la clé et la cible de déploiement viennent de vous plutôt que de l'agent |
Le modèle est cohérent : plus une tâche ressemble à l'écriture de balisage, mieux un agent fonctionne. Plus cela dépend de la surface exacte d'une version spécifique de bibliothèque, plus cela nécessite de vérification. Planifiez les incitations en fonction de cette courbe : remettez directement à Claude Code la création de modèles et de code type, et considérez toute partie touchant à la licence, au déploiement ou à une option de rendu moins commune comme une demande nécessitant un lien de documentation avant d'être publiée.
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
Les quatre clôtures sur cette page ont été exécutées dans l'ordre, sans surveillance, avec Claude Code 2.1.277 sur son modèle par défaut, Opus 5. Les chiffres ci-dessous proviennent de contrôles indépendants des fichiers laissés par l'exécution.
- L'invite de démarrage rapide ne nomme aucune version, donc elle a ajouté IronPdf 2026.10.3, la dernière version au moment, et a enregistré un output.pdf d'une page de 17 385 octets.
- L'agent a lu une clé de licence à partir d'une variable d'environnement sans qu'on le lui demande, donc la sauvegarde a réussi.
- Le même programme, exécuté sans clé, a lancé une LicensingException avec le message "Licence de production requise" lors de l'enregistrement avec SaveAs et n'a écrit aucun fichier.
- L'agent a déclaré dans les deux sessions que la sortie sans clé comporte un filigrane, ce que l'exécution a réfuté.
- L'invite CLAUDE.md a produit une section PDF contenant toutes les cinq règles.
- Avant d'écrire le code de la facture, l'agent a récupéré llms.txt et skill.md, comme l'avait instruit CLAUDE.md.
- Le modèle de facturation utilisait uniquement des styles en ligne et ne contenait aucune balise de script.
- InvoiceRenderer a été compilé avec IronPdf 2026.8.1, la version définie par le bloc de configuration au moment de cette exécution, sans erreurs lors de la première compilation.
- L'agent ne s'est pas arrêté pour poser une question. Il a laissé la taille du papier non définie, disant que la documentation ne nommait pas son type, bien que skill.md nomme PdfPaperSize.
- Avec une clé appliquée, le moteur de rendu a produit une facture d'une page avec chaque espace réservé rempli et des totaux corrects.
- Certaines étapes ont été exécutées différemment de la page. Le bloc de configuration se termine par une nouvelle commande claude, donc les invites CLAUDE.md et facture ont fonctionné lors d'une seconde session. L'invite de facturation ne demande pas d'exécution, donc la vérification a rendu la facture avec des valeurs d'exemple et a appliqué la clé elle-même.
Le modèle de facturation et InvoiceRenderer de l'exécution, rendus avec des éléments de ligne d'exemple.
La version de Claude Code, le modèle et le timing pour cette exécution sont répertoriés dans l'enregistrement de l'exécution.
Où cela vous laisse-t-il ?
Claude Code écrit le modèle, configure le moteur de rendu et exécute la construction jusqu'à ce que le document soit correct. Vous décidez ce qui rend le PDF, et vous vérifiez les noms d'API avant que quoi que ce soit ne soit publié. Cette division est valable quel que soit le modèle qui répond à l'incitation.
La version reproductible de ce flux de travail, une tâche exécutée du début à la fin avec un résultat publié et la date à laquelle elle a été vérifiée pour la dernière fois, est disponible dans le guide des assistants de codage AI, aux côtés des guides pour ChatGPT Codex, GitHub Copilot et Cursor.
Dépannage
- Appliquer une clé de licence dans IronPDF : si la sauvegarde du PDF déclenche une exception de licence
- Initialiser correctement RenderingOptions : si les noms d'options suggérés ne se résolvent pas
- Quelle version d'IronPDF devrais-je utiliser ? : pour épingler une version dans vos invites et votre fichier de projet
Des questions ?
Si vous avez des questions, contactez support@ironsoftware.com
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.