Cómo usar IronPDF con ChatGPT Codex

Curtis Chau
Curtis Chau
Actualizado: 26 de octubre de 2026

La mayoría de los desarrolladores conocen un agente de codificación de IA de la misma manera: pegan una clase a medio terminar en una ventana de chat, obtienen algo plausible de vuelta y pasan los siguientes veinte minutos averiguando cuáles partes son reales. Ese ciclo se vuelve costoso rápidamente cuando la biblioteca involucrada tiene una superficie de API específica, y la generación de PDF es ese tipo de biblioteca.

ChatGPT Codex es el sistema de codificación agente de OpenAI. Lee un repositorio, edita archivos, ejecuta comandos y informa sobre lo que cambió, y lo hace desde un terminal, un editor, una aplicación de escritorio o la nube compartiendo una cuenta. IronPDF renderiza HTML, CSS y JavaScript en documentos PDF a través de un motor Chromium incrustado. Se conectan a través de un flujo de trabajo que escribes, lo que convierte al prompt en la parte que realmente creas. Todo lo siguiente es un prompt primero y C# en segundo lugar.

Inicio rápido
NuGetInstalar con NuGet

PM > Install-Package IronPdf

Instale IronPDF ejecutando el comando arriba en la Consola del Administrador de Paquetes NuGet, o busque el paquete en el Administrador de Paquetes NuGet.

Dirige Codex a un proyecto de consola vacío y describe la salida que deseas:

In this C# console project, create Program.cs that uses IronPDF to render
the HTML string "<h1>Hello from IronPDF</h1>" to a file called hello.pdf.
Use only documented IronPDF APIs. Then run dotnet build and fix any errors.
Text

Codex escribe las tres líneas que importan: construye un ChromePdfRenderer, llama a RenderHtmlAsPdf en tu marcado, y SaveAs el documento devuelto al disco. El aviso es más largo que el código que produce. Usted dedica su esfuerzo a especificar, y el agente dedica su esfuerzo a escribir y verificar.



¿Qué es ChatGPT Codex y cómo encaja en el trabajo de PDF en .NET?

Codex es un agente en lugar de una ventana de chat. Lee archivos, escribe archivos y ejecuta comandos de shell dentro de un ámbito que le otorgas, luego muestra su trabajo. OpenAI lo envía como un agente detrás de varias puertas frontales que comparten una cuenta. La documentación de Codex CLI y la documentación de la extensión Codex IDE cubren las diferencias entre ellas.

SuperficieDónde se ejecutaUtilícelo cuando
CLITerminalQuieres al agente en la misma ventana que dotnet build
Extensión de IDEVS Code, JetBrains, XcodeQuieres la diferencia y el PDF generado lado a lado
Aplicación de escritoriomacOS, Windows, LinuxEstás manejando una tarea más larga desde el terminal
NubeNavegadorEstás delegando una tarea y recogiendo la diferencia más tarde

Un AGENTS.md comprometido con el repositorio gobierna los cuatro.

Instala el CLI con npm i -g @openai/codex, o brew install --cask codex en macOS. Instaladores independientes que no necesitan un tiempo de ejecución de Node.js están disponibles para cada plataforma, y las notas de fuente y lanzamientos se encuentran en el repositorio Codex CLI.

Por favor, tenga en cuenta: Mantén el alcance de @openai/ en esa instalación. El paquete codex sin ámbito en npm es un proyecto no relacionado que se publicó por última vez en 2012. También es una buena ilustración de por qué importa nombrar los paquetes exactos cuando un agente está escribiendo.

Codex ofrece varios modelos, y /model se mueve entre ellos a media sesión. La guía de modelos de OpenAI recomienda GPT-6.1 Sol para trabajos complejos de codificación y agentes y GPT-6 Luna para tareas enfocadas y repetibles, y la ejecución en esta página usó GPT-6 Luna. La mayor parte de una sesión PDF es el tipo de trabajo económico, editando una plantilla, reconstruyendo, mirando la salida nuevamente, con el ocasional tramo donde una tabla se rompe a través de una página por razones que ningún compilador explicará jamás. Cambia para esa parte y vuelve a bajar después.

