Agent Redactor와 함께 Claude Code 사용하기

사전 요구 사항: 설치 Agent Redactor 실행 중이어야 합니다. Claude Code가 설치되어 PATH에서 사용 가능해야 합니다.
  1. Agent Redactor 구성(먼저 이 작업을 수행)

    Claude Code를 설정하기 전에 로컬 편집 프록시를 실행하여 Claude Code가 이를 통해 연결할 수 있도록 하세요. Profiles 사이드바에서 프로필을 선택하거나 만듭니다. Local URL을 http://localhost:8080/(또는 원하는 포트)로, Forward To를 실제 공급자 엔드포인트(예: https://openrouter.ai/api/)로 설정하고 실제 API Key를 붙여넣으세요. 키는 로컬에서 암호화되며 기기를 절대 떠나지 않습니다. Save All Settings를 클릭하고 포트가 사용 가능으로 표시되는지 확인하세요.

  2. 편집 규칙 선택

    기기에서 무언가 나가기 전에 무엇을 편집할지 결정하세요. AI Powered Detection Model을 활성화하고 검출할 PII 범주를 선택하거나, 결정적 일치를 위해 Regex Patterns와 Keywords를 추가하거나, 셋 중 임의의 조합을 사용할 수 있습니다. 선택은 사용자에게 달려 있습니다. Regex와 Keywords는 AI 모델이 놓칠 수 있는 프로젝트별 비밀에도 이상적입니다.

  3. Claude Code를 Agent Redactor에 연결(영구)

    Claude Code는 설정 파일에서 환경 변수를 읽습니다. Windows에서는 C:\Users\<you>\.claude\settings.json(다른 OS에서는 ~/.claude/settings.json)의 사용자 설정 파일을 열고 기존 설정을 유지한 채 다음 env 블록을 추가하세요:

    {
      "env": {
        "ANTHROPIC_BASE_URL": "http://localhost:8080/",
        "ANTHROPIC_AUTH_TOKEN": "dummy-key-to-bypass-login",
        "ANTHROPIC_MODEL": "anthropic/claude-haiku-4.5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-haiku-4.5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-haiku-4.5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
        "ANTHROPIC_DEFAULT_FABLE_MODEL": "anthropic/claude-haiku-4.5",
        "CLAUDE_CODE_SUBAGENT_MODEL": "anthropic/claude-haiku-4.5",
        "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1048576",
        "CLAUDE_CODE_EFFORT_LEVEL": "max"
      }
    }
    • ANTHROPIC_BASE_URL: Agent Redactor의 Local URL과 정확히 일치해야 합니다.
    • ANTHROPIC_AUTH_TOKEN: 임의의 플레이스홀더 값이 작동합니다. Agent Redactor가 이미 실제 API 키를 안전하게 보유하고 업스트림에 주입합니다.
    • ANTHROPIC_MODEL 및 모델 재정의: anthropic/claude-haiku-4.5를 공급자의 정확한 모델 이름으로 바꾸세요. 모두 설정하면 Claude Code, 하위 에이전트, 백그라운드 작업이 모두 동일한 모델을 사용하도록 보장합니다.

    theme 또는 autoUpdatesChannel와 같은 파일의 다른 항목은 관련이 없으므로 그대로 두세요.

  4. 대안: 임시 세션 변수

    설정 파일을 건드리고 싶지 않은 경우(예: 프록시를 한 번 테스트) 대신 터미널에서 변수를 설정하세요. 현재 터미널 세션 동안만 유지됩니다.

    PowerShell (Windows):

    $env:ANTHROPIC_BASE_URL = "http://localhost:8080/"
    $env:ANTHROPIC_AUTH_TOKEN = "dummy-key-to-bypass-login"
    $env:ANTHROPIC_MODEL = "anthropic/claude-haiku-4.5"
    $env:ANTHROPIC_DEFAULT_OPUS_MODEL = "anthropic/claude-haiku-4.5"
    $env:ANTHROPIC_DEFAULT_SONNET_MODEL = "anthropic/claude-haiku-4.5"
    $env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "anthropic/claude-haiku-4.5"
    $env:ANTHROPIC_DEFAULT_FABLE_MODEL = "anthropic/claude-haiku-4.5"
    $env:CLAUDE_CODE_SUBAGENT_MODEL = "anthropic/claude-haiku-4.5"
    $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW = "1048576"
    $env:CLAUDE_CODE_EFFORT_LEVEL = "max"

    bash (Linux):

    export ANTHROPIC_BASE_URL="http://localhost:8080/"
    export ANTHROPIC_AUTH_TOKEN="dummy-key-to-bypass-login"
    export ANTHROPIC_MODEL="anthropic/claude-haiku-4.5"
    export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-haiku-4.5"
    export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-haiku-4.5"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"
    export ANTHROPIC_DEFAULT_FABLE_MODEL="anthropic/claude-haiku-4.5"
    export CLAUDE_CODE_SUBAGENT_MODEL="anthropic/claude-haiku-4.5"
    export CLAUDE_CODE_AUTO_COMPACT_WINDOW="1048576"
    export CLAUDE_CODE_EFFORT_LEVEL="max"

    터미널을 닫으면 변수가 사라지고 Claude Code가 일반 구성으로 돌아갑니다.

  5. Claude Code 시작 및 안전하게 작업

    새 터미널을 열어(새 설정을 적용하도록) Claude Code를 시작하세요:

    claude

    환영 화면에 선택한 모델이 API 사용 요금으로 실행 중으로 표시되어야 합니다. 이제 모든 나가는 요청은 인터넷에 닿기 전에 Agent Redactor를 통해 로컬로 필터링됩니다. 아래 예시에서 모델은 프롬프트가 도착하기 전에 이름이 편집되었음을 알 수 있습니다.

    Claude Code 세션에서 모델이 사용자 이름이 시스템 메시지에서 편집되었으며 읽을 수 없다고 답변하는 모습
    프록시를 통해 실행 중인 Claude Code. 모델은 실제 이름 대신 편집된 플레이스홀더를 받았습니다.

편집 확인

정확히 무엇이 가로채어졌는지 확인하려면 Agent Redactor의 Session Redactions 패널을 확인하세요.

Agent Redactor가 Statistics 패널을 표시: Requests: 1, PII: 2 및 Session Redactions에 private_person Bob을 포함한 가로채어진 PII 목록
Statistics 패널에 "Requests: 1, PII: 2"가 표시되고 Session Redactions에는 타임스탬프와 유형이 포함된 가로채어진 값들이 나염됩니다.
팁: 프로필에서 Regex Patterns와 Keywords를 사용하여 AI 모델이 놓칠 수 있는 프로젝트별 비밀(낶부 호스트명, 독점 ID, 프로젝트 코드명 등)을 포착하세요.