如何在Claude Code中使用IronPDF

Curtis Chau
Curtis Chau
已更新: 2026年10月20日

將AI編碼代理與PDF程式庫配對似乎很簡單,但直到第一個生成的代碼片段引用了不存在的方法時情況就變得複雜。Claude Code是Anthropic的智能編碼工具,可從終端會話、VS Code或JetBrains擴展、桌面應用程式或網路中直接讀取代碼庫、編輯文件並執行命令,這使得它非常適合用於PDF工作的重複部分:連接渲染器,設計HTML模板,為十多種報告類型添加頁眉和頁腳。

IronPDF通過嵌入的Chromium引擎將HTML、CSS和JavaScript渲染為PDF,因此代理需要生成的代碼很少,生成的HTML承載的是佈局部分。 這種劃分很重要。 讓Claude Code擁有模板和結構,並保持渲染調用本身簡短到一目了然。 IronPDF比大多數.NET PDF程式庫具有更多的訓練數據權重:超過20M次的NuGet下載和多年的公共文件意味著Claude Code已經瞭解其核心渲染呼叫,這縮短了從提示到工作代碼的距離,儘管仍需進行下述驗證步驟。 本指南介紹了項目設置、保持穩定的提示模式以及在其進入構建之前捕捉到虛構API的驗證步驟。

Claude的前沿組合在2026年再次變動。Claude Code現在提供Fable 5.1,其文件描述適用於多次操作的大型任務,還有Opus 5.5、Sonnet 5.5 和 Haiku 5.5,選擇使用哪一個取決於您面前的任務,而不是排名。 本指南可以與它們的任何一個一起使用。 下面的所有內容都是為了承載任何前沿模型而編寫,以回答提示,並且/model在會話中途切換它們。

可以預料的是,文件本身會隨著選擇的改變而變動。將同一個提示交給兩個模型會返回兩個發票,但間距不同、語調不同、跨頁表格的斷開方式也不同。 持續不變的是您指定的內容,因此將頁數、頁眉文本和頁腳格式釘住,讓其他的變動。

快速開始
NuGet使用NuGet安裝

PM > Install-Package IronPdf

在 NuGet 包管理器控制台中運行上述命令安裝 IronPDF,或在 NuGet 包管理器中搜索該包。

在.NET項目中打開一個會話,要求獲取的文件,而不是代碼:

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從頭到尾處理這一切。 它添加NuGet程式包,寫下幾行代碼來構建 ChromePdfRenderer,在您的標記上調用RenderHtmlAsPdf,並將結果SaveAs保存到磁碟上,運行dotnet build,修正任何無法編譯的內容,並告訴您文件的位置。 您審閱的內容是一個差異文件。

它還決定您遺留的任何空白,在一個「Hello World」程序中這是可以的:它會採用最新的包版本,遵循項目現有的目標框架,並給類命名一個合理的名稱。 在實際工作中,有三個附加措施讓這些決定依然由您來掌控:

  1. 釘住版本:指定您目標的IronPDF發布版,以便代理針對一個API表面工作,而不是在多個API之間取平均值。
  2. 限制依賴項:指明IronPDF是唯一可添加的包,以免在差異中出現第二個PDF程式庫。
  3. 允許它停止:要求它僅使用文檔記載的API,並在不確定時說明,這將無聲的創建變成一個您可以解決的問題。


Claude Code到底在.NET PDF項目中做了什麼?

Claude Code將大部分工作時間花在普通開發上:閱讀代碼庫,編寫和重構類,運行構建並從終端、IDE擴展、桌面應用程式或網路驅動測試循環。 文件生成與這同一個循環內,不需要從中獲取任何特別之處。

對於PDF工作,它處理機械一半。 它寫入HTML模板和渲染器類,當表格在頁面中拆分時編輯CSS,清除錯誤的文件並重新生成,經過一次運行重塑十二個報表模板,運行dotnet build,讀取編譯器錯誤,然後再次運行。 您描述文件並審查差異文件,這比反覆粘貼代碼片段的對話大幅簡化。

這留下了一個決定,仍由您掌控:什麼來渲染PDF。 考慮到自主性,代理會依據其訓練中最常見的內容組建文件管道,這就是風險所在。

  • 敏感文件需要安全的程式庫: 商務生成的PDF是其合同、發票和法律文件。 當今有幾個廣為人知的開源 PDF 工具被廢棄,公認的安全漏洞無人修補,基於它們構建的管道可能會洩漏其處理的文件。
  • 按字數計費:渲染一份發票很容易,隔夜渲染五萬份則是難點。 在程式碼中解決該問題的代理會對其讀寫的每個單字收取費用,Opus 5.5的費率為每百萬個標記4美元至20美元,並且每次問題出現時帳單都會返回。 IronPDF將此工作包含在程式庫內部,在其中解決一次。
  • 臨時管道沒有證明:沒有人運行一千多個文檔的測試,衡量其性能,或發布可檢查的結果。 IronPDF有記錄的API表面,系列測試發布了一個可自行重新運行的日期化結果。
  • 真正的程式包勝於猜測的:代理有時會安裝僅僅聽起來正確的程式包名稱,這是一個常見的技巧,獲得了一個名字,"slopsquatting",任何人都可以註冊這些名稱並用惡意軟體填充它們。 在提示中指定一個已知包即可關上這扇門。
