Jak używać IronPDF z Claude Code

Curtis Chau
Curtis Chau
Zaktualizowano: 20 października 2026

Łączenie agenta kodującego AI z biblioteką PDF wydaje się proste, dopóki pierwszy generowany fragment nie odwołuje się do metody, która nie istnieje. Claude Code to narzędzie agentowe Anthropic do kodowania, czytające kod, edytujące pliki i uruchamiające polecenia bezpośrednio z sesji terminalowej, rozszerzenia VS Code lub JetBrains, aplikacji desktopowej czy przeglądarki, co czyni go odpowiednim dla powtarzalnych części pracy z PDF: podłączenie rendereru, kształtowanie szablonu HTML, dodawanie nagłówków i stopek w kilkunastu typach raportów.

IronPDF renderuje HTML, CSS i JavaScript do formatu PDF poprzez wbudowany silnik Chromium, więc kod, który agent musi wygenerować, jest niewielki, a HTML, który musi wygenerować, to ta część, która przenosi układ. To rozdzielenie ma znaczenie. Pozwól, by Claude Code przejęło szablon i struktury, a samo wywołanie renderowania było na tyle krótkie, by móc je szybko ocenić. IronPDF posiada większą ilość danych szkoleniowych niż większość bibliotek PDF .NET: ponad 20M pobrań NuGet i lata publicznej dokumentacji oznaczają, że Claude Code już zna jego kluczowe wywołania renderujące, co skraca dystans od polecenia do działającego kodu, chociaż nadal obowiązuje poniższy krok weryfikacyjny. Ten przewodnik przeprowadza przez setup projektu, wzorce wywołań, które się sprawdzają, oraz krok weryfikacji, który wyłapuje wymyślone API, zanim trafią do kompilacji.

W 2026 roku asortyment Claude'a znów się zmienił. Claude Code oferuje teraz Fable 5.1, co według jego dokumentacji nadaje się do zadań większych niż jedno posiedzenie, obok Opus 5.5, Sonnet 5.5 i Haiku 5.5. Wyboru dokonuje się w zależności od zadania, a nie rankingu. Ten przewodnik działa z każdym z nich. Wszystko poniżej jest napisane tak, aby obsłużyć dowolny model graniczny, który odpowiada na polecenie, a /model przełącza je w trakcie sesji.

Oczekuj, że dokument sam przesunie się z tym wyborem. Ten sam prompt znajduje się w dwóch modelach i zwraca dwie faktury, z różnym rozstawem, innym akcentem, innym sposobem łamania tabeli na stronach. To, co pozostaje stałe, to cokolwiek, co określiłeś, więc ustal liczbę stron, tekst nagłówka i format stopki, a reszta niech się różni.

Szybki start
NuGetInstalacja z NuGet

PM > Install-Package IronPdf

Zainstaluj IronPDF, wykonując powyższe polecenie w konsoli Menedżera Pakietów NuGet lub wyszukaj pakiet w Menedżerze Pakietów NuGet.

Otworzyć sesję w projekcie .NET i poprosić o dokument zamiast o kod:

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.
Text

Claude Code obsługuje to od A do Z. Dodaje pakiet NuGet, pisze kilka linijek konstruujących ChromePdfRenderer, wywołuje RenderHtmlAsPdf na oznakowaniu i SaveAs wynik na dysk, uruchamia dotnet build, naprawia, co nie udaje się skompilować i mówi, gdzie wylądował plik. To, co recenzuje się, to różnica.

Decyduje również o wszystkim, co pozostawiasz otwarte, a na hello world to w porządku: weźmie najnowszą wersję pakietu, podąży za istniejącym docelowym frameworkiem projektu i nazwie klasę, jakikolwiek wyda się uzasadniony. Na realną pracę, trzy dodatki pozostawiają te decyzje własne:

  1. Ustal wersję: nazwij wydanie IronPDF, na które celujesz, aby agent działał na jednej powierzchni API zamiast średnio kilku.
  2. Ogranicz zależności: stwierdź, że IronPDF jest jedynym pakietem, który można dodać, aby druga biblioteka PDF nigdy nie pojawiła się w różnicy.
  3. Pozwól mu zatrzymać się: poprosić go, aby używał tylko udokumentowanych API i powiedział, gdy jest niepewny, co zmienia ciche wymyślenie w pytanie, na które można odpowiedzieć.


