Entregue seus PDFs e arquivos Word ao Claude Code, ao Cursor e ao Codex

Em outubro de 2026, o Claude Code consegue ler um PDF por conta própria, o Cursor lê um PDF que você anexa ao chat, e o Codex CLI documenta entrada de imagens, mas não de PDFs. Nenhum dos três lista arquivos Word (DOCX) entre os formatos que lê diretamente. Para especificações, manuais, artigos e contratos que o agente vai usar mais de uma vez, converta-os em Markdown, mantenha as cópias no projeto e diga ao agente onde estão.

Este guia é para agentes de programação que trabalham em uma pasta de projeto. Se você está montando uma pasta separada de documentos de referência, e não um projeto de código, comece pelo nosso guia sobre como preparar documentos para agentes de IA.

O que cada agente lê diretamente

Isto é o que a documentação de cada fornecedor diz em outubro de 2026.

O Claude Code lê um PDF curto inteiro. Um PDF com mais de 10 páginas é lido em trechos de até 20 páginas por vez, e essas leituras precisam do programa pdftoppm do poppler. No Windows, você instala uma build do poppler por conta própria e a adiciona ao PATH; sem isso, a leitura falha. Os detalhes estão na referência de ferramentas do Claude Code.

O Cursor adicionou a leitura de PDF na versão 2.4, lançada em janeiro de 2026. A lista de ignorados padrão do Cursor ainda inclui arquivos PDF e vários formatos do Office, e a ajuda do Cursor diz que arquivos ignorados ficam bloqueados para o agente. Anexe o PDF ao chat você mesmo em vez de esperar que o agente o encontre no projeto.

O Codex CLI aceita imagens passadas na linha de comando ou coladas no prompt. A documentação dele não descreve entrada de PDF ou Word para o CLI.

Um agente ainda pode tentar extrair texto de um documento executando um programa instalado no seu computador. Às vezes funciona, mas você não vê qual texto ele obteve, e uma tabela mal lida vai direto para a resposta dele.

Por que uma cópia Markdown funciona melhor

Markdown é texto simples com títulos, listas e tabelas. Dentro de um projeto, isso dá quatro vantagens que um PDF ou um arquivo DOCX não oferece.

• O agente consegue pesquisar nele. Uma busca de texto encontra uma frase em um arquivo Markdown. Um arquivo DOCX é um arquivo ZIP de partes XML, então uma busca de texto simples não encontra nada dentro dele.
• O agente consegue citar linhas exatas, e você consegue encontrar cada frase citada no arquivo e ler o que vem em volta.
• O agente lê só o que precisa: ele pesquisa em um manual longo e depois abre a única seção que importa, em vez de percorrer as páginas.
• O Git mostra o que mudou. Quando chega uma nova edição de uma especificação, o diff lista as linhas alteradas.

Você também vê exatamente o que o agente lê. Se uma tabela saiu errada, você a corrige uma vez no arquivo Markdown, e todas as sessões seguintes usam a cópia corrigida.

Um PDF digitalizado sem camada de texto é só imagens de páginas. Ele precisa de OCR (reconhecimento de texto) antes que um agente possa pesquisar nele. O MD Factory reconhece texto em PDFs digitalizados no seu PC. Para conferir o resultado, veja nosso guia para converter PDFs digitalizados.

Coloque os documentos em uma pasta docs

Mantenha os originais e as cópias Markdown dentro do projeto, ao lado do código que depende deles:

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. Copie os arquivos PDF e Word para a pasta docs. O MD Factory salva cada arquivo Markdown ao lado do original, então é aí que as cópias vão aparecer.
2. No MD Factory, clique em Adicionar pasta e escolha a pasta docs, ou solte a pasta na janela. A conversão começa na hora.
3. Aguarde até que todos os arquivos mostrem um status: Concluído, Precisa de revisão ou Falhou.
4. Clique em Precisa de revisão ao lado de um arquivo para ver o que conferir e depois compare essa parte com o original.

As imagens de um documento vão para uma pasta com o nome dele, como partner-api-spec_images. Os próprios arquivos PDF e Word não são alterados.

Mantenha os originais no projeto. Números de página, figuras e o texto exato assinado estão lá, e você vai precisar deles sempre que a cópia e a resposta do agente divergirem.

Aponte os arquivos para o agente

Dê ao agente uma lista curta de documentos no arquivo de instruções dele. Claude Code lê o CLAUDE.md, ou o AGENTS.md quando o projeto não tem CLAUDE.md. Codex e Cursor leem o AGENTS.md. Por exemplo:

## Documentos de referência

As cópias Markdown dos arquivos PDF e Word estão em docs/.
O original de cada cópia fica ao lado dela.

