noirdoc
WebsiteFree
noirdoc은 LLM에 도달하기 전에 민감한 데이터를 자동으로 가명화하고(예: Claude Code 플러그인을 통해), 가역적 매핑을 머신에 유지하며, 모델 출력을 원래 값으로 복원하는 오픈 소스 로컬 실행 PII 보호 도구입니다.
https://www.noirdoc.de/en/launch?ref=producthunt&utm_source=aipure
제품 정보
업데이트됨:May 18, 2026
noirdoc이란?
noirdoc은 개인 식별 정보(PII)가 LLM의 컨텍스트에 유입되는 것을 방지하도록 설계된 개인 정보 보호 도구입니다. Claude가 파일을 읽기 전에 로컬에서 파일을 수정하는 Claude Code PreToolUse 훅/플러그인을 제공하여 실제 이름과 식별자가 기록에 나타나지 않도록 합니다. 동일한 수정 엔진은 더 광범위한 LLM 워크플로우를 위한 CLI로도 제공되며, OpenAI, Anthropic 또는 Azure와 같은 공급자를 사용하는 팀을 위한 호스팅 프록시 옵션으로도 제공됩니다. 오픈 소스이며 MIT 라이선스가 적용되며, 탐지 및 매핑은 로컬에서 처리됩니다.
noirdoc의 주요 기능
Noirdoc은 오픈 소스 PII 보호 도구로, LLM에 도달하기 전에 민감한 콘텐츠(예: 이름, 날짜, 도시, ID, IBAN)를 로컬에서 가명화하여 실제 값이 모델의 컨텍스트에 노출되지 않도록 합니다. 읽기 시 보호된 파일을 자동으로 수정하고 나중에 응답을 복원하는 Claude Code 플러그인과 더 광범위한 LLM 워크플로우를 위한 CLI 형태의 동일한 수정 엔진, 그리고 OpenAI/Anthropic/Azure API 트래픽을 위한 호스팅 프록시 옵션을 제공합니다. 매핑은 사용자 기기에 유지되며, 원본은 사용자 터미널에서만 공개될 수 있어 기록 및 공유 로그를 깨끗하게 유지합니다.
로컬, 가역적 가명화: PII를 장치에서 감지하고 자리 표시자로 대체하며, 원본을 LLM에 노출하지 않고 복원할 수 있도록 가역적 매핑을 로컬에 유지합니다.
자동 복원 기능이 있는 Claude Code 플러그인: Claude가 파일을 읽기 전에 보호된 파일을 수정하고 나중에 모델의 응답을 자동으로 복원하는 PreToolUse 후크 역할을 합니다.
파일 액세스 시 핸즈프리 자동 수정: Claude Code에서 보호된 파일이 열리거나 읽히는 즉시 noirdoc은 민감한 값을 기기에서 벗어나기 전에 로컬에서 대체합니다.
경로 기반 보호 규칙 (글로브 패턴): 글로브 규칙(예: ./incoming/**, *.contract.*)을 사용하여 보호할 파일/폴더를 정의하고 다른 콘텐츠는 그대로 둡니다.
로컬 캐시 및 매핑 저장소: 가명화된 사본을 로컬 .noirdoc/cache/ 디렉토리에 저장하고 매핑을 기기에 유지합니다. 감지를 위해 API 호출이 필요하지 않습니다.
다중 진입점: 플러그인, CLI, 호스팅 프록시: IDE 워크플로우를 위해 Claude Code 플러그인을 사용하고, 로컬 문서 및 파이프라인을 위해 CLI를 사용하거나, 팀 전체 LLM API 호출(OpenAI/Anthropic/Azure)을 보호하기 위해 호스팅 프록시를 사용합니다.
noirdoc의 사용 사례
법률 및 계약 검토: LLM을 사용하여 계약을 요약하거나, 조항을 초안하거나, 의무를 추출하기 전에 클라이언트 이름, 주소 및 계약 식별자를 가명화하여 PII가 채팅 로그에 유출되는 것을 방지합니다.
의료 문서 워크플로우: 방문 요약, 코딩 제안 또는 내부 메모를 생성하는 동안 환자 식별자 및 날짜를 수정하여 민감한 데이터가 모델 컨텍스트 및 기록에 노출되지 않도록 합니다.
금융 및 회계 지원: LLM을 사용하여 조정, 보고서 초안 또는 지원 응답을 수행하는 동안 IBAN, 고객 이름 및 거래 참조를 보호합니다.
고객 지원 및 CRM 티켓 처리: LLM에 회신 초안을 작성하거나 문제를 분류하도록 요청하기 전에 수신 티켓 또는 첨부 파일(예: ID, 이름)의 개인 정보를 자동으로 수정합니다.
실제 사용자 데이터를 다루는 엔지니어링 팀: 개발자가 Claude Code를 사용하여 로그, 디버그 보고서 또는 사용자 제출 파일을 검사할 때 프로덕션 데이터(사용자 이름, 식별자)의 우발적인 노출을 방지합니다.
프록시를 통한 엔터프라이즈 LLM 거버넌스: 호스팅된 프록시를 통해 조직 전체의 LLM API 호출을 라우팅하여 OpenAI/Anthropic/Azure를 사용하는 도구 및 팀 전반에 걸쳐 민감한 필드를 일관되게 가명화합니다.
장점
데이터가 전송되기 전에 로컬에서 수정하여 실제 PII가 LLM 컨텍스트에 노출되지 않도록 합니다.
가역적 워크플로우: 기록은 깨끗하게 유지하면서 원본은 사용자 터미널에서 공개될 수 있습니다.
워크플로우 요구 사항에 따라 Claude Code 플러그인, CLI 또는 호스팅 프록시를 통해 유연하게 채택할 수 있습니다.
오픈 소스(MIT 라이선스) 구성 요소 및 로컬 전용 매핑 저장소는 투명성과 제어를 향상시킵니다.
단점
효과성은 감지 범위에 따라 달라집니다. 일반적이지 않은 형식이나 예외적인 식별자는 튜닝이 필요하거나 누락될 수 있습니다.
로컬에 저장된 가역적 매핑은 보안 책임(접근 제어, 백업, 장치 손상)이 될 수 있습니다.
경로/글로브 기반 보호는 올바른 구성이 필요합니다. 잘못 구성된 규칙은 민감한 파일을 수정하지 않은 상태로 둘 수 있습니다.
noirdoc 사용 방법
1) noirdoc 설치 (CLI 엔진): 공식 사이트에 설명된 대로 pip를 통해 머신에 noirdoc을 설치합니다. 설치 후 Python 또는 셸에서 직접 실행할 수 있습니다.
2) (선택 사항) Claude Code 플러그인 설치: noirdoc 시작 페이지에서 "플러그인 설치" 링크를 사용하여 오픈 소스 Claude Code 플러그인(MIT 라이선스)을 설치합니다. 이렇게 하면 Claude가 보호된 파일을 읽기 전에 자동 로컬 가명화가 가능해집니다.
3) 보호할 파일 선택 (경로 규칙): 자동으로 가명화할 대상을 결정하기 위해 glob 기반 경로 규칙을 구성합니다(예: "./incoming/**" 또는 "*.contract.*"). 이 규칙과 일치하는 파일은 콘텐츠가 Claude에 도달하기 전에 로컬에서 수정됩니다.
4) Claude Code를 정상적으로 사용; noirdoc은 보호된 파일을 자동으로 수정합니다: Claude Code에서 보호된 파일을 열거나 읽을 때 플러그인은 Claude가 보기 전에 민감한 데이터(예: 이름, IBAN, ID)를 로컬에서 자리 표시자로 대체합니다. 자리 표시자 예시에는 "<<PERSON_1>>", "<<DATE_1>>", "<<CITY_1>>"과 같은 토큰이 포함됩니다.
5) 데이터가 로컬에 저장되는 위치 이해: 가명화된 사본은 ".noirdoc/cache/"에 저장되며 가역적 매핑은 머신에 유지됩니다. 탐지는 로컬에서 실행되며 API 호출은 전송되지 않습니다(noirdoc 팀 포함).
6) 원본은 자신의 터미널에서만 표시 (Claude 기록에서는 절대 표시 안 함): 실제 값을 봐야 할 때 셸에서 "noirdoc reveal"을 실행합니다. 이렇게 하면 Claude 외부에서 원본이 표시되어 Claude 대화에 실제 개인 데이터가 포함되지 않습니다.
7) Claude Code 외부에서 noirdoc 사용 (CLI 워크플로우): noirdoc CLI를 사용하여 모든 LLM 워크플로우(Claude Code뿐만 아니라)에 대한 로컬 문서를 가명화합니다. 동일한 로컬 탐지 및 가역적 매핑 접근 방식이 적용됩니다.
8) (팀 옵션) API 호출을 위한 호스팅 프록시 사용: 팀에서 모든 API 호출(OpenAI / Anthropic / Azure)을 보호하려면 사이트에 언급된 호스팅 프록시 서비스를 사용하거나 공급업체에 프록시/자체 호스팅 옵션에 대해 문의하십시오.
noirdoc 자주 묻는 질문
Noirdoc은 LLM이 읽기 전에 민감한 데이터(예: 실제 이름, IBAN, ID)를 가명 처리/수정하여 실제 값이 모델의 컨텍스트에 들어가지 않도록 하는 PII 보호 도구입니다.
