Cómo usar IronWord con ChatGPT Codex

Curtis Chau
Curtis Chau
Actualizado: 19 de octubre de 2026

Cuando una empresa cambia su nombre, el equipo legal recibe una carpeta de contratos firmados para actualizar. El nombre anterior se encuentra en párrafos del cuerpo, tablas de partes, títulos en mayúsculas y encabezados de página. Word también puede almacenar el nombre en varias ejecuciones de formato, por ejemplo cuando un fragmento fue puesto en negrita hace años. Un buscar y reemplazar estándar en cada archivo soluciona solo algunos casos, mientras que otros quedan sin cambios sin alerta.

ChatGPT Codex es el agente de codificación de OpenAI. Dentro de un repositorio edita archivos, ejecuta comandos como dotnet run y luego resume los cambios. Un agente atiende el terminal, IDEs, la aplicación de escritorio de ChatGPT y tareas en la nube. IronWord, una biblioteca .NET de Iron Software, abre documentos de Word existentes como un modelo de objeto de párrafos, ejecuciones y tablas que el código puede editar y guardar sin Microsoft Office.

Codex trabaja en un retraso de contratos con un manifiesto de verdad básica. Los lotes de indicaciones escriben un CSV con una fila por contrato, por lo que cada conteo que Codex informa de ellos está respaldado por un archivo.

Inicio rápido
NuGetInstalar con NuGet

PM > Install-Package IronWord

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

Inicia Codex en un proyecto de consola .NET que contiene la carpeta de contratos, y solicita un inventario antes de cualquier edición.

$ironword Add the IronWord 2026.10.4 NuGet package to this console project.
Then have Program.cs open every .docx in Contracts/sample/ without changing it.

For each file, write one row to out/quickstart.csv with these columns:

- file
- body count, how often "Northwind Traders" appears in the body text
- table count, the same name counted separately in every table cell
- the exception type, when the file fails to open

Print the totals by reading that CSV back.
Program.cs reads the key from IRONWORD_LICENSE_KEY itself.
Don't print the key's value, and don't list environment variables.
Nothing gets saved here, so an unset key is no reason to stop.
Build and run it with at most three repair attempts, then tell me the result.
Text


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

Los pasos de instalación están en la documentación de Codex CLI, y los lanzamientos se publican en el repositorio de código abierto.

Codex conoce IronWord a partir de datos de entrenamiento y archivos suministrados, y un nuevo lanzamiento puede desactualizarlos a ambos. Las versiones 2026.10 cargan y guardan a través de flujos y llamadas asincrónicas.

¿Cómo se escribe una indicación de IronWord y se configura Codex para ella?

Una indicación de lote efectiva nombra la entrada, cada ubicación del nombre, la salida, la prueba, la verdad básica de solo lectura y las restricciones.

El artículo de OpenAI sobre por qué los modelos de lenguaje alucinan rastrea respuestas erróneas confiadas hasta el entrenamiento y la evaluación que recompensan adivinar, y en un trabajo de cambio de nombre la suposición es que cada contrato está limpio.

Codex busca habilidades en .agents/skills en cada directorio entre el directorio de trabajo y la raíz del repositorio. Guardado como .agents/skills/IronWord/SKILL.md, la skill.md de IronWord resuelve la mención $ironword.

Antes de cualquier trabajo, Codex lee un máximo de un AGENTS.md en cada directorio en el camino entre la raíz del repositorio y la carpeta de trabajo. El archivo más cercano a la carpeta de trabajo tiene prioridad. El comando /init redacta un AGENTS.md inicial.

Give this repository a top-level AGENTS.md with a Contract rebrand section.
List these rules in it:

- No DOCX library other than IronWord is allowed.
- IronWord's package is IronWord, and its namespaces are IronWord and IronWord.Models.
- The ironword skill in .agents/skills/ironword/ is one API reference.
- https://ironsoftware.com/word/csharp/llms.txt is the other.
- Contracts/inbox/ and Contracts/manifest.csv are read-only.
- Rebranded copies go to out/rebranded/ under their original names.
- IRONWORD_LICENSE_KEY holds the key, and its value never appears in output, logs or files.
- Checking the variable means its presence and length, nothing more.
- Any count you report is read from a CSV written in the same turn.
- The reply names that CSV.
Text

