Cómo usar IronPrint con Claude Code

Curtis Chau
Curtis Chau
Actualizado: 26 de octubre de 2026

Un laboratorio hospitalario imprime tres tipos de documentos desde un servicio. Las etiquetas de las muestras van a la impresora de etiquetas en el escritorio de recolección, los informes de resultados van a la impresora de la oficina y los manifiestos del mensajero van a la sala de despacho. Un archivo de enrutamiento nombra la impresora para cada tipo de documento, y un solo carácter erróneo en ese archivo puede enviar resultados de pacientes a otra sala sin error. Claude Code, la herramienta de codificación agéntica de Anthropic, edita archivos y ejecuta comandos en un repositorio. Está disponible como una herramienta de línea de comandos, como extensiones para los editores VS Code y JetBrains, en la aplicación de escritorio de Claude y en claude.ai/code.

IronPrint imprime PDFs e imágenes desde .NET, ya sea en silencio o a través del cuadro de diálogo del sistema operativo. La propiedad PrintSettings.PrinterName selecciona la impresora para un trabajo, y Printer.GetPrinterNames enumera las impresoras instaladas en la máquina. Los cuatro comandos probados abajo hacen que Claude Code construya un enrutador de impresoras para ese laboratorio, y las secciones entre ellos registran el comportamiento de IronPrint en el que se basa cada comando.

Inicio rápido
NuGetInstalar con NuGet

PM > Install-Package IronPrint

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

Inicie claude en un terminal abierto en la carpeta del proyecto y cambie el modelo con /model opusplan antes de enviar el primer comando. Escribiendo @ antes de una ruta incluye el contenido de ese archivo en la solicitud.

Add the IronPrint NuGet package, version 2026.10.1, to LabPrintRouter.csproj.
Then have Program.cs check the printer names in @config/printer-routes.json.

The program does this, in order:

1. Applies the license key and prints License.IsLicensed.
2. Prints each name from Printer.GetPrinterNames on its own line, in quotes.
3. Prints each route's document type, its printer name in quotes, and installed or missing.

A route's printer counts as installed only on an exact match, case and spaces included.
Don't send any print job. Every printer on this machine opens a Save dialog.

My key is in the IRONPRINT_LICENSE_KEY environment variable.
Program.cs reads it at startup and assigns it to License.LicenseKey.
Don't print its value, and don't dump the environment to find it.
If you check the variable, a yes or no on whether it's set is enough.
Text

Las comillas en la salida hacen visible un espacio posterior.



¿Qué hace Claude Code en un proyecto de impresión .NET?

El agente escribe un servicio de enrutamiento que lee el archivo de enrutamiento, compara cada nombre de impresora configurado con las impresoras instaladas y registra una decisión para cada documento. Claude Code también puede ejecutar el programa y sus pruebas y corregir los fallos que reporten. El desarrollador decide qué impresora sirve a cada tipo de documento.

Indique el nombre del paquete y la versión en el primer comando. En el ataque conocido como slopsquatting, los atacantes registran paquetes dañinos bajo nombres que los modelos de lenguaje alucinan. Un agente que escoge un nombre de paquete por sí mismo puede instalar uno de esos paquetes.

¿Cómo configuras Claude Code?

La instalación y el primer inicio de sesión siguen la guía rápida de Anthropic. La configuración se realiza una vez que claude abre una sesión en un terminal y responde a un comando.

¿Cómo configuras un proyecto en el que Claude Code pueda trabajar?

Coloque las entradas en el repositorio antes del primer comando. El proyecto de ejemplo para esta guía contiene una aplicación de consola .NET 9 para net9.0-windows, un archivo de enrutamiento para cuatro tipos de documentos y una bandeja de entrada de siete PDFs cuyos nombres comienzan con su tipo de documento. Una ruta usa el nombre exacto de una impresora instalada. Las otras tres usan una impresora que no está instalada, un nombre instalado en un caso diferente y un nombre instalado con un espacio posterior.

Claude Code lee CLAUDE.md cuando una sesión comienza, por lo que sus reglas se aplican en cada sesión posterior. Una vez que el Quickstart ha agregado el paquete, el segundo comando escribe ese archivo y define un subagente de solo lectura que revisa el código de impresión.

Add a Printing section to a new CLAUDE.md at the repository root.
Later sessions should follow these rules from it:

- All printing goes through IronPrint. Add no other printing library.
- The package is IronPrint, at the version LabPrintRouter.csproj references now.
- Look up IronPrint member names in docs/IronPrint.xml.
- config/ and inbox/ are inputs. Leave them unchanged.
- The program sends no print job unless it runs with --send.
- Never run it with --send on this machine.
- Read the key from IRONPRINT_LICENSE_KEY. Never print it, save it, or dump the environment.