Para el desarrollo de PDF, ese comportamiento agente cambia lo que se puede pedir razonablemente en un prompt. Un asistente de chat responde una pregunta. Un agente añade la referencia de NuGet, escribe la plantilla, ejecuta la compilación, lee el error del compilador y se corrige. Describes el resultado, luego revisas una diferencia en lugar de depurar un pegado.

Lo que Codex no puede hacer es conocer la API actual de IronPDF con certeza. Su conocimiento proviene de datos de entrenamiento más lo que pongas frente a él. OpenAI entrena a Codex para ejecutar comandos y verificar su propia salida, y aún te dice que revises el trabajo del agente antes de que se envíe. Esa guía se aplica doblemente aquí: un compilador detecta un método inventado, pero nada detecta un PDF que se renderiza ligeramente mal excepto abrirlo. La guía principal cubre la documentación para darle a cualquier asistente antes de que comience, y la misma configuración se lleva a Claude Code y GitHub Copilot con solo el nombre del archivo de contexto cambiando.

Codex es la mitad no determinista de este flujo de trabajo. Pídele la misma factura dos veces y vuelven dos plantillas plausibles. Lo que renderiza esas plantillas tiene que comportarse al revés: HTML idéntico de entrada, las mismas páginas renderizadas de salida, en cada ejecución. Ese es el caso de delegar la renderización a una biblioteca mantenida en lugar de dejar que un agente la arme, y la diferencia aparece en las funciones que nadie prototipa hasta el día que se necesitan.

  • Salida determinista: IronPDF fija su motor, y el mismo input renderiza las mismas páginas en cada ejecución.
  • Encriptación y permisos: la protección por contraseña y los indicadores de permiso generalmente significan una segunda biblioteca unida junto a la primera. IronPDF establece ambos en el documento que acaba de renderizar.
  • Formatos de cumplimiento: la salida archivada y accesible son los requisitos que nadie prototipa y que todos eventualmente necesitan. SaveAsPdfA escribe un archivo PDF/A, y SaveAsPdfUA escribe el PDF/UA etiquetado que un lector de pantalla puede navegar.
  • Alguien parchándolo: varias de las opciones gratuitas más copiadas están archivadas, por lo que una vulnerabilidad encontrada hoy permanece abierta. Una biblioteca comercial tiene un mantenedor en el otro extremo.

El costo de la opción gratuita rara vez es la licencia. Es el código que escribes alrededor de esas brechas, y la auditoría que fallas el día que un documento tiene que ser etiquetado o encriptado.

¿Qué hace efectivo a un prompt de IronPDF?

Especificidad, en seis dimensiones previsibles. Un prompt vago produce un código genérico que se compila contra una biblioteca imaginaria; un prompt específico produce un código que puedes revisar en treinta segundos.

ComponentePrompt débilPrompt fuerte
Lenguaje y framework"Crear un PDF""En C# dirigido a .NET 9"
Estructura del proyectoNo declarada"Agregar a Services/InvoiceService.cs"
Versión de la bibliotecaNo declarada"IronPDF versión actualmente en el .csproj"
Archivos de origenNo declarada"Leer Templates/invoice.html primero"
Salida esperada"Un buen PDF""A4 vertical, márgenes de 20mm, pie de página con números de página"
RestriccionesNoneSin nuevos paquetes. Solo async. Preguntar si no se está seguro de una API."

La última restricción merece su propia nota. Decirle a un agente que "No sé" es una respuesta aceptable reduce las APIs inventadas, porque el modelo de lenguaje por defecto es producir algo con forma plausible en lugar de admitir una brecha. Dale permiso para detenerse.

Consejos: Mantén la columna fuerte como una lista de verificación. Seis respuestas, un prompt, y la mayoría de las APIs inventadas nunca son escritas.

Un segundo hábito que da sus frutos en todo un proyecto es un archivo AGENTS.md comprometido en la raíz del repositorio. Ese es el archivo que Codex lee para obtener instrucciones permanentes del proyecto, y lo lee automáticamente al comienzo de cada sesión, concatenando primero el archivo raíz y luego los archivos anidados para que la guía a nivel de directorio prevalezca. Ejecuta /init en una sesión para esbozar uno. Grabar "IronPDF es la biblioteca PDF; verificar APIs contra ironpdf.com; nunca añadir un paquete PDF competidor" una vez significa que dejas de repetirlo en cada prompt.