Co właściwie robi Claude Code w projekcie .NET PDF?

Claude Code spędza większość swojego czasu pracy na zwykłym rozwijaniu: czyta kod, pisze i refaktoryzuje klasy, kompiluje i napędza pętlę testową z terminala, rozszerzenia IDE, aplikacji desktopowej lub webowej. Generowanie dokumentów znajduje się w tej samej pętli i nie wymaga niczego specjalnego.

Do pracy z PDF-ami przyjmuje mechaniczną połowę. Pisze szablon HTML i klasę renderera, edytuje CSS, gdy tabela dzieli się na stronach, usuwa niewłaściwe pliki i odtwarza je, przekształca na raz tuzin szablonów raportów, uruchamia dotnet build, czyta błąd kompilatora i zaczyna od nowa. Opisujesz dokument i przeglądasz różnicę, co jest znacznie krótszą rozmową niż wklejanie fragmentów tam i z powrotem.

Pozostaje jedna decyzja i to pozostaje własne: co renderuje PDF. Mając wolną rękę, agent tworzy pipeline dokumentacyjny z czegokolwiek, co widział najczęściej w szkoleniu i tu właśnie leży ryzyko.

  • Wrażliwe dokumenty potrzebują bezpiecznej biblioteki: PDF generowane przez przedsiębiorstwo to jego umowy, faktury, i dokumenty prawne. Kilka szeroko kopiowanych narzędzi PDF open-source jest dziś porzuconych, z publicznie znanymi lukami w zabezpieczeniach, których nikt nie łata, a pipeline zbudowany na nich może wyciec bardzo dokumenty, które przetwarza.
  • Objętość jest rozliczana według tokena: renderowanie jednej faktury jest łatwe, a renderowanie pięćdziesięciu tysięcy przez noc to trudna część. Agent rozwiązujący ten problem w kodzie jest rozliczany za każde słowo, które przeczyta i napisze, w stawkach Opus 5.5 od 4 do 20 dolarów za milion tokenów, a rachunek wraca za każdym razem, gdy problem się pojawia. IronPDF dostarcza tę pracę wewnątrz biblioteki, gdzie jest to rozwiązane raz.
  • Improwizowane pipeline'y nie niosą dowodów: nikt nie przebiegł jednego przez tysiąc dokumentów, nie zmierzył ani nie opublikował wyników, które można sprawdzić. IronPDF ma za nim udokumentowaną powierzchnię API, a test szeregowy publikuje datowane wyniki, które można uruchomić samodzielnie.
  • Prawdziwy pakiet bije zgadywany: agenci czasami instalują nazwy pakietów, które jedynie brzmią poprawnie, sztuczka wystarczająco powszechna, by zasłużyć na nazwę „slopsquatting”, a każdy może zarejestrować te nazwy i wypełnić je złośliwym oprogramowaniem. Nazwanie jednego znanego pakietu w prompcie zamyka te drzwi.
Porady: Jedna linia rozwiązuje sesję: 'używaj IronPDF do całej pracy z PDF w tym projekcie i nie dodawaj innych pakietów PDF.'

Skierować Claude Code na IronPDF, a praca agenta ogranicza się do tego, w czym naprawdę jest dobry: pisania HTML, podłączania rendereru i uruchamiania builda aż do uzyskania poprawnego dokumentu.

Jak skonfigurować Claude Code?

Zainstalować go raz, potwierdzić dane w koncie Claude i jest się gotowym. Przegląd Claude Code firmy Anthropic opisuje, czym jest to narzędzie i jak zainstalować rozszerzenia VS Code i JetBrains, jeśli woli się nie pracować w terminalu, a szybki start przeprowadza instalację i pierwszą sesję na macOS, Windows i Linux. Anthropic publikuje wideo z przeglądami na swoim kanale YouTube, jeśli woli się obejrzeć pierwszą sesję przed jej uruchomieniem.

Kiedy claude otworzy sesję i odpowie, wrócić tutaj. Reszta tego przewodnika zakłada tyle i nic więcej.