Copy IronPrint.xml to docs/ now, from the ironprint 2026.10.1 folder of the local NuGet cache.
Use the one under lib/net7.0-windows7.0.
If it isn't there, tell me, and still add the subagent below.

Then create a subagent at .claude/agents/printer-name-auditor.md.
Limit its tools to Read, Grep and Glob.
It reviews Services/ and returns three lists:

- IronPrint types and members in use, flagging any that docs/IronPrint.xml lacks.
- Types under IronSoftware.*, listed apart, since they ship in other assemblies.
- Every place a PrinterName gets set, and whether that name passed an exact installed check first.
Text

Claude Code observa .claude/agents y carga una nueva definición de subagente sin reiniciar, pero solo cuando esa carpeta existía al inicio de la sesión. Por lo tanto, el repositorio de ejemplo contiene la carpeta con un archivo .gitkeep vacío antes de que se abra la sesión. La llms.txt de IronPrint indexa sus guías de cómo hacerlo, su habilidad de agente y su otra documentación.

Aplique la clave de licencia antes de la primera llamada de impresión. Sin una clave, Printer.Print y Printer.PrintAsync generan, y no se pone ningún trabajo en cola. La página de Claves de Licencia de IronPrint ofrece una clave de prueba y muestra tanto la asignación de código como la configuración del archivo.

¿Qué reglas de impresora de IronPrint pertenecen a CLAUDE.md?

Probamos el comportamiento detrás de cada línea en IronPrint 2026.10.1, una vez con licencia y otra sin licencia. Pegue el bloque en la sección de Impresión.

These printer rules come from probes on IronPrint 2026.10.1:

- PrintSettings.PrinterName must equal a Printer.GetPrinterNames() entry, character for character.
- Any other name sends the job to the Windows default printer, and nothing throws.
- That covers a missing printer, a different case, a trailing space and an empty string.
- Decide whether to print with StringComparison.Ordinal.
- A trimmed or case-blind match may label a near miss, but it never sends a job.
- Printer.GetPrinterTrays() returns an empty list for a name that isn't installed.
- An empty tray list is also normal for some real printers, so it can't test a name.
- Printer.GetPrinterNames() works without a key, so a printer list proves nothing about licensing.
- IronPrint doesn't read IRONPRINT_LICENSE_KEY by itself. Assign License.LicenseKey at startup.
- Assigning a null key doesn't throw. License.IsLicensed just stays false.
- Without a key, Printer.Print throws AggregateException with a LicensingException inside.
- Without a key, Printer.PrintAsync throws LicensingException directly.
- LicensingException is IronSoftware.Exceptions.LicensingException, internal to IronPrint.dll.
- Print and PrintAsync both wait on the driver, and a Save dialog keeps them waiting.
Markdown

Las dos formas de excepción afectan el manejo de errores. Un manejador verifica la excepción de PrintAsync pero la excepción interna de Print. Ninguno puede usar catch (LicensingException), porque el tipo no es público y esa cláusula falló con CS0122 en la prueba.

¿Rechaza IronPrint un nombre de impresora que no coincide?

Según la guía de especificar el nombre de la impresora, la comparación de nombres es sensible a mayúsculas y minúsculas, y un nombre incorrecto o bien falla silenciosamente o genera un error. Nuestra prueba envió un informe de dos páginas bajo cuatro nombres que no coincidían con ninguna impresora instalada. Los nombres eran un nombre de impresora no instalado, "adobe pdf" para el "Adobe PDF" instalado, el nombre instalado seguido de un espacio y una cadena vacía. Ninguna de las cuatro llamadas generó, y cada trabajo fue enviado a la cola por defecto, que en la máquina de prueba es Microsoft Print to PDF.

Por lo tanto, el enrutador tiene que comparar él mismo cada nombre configurado con los nombres instalados antes de llamar al método de impresión.

¿Cómo construye IronPrint un trabajo de impresión?

IronPrint envía cada página PDF al controlador como una imagen a la resolución en PrintSettings.Dpi. El trabajo de prueba a Microsoft Print to PDF produjo un PDF A4 de dos páginas en el que cada página era una sola imagen de 1239 por 1754 píxeles sin capa de texto, renderizada a 150 DPI. Las salidas de muestra en la guía siguen el mismo patrón con el valor predeterminado de 300 DPI, con 2479 por 3508 píxeles por página A4. Por lo tanto, una revisión de la salida de una impresora PDF debe comparar recuentos de páginas o imágenes, porque el texto impreso no se puede buscar.