Apunta ese mismo archivo a la documentación legible por máquina de IronPDF. llms.txt indexa las páginas de documentación con una descripción de una línea, y skill.md es un conjunto de instrucciones rápidas que cubre convenciones de API y patrones comunes. Un prompt escribe ambos en el proyecto:

Create AGENTS.md at the repository 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

¿Cómo le pides a Codex que añada IronPDF y renderice un primer PDF?

Comienza haciendo que el agente haga la configuración, porque la configuración es donde se originan las desajustes de versión.

Add the IronPDF NuGet package to this project. Then show me the resulting
PackageReference line from the .csproj and tell me which IronPDF version
was installed. Do not change any other package references.
Text

Pedir nuevamente la versión es el pequeño movimiento que importa. Te da un hecho para incluir en cada prompt posterior, y saca a la luz el caso donde el agente instaló silenciosamente otra cosa. Espera como máximo una diferencia de una línea y un número de versión indicado. Para fijar deliberadamente en lugar de tomar la última, ¿Qué versión de IronPDF debo usar? cubre la elección.

Sin una clave de licencia, IronPDF renderiza el documento en memoria y luego lanza un LicensingException cuando se guarda o se lee como bytes, y la clave pertenece al inicio de la aplicación antes de cualquier otra llamada a IronPdf. Haz que Codex lo coloque en lugar de hacerlo manualmente:

Apply the IronPDF license key at application startup, before any
other IronPdf call, reading it from configuration rather than
hard-coding it. Then confirm IronPdf.License.IsLicensed returns
true and tell me where you put the call.
Text

Las claves de prueba y cualquier otra manera de aplicar una desde appsettings.json a Azure, se cubren en IronPDF License Keys.

Renderizar desde un archivo HTML en lugar de una cadena en línea es el siguiente paso realista, ya que las plantillas reales están en disco.

Create Templates/invoice.html with plain HTML and inline CSS: a header with
a company name, a line-item table (description, quantity, unit price, total),
and a right-aligned totals block. No JavaScript.

Then write Services/InvoiceRenderer.cs with a method RenderAsync that loads
that file, substitutes {{CompanyName}}, renders it with IronPDF, and returns
a byte array. Use the async IronPDF rendering method. Build and fix errors.
Text

Aproximadamente, ese prompt se traduce de la siguiente manera. Léelo para confirmar que el agente aterrizó en las APIs reales en lugar de escribirlo por ti mismo:

// IronPdf 2026.10.3, targeting .NET 9
using IronPdf;

public class InvoiceRenderer
{
    // One renderer, reused for every invoice. Constructing a new one
    // per request is the quiet performance mistake worth avoiding.
    private readonly ChromePdfRenderer _renderer = new ChromePdfRenderer();

    public async Task<byte[]> RenderAsync(string companyName)
    {
        // Read the HTML template off disk, exactly as written.
        var html = await File.ReadAllTextAsync("Templates/invoice.html");

        // Swap the placeholder for the real value before rendering.
        html = html.Replace("{{CompanyName}}", companyName);

        // Chromium renders the finished HTML. The async call leaves
        // the request thread free while that happens.
        var pdf = await _renderer.RenderHtmlAsPdfAsync(html);

        // BinaryData returns the raw bytes, ready for an HTTP
        // response or a storage upload.
        return pdf.BinaryData;
    }
}
C#

Cada miembro allí es real: ChromePdfRenderer, RenderHtmlAsPdfAsync, y BinaryData, todos aparecen en la referencia de API, que es la verificación que debe realizar en cualquier bloque que un agente le entregue. Cuando el HTML referencia imágenes locales o hojas de estilos, el renderizador necesita una ruta base para resolverlas, que se pasa como el segundo argumento de la llamada de renderizado (BaseUrlOrPath en RenderHtmlAsPdf, un Uri en RenderHtmlAsPdfAsync) en lugar de establecerlo en las opciones de renderizado, y se documenta en el tutorial HTML a PDF.