Jak skonfigurować projekt, w którym Claude Code może pracować?

Zaczyna się od zwykłego projektu .NET i dodaje IronPDF, zanim agent go otworzy. Dostarczając agentowi projekt, który już się kompiluje, usuwa się całą kategorię zamieszania: nigdy nie musi zgadywać, której biblioteki PDF zamierzało się użyć.

dotnet new console -n PdfReportDemo
cd PdfReportDemo
dotnet add package IronPdf --version 2026.10.3
claude
SHELL

Ostatnia komenda uruchamia sesję Claude Code w bieżącym katalogu, który zakresowi czytanie i edytowanie przez agenta ogranicza do tego folderu. Udokumentowany wzorzec to zmiana na katalog projektu i uruchomienie z tamtąd interfejsu wiersza poleceń. Terminal, rozszerzenia VS Code i JetBrains, aplikacja desktopowa i web działają na tym samym silniku, więc plik CLAUDE.md, ustawienia projektu i wszystkie serwery MCP skonfigurowane dla tego projektu przechodzą dalej bez względu na to, która powierzchnia przejmie sesję następnie.

Dwie szczegóły setup-u oszczędzają czas później:

  1. CLAUDE.md: plik instrukcji na poziomie projektu, który Claude Code czyta na początku każdej sesji. Zarejestruj docelowy framework, że IronPDF to biblioteka PDF, oraz że wygenerowany kod musi używać tylko udokumentowanych API.
  2. Indeks dokumentacji IronPDF: llms.txt wymienia prawidłowe URL-e dokumentacji w formie, którą agent może przeczytać.

Razem zastępują 'napisz kod IronPDF z pamięci' na 'czytaj dokumentację, potem napisz kod.' Jeden prompt napisze plik dla ciebie:

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.
Text

Jeszcze jedna rzecz należy do projektu przed pierwszym renderem. Bez klucza licencyjnego IronPDF renderuje dokument w pamięci, ale wyrzuca wyjątek licencyjny, gdy kod zapisuje PDF lub odczytuje jego bajty, więc klucz jest wprowadzany na starcie aplikacji, przed jakimkolwiek innym wywołaniem IronPdf. Klucze licencyjne IronPDF obejmują, gdzie zdobyć jeden i każdy sposób, w jaki można go zastosować.

Jak poprosić o kod IronPDF, który się kompiluje?

Osiągnij najbardziej niezawodne wyniki, rozdzielając dwie połowy pracy. Układ umiejscowiony jest w HTML i CSS, gdzie agent jest na znanym terenie. Renderowanie żyje w garści wywołań C#, gdzie precyzja ma znaczenie, a powierzchnia jest mała.

Prompt, który działa, bardziej przypomina specyfikację niż żądanie funkcji:

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.
Text

Trzy rzeczy sprawiają, że ten prompt się sprawdza:

  1. Określa ścieżki plików: agent tworzy strukturę, w którą można się poruszać, zamiast wynajdować swoją własną.
  2. Ogranicza HTML: niezamówiony JavaScript przynosi pytania dotyczące czasu renderowania, które nie są fajne do debugowania pierwszego dnia.
  3. Daje wyjście awaryjne: 'jeśli nie ma pewności, należy zatrzymać się i zapytać' sprawia, że przyznanie się do niepewności staje się akceptowalną odpowiedzią, i agenci z niej korzystają.
Porady: Gdy polecenie działa, poproś Claude Code, aby zapisał jego ograniczenia do CLAUDE.md. Każda późniejsza sesja w tym projekcie rozpoczyna się już z nimi załadowanymi.

Oczekiwać krótkiej sekwencji zwrotnej: przeczytać szablon z File.ReadAllText, podstawić wartości zastępcze, przekazać wynik do ChromePdfRenderer i jego metody RenderHtmlAsPdf, a następnie zapisać dokument na dysk z SaveAs. Gdy HTML odnosi się do lokalnych obrazów lub arkuszy stylów względną ścieżką, renderer potrzebuje ścieżki bazowej do ich rozwiązania, która jest przekazywana jako drugi argument RenderHtmlAsPdf i jest w pełni omówiona w samouczku HTML do PDF. Istnieje asynchroniczny wariant dla aplikacji internetowych, gdzie blokowanie wątku żądania nie jest akceptowalne.