提示: 一行代碼就能為整個會話定下基調:"在本項目中所有PDF工作中使用IronPDF,不添加其他PDF包。"

指向Claude Code使用IronPDF,代理的工作範圍縮小到其擅長的方面:編寫HTML、搭接渲染器,並運行構建直到文件正確。

您如何設置Claude Code?

安裝一次,通過Claude帳戶進行身份驗證,然後就準備好了。 Anthropic的Claude Code概述涵蓋了工具的介紹和如何安裝VS Code和JetBrains擴展,如果您不想在終端中工作,快速入門指導了在macOS、Windows和Linux上的安裝和第一個會話。 Anthropic發布了其YouTube頻道上的視頻教程,如果您希望在運行之前先觀看第一次會話。

一旦claude開啟一個會話並回答您,回到這裡。 指南的其餘部分假設到此為止。

如何設立一個Claude Code可以工作的項目?

首先從普通的.NET項目開始,然後在代理打開項目之前添加IronPDF。 給代理一個已經可以編譯的項目可清除整個類別的困惑:它不必猜測您打算使用哪個PDF庫。

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

最終命令在當前目錄中啟動Claude Code會話,限定代理讀取和編輯該文件夾的範圍。 文檔中記錄的模式是切換到項目目錄並從那裡運行CLI。 終端、VS Code和JetBrains擴展、桌面應用程式和網頁都運行相同的底層引擎,所以一個CLAUDE.md檔案、專案設置以及為此專案配置的任何MCP伺服器都會承傳到下一個拾取會話的介面。

兩個設置細節可以節省後續時間:

  1. CLAUDE.md: 在每次會話開始時,由Claude Code讀取的專案級說明檔案。 記錄目標框架,IronPDF是PDF庫,而且生成的代碼須僅使用文檔中的API。
  2. IronPDF的文件索引: llms.txt列出了代理可閱讀的有效文件URL形式。

共同的,它們將"從記憶中寫IronPDF代碼"替換為"讀取文檔,然後編寫代碼。"一個提示完成為您寫文件:

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

在第一次渲染前,還需要完成一件事。 沒有授權金鑰,IronPDF會在記憶體中渲染文件,但當代碼保存PDF或讀取其字節時會引發授權異常,因此金鑰在應用程式啟動時插入,在任何其他IronPdf呼叫之前。 IronPDF許可金鑰涵蓋了如何獲取以及任何應用方式。

如何提示IronPDF代碼編譯?

通過分開工作兩個部分來獲得最可靠的輸出。 佈局在HTML和CSS中,代理在這方面較為熟悉。 渲染由少量C#調用組成,精確度很重要,且表面積小。

有效的提示看起來不像是功能請求,而更像是規範:

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

有三件事使該提示有效:

  1. 它命名了文件路徑:讓代理構建一個您可以導航的結構,而不是自己發明。
  2. 限制HTML:未請求的JavaScript帶來渲染時間問題,初期調試困難。
  3. 提供出路:"如果不確定,請停下並詢問"使得承認不確定性成為可以接受的答案,代理樂於接受。
提示: 一旦提示成功,請要求Claude Code將其限制寫入CLAUDE.md。 此專案的後續每次會話均以這些設置為載入的起點。

預期會有一個短序列返回:用File.ReadAllText讀取模板,替換佔位符值,將結果傳遞給ChromePdfRenderer及其RenderHtmlAsPdf方法,然後用SaveAs將文件寫入磁碟。 當HTML引用本地圖像或樣式表通過相對路徑時,渲染器需要一個基路徑來解析它們,這作為RenderHtmlAsPdf的第二個參數,是HTML轉PDF教程的完整涵蓋。 對於不允許阻塞請求線程的網路應用程序,則存在一個異步變體。

請注意: 要求代碼旁給出文件文檔鏈接。 如果一個代理無法為它剛使用的API產生真實頁面,則在構建之前會告訴您一些內容。

Claude Code可通過MCP連接到IronPDF嗎?

Claude Code通過模型上下文協議(MCP)與外部工具和數據源連接,這是一個AI工具集成的開放標準。 MCP伺服器使代理可在其訓練數據之外獲得工具、數據庫和API訪問,Claude Code用CLI的一個命令添加,文檔記載於MCP參考中。

