Utiliser Claude Code avec Agent Redactor

Prérequis : Installez Agent Redactor et laissez-le fonctionner. Vous devez également avoir Claude Code installé et disponible dans votre PATH.
  1. Configurez Agent Redactor (à faire en premier)

    Avant de configurer Claude Code, faites tourner le proxy local de masquage pour que Claude Code puisse se connecter à travers lui. Dans la barre latérale Profiles, sélectionnez ou créez un profil. Définissez la Local URL sur http://localhost:8080/ (ou votre port préféré), Forward To sur le véritable point de terminaison de votre fournisseur (par ex. https://openrouter.ai/api/), et collez votre véritable API Key. La clé est chiffrée localement et ne quitte jamais votre machine. Cliquez sur Save All Settings et confirmez que le port s'affiche comme disponible.

  2. Choisissez vos règles de masquage

    Décidez de ce qui est masqué avant que quoi que ce soit ne quitte votre machine. Vous pouvez activer le AI Powered Detection Model et cocher les catégories de PII qu'il doit détecter, ajouter des Regex Patterns et des Keywords pour une correspondance déterministe, ou utiliser toute combinaison des trois. Le choix vous appartient. Regex et Keywords sont également idéaux pour les secrets spécifiques au projet que le modèle d'IA pourrait manquer.

  3. Pointez Claude Code vers Agent Redactor (permanent)

    Claude Code lit les variables d'environnement depuis son fichier de paramètres. Ouvrez votre fichier de paramètres utilisateur à C:\Users\<you>\.claude\settings.json sous Windows (~/.claude/settings.json ailleurs) et ajoutez le bloc env suivant en conservant vos paramètres existants :

    {
      "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: Doit correspondre exactement à la Local URL dans Agent Redactor.
    • ANTHROPIC_AUTH_TOKEN: Toute valeur d'espace réservé fonctionne. Agent Redactor conserve déjà votre véritable clé API en sécurité et l'injecte en amont.
    • ANTHROPIC_MODEL et les remplacements de modèle : Remplacez anthropic/claude-haiku-4.5 par le nom exact du modèle de votre fournisseur. Les définir tous garantit que Claude Code, ses sous-agents et les tâches d'arrière-plan utilisent le même modèle.

    Les autres entrées du fichier, comme theme ou autoUpdatesChannel, ne sont pas concernées, alors laissez-les telles quelles.

  4. Alternative : variables de session temporaires

    Si vous préférez ne pas toucher au fichier de paramètres, par exemple pour tester le proxy une fois, définissez les variables dans votre terminal. Elles ne durent que la session de terminal en cours.

    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"

    Une fois le terminal fermé, les variables disparaissent et Claude Code revient à sa configuration normale.

  5. Démarrez Claude Code et travaillez en sécurité

    Ouvrez un nouveau terminal (pour qu'il prenne les nouveaux paramètres) et lancez Claude Code :

    claude

    L'écran d'accueil devrait afficher votre modèle choisi fonctionnant via la facturation d'utilisation de l'API. Toutes les requêtes sortantes sont désormais filtrées localement via Agent Redactor avant même de toucher internet. Dans l'exemple ci-dessous, le modèle peut voir que le nom a été masqué avant que l'invite ne lui parvienne.

    Session Claude Code où le modèle répond que le nom de l'utilisateur a été masqué dans le message système et qu'il ne peut pas le lire
    Claude Code fonctionne via le proxy. Le modèle a reçu un espace réservé masqué au lieu du véritable nom.

Vérification du masquage

Consultez le panneau Session Redactions dans Agent Redactor pour voir exactement ce qui a été intercepté.

Agent Redactor affichant le panneau Statistics avec Requests: 1, PII: 2, et Session Redactions listant les PII interceptés dont private_person Bob
Le panneau Statistics affiche "Requests: 1, PII: 2" et Session Redactions liste les valeurs interceptées avec horodatage et type.
Astuce : Utilisez des Regex Patterns et des Keywords dans votre profil pour capturer les secrets spécifiques au projet que le modèle d'IA pourrait manquer, par exemple des noms d'hôtes internes, des ID propriétaires ou des noms de code de projet.