Guia de campo do Claude Code em português

Renomear os PDFs de uma pasta pelo que está escrito neles

Cada PDF da pasta (nota, boleto, contrato, recibo) sai renomeado como AAAA-MM-DD_cliente_tipo.pdf, com a lista do antes e depois em renomeados.csv e um desfazer.ps1 que volta os nomes antigos. É a receita 10 do guia (p. 124), testada duas vezes no Windows 11, sem tela (claude -p) e com as licenças dadas de antemão: a sessão em que você aprova cada passo não foi ensaiada.

O que você precisa

O Claude Code instalado, com login (p. 8 e p. 10).
PDFs com texto, de até 10 páginas. Até aí o Claude lê o PDF sem programa extra. Acima disso, a leitura por partes pede o pdftoppm, que o Windows não traz, e o erro é pdftoppm is not installed: renomeie esses à mão (p. 124).
Escaneado curto ele lê como imagem, sem programa extra, mas erra mais: confira todos.

1. Pasta de cópia e modo Manual

Como em toda receita do guia (p. 114): copie os PDFs para uma pasta nova, abra o Claude Code nela com claude --permission-mode default e deixe o original fora. No Manual, ler é livre; renomear, criar arquivo e rodar comando passam por você.

PowerShell

$d = [Environment]::GetFolderPath('Desktop')
New-Item -ItemType Directory "$d\pdfs-renomear"
Copy-Item "$HOME\Downloads\*.pdf" "$d\pdfs-renomear\"
cd "$d\pdfs-renomear"
claude --permission-mode default

2. Cole o pedido

O texto é o da página 124. Repare em duas regras: ele para antes de renomear e mostra a tabela; e grava um desfazer que você consegue ler, uma linha por arquivo.

Pedido para colar no Claude Code

Na pasta atual há vários arquivos PDF (notas, boletos, contratos, recibos).
Renomeie cada um no padrão AAAA-MM-DD_cliente_tipo.pdf.
Regras:
- Leia cada PDF para achar a data do documento, o nome do cliente ou fornecedor e o tipo (nota, boleto, contrato, recibo).
- No nome novo, use só letras sem acento, números e hífen; cliente em minúsculas, com hífen no lugar do espaço.
- Antes de renomear, me mostre a tabela: nome atual -> nome novo, e pare: só renomeie depois que eu responder.
- Se não achar a data ou o cliente num arquivo, não invente: deixe esse arquivo com o nome atual e me diga qual foi.
- Grave a lista do antes e depois em renomeados.csv e crie desfazer.ps1, que volta os nomes antigos: uma linha Rename-Item -LiteralPath por arquivo, sem laço, para eu poder ler. Grave o desfazer.ps1 em UTF-8 com BOM, para não estragar nome com acento.
- Use o PowerShell. Não instale nada.

3. O que vai aparecer

Ele abre os PDFs um a um (ler não pede licença).
Mostra a tabela, avisa quais ficaram de fora e para. Confira e responda "Pode renomear".
Pede licença para criar os dois arquivos e para renomear.

4. Confira

Abra dois ou três PDFs e confira se a data e o cliente do nome batem com o documento.
Conte antes e depois com (Get-ChildItem *.pdf).Count: o número é o mesmo.
Rode o desfazer uma vez no ensaio: desfazer que nunca rodou não é desfazer (p. 114).

PowerShell: voltar os nomes antigos

powershell -ExecutionPolicy Bypass -File .\desfazer.ps1

Cuidado medido no teste. Num dos ensaios do livro, um nome saiu com a data errada, e a tabela e o desfazer.ps1 concordavam com ela. Conferir que os três combinam não basta: abra o PDF.

Quando der errado, o que dizer

Sintoma	O que dizer
Data ou cliente que não está no PDF	"No arquivo X a data não está escrita; deixe o nome atual."
Dois ficariam com o mesmo nome	"Acrescente -2 no fim do segundo; não sobrescreva."
Quer instalar programa de PDF	"Não instale nada; deixe com o nome atual os que não ler."

O mesmo molde serve para o resto da pasta

O capítulo 13 do guia tem mais três receitas de PDF (juntar na ordem de uma lista, separar um escaneado por documento, tirar a tabela de um PDF para o Excel) e três de pastas (organizar a Downloads, achar duplicados sem apagar nada, arquivar por cliente e por mês). Toda receita que mexe em nome ou lugar mostra a tabela antes, para, e grava um desfazer.ps1 (p. 114).