Claude Code & Werkzeuge.

Verbinde Claude Code mit dem Noirdoc-Gateway oder maskiere lokale Dateien und Pfade direkt auf deinem Rechner mit dem Claude-Code-Plugin und der noirdoc-CLI.

Claude Code über das Gateway.

Setze ANTHROPIC_BASE_URL auf https://api.noirdoc.de (ohne /v1) und ANTHROPIC_AUTH_TOKEN auf deinen px--Schlüssel; wähle über ANTHROPIC_MODEL ein Claude-Modell aus GET /v1/models wie claude-sonnet-5-5 (Claude Code ist auf Claude-Modelle ausgelegt und unterstützt keine anderen Modelle über ein Gateway). Noirdoc Shield schaltest du über ANTHROPIC_CUSTOM_HEADERS oder direkt am API-Schlüssel (shield_mode auf Aktiv) ein.

Claude Code starten
export ANTHROPIC_BASE_URL="https://api.noirdoc.de"
export ANTHROPIC_AUTH_TOKEN="$NOIRDOC_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
export ANTHROPIC_CUSTOM_HEADERS="X-Noirdoc-Shield: on"
claude
UmgebungsvariableWirkung
ANTHROPIC_BASE_URLBasis-URL https://api.noirdoc.de ohne /v1 (Claude Code ergänzt /v1/messages selbst).
ANTHROPIC_AUTH_TOKENSendet deinen px--Schlüssel als Authorization: Bearer. Nicht gleichzeitig mit ANTHROPIC_API_KEY setzen.
ANTHROPIC_API_KEYAlternative zu ANTHROPIC_AUTH_TOKEN; sendet den px--Schlüssel als x-api-key (nur eine der beiden Variablen setzen).
ANTHROPIC_MODELClaude-Modell-ID aus GET /v1/models (z. B. claude-sonnet-5-5 oder claude-haiku-4-5).
ANTHROPIC_CUSTOM_HEADERSZusätzliche Header, ein Paar Name: Wert pro Zeile (etwa X-Noirdoc-Shield: on oder X-Noirdoc-Tags: ...).

Token-Zählung vorab: Claude Code zählt den Kontext vorab über POST /v1/messages/count_tokens. Dieser Aufruf überspringt Noirdoc Shield und kostet 0 € (auf Google Vertex AI leitet das Gateway an die Zählmethode von Vertex weiter; siehe Messages), während alle POST /v1/messages-Anfragen bei aktivem Shield geprüft werden.

Lokales Claude-Code-Plugin.

Das quelloffene Claude-Code-Plugin (MIT-Lizenz, unabhängig vom Gateway nutzbar) verbindet die lokale noirdoc-CLI direkt mit Claude Code. Das Plugin fängt Lesezugriffe auf geschützte Pfade ab, übergibt Claude nur eine lokal mit Platzhaltern wie <<PERSON_1>> maskierte Kopie und speichert Antworten mit Platzhaltern; die Originalwerte setzt du anschließend in deinem eigenen Terminal außerhalb von Claude Code wieder ein.

Claude Code
/plugin marketplace add nextaim-de/noirdoc-claude-plugin
/plugin install noirdoc@nextaim
/noirdoc:noirdoc-setup

Quellcode, Pfadregeln und Befehle stehen im Repository github.com/nextaim-de/noirdoc-claude-plugin.

noirdoc-CLI für Dokumente.

Das Python-Paket noirdoc (MIT-Lizenz) ersetzt personenbezogene Daten in PDF-, DOCX-, XLSX- und Textdateien lokal auf deinem Rechner durch konsistente Platzhalter wie <<PERSON_1>>. Über --namespace bleiben Platzhalter dateiübergreifend identisch, und noirdoc reveal setzt die Originalwerte lokal wieder ein. Die CLI eignet sich damit gezielt für Binärdokumente (PDF, DOCX, XLSX) vor dem Versand oder für lokale reversible Pseudonymisierung, während Noirdoc Shield im Gateway eingehende Texte zustandslos ohne gespeicherte Zuordnungen schwärzt.

noirdoc CLI
pip install "noirdoc[full]"
noirdoc redact --namespace mandant-mueller \
  brief.docx -o brief-maskiert.docx
noirdoc reveal --namespace mandant-mueller \
  brief-maskiert.docx -o brief.docx

Quellcode, unterstützte Formate und Optionen beschreibt github.com/noirdoc-ai/mask-engine.