Tus PDF y archivos de Word en Claude Code, Cursor y Codex

A octubre de 2026, Claude Code puede leer un PDF por sí solo, Cursor lee un PDF que adjuntes al chat y la documentación de Codex CLI describe la entrada de imágenes, pero no de PDF. Ninguno de los tres incluye los archivos de Word (DOCX) entre los formatos que lee directamente. Las especificaciones, manuales, artículos y contratos que el agente vaya a usar más de una vez conviértelos a Markdown, guarda las copias en el proyecto y dile al agente dónde están.

Esta guía es para agentes de programación que trabajan en una carpeta de proyecto. Si estás creando una carpeta aparte de documentos de referencia, y no un proyecto de código, empieza por nuestra guía para preparar documentos para agentes de IA.

Qué lee cada agente directamente

Esto es lo que dice la documentación de cada fabricante a octubre de 2026.

Claude Code lee un PDF corto entero. Un PDF de más de 10 páginas lo lee por tramos de hasta 20 páginas, y esas lecturas necesitan el programa pdftoppm de poppler. En Windows tienes que instalar tú una compilación de poppler y añadirla al PATH; sin ella, la lectura falla. Los detalles están en la referencia de herramientas de Claude Code.

Cursor lee PDF desde la versión 2.4, publicada en enero de 2026. La lista de exclusión predeterminada de Cursor sigue incluyendo los archivos PDF y varios formatos de Office, y la ayuda de Cursor indica que los archivos excluidos están bloqueados para el agente. Adjunta tú el PDF al chat en lugar de esperar que el agente lo encuentre en el proyecto.

Codex CLI acepta imágenes pasadas por línea de comandos o pegadas en el cuadro del prompt. Su documentación no describe la entrada de PDF o Word para la CLI.

Un agente siempre puede intentar sacar el texto de un documento ejecutando un programa instalado en tu equipo. A veces funciona, pero no ves qué texto obtuvo, y una tabla mal leída pasa directamente a su respuesta.

Por qué funciona mejor una copia en Markdown

Markdown es texto plano con títulos, listas y tablas. Dentro de un proyecto, te da cuatro cosas que un archivo PDF o DOCX no te da.

• El agente puede buscar en él. Una búsqueda de texto encuentra una frase en un archivo Markdown. Un archivo DOCX es un archivo ZIP con partes XML, así que una búsqueda de texto simple no encuentra nada dentro.
• El agente puede citar líneas exactas, y tú puedes encontrar cada frase citada en el archivo y leer lo que la rodea.
• El agente lee solo lo que necesita: busca en un manual largo y abre la sección que importa en lugar de recorrer las páginas.
• Git muestra qué ha cambiado. Cuando llega una nueva edición de una especificación, el diff lista las líneas modificadas.

Además, ves exactamente lo que lee el agente. Si una tabla sale mal, la corriges una vez en el archivo Markdown y todas las sesiones siguientes usan la copia corregida.

Un PDF escaneado sin capa de texto contiene solo imágenes de páginas. Necesita OCR (reconocimiento de texto) antes de que un agente pueda buscar en él. MD Factory reconoce el texto de los PDF escaneados en tu PC. Para revisar el resultado, consulta nuestra guía para convertir PDF escaneados.

Pon los documentos en una carpeta docs

Guarda los originales y sus copias en Markdown dentro del proyecto, junto al código que depende de ellos:

payments-service/
  AGENTS.md
  docs/
    partner-api-spec.pdf
    partner-api-spec.md
    partner-api-spec_images/
    supplier-contract.docx
    supplier-contract.md
  src/

1. Copia los archivos PDF y Word en la carpeta docs. MD Factory guarda cada archivo Markdown junto a su original, así que las copias aparecerán ahí.
2. En MD Factory, haz clic en Añadir carpeta y elige la carpeta docs, o arrástrala a la ventana. La conversión empieza de inmediato.
3. Espera a que cada archivo muestre un estado: Completado, Necesita revisión o Falló.
4. Haz clic en Necesita revisión junto a un archivo para ver qué hay que revisar y compara esa parte con el original.

Las imágenes de un documento van a una carpeta con su nombre, por ejemplo partner-api-spec_images. Los archivos PDF y Word no se modifican.

Deja los originales en el proyecto. Los números de página, las figuras y la redacción exacta firmada están ahí, y los necesitarás cuando la copia y la respuesta del agente no coincidan.

Indica al agente dónde están los archivos

Dale al agente una lista breve de documentos en su archivo de instrucciones. Claude Code lee CLAUDE.md, o AGENTS.md si el proyecto no tiene CLAUDE.md. Codex y Cursor leen AGENTS.md. Por ejemplo:

## Documentos de referencia

Las copias en Markdown de los archivos PDF y Word están en docs/.
El original de cada copia está a su lado.

