Usare Claude Code con Agent Redactor

Prerequisito: Installa Agent Redactor e lascialo in esecuzione. È inoltre necessario avere Claude Code installato e disponibile nel PATH.
  1. Configura Agent Redactor (fallo prima)

    Prima di configurare Claude Code, metti in funzione il proxy locale di redazione in modo che Claude Code possa connettersi attraverso di esso. Nella barra laterale Profiles, seleziona o crea un profilo. Imposta la Local URL su http://localhost:8080/ (o la porta preferita), Forward To sul vero endpoint del provider (es. https://openrouter.ai/api/) e incolla la tua vera API Key. La chiave è crittografata localmente e non lascia mai la tua macchina. Fai clic su Save All Settings e conferma che la porta risulti disponibile.

  2. Scegli le regole di redazione

    Decidi cosa viene redatto prima che qualcosa lasci la tua macchina. Puoi abilitare il AI Powered Detection Model e spuntare le categorie di PII che deve intercettare, aggiungere Regex Patterns e Keywords per corrispondenza deterministica, o usare qualsiasi combinazione dei tre. La scelta è tua. Regex e Keywords sono ideali anche per segreti specifici del progetto che il modello AI potrebbe perdere.

  3. Punta Claude Code su Agent Redactor (permanente)

    Claude Code legge le variabili d'ambiente dal suo file di impostazioni. Apri il file delle impostazioni utente su C:\Users\<you>\.claude\settings.json in Windows (~/.claude/settings.json altrove) e aggiungi il seguente blocco env, mantenendo le impostazioni esistenti:

    {
      "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: Deve corrispondere esattamente alla Local URL in Agent Redactor.
    • ANTHROPIC_AUTH_TOKEN: Qualsiasi valore segnaposto funziona. Agent Redactor custodisce già la tua vera chiave API in sicurezza e la inietta a monte.
    • ANTHROPIC_MODEL e le override del modello: Sostituisci anthropic/claude-haiku-4.5 con il nome esatto del modello del tuo provider. Impostandoli tutti garantisci che Claude Code, i suoi subagent e le attività in background usino lo stesso modello.

    Altre voci nel file, come theme o autoUpdatesChannel, non sono correlate, quindi lasciale così come sono.

  4. Alternativa: variabili di sessione temporanee

    Se preferisci non toccare il file di impostazioni, ad esempio per testare il proxy una volta, imposta le variabili nel terminale. Durano solo per la sessione corrente del terminale.

    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"

    Una volta chiuso il terminale, le variabili scompaiono e Claude Code torna alla sua configurazione normale.

  5. Avvia Claude Code e lavora in sicurezza

    Apri un nuovo terminale (così da ricevere le nuove impostazioni) e avvia Claude Code:

    claude

    La schermata di benvenuto dovrebbe mostrare il modello scelto in esecuzione con fatturazione per utilizzo API. Tutte le richieste in uscita vengono ora filtrate localmente tramite Agent Redactor prima ancora di toccare internet. Nell'esempio seguente, il modello può vedere che il nome è stato redatto prima che il prompt gli arrivasse.

    Sessione di Claude Code in cui il modello risponde che il nome dell'utente è stato redatto nel messaggio di sistema e non riesce a leggerlo
    Claude Code in esecuzione tramite il proxy. Il modello ha ricevuto un segnaposto redatto invece del nome reale.

Verifica della redazione

Controlla il pannello Session Redactions in Agent Redactor per vedere esattamente cosa è stato intercettato.

Agent Redactor che mostra il pannello Statistics con Requests: 1, PII: 2 e Session Redactions che elenca PII intercettati incluso private_person Bob
Il pannello Statistics mostra "Requests: 1, PII: 2" e Session Redactions elenca i valori intercettati con timestamp e tipo.
Suggerimento: Usa Regex Patterns e Keywords nel tuo profilo per intercettare segreti specifici del progetto che il modello AI potrebbe perdere, ad esempio nomi host interni, ID proprietari o nomi in codice del progetto.