¿Cómo migras una implementación de PDF existente a IronPDF?

Aquí es donde un agente se gana su sueldo, porque la migración es mecánica, tediosa y fácil de alcanzar un 90% de exactitud. El prompt tiene que apuntar al código existente en lugar de describirlo.

Read Reports/LegacyReportBuilder.cs. It currently builds PDFs by positioning
text and drawing at coordinates with another library.

1. Summarize what the current output looks like: page size, sections, fonts.
2. Propose an HTML/CSS template that reproduces that layout.
3. Do not write any code yet. Wait for my approval on the plan.
Text

Separar el análisis de la implementación es el patrón más útil en esta guía. Un agente que escribe 400 líneas antes de que estés de acuerdo en el enfoque produce 400 líneas que tienes que leer cuidadosamente. Un agente que produce un plan de cinco puntos produce algo que puedes corregir en una sola frase.

Por favor, tenga en cuenta: Separar el análisis de la implementación cuesta un viaje de ida y vuelta extra y ahorra leer una diferencia con la que no estabas de acuerdo.

Después de aprobar el plan, el seguimiento es estrecho:

Implement the plan. Create Templates/report.html and rewrite
LegacyReportBuilder.cs to render it with IronPDF, keeping the existing
public method signature so callers don't change. Leave the old file in
Git history only; don't keep dead code. Build and report the diff.
Text

Mantener la firma pública estable es una restricción que vale la pena expresar explícitamente cada vez. Sin ella, los agentes tienden a rediseñar la convención de llamada como un bono, y la migración silenciosamente crece en una refactorización.

¿Cómo solucionas problemas de diseño, encabezados y CSS a través de prompts?

Los problemas de diseño son visuales, y un agente no puede ver el PDF. El prompt tiene que llevar la descripción de lo que está mal.

The rendered invoice.pdf has two problems: the line-item table splits a row
across pages 1 and 2, and the totals block sits at the top of page 2 instead
of directly under the table.

Fix this in Templates/invoice.html using CSS page-break properties. Do not
change InvoiceRenderer.cs. Explain which CSS rule fixes which problem.
Text

Nombrar tanto el síntoma como el archivo a cambiar mantiene la corrección en la plantilla donde pertenece. Debido a que IronPDF renderiza a través de Chromium, se aplica CSS de impresión estándar. page-break-inside, break-after, y la regla @page se comportan tal como lo hacen en la vista previa de impresión de un navegador, lo que también le da una forma rápida de verificar una corrección sin regenerar el PDF. La excepción es @media print. IronPDF renderiza con el tipo de medio de pantalla por defecto, por lo que las reglas dentro de un bloque @media print se aplican solo después de que RenderingOptions.CssMediaType se establece en PdfCssMediaType.Print.

Los encabezados y pies de página funcionan de manera diferente. Son una configuración de renderizador en lugar de un marcado de plantilla, por lo que el prompt debe decirlo:

Add an HTML footer to the IronPDF renderer in InvoiceRenderer.cs showing
"Page {page} of {total-pages}", centered, 10mm max height. Use IronPDF's
HTML header/footer support on the rendering options, not markup inside
invoice.html. Link me to the documentation page you used.
Text

Pedir el enlace de documentación es un atajo de verificación. Si el agente no puede producir una página real para la API que acaba de usar, esa es una señal que vale la pena actuar antes de que el código llegue a una compilación. Mantén a mano Inicializando Correctamente RenderingOptions.

¿Cómo depuras una salida incorrecta de PDF de principio a fin?

Los prompts anteriores hacen cada uno una cosa. El uso más interesante es entregar a Codex un síntoma y dejar que trabaje todo el ciclo: inspeccionar, diagnosticar, corregir, probar. Aquí es donde se comporta como un asistente de desarrollo y no como un generador de fragmentos.

Our generated invoices are missing the company logo. The PDF renders and
saves without error, and the logo displays correctly when I open
Templates/invoice.html in a browser.

Investigate:
1. Read InvoiceRenderer.cs and invoice.html.
2. Identify why the image resolves in a browser but not in the render.
3. Explain the cause before changing anything.
4. Then apply the minimal fix and rebuild.
Text