Uwaga: Poproś o link do dokumentacji obok kodu. Agent, który nie może wyprodukować rzeczywistej strony dla używanego właśnie API, mówi ci coś, zanim zrobi to build.

Czy Claude Code może łączyć się z IronPDF przez MCP?

Claude Code łączy się z zewnętrznymi narzędziami i źródłami danych za pomocą Model Context Protocol, otwartego standardu dla integracji AI-tool. Serwery MCP dają agentowi dostęp do narzędzi, baz danych i API wykraczających poza dane szkoleniowe, a Claude Code dodaje jeden za pomocą jednego polecenia z CLI, udokumentowanego w referencje MCP.

Integracja IronPDF dzisiaj polega na dostępie do dokumentacji, i nie wymaga procesu serwerowego: skieruj Claude Code na llms.txt dla zaprogramowanej powierzchni API, na plik umiejętności skill.md dla konwencji i wzorców, oraz na dokumentację API w celu potwierdzenia nazwy metody przed jej wysłaniem. Pomiędzy tymi trzema, agent czyta aktualną dokumentację zamiast rekonstruować API IronPDF z pamięci, co pokrywa ten sam problem z przestarzałymi metodami, dla którego MCP jest inaczej używane. Żadne z tego nie wymaga procesu serwera, pliku konfiguracyjnego, ani restartu między aktualizacjami; to trzy URL'e, które agent może pobrać w ramach już działającej sesji.

Dostarcz te trzy źródła do sesji tak, jakby to były dowolne konteksty projektowe, wklejone bezpośrednio lub odwołane z CLAUDE.md i każde polecenie w tej sesji je dziedziczy.

Co należy zweryfikować przed zaufaniem generowanemu kodowi PDF?

Każdą nazwę API, za każdym razem. Ten jeden nawyk oddziela produktywną pracę z agentem od frustrującej.

Pracuj przez cztery kluczowe kroki w kolejności:

  • Kompiluje się: uruchomić dotnet build. Nazwa metody, którą pomyślono, zawodzi na etapie kompilacji, najtańszym możliwym miejscu, by ją złapać.
  • API jest rzeczywiste: przeszukać każdą nazwę klasy i metody w dokumentacji API. Nazwa, która się kompiluje, ale jest przestarzała, nadal pojawia się w notatkach wydania.
  • PDF renderuje się poprawnie: otworzyć wynik. Problemy z renderowaniem, jak brakująca czcionka, nieprzypisany obraz czy łamiąca się tabela na stronach, nie pojawiają się jako błędy.
  • Scenariusz negatywny jest obsłużony: wygenerowany kod często pomija sprawdzanie null, obsługę braku plików i zwalnianie zasobów. Należy poprosić o nie wyraźnie w kolejnym prompt.

Drugie sprawdzenie zasługuje na podkreślenie dla osób nowych w tym. Agent, który wymyśla renderer.ConvertHtmlToPdfDocument(), produkuje coś, co ma formę zgodną z wzorcem, nie działa wadliwie. Prawdopodobne kształt jest tym, co czyni to niebezpiecznym, ponieważ wygląda to poprawnie. Kompilator nie ma sentymentów do tego, co jest powodem, dla którego budowanie wcześnie i często się opłaca. Traktuj każdą nieznaną nazwę członka jako pytanie, a cztery powyższe sprawdzenia staną się pięciominutowym nawykiem zamiast sesji debugowania.

Jakie są praktyczne limity warte poznania z góry?

Praca nad PDF z pomocą agenta ma kształt, a jego znajomość zapobiega marnotrawstwu sesji.

ZadaniePasujeDłączego
Tworzenie szablonów HTML i CSSSilneDobry postać, łatwa do wizualnej weryfikacji
Konfiguracja renderowania szablonowegoSilneMała, stabilna powierzchnia API
Warianty szablonów powtarzalnychSilneReplikacja wzorca przez wiele plików
Zaawansowane opcje konfiguracyjneMieszaneNazwy opcji dryfują między wersjami
Konfiguracja licencjonowania i wdrażaniaSłabySpecyficzne dla konta, więc klucz i cel wdrożenia pochodzą od użytkownika zamiast agenta

