pii-tokens

Dado pessoal fora do contexto do Claude.

Plugin do Claude Code. Troca CPF, CNPJ, email e telefone por tokens antes de o Claude ler.

Mesmo valor, mesmo token: o Claude ainda conta, cruza e compara.
O valor real fica num cofre cifrado na sua máquina.

Reduz o vazamento por descuido, não o elimina. Antes de usar com dado real, leia os limites.

Onde	Status	Fica de fora
Claude Code (terminal, IDE)	✅ Completo	os limites
Claude Desktop, modo Code	✅ Completo (testado no Windows)	os limites
Claude Desktop, modo chat	🟡 O que um MCP devolve, pela extensão (testada no Windows)	o que você cola ou anexa
claude.ai	❌ Sem suporte	tudo

O Claude lê um CSV com nome, CPF e email e recebe tokens; um CPF colado na mensagem é barrado

Read in English

Instalar

/plugin marketplace add oLucasAguilar/pii-tokens
/plugin install pii-tokens@pii-tokens

Reinicie o Claude Code.
Peça: "roda o pii-selfcheck". Tem de terminar em all good.

Requer Python 3.10+. No Windows, também o Git for Windows.
Imagem só é mascarada com o tesseract instalado; sem ele, passa com aviso:

apt install tesseract-ocr   # ou: brew install tesseract
# Windows: instalador em github.com/UB-Mannheim/tesseract

Na prática

Consulta ao banco

O valor real só é usado com a sua confirmação.

A consulta traz razão social e CNPJ e o Claude recebe tokens; o pii-exec pede confirmação antes de usar o valor real

Texto num arquivo, como uma anotação ou um email

- CPF <CPF real>, contato <email real>. Falou com a Maria.
+ CPF CPF#3f1a9c0d22e4, contato EMAIL#91bd0e4a7c13. Falou com a Maria.

Nome solto no texto passa: troque por um apelido, ou ponha o nome na lista de termos.

Ferramentas do Claude, como Jira, Notion, um CRM ou uma API interna

Você escolhe que campo fica legível.

  titulo: "Erro no login"            responsável: "Colega do Time"
- cliente: "Acme Comercio Ltda"
+ cliente: "NAME#25aaae7143ac"

Imagem

Uma imagem com CNPJ colada na mensagem é barrada; o Claude lê o arquivo e recebe o token no lugar do CNPJ

O hook lê o texto da imagem antes de o Claude ver.

CPF, CNPJ, email e telefone recebem o token desenhado por cima.
Print colado com CPF, email ou telefone:
1. A mensagem é barrada, e o pedido para ler o print já vai para o Ctrl+V.
2. Aperte Ctrl+V e Enter.
3. O Claude lê o print com os dados trocados por tokens.
Print salvo num arquivo: peça ao Claude para ler o arquivo, e ele já chega com tokens.
Sem o tesseract, a imagem passa, com aviso.

Precisa do valor real

pii-exec -- grep CPF#3f1a9c0d22e4 app.log   # usa o CPF real; a saída volta mascarada
pii-reveal relatorio.md                     # abre a versão real no seu editor, longe do Claude

Comandos e configurações: docs/usage.md.

Claude Desktop

No chat do Desktop, hook não roda. Para um servidor MCP ali, use a extensão do Desktop, que mascara só o que o servidor devolve: docs/desktop.md.

O que é mascarado

Um CPF e um email viram token

Dado	Token
CPF e CNPJ (com dígito verificador válido)	`CPF#`, `CNPJ#`
Email, fora dos domínios que você liberar	`EMAIL#`
Telefone brasileiro	`PHONE#`
Colunas de nome, contato e documento (tabela, CSV, JSON)	`NAME#`, `CONTACT#`, `DOC#`
Termos que você listar, como o nome de um cliente	`TERM#`
IP, se você ligar a opção	`IP#`

Limites

Protege contra vazamento por descuido, não contra um modelo decidido a extrair o dado.
O que o detector não reconhece passa como está: revise antes de enviar dado sensível.

Passam sem máscara:

nome em texto livre, fora da lista de termos;
comando que falha e comando com !;
chave, senha e token de API (o plugin cuida de dado pessoal).

Também:

Em imagem, o OCR acha quase todo CPF e CNPJ, não todos.
O token é pseudônimo, não anônimo.

Lista completa, antes de usar com dado real: docs/limits.md.

E os outros?

Em 22/10/2026 não achamos outro plugin que:

troque o dado por token reversível;
entenda documento brasileiro;
rode dentro do Claude Code.

Comparação: docs/alternativas.md.