El marco de cuatro pasos importa. Pide un diagnóstico que puedas evaluar antes de que se hagan cambios en los archivos, lo cual es más barato que la ingeniería inversa de una edición después del hecho. En este caso, la causa probable es la resolución de rutas relativas: el navegador resuelve la imagen contra la ubicación del propio archivo mientras que el renderizador resuelve contra cualquier ruta base que se le haya dado, y una respuesta correcta nombra ese mecanismo en lugar de reemplazarlo con una ruta absoluta.

Los mensajes de error merecen el mismo tratamiento. Pegar el rastro completo de la pila es la cosa de mayor señal que puedes dar a un agente.

This exception is thrown from InvoiceRenderer.RenderAsync in our Linux
Docker container but not on Windows:

[PASTE FULL EXCEPTION AND STACK TRACE HERE]

Check our Dockerfile for missing native dependencies IronPDF's Chromium
engine needs on Debian-based images. Explain the cause, then propose the
Dockerfile change. Don't modify C# code unless the cause is there.
Text

Los fallos de contenedor generalmente se remontan a las dependencias nativas que el motor Chromium de IronPDF necesita en una imagen basada en Debian, y esas pertenecen a un Dockerfile en lugar de a C#. Apunta Codex a Cómo ejecutar IronPDF en un contenedor de Docker y haz que lea la guía de implementación actual antes de que edite algo.

¿Cómo convierte el código único en componentes reutilizables y probados?

Una vez que un renderizado funciona, el siguiente prompt debe generalizarlo, y un agente es inusualmente bueno en esto, porque el patrón ya está en el archivo.

Refactor InvoiceRenderer.cs into a reusable PdfDocumentService registered
with dependency injection. It should take a template path and a dictionary
of placeholder values. Reuse a single ChromePdfRenderer instance rather than
constructing one per call. Add XML doc comments. Keep it under 60 lines.
Text

La instrucción de reutilización de instancias es el tipo de detalle que vale la pena llevar en AGENTS.md, ya que construir un renderizador por solicitud es un error común y silencioso de rendimiento.

Las pruebas son el compañero natural, y la salida del PDF es más comprobable de lo que parece a primera vista:

Write xUnit tests for PdfDocumentService covering: output is non-empty,
output begins with the %PDF- file signature, placeholder substitution
appears in extracted text, and a missing template throws a clear exception.
Use IronPDF's text extraction for the content assertion. No golden-file
byte comparisons; rendering output is not byte-stable.
Text

Descartar la comparación byte por byte desde el principio previene una clase completa de pruebas inestables. Los motores de renderizado producen bytes ligeramente diferentes en versiones y plataformas, por lo que las afirmaciones pertenecen al nivel del texto extraído, recuento de páginas y metadatos.

Codex también es útil como lector. Apúntalo a una clase desconocida y convierte la referencia de API en algo que puedes consultar en lugar de desplazarte:

Read the IronPDF API reference for the rendering options type and list
every option that affects page size, then show which ones this project
already sets.
Text

¿Qué patrón de aviso se ajusta a qué tarea?

Seis secciones, seis patrones. El hilo común es que cada uno de ellos nombra algo específico: un archivo, una versión, un síntoma o un punto de detención.

TareaNombra esto en el promptPatrón
Añadiendo el paqueteLa versión, y que no se puede agregar nada másPide que te den de vuelta el resultado
Primera renderizaciónLa ruta de la plantilla y el método a utilizarEspecificar, luego construir
MigraciónEl archivo a leer y la firma a preservarPlanificar antes de codificar
Corrección de diseñoEl síntoma y el archivo a cambiarDescribe lo que ves
Fallo de contenedorEl rastro completo de la pila y la plataformaDiagnosticar antes de editar
Refactorizar y pruebasLa forma del resultado y lo que hay que descartarRestringir la salida

¿Qué produjeron los prompts en una ejecución real?