- `docs/partner-api-spec.md`: especificación de la API del socio, versión 3.2
- `docs/supplier-contract.md`: contrato con el proveedor, edición de 2026

Busca en docs/ antes de responder preguntas sobre la API del socio o el contrato.
Cita el título de la sección en la que te basas.
No edites archivos en docs/.

Escribe las rutas entre comillas invertidas, como arriba, no como @docs/partner-api-spec.md. En CLAUDE.md, una ruta con @ es una importación: Claude Code carga el archivo completo al inicio de cada sesión. Una ruta entre comillas invertidas queda como simple mención, y Claude abre el archivo cuando una tarea lo necesita.

Mantén la lista corta. Codex deja de leer archivos de instrucciones cuando juntos llegan a 32 KiB, su límite predeterminado.

Para una tarea concreta, menciona el archivo en tu prompt:

• En Claude Code, escribe @ y elige el archivo. Claude Code añade su contenido a la conversación si cabe en el límite de lectura, 25 000 tokens de forma predeterminada. Si el archivo es más largo, pide a Claude que primero busque en él.
• En Cursor, escribe @ y elige el archivo o toda la carpeta docs, como se explica en la ayuda de Cursor.
• En Codex CLI, escribe @ para insertar la ruta de un archivo, o usa el comando /mention para adjuntarlo, como se explica en la guía de prompts de Codex.

Un prompt que nombra el documento y pide citas podría ser así:

Lee las secciones «Authentication» y «Rate limits» de
docs/partner-api-spec.md. Actualiza el cliente de la API para cumplirlas.
Para cada cambio, cita la línea de la especificación en la que se basa.

Comprueba las respuestas y actualiza las copias

Antes de fiarte de una respuesta, busca tú el pasaje citado. Usa el primer comando en PowerShell y el segundo en Git Bash:

Select-String -Path docs\*.md -Pattern "rate limit"
grep -n -i "rate limit" docs/*.md

Si la cita no está en el archivo Markdown, búscala en el original. Si tampoco está ahí, el agente no la sacó del documento. Para números de página y figuras, abre siempre el original.

Vigila tu archivo .gitignore. La búsqueda de Claude Code omite los archivos de .gitignore, aunque Claude puede buscar en un archivo o leerlo si le das su ruta. Cursor mantiene los archivos de .gitignore fuera del alcance del agente salvo que una línea que empiece por ! en .cursorignore los vuelva a incluir. Si los documentos no deben entrar en Git, enumera la ruta de cada archivo en el archivo de instrucciones para Claude Code y añade esta línea a .cursorignore para Cursor: !docs/

Los archivos de referencia solo deberían cambiar cuando tú lo decidas. Revisa el diff después de cada tarea. Si quieres que Claude Code no toque la carpeta docs, añade una regla de denegación Edit para ella.

Cuando llegue una nueva edición, sustituye el original en la carpeta docs con el mismo nombre de archivo y vuelve a añadirlo a MD Factory. Si no editaste la copia anterior en Markdown, MD Factory la reemplaza. Si la editaste, la copia nueva recibe un nombre numerado, por ejemplo partner-api-spec (2).md, y tus cambios se quedan en el archivo anterior. Un diff del archivo Markdown muestra entonces qué secciones cambiaron y qué código puede necesitar ajustes.

Documentos confidenciales: qué envía el agente

MD Factory convierte los documentos en tu PC y no los sube a ningún sitio, pero eso solo cubre la conversión. Cuando el agente lee la copia en Markdown, el texto va al proveedor del modelo como el resto de tu prompt.

• Claude Code se ejecuta en tu equipo, pero envía los prompts y las respuestas del modelo por la red. Cuánto tiempo conserva Anthropic esos datos depende de tu tipo de cuenta y tu configuración de privacidad: consulta la conservación de datos en Claude Code.
• Cursor indica que, cuando el agente abre un archivo, su contenido puede incluirse en la solicitud al modelo.
• Codex usa OpenAI como proveedor de modelos predeterminado.

Antes de que un agente lea un documento confidencial:

• Convierte y añade solo los documentos que necesita la tarea.
• Si un documento está sujeto a un acuerdo de confidencialidad o a un contrato con un cliente, comprueba si permite enviar el texto a un servicio de IA externo.
• Guarda fuera de la carpeta del proyecto los documentos que el agente no debe leer. Las reglas de denegación de Claude Code y los archivos de exclusión de Cursor bloquean las herramientas de archivos integradas. Aun así, ambos fabricantes advierten que algunos comandos de terminal pueden leer esos archivos: consulta los permisos de Claude Code y los archivos de exclusión de Cursor.
• Trata los documentos de otras personas como datos no fiables: pueden contener texto escrito para dirigir a un agente. Revisa los comandos y los cambios que propone el agente.