Noirdoc

Noirdoc とは？

Noirdoc は Claude Code 用のオープンソース「PII ガード」で、Claude に到達する前に機密データを仮名化し、ユーザー制御下で元の値を復元します。主な目的は、実在の名前、メール、IBAN、その他の検出された識別子が Claude Code のコンテキストに入らないようにすることです。

このページでは、同じアプローチを他のエントリーポイントで提供：任意の LLM ワークフロー向けローカル CLI でドキュメントを伏せ字化、OpenAI、Anthropic、Azure の API コールを洗浄するホスト型プロキシ。

主な機能

• Claude Code 向け PreToolUse 伏せ字化: フックが保護ファイルを Claude Code が読み込む前に伏せ字化するため、実値が Claude のコンテキストに入りません。
• ローカル検出と処理: 検出と仮名化はあなたのマシン上で実行；ページでは「私たちにも一切 API コールが送信されません」と明記。
• ローカル復元付き可逆マッピング: 処理後に仮名化出力が自動復元；noirdoc reveal で自分のターミナルで原値を表示。
• パスルールによる保護設定: Glob パターン（例: ./incoming/** や *.contract.*）で伏せ字化対象ファイルを指定；それ以外は変更なし。
• マッピングのローカル保存: プラグインは .noirdoc/cache/ に仮名化コピーを保持し、可逆マッピングをローカルに保存（CLI 例の「one-shot」対「persistent」モードで動作が異なる）。

Noirdoc の使い方

• Claude Code プラグインのインストール

  1. Claude Code マーケットプレイスに追加: /plugin marketplace add nextaim-de/noirdoc-claude-plugin
  2. Claude Code 内でインストール: /plugin install noirdoc@nextaim
  3. Claude Code で保護ファイルを開くか読み込み；プラグインが Claude が閲覧前に検出項目を伏せ字化。

• ワークフロー後にローカルで原値を表示

  • 自分のシェルで noirdoc reveal を実行して原値を表示。ページでは Claude Code トランスクリプト外で復元すると強調。

• ローカルドキュメントワークフロー向け CLI 利用

  • インストール: pip install noirdoc
  • ワンショット例: ファイルをクリーン出力に伏せ字化後、出力ファイルを使って復元。
  • 永続モード例: 名前空間を使ってコマンド間でマッピングを再利用。

ユースケース

• Claude Code で個人・口座識別子を含むドキュメント作業: 実名、メール、IBAN、ID を含むファイルを保護し、Claude Code にプレースホルダーを送信。
• 受信契約書や書類のバッチ伏せ字化: パス/glob ルールで特定フォルダ（例: incoming）やファイルタイプ（例: *.contract.*）のみ仮名化；他は変更なし。
• 復元回答の制御レビュー: Claude Code の会話を「クリーン」に保ち、必要時に自分のターミナルで noirdoc reveal を実行して原値回復。
• CLI 経由の非 Claude LLM ワークフロー統合: noirdoc で PDF、DOCX、プレーンテキストをローカル伏せ字化後、一貫プレースホルダーで応答復元。
• チーム向け LLM API リクエスト洗浄: ホスト型プロキシ（またはページ記載のセルフホスト版）を使い、OpenAI/Anthropic/Azure API コールすべてを2行統合で洗浄。

FAQ

• Noirdoc はデータを第三者に送信しますか？ ページでは検出がローカル実行で「私たちにも一切 API コールが送信されません」と明記。

• Claude Code 実行中に機密値はどう扱われますか？ プラグインが Claude Code に渡す前にローカルで入力仮名化；名前、IBAN、ID をプレースホルダーに置換。

• 原値を復元できますか？ はい。プラグインが応答を自動復元；自分のターミナル（Claude Code トランスクリプト外）で noirdoc reveal を実行。

• どのファイルを保護対象にしますか？ ページでは glob パターンを使ったパスルールで自動仮名化対象を決定。

• Noirdoc の使い方は複数ありますか？ はい: ページでは3つのエントリーポイントを記載—Claude Code プラグイン、一般ドキュメントワークフロー向けローカル CLI、API コール向けホスト型プロキシ（セルフホスト可）。

代替案

• ドキュメントの手動前処理（プロンプト前の伏せ字化）：LLMにテキストを送信する前に自分で機密フィールドを伏せ字化できますが、プレースホルダの一貫性と復元を手動で管理する必要があります。
• 汎用データ損失防止（DLP）またはコンテンツフィルタリングツール：これらは機密データの共有を防ぐのに役立ちますが、Claude Code のワークフローに最適化された可逆プレースホルダマッピングと応答復元を提供しない場合があります。
• 他のLLM「PIIマスキング」ミドルウェア：このカテゴリの代替案は通常リクエスト前に機密文字列をマスクします。統合方法（プラグイン vs プロキシ vs ミドルウェア）と可逆マッピングおよびローカルワークフローのサポートを比較してください。
• LLM API用のセルフホストプロキシソリューション：主なニーズがAPIの洗浄の場合、プロキシベースのアプローチで制御を一元化できます。一方、Claude Code プラグインはClaude Code 内部のローカル処理に焦点を当てています。