IronPDF的整合今天是文件訪問,且不需要伺服器進程:指向Claude Code llms.txt以查找索引的API表面,指向下拉的skill.md技能檔案以獲取慣例和常見模式,以及API參考確認方法名稱在發佈前。 三者之間,代理閱讀當前文檔,而不是憑記憶重構IronPDF的API,這涵蓋了通常需要解決的陳舊方法問題。 這一切不需要伺服器進程、配置文件或更新間的重啟; 這是代理在其已運行的會話中可提取的三個URL。

以您對待任何專案上下文的方式將這三個來源提供到會話中,直接粘貼或從CLAUDE.md引用,該會話中的每個提示都會繼承它們。

在信任生成的PDF代碼之前你應該核實什麼?

每次API名稱。這一習慣將生產型代理工作流與令人沮喪的工作分開。

按順序做完四項檢查:

  • 它編譯成功:運行dotnet build。 不能編譯的虛構方法名會在編譯時失敗,這是捕捉它的最優惠地點。
  • 該API是真實的:檢索每個類和方法名稱在API參考中。 一個能編譯但已被棄用的名字仍然出現在更新說明中。
  • PDF渲染正確:打開輸出。 渲染問題,如缺失的字體、未解析的圖像,或跨頁表格的斷開不顯示為錯誤。
  • 不良路徑已被處理:生成的代碼通常省略了空檢查、文件找不到的處理和資源釋放。 在後續提示中明確要求這些。

第二項檢查對於新手來說值得強調。 創造renderer.ConvertHtmlToPdfDocument()的代理正在從模式中產生看似合理的東西,而不是故障。 可能形狀的就是它危險之處,因為它看起來是正確的。 編譯器對此沒有感情,這就是為何及早且頻繁的構建的好處。 把每個不熟悉的成員名稱當作一個問題,上述四項檢查成為五分鐘的習慣,而不是一個調試會話。

有哪些值得提前了解的實際限制?

代理輔助的PDF工作有一個形狀,知道它能防止浪費的會話。

任務適合為何
HTML和CSS模板創作強表現良好,視覺上易於驗證
標準渲染設置強小而穩定的API表面
重複的模板變體強模式在多個文件中複製套用
高級配置選項混合選項名稱在版本間漂移
許可和部署設置弱帳戶特定,因此密榮和部署目標來自您,而非代理

模式是一貫的:任務越像寫標記,代理就越能發揮。 它越依賴於某個特定庫版本的確切表面,就越需要驗證。 計劃提示圍繞這條曲線:將模板和標準代碼直接交給Claude Code處理,任何涉及許可、部署或不常見的渲染選項操作都需視為一個要在走出之前附上文檔鏈接的請求。

在實際運行中,這些提示產生了什麼結果?

此頁面的四個圍欄按順序運行,無需管控,版本Claude Code 2.1.277在其默認模型Opus 5運行。以下數據來自獨立檢查跑留下的文件。

  • 快速入門提示未命名版本,於是它添加了IronPdf 2026.10.3,當時最新版本,並將17,385個字節的一頁output.pdf保存下來。
  • 代理從環境變量中讀取了授權金鑰而未被要求,於是保存成功。
  • 相同的程式,在沒有鍵的情況下運行,在SaveAs拋出LicensingException,信息為"需要生產授權",並未寫入文件。
  • 代理在兩個會話中都聲明無鍵輸出的帶有水印,但運行證實不是。
  • CLAUDE.md提示生成了一個PDF部分,包含所有五條規則。
  • 在編寫發票代碼之前,代理按照CLAUDE.md的指導獲取了llms.txt和skill.md。
  • 發票模板只使用了內嵌樣式,且不含腳本標籤。
  • InvoiceRenderer編譯對應IronPdf 2026.8.1,當時設置塊固定的版本,首次構建沒有錯誤。
  • 代理沒停下來詢問問題。 它將紙張大小設置為未設定,並表示文件中沒有命名其類型,雖然skill.md命名為PdfPaperSize。
  • 應用金鑰後,渲染器生成了一頁的發票,所有佔位符均填滿且總計正確。
  • 一些步驟與頁面上運行的不同。 設置塊以一個新的claude命令結束,所以在第二個會話中運行了CLAUDE.md和發票提示。 發票提示未要求運行,所以檢查用樣本值渲染了發票並自行應用了金鑰。

運行中的發票模板和InvoiceRenderer,使用示例行項渲染。

此運行的Claude Code版本、模型和時機列在運行記錄中。

在此您自己該怎麼做?

Claude Code編寫模板,接口渲染器,並運行構建直到文件正確。 您決定什麼渲染PDF,您檢查API名稱,在任何發布之前。 無論哪個模型回答提示,該分工仍舊成立。

此工作流程的可重現版本,一次性任務的執行完整結果和最後檢查日期,放在AI編程助手指南中,與ChatGPT Codex、GitHub Copilot和Cursor指南一起。


疑難排解

問題?

如果您有任何疑問,請聯繫support@ironsoftware.com

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

閱讀更多

準備好開始了嗎?

NuGet 下載次數 22,198,312版本:2026.11剛剛發布