Para inspeccionar trabajos sin imprimirlos, la configuración de prueba enganchó la llamada de impresión WPF que IronPrint usa en Windows. El gancho escribe cada trabajo en disco en formato XPS y nada en cola, y las imágenes guardadas de las páginas medían 1239 por 1754 píxeles, igual que el trabajo de prueba. IronPrint escribe los otros ajustes en el ticket de impresión del trabajo. Con Grayscale activado, el ticket solicitó salida en monocromo. Las imágenes de las páginas se almacenaron como RGB y solo contenían píxeles grises. El conteo de copias del ticket provino de NumberOfCopies, y el trabajo mantuvo cada página una vez.

La ruta de la etiqueta muestra lo que hace un esquema alternativo a un trabajo. La entrada es specimen-label__S-031.pdf, una etiqueta de 100 por 50 mm de la bandeja de entrada, que el archivo de enrutamiento envía a LAB-ZEBRA-01 a 300 DPI con PaperSize.PrinterDefault.

Resultado

Los ajustes de la ruta de la etiqueta se enviaron sin la verificación del nombre, por lo que el trabajo regresó a Microsoft Print to PDF. El tamaño de papel predeterminado de la impresora luego se resolvió en la hoja A4 de esa impresora, y la etiqueta se convirtió en una imagen de 1179 por 591 píxeles en una página A4 en modo horizontal. El trabajo ajustó esa imagen a 297 por 149 mm, el ancho completo de la hoja.

Etiqueta de muestra S-031 como IronPrint construyó el trabajo sin la verificación del nombre. Una página A4 en modo horizontal a 300 DPI, dirigida a Microsoft Print to PDF y capturada en un archivo en lugar de una impresora.

¿Cómo se solicita código de IronPrint que compila?

Envíe el enrutador y su informe como un solo comando en modo plan, para que el diseño esté acordado antes de cualquier cambio en los archivos. Presione Shift+Tab hasta que la barra de estado muestre modo plan, luego envíe el comando. Bajo opusplan, el plan proviene de Opus, y Sonnet hace los cambios después de que el plan es aprobado.

Build the router in Services/PrintRouter.cs and the report in Services/RoutingReport.cs.
Call both from Program.cs after the printer check.
Program.cs passes PrintRouter the list from one Printer.GetPrinterNames call.

Each PDF in inbox/ is named <documentType>__<id>.pdf.
For each file, PrintRouter does this:

1. Finds the route for its document type in config/printer-routes.json.
2. Checks the route's printer against that list.
3. Builds PrintSettings from the route's paper size, orientation, DPI, copies and grayscale.
4. Sends the job with Printer.PrintAsync, but only under --send.

Each file gets the first of these decisions that fits:

- send, when the printer name matches an installed name exactly.
- name-mismatch, when it matches one after ignoring case and outer spaces.
- not-installed, when nothing matches.
- no-route, when the config has no route for the type.

Only send files reach the print call.
Put that call behind an interface so tests can use a fake.

Write out/routing-report.csv with a header row and one row per file, sorted by file name.
Its first columns are File, DocumentType, ConfiguredPrinter, Decision and InstalledName.
Then come PaperSize, Orientation, Dpi, Copies and Grayscale from the route.
InstalledName holds the installed printer for send and the near match for name-mismatch.
It stays empty for the other two decisions.
A no-route row leaves the five route columns empty too.
Write Grayscale as true or false.
Print a count of files per decision.

Run the program without --send and show me the CSV.
Then have the printer-name-auditor subagent review Services/.
Text

Dos partes del comando protegen el enrutamiento.

  1. El indicador de envío: sin --send, el programa no envía ningún trabajo, por lo que el agente puede ejecutar y probar el enrutador en una máquina cuyas impresoras abren un cuadro de diálogo.
  2. El subagente auditor: un subagente personalizado carga CLAUDE.md, por lo que las reglas de nombres de impresora se aplican a su revisión también. De los agentes integrados, Explore y Plan comienzan sin CLAUDE.md.
Consejos: Antes de aprobar el plan, confirma que el nombre dado a IronPrint es el nombre instalado del chequeo exacto. Un plan que coincide con los nombres sin considerar las mayúsculas y luego pasa el nombre configurado envía los manifiestos del mensajero a la impresora predeterminada.

¿Se puede probar el código de enrutamiento de IronPrint sin una clave de licencia?

Sí, siempre que las pruebas reemplacen la llamada de impresión. Leer el archivo de enrutamiento, listar las impresoras instaladas y construir PrintSettings todo funciona sin una clave, para que cada decisión de enrutamiento pueda ser probada en un servidor de compilación que no tiene clave.

Add a LabPrintRouter.Tests xUnit project that targets net9.0-windows.
It tests PrintRouter through a fake print sink.