¿Cómo pides a Codex que agregue IronWord y verifique la licencia?

Print the IronWord PackageReference from ContractRebrand.csproj and the version restore resolved.
Then quote every IronSoftware entry that dotnet list package --include-transitive prints.
Leave the package references exactly as they are.
Text

IronWord 2026.10.4 hace referencia a IronSoftware.Abstractions 2026.1.2, IronSoftware.Common 2026.4.2 e IronSoftware.System.Drawing 2026.11.3. Además restaura IronSoftware.Drawing.Abstractions 2026.1.2. La compilación copia bibliotecas nativas de LayoutEngineInterop para Windows, Linux y macOS en una carpeta de tiempos de ejecución. La página de conflictos OpenXML cubre un conflicto con un DocumentFormat.OpenXml más reciente en lanzamientos antes de 2025.7.13. Verifica el registro de cambios de IronWord antes de fijar.

Sin una clave, abrir, leer y reemplazar tienen éxito, pero cada sobrecarga de guardado, incluidas las asincrónicas, lanza una LicensingException con el mensaje Se requiere licencia de producción.

Add Startup.ApplyIronWordKey and call it first in Program.cs.
It copies the IRONWORD_LICENSE_KEY value into IronWord.License.LicenseKey.
It also reports whether License.IsLicensed is true.

Add a --dry-run switch that opens and edits in memory and never saves.
Then run the sample twice with the variable removed:

1. Run it once with --dry-run.
2. Run it once copying each file to out/licence-check/ through SaveAs.

Clear the variable inside each child process only, never for the session.
Write out/licence-check.csv with the columns run, file, call, exception type name and message.
Tell me which calls threw.
The licensing exception type isn't public, so catch Exception and record its GetType().FullName.
Stop after three repair attempts.
Text

La página de claves de licencia también cubre Web.config, App.config y appsettings.json.

¿Qué partes de un documento de Word alcanza un reemplazo de texto?

Create Services/MentionScanner.cs.
For one DOCX it returns a count for each of these:

- "Northwind Traders" in body paragraphs
- "Northwind Traders" in table cells
- the name in upper case
- the name inside "Northwind Traders Pension Trust"
- the name in headers and footers
- the old notice address
- the Fax notices paragraph

The body and table cell counts leave out the pension trust name.
IronWord has no header or footer model.
For that column only, read word/header*.xml and word/footer*.xml with System.IO.Compression.

Then run it over Contracts/inbox/ into out/inventory.csv.
Mark files that fail to open as Unreadable.
List every file whose counts differ from manifest.csv.
In that comparison, the body count is body_mentions plus split_run_mentions.
Text

El agente explorador incorporado prueba el reemplazo en archivos reales.