- `docs/partner-api-spec.md`: especificação da API de parceiros, versão 3.2
- `docs/supplier-contract.md`: contrato com fornecedores, edição de 2026

Pesquise em docs/ antes de responder a perguntas sobre a API de parceiros ou o contrato.
Cite o título da seção em que você se baseou.
Não edite arquivos em docs/.

Escreva os caminhos entre crases, como acima, e não como @docs/partner-api-spec.md. No CLAUDE.md, um caminho com @ é uma importação: o Claude Code carrega o arquivo inteiro no início de cada sessão. Um caminho entre crases continua sendo uma simples menção, e o Claude abre o arquivo quando uma tarefa precisa dele.

Mantenha a lista curta. O Codex para de ler arquivos de instruções quando eles somam 32 KiB, o limite padrão dele.

Para uma tarefa isolada, mencione o arquivo no seu prompt:

• No Claude Code, digite @ e escolha o arquivo. O Claude Code adiciona o conteúdo à conversa se ele couber no limite de leitura, 25.000 tokens por padrão. Para um arquivo mais longo, peça ao Claude que pesquise nele primeiro.
• No Cursor, digite @ e escolha o arquivo ou a pasta docs inteira, como descrito na ajuda do Cursor.
• No Codex CLI, digite @ para inserir o caminho de um arquivo, ou use o comando /mention para anexar um arquivo, como descrito no guia de prompts do Codex.

Um prompt que nomeia o documento e pede citações pode ficar assim:

Leia as seções “Autenticação” e “Limites de requisições” de
docs/partner-api-spec.md. Atualize o cliente da API para segui-las.
Para cada mudança, cite a linha da especificação em que ela se baseia.

Confira as respostas e atualize as cópias

Antes de confiar em uma resposta, encontre você mesmo o trecho citado. Use o primeiro comando no PowerShell e o segundo no Git Bash:

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

Se a citação não estiver no arquivo Markdown, procure no original. Se também não estiver lá, o agente não a tirou do documento. Para números de página e figuras, abra sempre o original.

Fique atento ao seu arquivo .gitignore. A busca do Claude Code ignora arquivos do gitignore, embora o Claude ainda possa pesquisar ou ler um arquivo que você indique pelo caminho. O Cursor mantém os arquivos do gitignore longe do agente a menos que uma linha começando com ! no .cursorignore os traga de volta. Se os documentos precisam ficar fora do Git, liste o caminho de cada arquivo no arquivo de instruções do Claude Code e adicione esta linha ao .cursorignore para o Cursor: !docs/

Arquivos de referência só devem mudar quando você decidir. Olhe o diff depois de cada tarefa. Se você quer que o Claude Code deixe a pasta docs em paz, adicione uma regra de negação de Edit para ela.

Quando chegar uma nova edição, substitua o original na pasta docs, mantendo o mesmo nome de arquivo, e adicione-o ao MD Factory de novo. Se você não editou a cópia Markdown antiga, o MD Factory a substitui. Se editou, a nova cópia recebe um nome numerado, como partner-api-spec (2).md, e as suas edições ficam no arquivo antigo. Um diff do arquivo Markdown mostra então quais seções mudaram e qual código talvez precise acompanhar.

Documentos confidenciais: o que o agente envia

O MD Factory converte documentos no seu PC e não os envia, mas isso vale só para a conversão. Quando o agente lê a cópia Markdown, o texto vai para o provedor do modelo, como o resto do seu prompt.

• O Claude Code roda no seu computador, mas envia prompts e as saídas do modelo pela rede. Por quanto tempo a Anthropic guarda esses dados depende do tipo da sua conta e das suas configurações de privacidade: veja retenção de dados no Claude Code.
• O Cursor diz que, quando o agente abre um arquivo, o conteúdo dele pode ser incluído na requisição ao modelo.
• O Codex usa a OpenAI como provedor de modelo padrão.

Antes de um agente ler um documento confidencial:

• Converta e adicione apenas os documentos de que a tarefa precisa.
• Se um documento está coberto por um acordo de confidencialidade ou por um contrato com cliente, verifique se ele permite enviar o texto a um serviço de IA externo.
• Mantenha fora da pasta do projeto os documentos que o agente não deve ler. As regras de negação do Claude Code e os arquivos de ignorados do Cursor bloqueiam as ferramentas de arquivo integradas. Os dois fornecedores observam que alguns comandos de terminal ainda podem ler esses arquivos: veja Permissões do Claude Code e Arquivos de ignorados do Cursor.
• Trate documentos de outras pessoas como entrada não confiável: eles podem conter texto escrito para conduzir um agente. Revise os comandos e as edições que o agente propõe.