Usar o Claude Code com o Agent Redactor

Pré-requisito: Instale Agent Redactor e deixe-o em execução. Você também precisa ter o Claude Code instalado e disponível no PATH.
  1. Configure o Agent Redactor (faça isso primeiro)

    Antes de configurar o Claude Code, coloque o proxy local de redação em funcionamento para que o Claude Code possa conectar por meio dele. Na barra lateral Profiles, selecione ou crie um perfil. Defina a Local URL como http://localhost:8080/ (ou sua porta preferida), Forward To como o endpoint real do seu provedor (ex.: https://openrouter.ai/api/) e cole sua API Key real. A chave é criptografada localmente e nunca sai da sua máquina. Clique em Save All Settings e confirme que a porta aparece como disponível.

  2. Escolha suas regras de redação

    Decida o que é redigado antes de qualquer coisa sair da sua máquina. Você pode ativar o AI Powered Detection Model e marcar as categorias de PII que ele deve capturar, adicionar Regex Patterns e Keywords para correspondência determinística ou usar qualquer combinação dos três. A escolha é sua. Regex e Keywords também são ideais para segredos específicos do projeto que o modelo de IA pode perder.

  3. Aponte o Claude Code para o Agent Redactor (permanente)

    O Claude Code lê as variáveis de ambiente do seu arquivo de configurações. Abra o arquivo de configurações do usuário em C:\Users\<you>\.claude\settings.json no Windows (~/.claude/settings.json em outros sistemas) e adicione o seguinte bloco env, mantendo as configurações existentes:

    {
      "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 corresponder exatamente à Local URL no Agent Redactor.
    • ANTHROPIC_AUTH_TOKEN: Qualquer valor de espaço reservado funciona. O Agent Redactor já guarda sua chave de API real com segurança e a injeta a montante.
    • ANTHROPIC_MODEL e as substituições de modelo: Substitua anthropic/claude-haiku-4.5 pelo nome exato do modelo do seu provedor. Definir todos garante que o Claude Code, seus subagentes e as tarefas em segundo plano usem o mesmo modelo.

    Outras entradas no arquivo, como theme ou autoUpdatesChannel, não são relacionadas, então deixe-as como estão.

  4. Alternativa: variáveis de sessão temporárias

    Se preferir não mexer no arquivo de configurações, por exemplo para testar o proxy uma vez, defina as variáveis no seu terminal. Elas duram apenas a sessão atual do terminal.

    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"

    Quando você fecha o terminal, as variáveis desaparecem e o Claude Code volta à sua configuração normal.

  5. Inicie o Claude Code e trabalhe com segurança

    Abra um novo terminal (para que ele pegue as novas configurações) e inicie o Claude Code:

    claude

    A tela de boas-vindas deve mostrar seu modelo escolhido em execução por meio da cobrança de uso da API. Todas as solicitações de saída agora são filtradas localmente por meio do Agent Redactor antes de tocar a internet. No exemplo abaixo, o modelo consegue ver que o nome foi redigido antes que a instrução chegasse até ele.

    Sessão do Claude Code em que o modelo responde que o nome do usuário foi redigido na mensagem do sistema e não consegue lê-lo
    Claude Code em execução por meio do proxy. O modelo recebeu um espaço reservado redigido em vez do nome real.

Verificação da redação

Verifique o painel Session Redactions no Agent Redactor para ver exatamente o que foi interceptado.

Agent Redactor mostrando o painel Statistics com Requests: 1, PII: 2 e Session Redactions listando PII interceptado incluindo private_person Bob
O painel Statistics mostra "Requests: 1, PII: 2" e o Session Redactions lista os valores interceptados com carimbo de data/hora e tipo.
Dica: Use Regex Patterns e Keywords no seu perfil para capturar segredos específicos do projeto que o modelo de IA pode perder, por exemplo nomes de host internos, IDs proprietários ou codinomes de projeto.