Create a scratch console project under scratch/replace-probe/ yourself.
Add a Compile Remove line for scratch/** to ContractRebrand.csproj.

Then ask the explorer agent to use that project.
It finds which parts of a contract the document-level ReplaceText call changes.
It tests copies of the Contracts/sample/ files in memory, with these four cases:

- a name split across runs
- a table cell
- the upper-case title
- the pension trust

The header has no object in the API, so the explorer answers that one from IronWord.xml.
It changes nothing under Services/ or in Program.cs.

Write the five answers to out/replace-reach.csv.
Beside each answer, quote the ironword skill or IronWord documentation.
Where a page and the test disagree, say so.
Text

La calibración en 2026.10.4 dio estos resultados en memoria.

UbicaciónReemplazo a nivel de documentoQué lo alcanza
Cuerpo, una ejecuciónReemplazadoLa llamada del documento
Cuerpo, dividido en ejecucionesReemplazadoLa llamada del documento
Celda de tablaSin cambiosReplaceText en cada TableCell
Título en mayúsculasSin cambios (coincidencia sensible a mayúsculas y minúsculas)Una segunda llamada con la forma en mayúsculas
Nombre del fideicomiso de pensionesRenombrado (coincidencia de subcadena simple)Un marcador de posición sustituido primero y restaurado después
Encabezado o pie de páginaNo está en el modelo de objetoInfórmalo, luego edítalo manualmente

La fila de ejecución dividida tiene un efecto secundario. Un nombre almacenado como North en negrita seguido de un wind Traders normal se convierte en una ejecución en negrita que lee Contoso Ltd.

Una verificación construida sobre el ExtractText del documento, que devuelve solo párrafos del cuerpo, aprueba un contrato cuya tabla de partes aún nombra la antigua empresa. FindText omite una coincidencia de ejecución dividida, ya que solo coincide con un elemento de texto que contiene toda la frase.

¿Cómo reemplazas texto en una carpeta de documentos?

Have the worker agent write Services/Rebrander.cs.
It applies every rule in Contracts/README.md to Contracts/inbox/.
It builds on the explorer's findings and follows these rules:

- Replace inside each table cell as well as the body.
- Keep the pension trust intact.
- Delete the Fax notices paragraph.
- Leave header and footer parts as they are, since IronWord can't edit them.
- Report those contracts as HeaderFlagged.
- Save each copy to out/rebranded/ with SaveAs.
- Never call Save() on a document opened from inbox/.

Add a --sequential mode that rescans the saved copies with MentionScanner.
It writes out/sequential.csv with these columns:

- file
- status from the README, always one of its four
- mentions left per location
- milliseconds
- header_lost, set to yes when a copy lacks a header or footer part its original had

The header_lost column is reported on its own and never changes a status.
Tell me the status counts.
Text

En IronWord 2026.10.4, guardar un DOCX cargado con una tabla descarta cada edición de texto dentro de la tabla y en cualquier párrafo después de la primera tabla. La copia en disco mantiene el texto antiguo, no se levanta ninguna excepción, y el documento en memoria aún muestra el reemplazo. Las ediciones antes de la primera tabla persisten, al igual que una celda reemplazada con un nuevo TableCell. Estos contratos colocan la firma después de la tabla de partes, por lo que una verificación en memoria aprueba copias cuya firma guardada nunca cambió.

El Save sin parámetro está documentado para sobrescribir el archivo fuente de un documento cargado, por lo que un lote no debería llamarlo. La guía de eliminación de texto muestra la eliminación de párrafos detrás de la regla del fax.

En la calibración, cargar un archivo de cero bytes lanzó una NullReferenceException, y un archivo de texto, un paquete truncado y un paquete de bytes aleatorios cada uno lanzó una FileFormatException desde un espacio de nombres ofuscado con el mensaje El archivo contiene datos corruptos. Un bloque para el tipo System.IO lo omite. Busca Exception por archivo y registra su tipo.

Las copias usan SaveAs, que la página de resolución de problemas de IronWord nombra para un encabezado que desaparece después de guardar.

Check whether SaveAs lost a header anywhere in this backlog.
IronWord's troubleshooting page header-disappears-after-saveas reports that in one environment.

For every HeaderFlagged file, compare the inbox original with its out/rebranded/ copy.
Look at the word/header*.xml and word/footer*.xml parts.
Write out/header-check.csv with these columns:

- file
- header parts before
- header parts after
- whether each part is present with its text unchanged

If a part went missing, rebrand that contract again from its inbox original.
Write it with the Save overload that takes the out/rebranded/ path.
Don't use the parameterless Save().
If the part is still missing, record it and stop.
Tell me which files lost a part.
Text

¿Cómo procesas una carpeta de documentos en paralelo?

Las llamadas asincrónicas realizan I/O de archivos sin bloquear, pero la documentación establece que el análisis y la serialización permanecen sincrónicos y que una instancia de documento no es segura para hilos.

Add a --parallel mode that works like this:

- It runs Task.WhenAll over the inbox.
- Each task holds a slot of a SemaphoreSlim whose size comes from --concurrency.
- Then it awaits WordDocument.LoadAsync and SaveAsAsync on its own WordDocument.

Run the mode three times:

1. At concurrency 1 into out/parallel-c1/.
2. At concurrency 4 into out/parallel-c4/.
3. At Environment.ProcessorCount into out/parallel-max/.

Write out/parallel-compare.csv with the columns file, folder and a yes or no.
The yes or no says whether the extracted body and cell text match out/rebranded/.
Log each run as a new line of out/runs.csv.
Give it the mode, concurrency, elapsed seconds and match count from out/parallel-compare.csv.
Tell me the quickest setting in runs.csv.
Text

En la calibración, abrir y editar la bandeja de entrada en memoria, incluidos cuatro archivos ilegibles, tomó 4.8 segundos secuencialmente, 1.4 a un límite de 4 y 1.8 a 16, y con SaveAsAsync se agregaron 14.4, 5.5 y 4.7 segundos. La guardada es el paso limitante.

¿Cómo diagnosticas un documento que aún muestra texto antiguo?

Codex acepta imágenes a través de la bandera -i (--image) en una nueva sesión o con codex exec resume, o como una pega en el compositor.

I attached the first page of out/rebranded/MSA-1050.docx as an image with -i.
Its header still names Northwind Traders.
Look at the image, then explain from the file itself why the batch left that text.
Tell me whether out/sequential.csv already flags this file.
Don't change any code.
Text

Una respuesta correcta nombra la parte del encabezado y la fila HeaderFlagged del archivo.

¿Cómo depurar una salida incorrecta de lote de principio a fin?

Find out why the nightly job passed contracts that legal later flagged.
The log reports 0 contracts still naming Northwind Traders.
Contracts/legal-review.csv lists contracts where legal still found the old name.
It was in the party table or an upper-case title.
The file also lists a pension trust that was renamed.

Send the explorer agent through Jobs/NightlyRebrand.cs and Logs/nightly-2026-10-07/ first.
Then write your own report in out/nightly-diagnosis.md with these parts:

- why the job's own check passed them
- the smallest fix
- the command that proves the fix

Don't run or edit any code.
Text

El diagnóstico debe citar la línea donde el trabajo marca un contrato limpio.

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

Put the worker agent on a RebrandJob class, built like this:

- Install the Microsoft.Extensions.DependencyInjection package.
- Have its container resolve RebrandJob.
- Set it up through a RebrandOptions record with inbox, output folder, concurrency and dry run.
- Keep every README rule, the header check and the per-file CSV.
- RebrandJob.cs stays under 180 lines, with XML doc comments.

The README rules cover body and cell replacement, upper case and the pension trust guard.
They also cover the address and the fax deletion.
Run the job over the whole inbox into out/final/ and out/final.csv.
Then tell me whether every status matches manifest.csv.
Also confirm no copy keeps an old name, old address or fax paragraph.
Old names in a copy's header or in the pension trust don't count.
Text

Una refactorización puede eliminar una regla y aun así compilar.

Add an xUnit project at tests/ContractRebrand.Tests.
Exclude it from the main project's compile items, and join both projects in a solution file.

Write tests on real inbox files that check these:

- a split-run contract comes back with no old name
- a table contract is clean in its cells
- a pension trust mention survives
- a header contract is HeaderFlagged
- the zero-byte file is Unreadable without stopping the batch
- 20 files rebranded in parallel equal their sequential copies

Assert on extracted text and statuses, never on DOCX bytes.
Keep test copies in out/tests/work/.
Run dotnet test on the solution with a trx logger into out/tests/.
Report the totals from the trx file.
Text

La documentación de indicaciones personalizadas de OpenAI desaprueba las indicaciones guardadas en ~/.codex/prompts a favor de habilidades, donde pertenecen preguntas recurrentes.

$ironword Look in the installed IronWord.xml.
List the WordDocument members that load or save a document, and answer these:

- Which ones are asynchronous?
- Which one overwrites the source file a document was loaded from?

List only members you can call from a line that compiles in a probe under scratch/.
Also name any member anywhere in IronWord.xml that is documented but doesn't compile.
Check by compiling only.
Don't run Save() on any document loaded from Contracts/inbox/.
Then show the line in RebrandJob that keeps Contracts/inbox/ untouched.
Text

¿Cómo reutilizas estas indicaciones en otro retraso de documentos?

Con nombres, rutas y reglas cambiadas, estas indicaciones se adaptan al siguiente retraso, y la guía de asistentes de codificación de IronWord AI cubre la configuración para los cinco asistentes.

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

Las indicaciones se ejecutaron en orden en una sesión de Codex. El proyecto .NET 9 contenía 124 contratos y un manifiesto de estados y conteos esperados, y cada compilación en Release tuvo éxito. Nuestro escáner volvió a escanear cada copia guardada, y las pruebas se ejecutaron nuevamente en un clon nuevo.

  • Antes del cambio de nombre, el inventario coincidía con el manifiesto en los 124 archivos y marcó los 4 archivos no DOCX como Ilegibles.
  • Después de la rebranding secuencial, las 120 copias guardadas no contenían ninguno de los 114 nombres antiguos sobre la tabla de partes, incluidos los 22 divididos en ejecuciones.
  • Ninguno de los 13 títulos en mayúsculas, 38 direcciones de aviso antiguas o 57 párrafos de fax permanecieron.
  • Todos los 9 nombres de fideicomisos de pensiones se mantuvieron intactos.
  • El nombre antiguo permaneció en 28 tablas de partes y 114 firmas, porque la guardada descartó esas ediciones.
  • El sequential.csv del trabajador dio a cada archivo el estado del manifiesto, Rebranded 104, HeaderFlagged 10, NoChange 6 e Ilegible 4, pero sus propias columnas de conteo aún mostraban las 114 menciones de firma y 28 de tabla. Los estados registran detección, no reemplazo, como informó el propio Codex.
  • En los 10 archivos de muestra, el inicio rápido informó 19 menciones de cuerpo y 2 de tabla, frente a 16 y 2 en el manifiesto. Su conteo de cuerpo también incluyó las 2 menciones de celda y el nombre del fideicomiso de pensiones.
  • Sin la clave, la ejecución en seco editó los 9 archivos de muestra legibles en memoria. La ejecución de guardado lanzó LicensingException en SaveAs para cada uno de ellos.
  • Con límites de 1, 4 y 32, las ejecuciones en paralelo tomaron 11.456, 7.825 y 5.830 segundos. Las 120 copias legibles en cada carpeta coincidían con las secuenciales.
  • El diagnóstico nocturno rastreó los hallazgos a la verificación ExtractText().Contains del trabajo, sensible a mayúsculas y minúsculas, y su reemplazo a nivel de documento. No citó números de línea, y su comando de prueba se dirigió a un proyecto de prueba que aún no existía.
  • La refactorización mantuvo cada regla en un RebrandJob.cs de 68 líneas, y sus copias out/final coincidieron con out/rebranded.
  • final.csv coincidió con los estados del manifiesto pero marcó 118 filas como incompletas, y Codex informó que la verificación de contenido falló.
  • La ejecución de Codex y el clon nuevo pasaron cada uno 4 de las 6 pruebas. La prueba de ejecución dividida falló en la firma y la prueba de tabla en una celda de la tabla de partes.
  • La respuesta de la API enumeró cuatro cargas, siete guardados y cinco miembros asincrónicos, y nombró el comando Save sin parámetros como el que sobrescribe la fuente.
  • Nombró correctamente cuatro miembros documentados que no compilan. Estos eran el constructor que toma bytes y una cadena, FlushModelToBytes, ReplaceTextAcrossRuns en un párrafo y SetNoChangeStatusAsUpdated.
  • También enumeró el constructor solo de bytes, que compila, y omitió otros cinco que fallan en 2026.10.4, FromMarkdown, FromMarkdownFile, ExportToMarkdownFile, GetMailMergeWorkingBytes y ApplyCellStyle en una tabla.
  • Algunos pasos se ejecutaron de manera diferente a lo esperado. La imagen se renderizó con python-docx desde la copia MSA-1050 de la ejecución. El trabajo nocturno, su registro y el archivo de revisión legal se agregaron inmediatamente antes de la indicación de investigación.

La guía de GitHub Copilot prueba una declaración guardada leyendo su tabla a través de Tablas, Filas y Celdas. La guía de Cursor enumera las partes de un DOCX que IronWord no lee.

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


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