Noirdoc

Что такое Noirdoc?

Noirdoc — open-source «PII guard» для Claude Code, который анонимизирует чувствительные данные перед передачей в Claude, а затем восстанавливает оригинальные значения под вашим контролем. Основная цель — предотвратить попадание реальных имён, email, IBAN и других обнаруженных идентификаторов в контекст Claude Code во время работы.

На странице также описан тот же подход через другие точки входа: локальный CLI для редактирования документов в любом LLM-воркфлоу и hosted proxy, который очищает API-вызовы для OpenAI, Anthropic и Azure.

Ключевые возможности

• PreToolUse-редактирование для Claude Code: Хук редактирует защищённые файлы перед чтением Claude Code, чтобы реальные значения не попали в контекст Claude.
• Локальное обнаружение и обработка: Обнаружение и анонимизация выполняются на вашей машине; на странице указано, что ни один API-вызов не покидает вашу машину «даже не к нам».
• Обратимое сопоставление с локальным раскрытием: Анонимизированные выходы восстанавливаются автоматически после обработки; выполните noirdoc reveal, чтобы просмотреть оригиналы в своём терминале.
• Настраиваемая защита через правила путей: Glob-шаблоны (например, ./incoming/** или *.contract.*) определяют, какие файлы анонимизировать; остальное остаётся нетронутым.
• Локальное хранение сопоставлений: Плагин сохраняет анонимизированные копии в .noirdoc/cache/ и хранит обратимое сопоставление локально (поведение зависит от режимов «one-shot» vs «persistent» в примерах CLI).

Как использовать Noirdoc

• Установка плагина Claude Code

  1. Добавьте в marketplace Claude Code: /plugin marketplace add nextaim-de/noirdoc-claude-plugin
  2. Установите внутри Claude Code: /plugin install noirdoc@nextaim
  3. Откройте или прочитайте защищённый файл в Claude Code; плагин отредактирует обнаруженные элементы перед передачей Claude.

• Раскрытие оригиналов локально после воркфлоу

  • В своём shell выполните noirdoc reveal, чтобы просмотреть оригинальные значения. На странице подчёркивается, что раскрытие происходит вне транскрипта Claude Code.

• Использование CLI для локальных воркфлоу с документами

  • Установка: pip install noirdoc
  • Пример one-shot round trip: отредактируйте файл в очищенный выход, затем раскройте обратно с использованием выходного файла.
  • Пример persistent-режима использует namespace, чтобы сопоставление можно было переиспользовать между командами.

Сценарии использования

• Работа с документами, содержащими личные или учётные идентификаторы в Claude Code: Защищайте файлы с реальными именами, email, IBAN или ID, чтобы Claude Code получал плейсхолдеры вместо оригиналов.
• Пакетная обработка входящих контрактов или документов: Используйте правила путей/glob для анонимизации только определённых папок (например, incoming) или типов файлов (например, *.contract.*), не трогая остальное.
• Контролируемый просмотр восстановленных ответов: Держите разговор «чистым» в Claude Code, затем выполните noirdoc reveal в своём терминале, чтобы получить оригиналы по необходимости.
• Интеграция редактирования в не-Claude LLM-воркфлоу через CLI: Используйте noirdoc для локальной обработки PDF, DOCX и plain text, затем переводите ответы обратно с一致ными плейсхолдерами.
• Очистка LLM API-запросов для команд: Используйте hosted proxy (или self-hosted версию по странице) для scrubbing каждого OpenAI/Anthropic/Azure API-вызова с двухстрочной интеграцией.

FAQ

• Отправляет ли Noirdoc мои данные третьей стороне? На странице указано, что обнаружение локальное и ни один API-вызов не покидает вашу машину «даже не к нам».

• Как обрабатываются чувствительные значения во время работы Claude Code? Плагин анонимизирует входы локально перед передачей Claude Code, заменяя имена, IBAN и ID на плейсхолдеры.

• Могу ли я восстановить оригинальные значения? Да. Плагин автоматически восстанавливает ответы, и вы можете раскрыть оригиналы командой noirdoc reveal в своём терминале (вне транскрипта Claude Code).

• Как выбрать, какие файлы защищать? На странице описаны правила путей с glob-шаблонами для автоматической анонимизации файлов.

• Есть ли несколько способов использовать Noirdoc? Да: на странице описаны три точки входа — плагин Claude Code, локальный CLI для общих воркфлоу с документами и hosted proxy (с опцией self-host) для API-вызовов.

Альтернативы

• Ручная предобработка документов (редактирование перед запросом): Вы можете сами отредактировать чувствительные поля перед отправкой текста в LLM, но вам придётся вручную управлять согласованностью заполнителей и их восстановлением.
• Общие инструменты предотвращения утечек данных (DLP) или фильтрации контента: Они помогают предотвратить передачу чувствительных данных, но могут не обеспечивать обратимое сопоставление заполнителей и восстановление ответов, адаптированное под рабочие процессы Claude Code.
• Другие промежуточные слои «маскировки PII» для LLM: Альтернативы в этой категории обычно маскируют чувствительные строки перед запросами; сравните, как они интегрируются (плагин vs прокси vs middleware) и поддерживают ли обратимые сопоставления и локальные рабочие процессы.
• Самостоятельно размещённые прокси-решения для API LLM: Если основная потребность — очистка API, прокси-подход централизует контроль, в то время как плагин Claude Code фокусируется на локальной обработке внутри Claude Code.