The tests read the copies of inbox/ and config/ in their output folder.
Give the router a fixed printer list of "Adobe PDF", "Microsoft Print to PDF" and "Fax".
Assert these results:

- The decision for each of the 7 files.
- The fake receives the 2 result reports and nothing else.
- RPT-4471 goes out with A4, Portrait, 150 DPI, 1 copy and grayscale on.
- Printer.GetPrinterNames runs without throwing while no key is applied.

Set the project up this way:

- It lives in its own folder, and the repository root gets no solution file.
- LabPrintRouter.csproj must not compile anything in that folder.
- The test output folder gets copies of config/ and inbox/.

Run dotnet test one time, in a child process that has no IRONPRINT_LICENSE_KEY.
Tell me the pass count from that run.
Text

¿Qué debe verificar antes de confiar en el código generado de IronPrint?

Revise el código generado de IronPrint con estas verificaciones.

  • La construcción: un miembro que IronPrint no tiene detiene dotnet build con un error de compilación. El IronPrint.xml enviado también documenta un método de la clase interna PdfiumUtils, y el código que lo llama falla con CS0122.
  • El informe de enrutamiento: compare cada decisión con el archivo de enrutamiento y la lista de impresoras instaladas antes del primer trabajo real.
  • Una página de prueba por impresora: antes de la liberación, confirme en cada dispositivo que una página de prueba se imprimió donde la ruta dice.

La guía de asistentes de codificación AI ofrece una tarea completa de IronPrint, con criterios de paso fijo, como una prueba repetible.

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

Los cuatro comandos se ejecutaron en una sola sesión de Claude Code, en el orden mostrado. Antes del comando 3, el bloque de reglas se pegó en CLAUDE.md, y nadie editó el código a mano.

  • La salida del Quickstart nombró a las cuatro impresoras instaladas y marcó una ruta instalada y tres faltantes.
  • El informe de enrutamiento sostuvo una fila para cada uno de los 7 archivos.
  • 2 archivos fueron marcados para enviar, 2 sin coincidencia de nombre, 2 no instalados, y 1 sin ruta.
  • Cada decisión coincidió con nuestra verificación independiente contra las impresoras instaladas.
  • La coincidencia cercana fue Adobe PDF para el manifiesto del mensajero y Microsoft Print to PDF para el resumen de la sala.
  • Una ejecución de liberación limpia en una copia nueva produjo el mismo informe.
  • Sin la clave, el programa informó IsLicensed como Falso e hizo las mismas 7 decisiones.
  • 10 de 10 pruebas pasaron en un proceso sin la variable IRONPRINT_LICENSE_KEY.
  • El subagente no encontró ningún miembro de IronPrint faltante en IronPrint.xml.
  • El subagente encontró una asignación de nombre de impresora, colocada después del chequeo exacto.
  • Las colas de impresión estaban vacías después de la ejecución, y ningún comando en las transcripciones usó --send.
  • La captura de los dos trabajos de envío sostuvo 3 páginas A4 en modo retrato para la cola de Adobe PDF, cada una una imagen de 1239 por 1754 píxeles.
  • Cada comando dejó una construcción de liberación sin advertencias ni errores.
  • Un escaneo de las transcripciones, los archivos de la sesión y el repositorio no encontró copia de la clave de licencia.
  • Algunos pasos se ejecutaron de manera diferente a lo esperado. Una respuesta escrita aprobó el plan del comando 3, porque la sesión se ejecutó sin interfaz. No se imprimió ningún trabajo, porque cada impresora en la máquina de prueba abre un cuadro de diálogo de Guardar, por lo que los dos trabajos de envío se capturaron en XPS.

La primera fila de envío en el informe de enrutamiento fue result-report__RPT-4471.pdf, un informe de resultados de dos páginas de la bandeja de entrada.

Resultado

La herramienta de captura pasó la configuración de esta fila del informe de enrutamiento a IronPrint. El PDF a continuación contiene ambas páginas capturadas sin cambios.

Informe de resultados RPT-4471 como IronPrint construyó el trabajo de envío desde el informe de enrutamiento de la ejecución. Ambas páginas son A4 en modo retrato a 150 DPI para la cola de Adobe PDF, capturadas en un archivo en lugar de una impresora.

Cursor también tiene un Modo Plan, y la guía de Cursor envía su comando 3 en él. Codex lee sus reglas de proyecto desde AGENTS.md, el contrapartida de CLAUDE.md, como muestra la guía de Codex de ChatGPT. La versión de Claude Code de esta ejecución, los modelos y la duración total aparecen en el registro de la ejecución junto a la máquina de prueba.


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 52,106Versión:2026.11recién lanzado