Wzorzec jest spójny: im więcej zadanie przypomina pisanie znaczników, tym lepiej agent sobie radzi. Im bardziej zależy od dokładnej powierzchni konkretnej wersji biblioteki, tym bardziej wymaga weryfikacji. Planowanie promptów wokół tej krzywej: przekazać Claude Code szablony i szablony boilerplate wprost, a traktować wszystko, co dotyczy licencjonowania, wdrażania lub rzadziej spotykanej opcji renderowania jako żądanie, które wymaga dołączonego linku do dokumentacji, zanim zostanie przekazane.

Co wyprodukowały zapytania w rzeczywistym uruchomieniu?

Cztery ogrodzenia na tej stronie działały w kolejności, bez nadzoru, przy użyciu Claude Code 2.1.277 na domyślnym modelu, Opus 5. Poniższe dane pochodzą z niezależnych kontroli plików pozostawionych po wykonaniu.

  • Polecenie do szybkiego startu nie podaje wersji, więc dodano IronPdf 2026.10.3, najnowsze wydanie w tamtym czasie, i zapisano jednokartkowy output.pdf o rozmiarze 17 385 bajtów.
  • Agent odczytał klucz licencyjny ze zmiennej środowiskowej bez pytania, więc zapis się udał.
  • Ten sam program, uruchomiony bez klucza, wyrzucił LicensingException z wiadomością „Wymagana licencja produkcyjna” przy SaveAs i nie zapisał pliku.
  • Agent stwierdził w obu sesjach, że wyjście bez klucza ma znak wodny, co wykonanie obaliło.
  • Polecenie CLAUDE.md wygenerowało sekcję PDF zawierającą wszystkie pięć zasad.
  • Przed napisaniem kodu faktury agent pobrał llms.txt i skill.md, zgodnie z instrukcjami CLAUDE.md.
  • Szablon faktury używał tylko stylów inline i nie zawierał tagów skryptów.
  • InvoiceRenderer skompilowany przeciwko IronPdf 2026.8.1, wersji przypiętej w bloku ustawień w momencie tego wykonania, bez błędów przy pierwszym kompilowaniu.
  • Agent nie zatrzymał się, by zapytać o coś. Pozostawił nieustawiony rozmiar papieru, mówiąc, że dokumentacja nie podaje jego typu, chociaż skill.md podaje PdfPaperSize.
  • Z uwzględnionym kluczem, renderer wygenerował jednostronicową fakturę z wszystkimi wypełnionymi zastępczymi i poprawnymi sumami.
  • Niektóre kroki uruchomiono inaczej niż na stronie. Blok konfiguracji kończy się nowym poleceniem claude, więc polecenia CLAUDE.md i faktury zostały uruchomione w drugiej sesji. Polecenie faktury nie wymaga uruchomienia, więc kontrola wyrenderowała fakturę z przykładowymi wartościami i zastosowała klucz.

Szablon faktury i InvoiceRenderer z wykonania, renderowane z przykładowymi pozycjami.

Wersja Claude Code, model i czas dla tego uruchomienia są wskazane w rekordzie wykonania.

Gdzie cię to pozostawia?

Claude Code pisze szablon, łączy renderer i uruchamia build, aż dokument będzie prawidłowy. Decydować, co renderuje PDF, i sprawdzać nazwy API przed wdrożeniem. Ten podział obowiązuje niezależnie od modelu odpowiedzi na prompt.

Reproduktywną wersję tego przepływu pracy, jedno zadanie uruchamiane od początku do końca z opublikowanym wynikiem i datą ostatniego sprawdzenia, znajdziesz w przewodniku dla asystentów kodowania AI, obok przewodników dla ChatGPT Codex, GitHub Copilot i Cursor.


Rozwiązywanie problemów

Pytania?

Jeśli są jakiekolwiek pytania, należy skontaktować się z support@ironsoftware.com

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 22,198,312Wersja:2026.11właśnie wydane