Enviamos los avisos anteriores a Codex en orden, en una sesión, en un proyecto de consola .NET 9 con IronPdf 2026.10.3. Cada compilación de Release tuvo éxito. Chrome falló al iniciar dentro del entorno Codex, así que una verificación separada renderizó cada PDF del código que dejó atrás cada aviso.

  • Antes del aviso de diseño, la factura dividía el artículo de línea 9 entre las páginas 1 y 2, con el bloque de totales en la parte superior de la página 2.
  • Antes del aviso del logotipo, la factura mostraba un marcador de posición de imagen rota y el texto alternativo en lugar del logotipo.
  • El programa Quickstart lanzó LicensingException en SaveAs, incluso con la clave en el entorno, porque nada aplicó la clave.
  • El aviso de licencia leyó la clave de una variable de entorno y la aplicó antes del primer renderizado. El resultado hello.pdf fue un archivo A4 de 1 página de 17,385 bytes.
  • El aviso AGENTS.md produjo una sección de PDF que contenía los cinco requisitos.
  • El plan de migración no cambió ningún archivo y describió la página A4, fuentes, colores y secciones del informe original correctamente. El informe migrado mantuvo la firma del método público, eliminó el paquete PDFsharp y reprodujo cada figura.
  • El pie de página migrado se movió a una segunda página y leía Página 0 de 0, donde el informe original de 1 página leía Página 1 de 1.
  • La corrección de diseño colocó cada regla de salto de página dentro de un bloque @media print, que el tipo de medio de pantalla por defecto ignora. La factura no cambió, y el artículo de línea 9 todavía estaba dividido.
  • Con CssMediaType configurado en Print, la misma plantilla mantuvo completo el artículo de línea 9 en la página 2, con los totales directamente debajo.
  • El aviso de pie de página añadió un pie de página HTML, y las dos páginas leían Página 1 de 2 y Página 2 de 2.
  • El diagnóstico del logotipo nombró la ruta relativa y la URL base faltante como la causa. Con la carpeta de plantillas pasada como URL base y logo.png copiado al resultado de la compilación, el logotipo se representó a 240 por 96 píxeles.
  • El primer InvoiceRenderer creó un nuevo ChromePdfRenderer en cada llamada. El PdfDocumentService refactorizado tenía 51 líneas, y la inyección de dependencias compartía un ChromePdfRenderer.
  • Las dos pruebas xUnit cubrieron las cuatro condiciones y pasaron con la clave. Sin la clave, la prueba de extracción de texto falló con LicensingException.
  • La respuesta de la API nombró a doce miembros, y los doce existen en IronPdf 2026.10.3, incluido el campo PaperFit. Informó correctamente que el proyecto solo estableció el margen inferior entre ellos.
  • Ningún PDF renderizado llevaba una marca de agua, y la clave no apareció en ningún archivo, compromiso o registro de sesión de Codex.
  • Algunos pasos se ejecutaron de manera diferente a lo esperado. El repositorio README nombró la variable clave y dijo que nunca la imprimiera. El informe PDFsharp, una factura de 9 líneas y el logotipo se agregaron antes de los avisos que los necesitaban. El aviso del contenedor de Linux no se ejecutó, porque la máquina no tenía Docker. El entorno no tenía red, por lo que Codex restauró los paquetes desde la caché local de NuGet, donde se había restaurado el paquete de inyección de dependencias durante la ejecución.

La factura a continuación es la salida no editada del PdfDocumentService final. Lleva el pie de página y el logotipo, y el artículo de línea 9 todavía está dividido.

El registro compartido de la ejecución lista la versión de Codex, modelo, máquina y tiempo para esta ejecución.

¿Qué se traslada al siguiente proyecto?

Los prompts, no el código. Cada patrón anterior sobrevive a un cambio de proyecto solo con los nombres de los archivos intercambiados, por lo que AGENTS.md comprometido gana su lugar: convierte las restricciones que resolvió una vez en la base predeterminada de cada sesión posterior.

La prueba de aceptación contra la cual se mide esta serie, se ejecuta de principio a fin con un resultado publicado y una fecha de última prueba, vive en la guía de asistentes de codificación de IA.


Solución de problemas


¿Preguntas?

Si tienes alguna pregunta, contacta a support@ironsoftware.com

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

Leer más

¿Listo para empezar?

Descargas de NuGet 22,198,312Versión:2026.11recién lanzado